Payment Query

Request

API URL: /merchant/v2/{GUID}/payment/query

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	Sign	Description
user_id	String	✅	✅	Merchant identification
order_id	String	✅	✅	Payment order Id of merchant system. The order id should be unique.
timestamp	Interger	✅	✅	Request timestamp (10 digits), If the time difference is allowed to be 5 seconds, it will fail.
sign	String	✅	❌	Signature string. Please refer to Data Signature and Verification

Response

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 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
status	String	✅	✅	0000 = Waiting 1000 = Processing 2000 = Success 3000 = Failed 4000 = Order error
timestamp	Integer	✅	✅	Transaction last update timestamp (10 digits)
submit_promo	Float	⭕	❌	Submit amount promo(Support up to 6 decimal places)
accept_promo	Float	⭕	❌	Paid amount promo of accept currency (Support up to 6 decimal places)
hash	String	⭕	❌	Transaction hash. (Provides when return_hash=true)
payment_address	String	⭕	❌	Crypto exclusive, if need, please inform customer service staff
receiving_address	String	⭕	❌	Crypto exclusive, if need, please inform customer service staff
error_message	String	⭕	❌	Error message
reference_number	String	⭕	❌	GCASH transaction id or QRPH Invoice number
sign	String	✅	❌	Signature string. Please refer to Data Signature and Verification

Response Example