自由换汇结果通知

• Endpoint: POST /exchangeResultNotifyUrl
• Tags: 外汇(新)

Description

该地址无需商户主动请求，以下request.body为payermax对订单状态的回调内容，您在收到回调后需要响应{"msg": "Success","code": "SUCCESS"} 只适用于通过API发起的自由换汇交易

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Required

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
appId	string	Yes		PayerMax分配给商户应用的唯一标识,会员维度的集成appid
code	string	Yes		’APPLY_SUCCESS’代表有效通知
data	object	Yes
data.accountInfo	object	Yes
data.accountInfo.buyFundsAccountNo	string	Yes		买入资金账户
data.accountInfo.sellFundsAccountNo	string	Yes		卖出资金账户
data.ccyPair	string	Yes		币种对(=交易币种目标币种)
data.completeTime	string	Yes		完成时间
data.outTradeNo	string	Yes		商户订单号
data.rate	string	Yes		汇率(1交易币种=?目标币种)
data.rateReferenceId	string	Yes		汇率版本
data.side	string	Yes		针对交易币种的买卖方向
data.status	string	Yes		-PROCESSING 处理中 -SUCCESS 成功 -FAILED 失败
data.targetAmount	string	Yes		目标金额
data.targetCurrency	string	Yes		目标币种
data.tradeNo	string	Yes		平台订单号
data.transactionAmount	string	Yes		交易金额
data.transactionCurrency	string	Yes		交易币种
keyVersion	string	Yes		当前值为：1
msg	string	Yes		有效通知描述：Success
notifyTime	string	Yes		符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX
notifyType	string	Yes		EXCHANGE
version	string	Yes		当前值为：1.0

Example

{
  "appId": "dcd915175dca42a8bad45cdac6f08522",
  "code": "APPLY_SUCCESS",
  "data": {
    "accountInfo": {
      "buyFundsAccountNo": "P25101038985",
      "sellFundsAccountNo": "P25101038984"
    },
    "ccyPair": "USDPHP",
    "completeTime": "2025-12-05T12:56:37.000Z",
    "outTradeNo": "20251201004059PO66350070490846T04",
    "rate": "58.56637500",
    "rateReferenceId": "tieredBatchId0076176493939752933802672",
    "side": "SELL",
    "status": "SUCCESS",
    "targetAmount": "58624.94",
    "targetCurrency": "PHP",
    "tradeNo": "20251205125637TU9495336408000531T05",
    "transactionAmount": "1001.00",
    "transactionCurrency": "USD"
  },
  "keyVersion": "1",
  "msg": "Success",
  "notifyTime": "2026-04-01T13:27:11.689Z",
  "notifyType": "EXCHANGE",
  "version": "1.0"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
msg	string	Yes		返回描述，’Success.’
code	string	Yes		’APPLY_SUCCESS’代表成功

Response Example

{
  "msg": "Success",
  "code": "SUCCESS"
}