API REFERENCE

Vietnam · Payment return

Endpoint, parameters and examples for Vietnam: Payment return.

Notification destination#

POSTpay_callbackurl

application/x-www-form-urlencoded

Parameters#

Parameter	Meaning	Signed	Description
`memberid`	Merchant ID	Yes	Assigned merchant ID
`orderid`	Merchant order ID	Yes	Must be unique
`amount`	Order amount	Yes
`transaction_id`	Platform transaction ID	Yes	Platform transaction ID
`datetime`	Transaction completion time	Yes	Format: YYYYMMDDHHmmss
`returncode`	Transaction status	Yes	“00”=success
`attach`	Additional return data	No	Merchant attachment returned
`sign`	MD5 signature	No	See signing and verification

Examples#

Notification example

{
  "memberid": "10000",
  "orderid": "DEMO_COLLECT_001",
  "transaction_id": "DEMO_PLATFORM_COLLECT",
  "amount": "100.00",
  "datetime": "20261011120500",
  "returncode": "00",
  "sign": "CALCULATE_WITH_YOUR_APIKEY",
  "attach": ""
}

Signing & result handling#

Verify sign before processing. Match merchant, order and amount; apply the result idempotently.

Open signing guide