查询交易
用于检查订单状态
信息
在收到访问凭证（商户 ID、登录名、商户密钥）之后，您可以按照演示 查询订单状态 逐步完成操作，这可能有助于您阅读文档时的理解。
端点
https://ccapi.iotpaycloud.com/v3/cc_query
方法
POST
头部
Content-Type: application/json;charset=UTF-8
请求
| 名称 | 必需 | 类型 | 示例 | 描述 |
|---|---|---|---|---|
| mchId | y | String(30) | 10000701 | 由 IOTPay 分配 |
| mchOrderNo | y | String(30) | 1234567890abc | 由商户分配的订单号（不可重复） |
| payOrderId | y | String(30) | PC20240101231256043886634219 | 由 IOTPay 生成 |
| sign | y | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名算法 |
注意
只需要 mchOrderNo 或 payOrderId 中的一个来进行查询。
响应
| 名称 | 必需 | 类型 | 示例 | 描述 |
|---|---|---|---|---|
| retCode | y | String | SUCCESS 或 FAIL | |
| retMsg | y | String | ||
| retData | y | JSON | 如果 retCode=SUCCESS，则返回订单详细信息 |
retData 包含订单信息:
| 名称 | 必需 | 类型 | 示例 | 描述 |
|---|---|---|---|---|
| payOrderId | y | String | PC20240101231256043886634219 | 由 IOTPay 生成 |
| mchId | y | String | 10000701 | 由 IOTPay 分配 |
| mchOrderNo | y | String | 604567999 | 由商户分配的订单号（不可重复）的订单号 |
| originalOrderId | n | String | 用于退款的原始支付订单 ID | |
| currency | y | String | CAD | 仅支持 'CAD' |
| amount | y | Int | 1500 | 以分为单位 |
| payType | y | String | pay or refund | 支付或退款 |
| refundable | y | Int | 1500 | 可以从该订单中退款的金额（以分为单位） |
| status | y | Int | 0,1,2,9 | 0 = 待处理订单，1 = 未知，2 = 成功，9 = 失败 |
| paySuccTime | y | String | 2021-04-07 19:44:51 | 支付成功的时间戳 |
| cardNum | y | String | 432567******2266 | 用于购买的卡的卡号 |
| expiryDate | y | String | 0725 | 用于购买的卡的到期日期 |
| invoiceNum | y | String | ||
| authNum | y | String | ||
| transNum | y | String | ||
| channel | y | String | PF_CC | PF_CC 或 UPI_EX |