CASHPAY巴西PIX支付API
  1. 支付接口
CASHPAY巴西PIX支付API
  • 身份验证说明
  • CPF验证规则
  • CASHPAY支持巴西游戏用户实名方案
  • 其他提示
  • 支付接口
    • 代收代付查询订单
      GET
    • 创建代收订单
      POST
    • 创建代付订单(新版)
      POST
    • 商户查询余额
      GET
    • 代收代付回调请求示例
      POST
    • 代收代付批量查询接口
      GET
  • 废弃
    • 创建代付订单(废弃)
      POST
  1. 支付接口

创建代收订单

POST
/open-api/pay/payment
请求该接口需要判断返回值当 code=200并且status=00为正常。然后获取返回的payUrl供用户充值
如果http响应码为502,可间隔2秒重试请求3次
pix qrcode 格式 验证工具:https://pix.nascent.com.br/tools/pix-qr-decoder
2024-11-01 代收要求传cpf/name,代收代付需要传用户id

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Basic 之后拼接空格,以及经过 Base64 编码的 username:password
示例:
Authorization: Basic *****************
Header 参数

Body 参数application/json

示例
{
    "amount": "200",
    "notifyUrl": "https://pix.aaa.com/pay/callback",
    "merchantOrderId": "6c16fff6-9c53-4d59-bd55-f567d9207411",
    "merchantUserId":"634123234"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/open-api/pay/payment' \
--header 'x-app-id: appId' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "amount": "200",
    "notifyUrl": "https://pix.aaa.com/pay/callback",
    "merchantOrderId": "6c16fff6-9c53-4d59-bd55-f567d9207411",
    "merchantUserId":"634123234"
}'

返回响应

🟢200OK
application/json
Body

示例
{
    "code": 200,
    "msg": "success",
    "status": "00",
    "payUrl": "https://pay2.mtbtop1.com/s3/checkout-page/v3.html?cid=expireAt%202023-05-29T12:07:34.852740&sid=S110202305291663185317441789952&amount=2&qrcode=00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/5214d403821a491e97374b79733eb2f65204000053039865802BR5925Wudi%20pay%20Correspondente%20d6009Sao%20Paulo62070503***63045210",
    "qrcodeRaw": "00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/5214d403821a491e97374b79733eb2f65204000053039865802BR5925Wudi pay Correspondente d6009Sao Paulo62070503***63045210",
    "amount": "200",
    "fee": "0.8",
    "createTimeL": 1685369254824,
    "orderId": "S110202305291663185317441789952",
    "merchantOrderId": "305291663185317299159040",
    "payType": "110",
    "sign": "a2fdc7724e85038191ad5d212e412bc6",
    "traceId": "i220,i22052976b20c42de1945d7bec29a8a468a1c8f"
}
🔴500Internal Server Error
修改于 2024-11-01 14:45:42
上一页
代收代付查询订单
下一页
创建代付订单(新版)
Built with