API REFERENCE

Vietnam · Query collection

Endpoint, parameters and examples for Vietnam: Query collection.

Endpoint#

POSThttps://YOUR_GATEWAY_HOST/Pay_Trade_query.html

application/x-www-form-urlencoded

Parameters#

Parameter	Meaning	Required	Signed	Description
`pay_memberid`	Merchant ID	Yes	Yes	Assigned merchant ID
`pay_orderid`	Merchant order ID	Yes	Yes	Must be unique
`pay_md5sign`	MD5 signature	Yes	No	See signing and verification

Examples#

cURL · replace placeholders before use

curl --request POST 'https://YOUR_GATEWAY_HOST/Pay_Trade_query.html' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'pay_memberid=10000' \
  --data-urlencode 'pay_orderid=DEMO_COLLECT_001' \
  --data-urlencode 'pay_md5sign=CALCULATE_WITH_YOUR_APIKEY'

Request fields · submit as form

{
  "pay_memberid": "10000",
  "pay_orderid": "DEMO_COLLECT_001",
  "pay_md5sign": "CALCULATE_WITH_YOUR_APIKEY"
}

Response example

{
  "memberid": "10000",
  "orderid": "DEMO_COLLECT_001",
  "amount": "100.00",
  "time_end": "2026-10-11 12:05:00",
  "transaction_id": "DEMO_PLATFORM_COLLECT",
  "returncode": "00",
  "trade_state": "SUCCESS",
  "sign": "CALCULATE_WITH_YOUR_APIKEY"
}

Response example

{
  "memberid": "10000",
  "orderid": "DEMO_COLLECT_001",
  "amount": "100.00",
  "time_end": "1970-01-01 00:00:00",
  "transaction_id": "DEMO_PLATFORM_COLLECT",
  "returncode": "00",
  "trade_state": "NOTPAY",
  "sign": "CALCULATE_WITH_YOUR_APIKEY"
}

Signing & result handling#

Compute the signature over the operation-specific field set, not every example field.

Open signing guide