订阅查询

请求

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（应保持唯一性）
timestamp	整数	✅	✅	请求时间戳（10位数字），允许时间差为5秒，超过则失败
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

响应

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
order_id	字符串	✅	✅	商户系统的支付订单ID（应保持唯一性）
transaction_id	字符串	✅	✅	PTS 交易ID
channel	字符串	✅	✅	请参考 支持通道
submit_currency	字符串	✅	✅	提交的货币
submit_amount	浮点数	✅	✅	提交的金额（支持最多6位小数）
accept_currency	字符串	✅	✅	实际支付的货币
accept_amount	浮点数	✅	✅	支付的金额（支持最多6位小数）
exchange_rate	浮点数	✅	✅	汇率
enabled	布林	✅	✅	订阅状态。true = 已启用，false = 已禁用。
period_count	整数	✅	✅	付款週期(計數)。限填1-12。
period_unit	整数	✅	✅	付款週期(單位)。 1 = 週。 2 = 月。 3 = 年。
subscribe_at	整数	✅	✅	订阅时间戳（10位数字）
last_payment_at	整数	✅	✅	最后付款时间戳（10位数字）
next_payment_at	整数	✅	✅	下次付款时间戳（10位数字）
timestamp	整数	✅	✅	交易的最后更新时间戳（10位数字）
payments	数组<Payment>	⭕	❌	付款清单
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

Payment 物件

参数	类型	描述
payment_id	String	订阅付款 PTS 交易ID
status	String	0000 = 等待 1000 = 处理中 2000 = 成功 3000 = 失败 4000 = 订单错误
timestamp	Integer	交易的最后更新时间戳（10位数字）

响应示例

{
  "code": "1000",
  "message": "Order Success",
  "data": {
    "user_id": "1",
    "order_id": "TP20250110091712",
    "transaction_id": "1062299063447326720",
    "channel": "MAYA",
    "submit_currency": "PHP",
    "submit_amount": 125,
    "accept_currency": "PHP",
    "accept_amount": 125,
    "exchange_rate": 1,
    "enabled": true,
    "period_count": 1,
    "period_unit": 2,
    "subscribe_at": 1738912357,
    "last_payment_at": 1738912361,
    "next_payment_at": 1741309200,
    "timestamp": 1736500634,
    "payments": [
      {
        "payment_id": "1062299068027506688",
        "status": "1000",
        "timestamp": 1736500634
      }
    ],
    "sign": "eDjle27XFldeLCn........"
  }
}