Payment Request

Request

API URL: /merchant/payment

Note

✅ Required ⭕ Optional ❌ Not used

Header	Content	Description
Content-Type	text/plain
Authorization	{token_type} {access_token}	Concat token_type and access_token with whitespace.

Param	Type	Required	Signature	Description
user_id	String	✅	✅	Merchant identification
order_id	String	✅	✅	Payment 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 Currencies & Channels
channel	String	✅	✅	Please refer to Currencies & Channels
email	String	✅	❌	Validate email format
phone	String	✅	❌	Validate phone number format, ex: 09123456789
bank_code	String	⭕	✅	If this param is provided, you need to add it to the sign string.
real_name	String	⭕	❌	Required for RMB transactions to comply with China government regulations.
callback_url	URL	✅	✅	The url to receive callback request from PTS when transaction complete.
redirect_url	URL	✅	✅	When the payment process finished, the client will be redirected to this URL.
error_url	URL	⭕	❌	When the payment process failed, the client will be redirected to this URL.
timestamp	Integer	✅	✅	Request timestamp (10 digits)
remark	String	⭕	❌	Remark
sign	String	✅	❌	Signature string

Response

There are three types of payment response methods.

s

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

Redirect

Return a javascript code with redirect_url, the user will be redirected to actual payment webpage automatically.

HTML

Return a html input form to user with automatically submit javascript. You should forward entire response content to user and make sure html and javascript workable.

JSON

Return request result in JSON format (when response code=1000)

Param	Type	Required	Sign	Description
user_id	String	✅	✅	Merchant identification
order_id	String	✅	✅	Payment order Id of merchant system. The order id should be unique.
transaction_id	String	✅	✅	PTS transaction id
channel	String	✅	✅	Please refer to Currencies & Channels
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
pay_url	URL	✅	✅	The webpage which to pay the amount
wallet_address	String	⭕	❌	Crypto exclusive, if need, please inform customer service staff
expired_at	Integer	⭕	❌	Crypto exclusive, if need, please inform customer service staff
qr_code	String	⭕	❌	QR code for payment (QRPH, INSTAPAY channels only)
sign	String	✅	❌	Signature string

{
    "code": "1000",
    "message": "Accepted",
    "data": {
        "user_id": "1",
        "order_id": "20210521184906",
        "transaction_id": "P12021052118495503889",
        "channel": "CNY2TRC",
        "submit_currency": "CNY",
        "submit_amount": 1000,
        "accept_currency": "USDT-TRC",
        "accept_amount": 165.9181999999,
        "exchange_rate": 0.1659182,
        "sign": "jgtOKfV48sOD2NjBZ4WhiAUMwTgux9fTH53jNzNR..."
    }
}