Create Payment Request

Request

URL

[POST] /api/v1/invoice/create-payment

Headers

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

Body

Name	Required	Type	Description
invoice_id	required	string	Invoice ID
payment_method_id	optional	string	Payment method ID

Response

Headers

Content-Type: application/json

Body

Name	Type	Description
id	uuid.UUID	Payment ID
provider_code	string	Provider code
payment_method	string	Payment method
payment_request_code	string	Payment request code
ref_type	string	Ref type
ref_id	string	Ref ID
linking_bank_account	struct-parent
account_number	string
account_name	string
bank_code	string
is_active	boolean
usage_type	string
id	uuid.UUID
balance_available_amount	float64
reference_id	uuid.UUID
master_account_name	string
bank_id	string
payment_info	struct
payment_note	payment_info:string
request_amount	payment_info:float64
currency_code	payment_info:string
qr_info	struct-parent: payment_info
qr_code	qr_info:string
account_number	qr_info:string
bank_virtual_account_number	qr_info:string
account_name	qr_info:string
bank_code	qr_info:string
bank_id	qr_info:string

Errors

Status	Messsage
200	Success
401	Unauthorized

Example

Request

URL

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

Body

{
    "invoice_id": "92890a75-c0d4-4329-90ad-235ee602ce08",
    "payment_method_id": "fcefa968-fe00-4d06-a431-53bd001e7f4b"
}

Response

Body

{
    "message": {
        "content": "Bạn vừa thực hiện tạo thành công %s"
    },
    "code": 102001,
    "request_id": "3f619905-43d5-4d69-b9ec-b541de60959e",
    "data": {
        "id": "33db41bc-2bb3-4243-a113-5c32db331cf8",
        "provider_code": "sobanhang",
        "payment_method": "viet_qr_pro_mb",
        "payment_request_code": "PRTL3VUI",
        "ref_type": "invoice",
        "ref_id": "SOSPMFA3",
        "linking_bank_account": {
            "account_number": "VQRQOPBIE7328",
            "account_name": "NGUYEN VAN A",
            "bank_code": "MB",
            "is_active": false,
            "usage_type": "",
            "id": "cb375200-480c-4c18-8592-e30617f90fc7",
            "balance_available_amount": 0,
            "reference_id": "",
            "master_account_name": "NGUYEN VAN A",
            "bank_id": "311"
        },
        "payment_info": {
            "qr_info": {
                "qr_code": "00020101021238570010A000000727012700069704220113VQRQOQHMM90720208QRIBFTTA530370454063500005802VN62320107NPS68690817TT3LKETR SOSPMFA363045662",
                "account_number": "5729334769767",
                "bank_virtual_account_number": "VQRQOQHMM9072",
                "account_name": "NGUYEN VAN A",
                "bank_code": "MB",
                "bank_id": "311"
            },
            "payment_note": "TT3LKETR SOSPMFA3",
            "request_amount": 350000,
            "currency_code": "VND"
        }
    }
}

QR Check

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