订单查询请求参数
# 请求地址
POST https://ph-openapi.toppayment.com/ph/disbursement/query
# 请求参数
- 注：商户订单号和平台订单号两者必需传递其中一个，也可以同时传递
| 参数 | 是否必填(Y-是,N-否) | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| mchNo | string(32) | Y | 商户编号，在商户平台-个人中心-个人信息中获取 | PHOT000012 |
| timestamp | long | Y | 请求时间戳 | 11749029774 |
| sign | string | Y | 签名字符串 | PHOT000001 |
| orderNum | string(64) | Y | 商户订单号 | T1231511321515 |
| platOrderNum | string(64) | Y | 平台订单号 | PRE1234567890 |
# 响应参数
| 参数 | 类型 | 描述 | 示例 |
|---|---|---|---|
| orderNum | String | 商户订单号 | 23645782 |
| platOrderNum | String | 平台订单号 | 987654321 |
| amount | string | 支付金额 | 10000 |
| fee | String | 手续费金额 | 12.25 |
| feeType | String | 手续费类型 | 0：订单内扣除，1：手续费另计 |
| status | String | 订单状态 | |
| statusMsg | String | 订单状态描述 | |
| bankCode | String | 银行编号 | 014(参考附录Ⅱ BankCode小节) |
| bankCard | string(64) | 客户银行卡号 | 12312431241 |
| accountName | String(64) | 客户名称 | Amot |
| description | string(255) | 代付说明 | 代付下单 |
# 请求报文示例
- 代收订单请求报文示例
{
"timestamp": "11749029774",
"mchNo": "PHOT000012",
"orderNum": "T1642593166888",
"platOrderNum": "PRE1642593166888",
"sign": "lGw1OJcuUL0MGaIq44U2u2bFM5dalJJuT/G6mQWbIBT9dmVAJaLwR125emPDXYYSdnOtNxja86A2VJJLf40BCg2HevHolebvt2ay3ukCQaUhwNkIGz4KF0Ud+XMUA36LoFTWZbDYv9y8vgCnWxwZFKj7ePrfLxc+TA7jpqv65lQ\u003d"
}
- 代收订单响应报文示例
{
"success": true,
"code": "9999",
"timestamp": 1749029774,
"message": "Success",
"data": {
"platOrderNum": "W0620220119174331000001",
"orderNum": "186888188666",
"status": 0,
"statusMsg": "Apply",
"amount": "50000",
"fee": "7",
"feeType": "0",
"bankCode": "1001",
"bankCard": "123456789",
"accountName": "test cash name",
"description": "test cash",
}
}