4.3 WebPay 收款还款通知

POST

/callbacks/webpay-payment

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

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

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

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

原始文档：https://docs.paycools.com.my/zh/PaymentOrder/PaymentOrderNotification.html

请求参数

Body 参数application/json必填

示例

{
    "sign": "V6HQvEZaLF5MSH8TcOVdqPj7fLyvdrAOPm74rW9svpclBIVPlokyiZqPXl09/yAOS8PNnganUtvRvie9MAxJwtYOkDMXxxi4gWjPl3D9L6W4fnVeC28HjhZhWrSgwlecJG6SuHM3odTHAxr5WQUuOxsYFtx+c74Ew+ZzuICCH3dA4+uzNEbDyB8QmBF94nM1LFhDId/VEMxdbj8xKJuOMiSBgwAWaFElm5YCfgmrZpU/qLnuGX2hNxQAMKY2GAw+4VpphYpHG8Xak5+PlqFWKp8mKJ9DgyphVf0ACGpcjOQp0S1V+S1HMMVU0AkW6c8n0weOMu3l6k6cPHsjEe/jSQ==",
    "param": "{\"eventName\":\"order.payment.success\",\"amount\":50000,\"channelCode\":\"TOUCHNGO_URL\",\"mchOrderId\":\"Platform653350151938813\",\"createTime\":\"2023-01-01 09:38:06\",\"remark\":\"test payment\",\"sign\":\"xxxxxxxxxxxxx\",\"returnTime\":\"2023-01-01 09:40:06\",\"transactionId\":\"C1032653961085706055\",\"transactionStatus\":\"COMPLETED\"}"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/callbacks/webpay-payment' \
--header 'Content-Type: application/json' \
--data '{
    "sign": "V6HQvEZaLF5MSH8TcOVdqPj7fLyvdrAOPm74rW9svpclBIVPlokyiZqPXl09/yAOS8PNnganUtvRvie9MAxJwtYOkDMXxxi4gWjPl3D9L6W4fnVeC28HjhZhWrSgwlecJG6SuHM3odTHAxr5WQUuOxsYFtx+c74Ew+ZzuICCH3dA4+uzNEbDyB8QmBF94nM1LFhDId/VEMxdbj8xKJuOMiSBgwAWaFElm5YCfgmrZpU/qLnuGX2hNxQAMKY2GAw+4VpphYpHG8Xak5+PlqFWKp8mKJ9DgyphVf0ACGpcjOQp0S1V+S1HMMVU0AkW6c8n0weOMu3l6k6cPHsjEe/jSQ==",
    "param": "{\"eventName\":\"order.payment.success\",\"amount\":50000,\"channelCode\":\"TOUCHNGO_URL\",\"mchOrderId\":\"Platform653350151938813\",\"createTime\":\"2023-01-01 09:38:06\",\"remark\":\"test payment\",\"sign\":\"xxxxxxxxxxxxx\",\"returnTime\":\"2023-01-01 09:40:06\",\"transactionId\":\"C1032653961085706055\",\"transactionStatus\":\"COMPLETED\"}"
}'

返回响应

🟢200

application/json

业务处理结果

Bodyapplication/json

示例

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

修改于 2026-08-31 11:03:58

4.2 WebPay查询收款状态

退款支持列表