BetcatPay
  1. 代收
BetcatPay
  • 接入指引
  • 附件码表
  • 签名示例
  • 签名常见问题解决方案
  • 代收
    • 代收订单创建
      POST
    • 代收订单查询
      GET
  • 代付
    • 代付订单创建
      POST
    • 代付订单查询
      GET
  • 账户
    • 余额查询
      GET
  • 回调通知
    • 代收回调通知
    • 代付回调通知
  • 订单凭证
    • 订单凭证
      GET
  1. 代收

代收订单创建

POST
{{HOST}}/api/v1/payment/order/create

请求参数

Body 参数application/json
appId
string 
应用号
必需
merOrderNo
string 
商户订单号
必需
currency
string 
金额币种
必需
3位字符
amount
number 
订单金额
必需
保留2位小数(若需保留 .00, .0类无效小数位,请转换为字符串格式,避免签名数据不一致)
returnUrl
string 
同步通知地址
可选
notifyUrl
string 
异步通知地址
必需
attach
string 
附加信息
可选
商户附加信息,原样返回
sign
string 
签名
必需
devedor
object 
债务人信息
必需
创建时携带债务人信息,将只有债务人能够付款
cpf
string 
cpf 信息
必需
nome
string 
名字
必需
示例
{
    "appId": "a0c07e56c281c23c9b0bfd94923cfb9d",
    "merOrderNo": "20220408123109677",
    "currency": "BRL",
    "amount": 1,
    "returnUrl": "https://www.betcatpay.net/",
    "notifyUrl": "https://www.betcatpay.net/",
    "sign": "a8e8789b76d43d57d3b72fdfb14f482761e05a192a86048b90710f517369f5f8"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{HOST}}/api/v1/payment/order/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "a0c07e56c281c23c9b0bfd94923cfb9d",
    "merOrderNo": "20220408123109677",
    "currency": "BRL",
    "amount": 1,
    "returnUrl": "https://www.betcatpay.net/",
    "notifyUrl": "https://www.betcatpay.net/",
    "sign": "a8e8789b76d43d57d3b72fdfb14f482761e05a192a86048b90710f517369f5f8"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
响应状态码
必需
0为成功
data
object 
返回数据
必需
orderStatus
integer 
订单状态
必需
0生成订单,1支付中,2支付未通知,3支付已通知,-1交易失败,-2交易过期,-3交易退还,-4交易异常
orderNo
string 
交易订单号
必需
merOrderNo
string 
商户订单号
必需
amount
number 
订单金额
必需
currency
string 
金额币种
必需
createTime
integer 
必需
updateTime
integer 
必需
message
string 
描述信息
必需
订单异常时会返回此字段,用作异常描述
params
object 
支付数据
必需
sign
string 
签名
必需
msg
string 
返回文字描述
必需
示例
{
    "code": 0,
    "data": {
        "orderStatus": 0,
        "orderNo": "202204161856041167951",
        "merOrderNo": "202204161856042621",
        "amount": 1,
        "currency": "BRL",
        "attach": null,
        "createTime": 1650106564116,
        "updateTime": 1650106564116,
        "params": {
            "url": "https://h5.betcatpay.net/payment/202204161856041167951"
        },
        "sign": "35cad174f71f5771f1709a9a075fc26394b3c41df626c6ed039cd80e55ebf8dc"
    },
    "msg": "请求成功"
}
修改于 2024-10-07 04:38:23
上一页
签名常见问题解决方案
下一页
代收订单查询
Built with