创建代付订单

POST

/open-api/pay/transfer_fast

-------------------- 重点 --------------------
⚠️请求该代付接口只有获取到 code=500 可以认为提交失败
如果发生超时/其他异常，不要直接处理为失败，因为我们可能已经接收到订单，等待我们回调或者调用查询订单api，
⚠️请求我们得到响应后，需要等待至少3分钟，再进行查询订单，如果返回了 code=404 说明我们没有接收到订单可以认为失败。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Body 参数application/json

示例

{
    "accountType": "CPF",
    "accountNum": "32562523890",
    "amount": "100",
    "merchantOrderId": "daifu20230703cspix107",
    "transferReceipt": "no",
    "customerCert": "32562523890",
    "customerName": "HE YONG",
    "notifyUrl": "https://pix.aaa.com/pay/callback",
    "merchantUserId":"634123234"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/open-api/pay/transfer_fast' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "accountType": "CPF",
    "accountNum": "32562523890",
    "amount": "100",
    "merchantOrderId": "daifu20230703cspix107",
    "transferReceipt": "no",
    "customerCert": "32562523890",
    "customerName": "HE YONG",
    "notifyUrl": "https://pix.aaa.com/pay/callback",
    "merchantUserId":"634123234"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例异常示例重复请求

{
    "code": 200,
    "msg": "WAIT_DEDUCT",
    "status": "90",
    "transferReceipt": "no",
    "amount": "100",
    "fee": "0",
    "createTimeL": 1688387795591,
    "orderId": "S120202307031675845995054960640",
    "merchantOrderId": "daifu20230703cspix107",
    "payType": "120",
    "traceId": "i170,i1707032a0b862e2f594444bd50da59536ba8fb",
    "customerName": "HE YONG",
    "customerCert": "32562523890"
}

修改于 2025-08-13 12:16:56

身份验证说明

代付凭证查询