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

代付订单查询

GET
{{HOST}}/api/v1/payout/order/query

特别声明#

代付订单创建发起时,若 HTTP 响应状态码非 200 的情况,一定要通过商户管理后台或者订单查询接口二次核验订单状态,若订单存在且状态为"生成订单"和“交易异常”,则当前订单暂处于进行中状态,不要进行任何订单变更行为,否则将有可能发生不必要的资损,因此请谨慎操作。如果是创建接口返回业务 code 为 400 且有明确的参数验证失败的情况,可以无需查询,直接判定订单失败。若有任何疑问请第一时间向 BetcatPay 团队确认,查询接口一定要以订单状态(orderStatus)为订单判断依据,若是其他任何异常情况,请不要私自修改订单状态,需要向 BetcatPay 团队人工参与进行后续确认,请不要对订单中的提现信息进行二次提现操作,以避免不必要的资金损失。

请求参数

Query 参数
appId
string 
应用号
必需
示例值:
a0c07e56c281c23c9b0bfd94923cfb9d
merOrderNo
string 
可选
商户订单号(orderNo二选一)
示例值:
20220408123109677
orderNo
string 
可选
交易订单号(merOrderNo二选一)
sign
string 
签名
必需
示例值:
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 GET '{{HOST}}/api/v1/payout/order/query?appId=a0c07e56c281c23c9b0bfd94923cfb9d&merOrderNo=20220408123109677&orderNo&sign=a8e8789b76d43d57d3b72fdfb14f482761e05a192a86048b90710f517369f5f8'

返回响应

🟢200成功
application/json
Body
code
integer 
响应状态码
必需
data
object 
返回数据
必需
orderStatus
integer 
订单状态
必需
0生成订单,1支付中,2支付未通知,3支付已通知,-1交易失败,-2交易过期,-3交易撤销,-4交易异常
orderNo
string 
交易订单号
必需
merOrderNo
string 
商户订单号
必需
amount
number 
订单金额
必需
currency
string 
金额币种
必需
receiptUrl
string 
凭证信息
可选
动态数据,视订单情况存在
createTime
integer 
必需
updateTime
integer 
必需
message
string 
描述信息
必需
订单异常时会返回此字段,用作异常描述
sign
string 
签名
必需
msg
string 
返回文字描述
必需
示例
{
    "code": 0,
    "data": {
        "orderStatus": 1,
        "orderNo": "202204191703308526031",
        "merOrderNo": "202204191703302152",
        "amount": 10,
        "currency": "CNY",
        "attach": null,
        "createTime": 1650359010851,
        "updateTime": 1650359011745,
        "sign": "2293b6e8089bb8f65811503ae05e181be450412c9a6ce1bdd285816866363bb7"
    },
    "msg": "请求成功"
}
修改于 2024-04-02 06:04:55
上一页
代付订单创建
下一页
余额查询
Built with