支付接口

接口描述:
商户系统向 支付系统发起支付订单/转账订单 查询请求,支付系统在收到请求后,验证处理并返回结果
业务方向
商户系统 -> 支付系统
安全约束
IP 白名单验证
请求数据签名验证
请求URL:
/api/order/query
请求方式:
POST
参数名
必需
类型
说明
Content-Type string application/json
Accept string application/json
请求参数:
参数名
必需
类型
数据规格
说明
merchantNo long 不能为null,最大长度:20 商户号(咨询客服)
orderNo String 最大长度:20 支付系统订单号
timestamp long 最大长度:12 毫秒级时间戳
sign String 最大长度:64 签名数据
调用示例:
shell
curl --request POST \
--url https://xxx.com/api/order/query  \
--header 'Content-type: application/json' \
--header 'Accept: application/json' \
--data '{
  "merchantNo": 22190316182634496,
  "orderNo": "F22330938439041024",
  "sign": "5f5ae9e54ecf182c71b71426e3b3aa62",
  "timestamp": 1767167360038
}'
json
{
  "merchantNo": 22190316182634496,
  "orderNo": "F22330938439041024",
  "sign": "5f5ae9e54ecf182c71b71426e3b3aa62",
  "timestamp": 1767167360038
}
返回示例:

成功响应时

{
  "data": {
    "merchantNo": 22190316182634496,
    "orderNo": "F22330938439041024",
    "merchantOrderNo": "32e6df0ab6df44eb85d0d3adec590eaf",
    "amount": "100",
    "currency": 1,
    "status": 5,
    "orderType": 2,
    "statusMsg": "PROCESSING",
    "timestamp": 1767167178992,
    "sign": "470919b121461c756e4171e23c77ad10"
  },
  "code": "0",
  "message": "Successful"
}

错误时返回

{
  "message": "账户不可用",
  "code": "-1"
}
返回参数说明:
参数名
类型
说明
code String 状态码 : 字符串0表示成功
msg String 结果描述信息
data Object 结果数据
data 数据结构说明:
参数名
类型
说明
merchantNo long 商户号
orderNo String 支付系统订单号
merchantOrderNo String 商户系统订单号
amount dicimal 订单金额
currency int 币种,1是 CNY 人民币
orderType int 订单类型:1支付订单,2 转账订单
status int 转账订单状态,更多状态请参见数据字典
statusMsg String 状态描述
timestamp long 时间戳
sign String 签名

results matching ""

    No results matching ""