订阅查询
请求
API URL: /merchant/v2.1/{GUID}/subscribe/query
Note
{GUID} 由商户后台取得（API 对接 -> GUID）
✅ 必填 ⭕ 可選 ❌ 不適用
| 标头 | 内容 | 描述 |
|---|---|---|
| Content-Type | text/plain | |
| X-Transaction-Signature | {transaction_signature} | 请参阅 交易签名 |
| 参数 | 类型 | 必填 | 签名 | 描述 |
|---|---|---|---|---|
| user_id | 字符串 | ✅ | ✅ | 商户标识码 |
| order_id | 字符串 | ✅ | ✅ | 您的订单ID。订单ID应保持唯一。 |
| timestamp | 整数 | ✅ | ✅ | 请求时间戳（10位数字），允许时间差为5秒，超过则失败。 |
| sign | 字符串 | ✅ | ❌ | 签名字符串。请参阅 数据签名与验证 |
响应
| 参数 | 类型 | 必填 | 签名 | 描述 |
|---|---|---|---|---|
| user_id | 字符串 | ✅ | ✅ | 商户标识码 |
| order_id | 字符串 | ✅ | ✅ | 商户系统的支付订单 ID。订单 ID 应保持唯一 |
| transaction_id | 字符串 | ✅ | ✅ | PTS 交易ID |
| channel | 字符串 | ✅ | ✅ | 请参考 支持通道 |
| submit_currency | 字符串 | ✅ | ✅ | 提交的货币 |
| submit_amount | 浮点数 | ✅ | ✅ | 提交的金额（支持最多6位小数） |
| accept_currency | 字符串 | ✅ | ✅ | 实际支付的货币 |
| accept_amount | 浮点数 | ✅ | ✅ | 支付的金额（支持最多6位小数） |
| exchange_rate | 浮点数 | ✅ | ✅ | 汇率 |
| enabled | 布林 | ✅ | ✅ | 订阅状态。true = 已启用，false = 已禁用。 |
| subscribe_at | 整数 | ✅ | ✅ | 订阅时间戳（10位数字） |
| timestamp | 整数 | ✅ | ✅ | 交易的最后更新时间戳（10位数字） |
| payments | 数组<Payment> | ⭕ | ❌ | 付款清单 |
| sign | 字符串 | ✅ | ❌ | 签名字符串。请参阅 数据签名与验证 |
Payment 物件
| 参数 | 类型 | 描述 |
|---|---|---|
| payment_id | String | 订阅付款 PTS 交易ID |
| status | String | 0000 = 等待 1000 = 处理中 2000 = 成功 3000 = 失败 4000 = 订单错误 |
| timestamp | Integer | 交易的最后更新时间戳（10位数字） |
响应示例