Exchange Result Notification

• Endpoint: POST /exchangeResultNotifyUrl
• Tags: Forex(New)

Description

You do not need to request this url. The following request.body is the callback content from PayerMax regarding the order status. You need to respond with {"msg": "Success","code": "SUCCESS"} upon receiving the callback. For API-initiated flexible FX transaction only.

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		The unique identifier assigned to the merchant app by PayerMax
code	string	Yes		APPLY_SUCCESS means this is a valid callback.
data	object	Yes
data.accountInfo	object	Yes
data.accountInfo.buyFundsAccountNo	string	Yes		Buy funds account number,Funds will be credited to this account upon successful transaction
data.accountInfo.sellFundsAccountNo	string	Yes		Sell funds account number,Funds will be debited from this account upon successful transaction
data.ccyPair	string	Yes		(= transaction currency + target currency)
data.completeTime	string	Yes		Completion time
data.outTradeNo	string	Yes		Merchant order id
data.rate	string	Yes		(1 transaction currency = ? target currency)
data.rateReferenceId	string	Yes
data.side	string	Yes
data.status	string	Yes		PROCESSING: Processing SUCCESS: Success FAILED: Failed
data.targetAmount	string	Yes		Target amount
data.targetCurrency	string	Yes		Target currency
data.tradeNo	string	Yes		Platform order number
data.transactionAmount	string	Yes		Transaction amount
data.transactionCurrency	string	Yes		Transaction currency
keyVersion	string	Yes		Current value: 1
msg	string	Yes		Valid notification description：Success.
notifyTime	string	Yes		Notification time, in line with rfc3339 specification, format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX.
notifyType	string	Yes		EXCHANGE
version	string	Yes		Current value: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
code	string	Yes

Response Example

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