支付接口
接口描述:
商户系统向 支付系统发起支付订单/转账订单 查询请求,支付系统在收到请求后,验证处理并返回结果
业务方向
商户系统 -> 支付系统
安全约束
IP 白名单验证
请求数据签名验证
请求URL:
/api/order/query
请求方式:
POST
Header
| 参数名 | 必需 |
类型 | 说明 |
|---|---|---|---|
| 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 | 签名 |