# 4. 代付回调接口
# 说明
该接口由商户实现,作用是在用户完成还款交易时,调用此接口将还款交易详情通知给商户。
# HTTP请求信息
# URL
由商户提供
# 请求方式
POST
# 请求头
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
Content-Type | mandatory | string | application/json |
# 请求体参数
参数名 | 必选 | 类型 | 长度限制 | 示例 | 说明 |
---|---|---|---|---|---|
param | 是 | string | - | - | 参数体 |
sign | 是 | string | - | 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 | 签名 |
# param 参数
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
eventName | 是 | string | 事件名称( disbursement.success , disbursement.failed ) |
mchOrderId | 是 | string | 商户订单号 |
transactionId | 是 | string | Platform 流水号 |
countryCode | 是 | string | 国家编码 (PH , ID , MY , TH ) |
currency | 是 | string | 标价币种 (PHP , IDR , MYR , THB ) |
amount | 是 | integer | 金额 (单位为分, 当国家为印尼时, 单元为元) |
transactionStatus | 是 | string | 交易状态(PENDING , COMPLETED , FAILED ) |
createTime | 是 | string | 交易创建时间 |
returnTime | 是 | string | 交易完成时间 |
remark | 是 | string | 备注 |
failedCode | 否 | integer | Failed Code |
failedMessage | 否 | string | Failed Message |
# 请求示例
# 请求体
{
"param": "{\"amount\":100,\"countryCode\":\"PH\",\"createTime\":\"2024-07-19T14:14:47+08:00\",\"currency\":\"PHP\",\"eventName\":\"disbursement.failed\",\"failedCode\":-10004,\"failedMessage\":\"Transaction Channel Rejected\",\"mchOrderId\":\"10e1369686110330100\",\"returnTime\":\"2024-07-19T14:15:01+08:00\",\"transactionId\":\"DU514182073259261952\",\"transactionStatus\":\"FAILED\"}",
"sign": "N+1G8irSDgfnjHhAfV7Tn8E0arj65tGV4gBGZCpUJCN57wtvTv8jp173FO/T5zE95RhOo8dg7gLrYL7Sq4F+ukWX1elFgjxEjadrolXPno0Vvib24eP9iFBt3OySEA/dGKmiZJ1BO+5T1NcQYHc+9gyCAuNjuRSi6JKophnxXsFTt4AuaTEaxOwp7gdGD0d5LkyF2MltF09kEP8wdp94zWuVt7x2C/E+MI6yK4DtOqszlo54v0r/UNyctIsA45dsWd33dFx7liyOkJ0iKWmdS/kAzUPjQ4bCp7zxMMh/MSz2PxCp6fEAVOl6vPfp4W3Ef9c/OqCwAI2Z1tOKw+eZRA=="
}
# 响应参数
参数名 | 类型 | 说明 |
---|---|---|
code | integer | 响应码,固定为 10000 |
message | string | 响应消息,固定为 Success |
# 返回示例
{
"code": 10000,
"message": "Success"
}