创建代付订单(新版) - CASHPAY巴西PIX支付API

-------------------- 重点 --------------------
⚠️请求该代付接口只有获取到 code=500 可以认为提交失败

如果发生超时/其他异常，不要直接处理为失败，因为我们可能已经接收到订单，等待我们回调或者调用查询订单api，

⚠️请求我们得到响应后，需要等待至少3分钟，再进行查询订单，如果返回了 code=404 说明我们没有接收到订单可以认为失败。

该新版api与旧版的不同点：1.返回的状态不一样，2.不再返回sign参数，3.增加返回了一些字段

关于巴西通过pix付款给收款人（代付）的解释

收款人需要有pix账号(类似国内支付宝账号)巴西官方名字 pix chave(中文: pix 键，英文 pix key)

个人主体付款人有账户肯定有自己的CPF (税号/证件号，类似国内身份证号)，公司主体是 CNPJ

pix chave 类型有5种，分别是EMAIL/PHONE/CPF/CNPJ/EVP，
同样pix 键就是上面5种格式，CPF:11位数；PHONE:11位数(可加前缀'+55')；EMAIL:邮箱格式；CNPJ:14位数；EVP: uuid格式
对接我们：
accountNum 传pix chave
accountType 传对应类型
customerCert 传税号，个人传他的CPF,公司传他的CNPJ
customerName 传用户名字

建议在提交支付平台之前或者前端校验用户输入的CPF，检验规则见：《CPF验证规则》

请求参数

Authorization

在 Header 添加参数

Authorization

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

示例：

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

Header 参数

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

返回响应

🟢200OK

application/json

Body

示例

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

{
    "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"
}

🔴500Internal Server Error