Callback Notify

Callback notify 是交易处理后，发送到商户 notifyUrl 的通知。

该回调适用于：

• Pay-in 交易（生成 QRIS 交易后）
• Disbursement 交易（发起转账后）

发送摘要

Item	值
Method	POST
Content-Type	application/json
目标地址	交易请求中传入的 notifyUrl

KingsPay 服务器 IP 白名单

如果商户系统在 notifyUrl 端点启用了基于 IP 的白名单，请添加以下 KingsPay 服务器 IP：

• 172.237.80.251
• 172.237.86.181
• 104.64.211.91
• 104.64.213.171
• 172.236.138.74

Pay-in 回调载荷

{
  "idMerchant": 1,
  "merchantName": "TESTING STORE",
  "merchantTrxId": "D1776936915102936",
  "platformTrxId": "20260423093515686737973",
  "amount": 10000,
  "status": "success",
  "success_at": "2026-04-23 16:37:04.815+07:00",
  "additionalInfo": {
    "rrn": "001137044141",
    "nmid": "ID1026481167827",
    "storeName": "Lumibook Digital Store"
  }
}

Pay-in 字段说明

Field	Type	Description
idMerchant	number	系统内商户 ID
merchantName	string	商户名称
merchantTrxId	string	商户侧交易 ID
platformTrxId	string	平台交易 ID
amount	number	交易金额
status	string	交易状态
success_at	string	交易成功时间
additionalInfo.rrn	string	Reference Retrieval Number
additionalInfo.nmid	string	National Merchant ID
additionalInfo.storeName	string	QRIS 交易中的门店名称

Disbursement 回调载荷

{
  "merchantTrxId": "2026042420291140486107584",
  "platformTrxId": "20260424132917411739651",
  "accountNo": "3324234234",
  "accountName": "JOHN DOE",
  "amount": 10000,
  "status": "success",
  "success_at": "2026-04-24 15:35:24"
}

Disbursement 字段说明

Field	Type	Description
merchantTrxId	string	商户侧交易 ID
platformTrxId	string	平台交易 ID
accountNo	string	收款账号
accountName	string	账户姓名
amount	number	转账金额
status	string	交易状态
success_at	string	交易成功时间

商户端响应建议

建议 notifyUrl 端点在成功接收 payload 后返回 HTTP 200 OK，以便回调被记录为成功。