Create Payment Request

Request

URL

[POST] /api/v1/payment/create

Headers

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

Body

Name	Required	Type	Description
bank_account_id	required	string	number bank account which linked to bank
payment_info	required	struct-parent
payment_note	optional	string	optional for verify come from your service
request_amount	required	float64	min=2000, max=1000000000
currency_code	required	string	704 = VND, 840 = USD

Response

Headers

Content-Type: application/json

Body

Name	Type	Description
id	string	Payment ID
payment_request_code	string	Payment request code
amount	float64	Amount
account_name	string	Account name
account_number	string	Account number
bank_code	string	Bank code
qr	string	QR

Errors

Status	Messsage
200	Success
401	Unauthorized

Example

Request

URL

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

Body

{
    "payment_info": {
        "payment_note": "[Open API] test payment MHRrnZ",
        "request_amount": 12345,
        "currency_code": "616"
    },
    "bank_account_id": "b39da812-1a50-486a-b18b-3462b5ea4ad9"
}

Response

Body

{
    "message": {
        "content": "Bạn vừa thực hiện tạo thành công %s"
    },
    "code": 102001,
    "request_id": "919df25a453b171c1bd400b034de8a92",
    "data": {
        "id": "18ee260d-9866-40c2-a232-62bcf49a50f7",
        "payment_request_code": "PRR3NU5X",
        "amount": 12345,
        "account_name": "MBCHILDB",
        "account_number": "1AM002110000123",
        "bank_code": "SHBVN",
        "qr": "00020101021238590010A0000007270129000697042401151AM0025000002390208QRIBFTTA53037045405123455802VN5908MBCHILDB62290825[Open API] test payment M6304F205"
    }
}

QR Check

https://me-qr.com/qr-code-generator/qr -> copy qr -> choose Text then paste it in there