Skip to main content
POST
VND Disbursement Application
All example requests on this page are based on the sandbox (test) environment. Please be careful to distinguish it from the production environment.

Secret Key & Private Key (Generate Signature)

Body

application/json
appId
integer
required

Business ID (obtained from backend, must match the currency in the URL)

orderId
string
required

Merchant order ID

Maximum string length: 48
amount
string
required

Transaction amount (unit: ₫) Range: 50,000–10,000,000

accountType
enum<string>
required

Account type: BANK_ACCOUNT

Available options:
BANK_ACCOUNT
bankCode
string
required

Bank code

accountNo
string
required

User bank account number

name
string
required

Recipient name (Format: English or Vietnamese, case-insensitive, spaces allowed, 1–30 characters, "firstName middleName lastName" (middleName is optional), special characters supported: '.-)

Required string length: 1 - 30
phone
string
required

Real phone number

email
string<email>
required

Real email address

partnerUserId
string
required

User unique identifier (e.g., userId). Used by risk control, must be valid. Format: numbers, letters, or common symbols -~!@#$%&*()_.

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
required

Signature

notifyUrl
string<uri>

Callback URL

subject
string

Payment note (transaction title, product name, payment reason)

body
string

Detailed note

Response

200 - application/json
status
string

1: Normal, 0: Exception

error
string

Error code

msg
string

Error description

data
object
Last modified on October 13, 2026