代收订单创建

请求参数

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

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": "请求成功"
}