2.3 代付下单接口

POST

/open-api/disbursement

商户代付-下单接口

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

参数名	必选	类型	长度限制	示例	说明
timestamp	是	long	-	1678356680000	毫秒时间戳
mchOrderId	是	string	10-32	CCP20220428011068111	商户订单id，格式：字母+数字
idempotencyId	是	string	10-32		幂等式校验KEY, 格式：字母+数字
amount	是	long	-	50000	代付金额（单位为分）
accountNo	是	string	1-50	-	收款人账号, 如果是手机号码, 需要以01开头
accountName	是	string	1-128	-	收款人姓名格式：英文大小写且允许有空格
payMethodCode	是	string	-	参考此列表	代付类型
transferCode	是	string	-	参考此列表	收款渠道编码
accountType	是	string	-		收款账号类型 ( MOBILE_NUMBER , BANK_ACCOUNT )
remark	否	string	1-256	-	代付备注

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

请求参数

Body 参数application/json必填

示例

{
    "appId": "123456",
    "sign": "abcdef",
    "param": "{\"mchOrderId\":\"TestMchOrderIdD0001\",\"idempotencyId\":\"TestMchOrderIdD0001\",\"amount\":100,\"payMethodCode\":\"BANK\",\"transferCode\":\"RHBB\",\"accountNo\":\"1234\",\"accountName\":\"account\",\"remark\":\"remark\",\"timestamp\":1678356680000}"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/open-api/disbursement' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "123456",
    "sign": "abcdef",
    "param": "{\"mchOrderId\":\"TestMchOrderIdD0001\",\"idempotencyId\":\"TestMchOrderIdD0001\",\"amount\":100,\"payMethodCode\":\"BANK\",\"transferCode\":\"RHBB\",\"accountNo\":\"1234\",\"accountName\":\"account\",\"remark\":\"remark\",\"timestamp\":1678356680000}"
}'

返回响应

🟢200

application/json

业务处理结果

Bodyapplication/json

示例

成功示例失败示例

{
    "code": 1000,
    "message": "success",
    "data": {
        "transactionId": "D1036653581161279102",
        "transactionStatus": "PENDING",
        "transactionTime": "2022-05-24 12:51:07"
    }
}

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

2.2 查询验卡订单状态

2.4 查询代付状态接口