BetcatPay

代付订单查询

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

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

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

最后修改时间： 10 个月前