订阅请求

请求

API URL: /merchant/v2.1/{GUID}/subscribe

Note

{GUID} 由商户后台取得（API 对接 -> GUID）

✅ 必填 ⭕ 可选 ❌ 不适用

标头	内容	描述
Content-Type	text/plain
X-Transaction-Signature	{transaction_signature}	请参阅 交易签名

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
order_id	字符串	✅	✅	商户系统的支付订单ID（应保持唯一性）。
amount	字符串	✅	✅	交易金额（支持最多6位小数。
currency	字符串	✅	✅	请参阅 支持通道。
channel	字符串	✅	✅	请参考 支持通道
card_number	字符串	✅	✅	信用卡号码
card_exp_month	字符串	✅	✅	信用卡到期月份
card_exp_year	字符串	✅	✅	信用卡到期年份
card_cvc	字符串	✅	✅	信用卡 CVC
first_name	字符串	✅	✅	客戶的 first part of name，不可包含數字
middle_name	字符串	⭕	❌	客戶的 middle part of name，不可包含數字
last_name	字符串	✅	✅	客戶的 last part of name，不可包含數字
timestamp	整数	✅	✅	请求时间戳（10位数字），允许时间差为5秒，超过则失败。
details	Details	✅	❌	Details 物件 依通道而定。
callback_url	URL	⭕	❌	用于接收 PTS 交易完成后的回调请求的 URL。
remark	字符串	⭕	❌	备注。
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

响应

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
order_id	字符串	✅	✅	商户系统的支付订单ID（应保持唯一性）
transaction_id	字符串	✅	✅	PTS 交易ID
channel	字符串	✅	✅	请参阅 支持通道
submit_currency	字符串	✅	✅	提交的货币
submit_amount	浮点数	✅	✅	提交的金额（支持最多6位小数）
accept_currency	字符串	✅	✅	实际支付的货币
accept_amount	浮点数	✅	✅	支付的金额（支持最多6位小数）
exchange_rate	浮点数	✅	✅	汇率
verification_url	URL	⭕	❌	验证网页
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

响应示例