Subscribe Request

Request

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

Note

{GUID} Obtained from the merchant backend (API Docking -> GUID)

✅ Required ⭕ Optional ❌ Not used

Header	Content	Description
Content-Type	text/plain
X-Transaction-Signature	{transaction_signature}	Please refer to Transaction Signature

Param	Type	Required	Signature	Description
user_id	String	✅	✅	Merchant identification
order_id	String	✅	✅	Subscribe order Id of merchant system. The order id should be unique.
amount	String	✅	✅	Transaction amount (Support up to 6 decimal places)
currency	String	✅	✅	Please refer to Support Channel
channel	String	✅	✅	Please refer to Support Channel
card_number	String	✅	✅	Credit card number
card_exp_month	String	✅	✅	Credit card expiration month
card_exp_year	String	✅	✅	Credit card expiration year
card_cvc	String	✅	✅	Credit card CVC
first_name	String	✅	✅	Client's first name, cannot contain numbers.
middle_name	String	⭕	❌	Client's middle name, cannot contain numbers.
last_name	String	✅	✅	Client's last name, cannot contain numbers.
timestamp	Integer	✅	✅	Request timestamp (10 digits), If the time difference is allowed to be 5 seconds, it will fail.
details	Details	⭕	❌	Details object depends on channel
callback_url	URL	⭕	❌	The url to receive callback request from PTS when transaction complete.
remark	String	⭕	❌	Remark
sign	String	✅	❌	Signature string. Please refer to Data Signature and Verification

There are three types of subscribe response methods.

tip

You should notify PTS customer service to configure this for you to match actual usage situation.

Param	Type	Required	Sign	Description
user_id	String	✅	✅	Merchant identification
order_id	String	✅	✅	Subscribe order Id of merchant system. The order id should be unique.
transaction_id	String	✅	✅	PTS transaction id
channel	String	✅	✅	Please refer to Support Channel
submit_currency	String	✅	✅	Submit currency
submit_amount	Float	✅	✅	Submit amount (Support up to 6 decimal places)
accept_currency	String	✅	✅	The currency real paid
accept_amount	Float	✅	✅	Paid amount of accept currency (Support up to 6 decimal places)
exchange_rate	Float	✅	✅	Exchange rate
verification_url	URL	⭕	❌	The webpage for verification
sign	String	✅	❌	Signature string. Please refer to Data Signature and Verification