订单查询请求参数
# 请求地址
POST https://ph-openapi.toppayment.com/ph/pay/query
# 请求参数
- 注：商户订单号和平台订单号两者必需传递其中一个，也可以同时传递
| 参数 | 是否必填(Y-是,N-否) | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| mchNo | string(32) | Y | 商户编号，在商户平台-个人中心-个人信息中获取 | PHOT000001 |
| 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 | 手续费金额 | 5.32 |
| productDetail | String | 产品详情 | Macbook Pro |
| customerName | String | 客户名称 | Amot |
| customerEmail | String | 客户邮件 | [email protected] |
| customerPhone | String | 客户手机号码 | 123456789 |
| validTime | Long | 有效期 | |
| status | String | 订单状态 |
# 请求报文示例
- 代收订单请求报文示例
{
"timestamp": "11749029774",
"mchNo": "PHOT000001",
"orderNum": "T1642593166888",
"platOrderNum": "PRE1642593166888",
"sign": "lGw1OJcuUL0MGaIq44U2u2bFM5dalJJuT/G6mQWbIBT9dmVAJaLwR125emPDXYYSdnOtNxja86A2VJJLf40BCg2HevHolebvt2ay3ukCQaUhwNkIGz4KF0Ud+XMUA36LoFTWZbDYv9y8vgCnWxwZFKj7ePrfLxc+TA7jpqv65lQ\u003d"
}
- 代收订单响应报文示例
{
"success": true,
"code": "9999",
"msg": null,
"timeStamp": 1749543668391,
"data": {
"orderNum": "PH1234565",
"platOrderNum": "PRE1932314772468932608",
"amount": 100.00000000,
"fee": 2.00000000,
"validTime": 1749621117000,
"productDetail": "测试",
"customerName": "andy测试",
"customerEmail": "[email protected]",
"customerPhone": "0817773255",
"status": "NO_PAY"
}
}