Create Virtual Account

Request

URL

[POST] /api/account/create-virtual-account

Headers

Content-Type: application/json
x-client-id: <client_id>
x-signature: <signature>
x-timestamp: <timestamp>

Body

Name	Required	Type	Description
master_account_id	required	string	number bank account which linked to bank
name	required	string	virtual account name
bank_code	required	string	SHBVN / MB / (BIDV currently not supported)
bank_account_name	optional	string	ex: Shinha Bank 1-2-3
alias_name	optional	string	ex: Shinhabank

Response

Headers

Content-Type: application/json

Body

Name	Type	Description
account_name	string	Account name
account_number	string	Account number
bank_code	string	Bank code
currency_code	string	ex : VND/USD
provider_business_id	amount	Provider business id
master_account_name	string	Master account name

Errors

Status	Messsage
200	Success
401	Unauthorized

Example

Request

URL

[POST] /oapi/v1/banking/virtual-account

Body

{
    "master_account_id": "0f00f25f-1096-4dc9-af68-e58a10c34a4f",
    "name": "MB-Child-B",
    "bank_code": "SHBVN"
}

Response

Body

{
    "message": {
        "content": "Bạn vừa thực hiện tạo thành công %s"
    },
    "code": 102001,
    "request_id": "f3fe9810-c9a9-4f56-93b1-b54ef6dbcac8",
    "data": {
        "account_name": "MBCHILDB",
        "account_number": "1AM002110000132",
        "bank_code": "SHBVN",
        "currency_code": "704",
        "master_account_name": "CONG TY TNHH 1AM VIET NAM"
    }
}