Create Deposit (Vietnam)

Create a Vietnamese Dong (VND) deposit order interface.

Request Information

• Request URL: /gateway/api/v2/payments
• Request Method: POST
• Content-Type: application/json;charset=utf-8

Request Parameters

Parameter	Required	Type	Description
platform_id	Yes	String(6)	Merchant ID
service_id	Yes	String(7)	Service ID
payment_cl_id	Yes	String(64)	Merchant Order Number
amount	Yes	Integer(10)	Amount (cents)
notify_url	Yes	String(256)	Transaction result notification URL
request_time	Yes	Integer(10)	Request time (seconds)
sign_type	No	String(16)	Signature type, fixed value HMAC-SHA256
sign	Yes	String(32|64)	Order Signature

Request Example

{
  "amount": "50000000",
  "notify_url": "https://xxx.xx/notification",
  "payment_cl_id": "DEVPM00014581",
  "platform_id": "PF0002",
  "request_time": "1595504136",
  "service_id": "SVC0015",
  "sign": "c81634c1769044eac9e9628a2292f557"
}

Response Example

Success Response

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 5001000,
    "qr_code_content": "00020101021238600010A000000727013000069704480",
    "token": "fabdzannfa",
    "card_name": "NGUYEN VAN A",
    "card_number": "0110100007725008",
    "bank_name": "Asia Commercial Bank"
  }
}

Error Response Example

{
  "error_code": "0004",
  "error_msg": "Signature verification failed!"
}

Response Parameters

Parameter	Type	Description
error_code	String	Error code, see Global Error Codes
error_msg	String	Error message (returned when error_code is not "0000")
link	String	Order cashier page URL
payment_id	String	Platform order number
payment_cl_id	String	Merchant order number
amount	Int	Order amount
token	String	Transfer reference
qr_code_content	String	QR code content
card_name	String	Payee name
card_number	String	Bank card number
bank_name	String	Bank name

Notes

• Merchant ID is a unique identifier assigned by the system. If you haven't obtained one, please contact system personnel
• Service ID options:
  • SVC0015 Bank Card (Vietnam channel)
  • SVC0016 Bank Direct (Vietnam channel)
  • SVC0017 QR Code (Vietnam channel)
  • Refer to service_id list
• Transaction amount unit is Vietnamese Dong (cents), please multiply by 100. For example, to collect 10000.00, pass the value 1000000
• Request time uses Unix timestamp in seconds
• Transaction results will be notified to notify_url. Please provide a publicly accessible complete URL (only http and https protocols are supported). For parameter specifications, see Transaction Result Notification