2.5 代付回调通知接口

POST

/callbacks/disbursement

此接口由商户实现，路径和服务器地址均为导入占位值。

该接口由商户实现，作用是在用户完成还款交易时,调用此接口将还款交易详情通知给商户。

param 是经过 JSON 序列化后的字符串；下表描述其反序列化后的逻辑字段。

参数名	是否必填	类型	说明
eventName	是	string	事件名称（ disbursement.success ， disbursement.failed ）
mchOrderId	是	string	商户订单号
transactionId	是	string	交易流水号
amount	是	integer	金额
transactionStatus	是	string	交易状态（ PENDING ， COMPLETED ， FAILED ）
createTime	是	string	交易创建时间
returnTime	是	string	交易完成时间
remark	是	string	备注
failedCode	否	integer	Failed Code
failedMessage	否	string	Failed Message

原始文档：https://docs.paycools.com.my/zh/Disbursement/DisburseNotification.html

请求参数

Body 参数application/json必填

示例

{
    "param": "{\"amount\":10000,\"createTime\":\"2023-03-02 09:25:12\",\"eventName\":\"disbursement.success\",\"mchOrderId\":\"TestMchOrderIdD0001\",\"remark\":\"remark\",\"returnTime\":\"2023-03-02 09:25:12\",\"transactionId\":\"D1631118424367169536\", \"transactionStatus\":\"COMPLETED\"}",
    "sign": "abcdef"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/callbacks/disbursement' \
--header 'Content-Type: application/json' \
--data '{
    "param": "{\"amount\":10000,\"createTime\":\"2023-03-02 09:25:12\",\"eventName\":\"disbursement.success\",\"mchOrderId\":\"TestMchOrderIdD0001\",\"remark\":\"remark\",\"returnTime\":\"2023-03-02 09:25:12\",\"transactionId\":\"D1631118424367169536\", \"transactionStatus\":\"COMPLETED\"}",
    "sign": "abcdef"
}'

返回响应

🟢200

application/json

业务处理结果

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "Success"
}

修改于 2026-09-09 02:46:14

2.4 查询代付状态接口

QR Code 渠道码列表