▶️ 创建订单 / Create Payment Order

<aside> 💡

Endpoint: POST /api/pay/neworder

</aside>

参数 / Request Parameters

参数名 类型 必填 示例 描述 / Description
mchId string ✅ BXtest067 商户号 / 注意：商户号不为商户ID
mchOrderNo string ✅ 202503110001 商户订单号
amount int ✅ 10000 金额（分）必须为100的正整数倍 / 实际金额100,这里需要传10000
currency string ✅ BRL 币种
remark string ❌ 备注
notifyUrl string ✅ https://merchant.com/notify 回调地址
returnUrl string ❌ https://merchant.com/return 前端跳转
sign string ✅ 5E0AA05D… 签名值 / Signature

请求示例 / Request Example

POST /api/pay/neworder
mchId="BXtest067"
mchOrderNo="202503110001"
amount=10000
currency="BRL"
remark="123123"
notifyUrl="http://localhost:8081/api/pay/notifyUrl"
returnUrl="http://www.baidu.com/return.htm"
sign="79B1E1C4F3290FBB6CB2FA2CAE2BA67C"

⚠️ SUCCESS 表示订单创建成功，非支付成功。

返回示例 / Response Example

{
"retCode": "SUCCESS",
"retMsg": "OK",
"payOrderId": "Sv20250311182001", // 代收订单号
"payParams": {
	"payMethod": "urlJump",
	"payUrl": "[https://checkout.seavapay.com](https://cashier.seedpay.global/pay?id=12345)/#/checkout/10009/checkout?orderId=Sv20250311182001", // 收银台地址
	"qrString": "00020101021226820014br.gov.bcb.pix2560qrcode.pagsm.com.br/pix/24998ae7-43f8-4dc4-9b07-c53cf2c61deb5204000053039865802BR5907EASYPAY6008SaoPaulo62070503***63047216", // 用于包装的二维码
	"url": null // 用于包装的深链  qrString 或 url必定返回一个
},
"sign": "ABCD1234..." // 密钥
}

⚠️ SUCCESS 表示订单创建成功，非支付成功。

<aside> 💡

特殊说明： qrString：返回为支付二维码 url：深度链接，跳转链接

两个值必定会返回一个用于包装收银台

</aside>

▶️ 查询支付订单 / Query Payment Order

<aside> 💡

Endpoint: POST /api/pay/orderquery

</aside>

参数名 类型 必填 示例 描述 / Description
mchId string ✅ BXtest067 商户号 / 注意：商户号不为商户ID
payOrderId String(30) ✅ Sv20160427210604000490 交易中心生成的订单号，与mchOrderNo二者传一即可
mchOrderNo String(30) ✅ 20160427210604000490 商户生成的订单号，与payOrderId二者传一即可
executeNotify Boolean ✅ true 是否执行回调，如果为true，则交易中心会再次向商户发起一次回调，如果为false则不会发起
sign String(32) ✅ C380BEC2BFD727A4B6845133519F3AD6 签名值，详见签名算法

请求示例 / Request Example

POST /api/agentpay/query_order
mchId="BXtest067"
payOrderId="Sv202503110001"
mchOrderNo="202503110001"
executeNotify=true
sign="C380BEC2BFD727A4B6845133519F3AD6"

返回示例 / Response Example

{
"retCode": "SUCCESS",
"retMsg": "返回信息",
"status": 2,
"amount": 10000, // 金额
"currency": "BRL",
"mchOrderNo": "20160427210604000490", // 商户订单号
"payOrderId": "Sv20160427210604000490", // 代收订单号
"errorMessage":"error message", // 返回错误信息
"channelPayNo": "E12300000", //E2E单号
"voucherMap": {
        "accountNo": "payee_code_123",  // 收款人CPF
        "accountName": "payee_name_123", // 收款人名称  
        "bankName": "payee_bank_123",  // 收款人银行
        "payerCode": "payer_123123123", // 付款人CPF
        "payerBank": "payer_bank_123", //付款人银行
        "payerName": "payer_name_123",  //付款人名称 
},
"paySuccTime": 1730111845123 // 精确到毫秒
}

<aside> 💡

状态说明： -1 创建失败 ｜ 0 订单生成 ｜ 1 支付中 ｜ 2 成功 ｜ 3 失败

</aside>