Skip to main content

订阅请求

请求

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

Note

{GUID} 由商户后台取得(API 对接 -> GUID)

✅ 必填 ⭕ 可选 ❌ 不适用

标头内容描述
Content-Typetext/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,不可包含數字
period_count整数付款週期(計數)。限填1-12。
period_unit整数付款週期(單位)。
1 = 週。
2 = 月。
3 = 年。
timestamp整数请求时间戳(10位数字),允许时间差为5秒,超过则失败
detailsDetailsDetails 物件 依通道而定
callback_urlURL用于接收 PTS 交易完成后的回调请求的 URL
remark字符串备注
sign字符串签名字符串。请参阅 数据签名与验证

Details 物件

参数类型描述
phone字符串有效的手機號格格式,如 09123456789。
email字符串有效的電子郵件格式。

响应

参数类型必填签名描述
user_id字符串商户标识码
order_id字符串商户系统的支付订单ID(应保持唯一性)
transaction_id字符串PTS 交易ID
channel字符串请参考 支持通道
submit_currency字符串提交的货币
submit_amount浮点数提交的金额(支持最多6位小数)
accept_currency字符串实际支付的货币
accept_amount浮点数支付的金额(支持最多6位小数)
exchange_rate浮点数汇率
period_count整数付款週期(計數)。限填1-12。
period_unit整数付款週期(單位)。
1 = 週。
2 = 月。
3 = 年。
verification_urlURL验证网页
sign字符串签名字符串。请参阅 数据签名与验证

响应示例

{
"code": "1000",
"message": "Accepted",
"data": {
"user_id": "1",
"order_id": "TP20250110091712",
"transaction_id": "1062299068027506688",
"channel": "MAYA",
"submit_currency": "PHP",
"submit_amount": 125,
"accept_currency": "PHP",
"accept_amount": 125,
"exchange_rate": 1,
"verification_url": "https://......",
"period_count": 1,
"period_unit": 2,
"sign": "hdFe+P0Qzjo4zcKqWiUeytWDB28Pc2x....."
}
}