---
title: "Khởi tạo QR Code"
method: POST
path: "/api/v1/acb/qr-payment/generate"
tags: ["ACB QR Banking"]
---

# Khởi tạo QR Code

`POST /api/v1/acb/qr-payment/generate`

## Request

- Base URL: `https://api.monapay.vn`
- URL: `https://api.monapay.vn/api/v1/acb/qr-payment/generate`
- Auth: `Bearer Auth` (a scheme the document does not define)

Đây là chuẩn ACB cung cấp cho doanh nghiệp để doanh nghiệp xây dựng API theo chuẩn này với mục đích gọi sang hệ thống ACB cung cấp thông tin đơn hàng thanh toán cần tạo QRCode. Điều kiện cần:
            
            Số tài khoản hưởng là tài khoản của doanh nghiệp và đã có đăng ký Tài khoản định danh trên hệ thống ACB.
            QR Code được doanh nghiệp thể hiện phải có các thông tin:
            Dòng cảnh báo người thanh toán ”Quý khách vui lòng kiểm tra thông tin thanh tóan trước khi thực hiện giao dịch”.
            Số tiền cần phải thanh toán in Đậm và kích cỡ lớn.

## Request body

- QRPaymentRequest
  - `ownerNumber` string, required: Owner Number
  - `ownerType` 'PER' | 'ORG', required
  - `traceNumber` string, nullable: Unique identifier for the transaction
  - `merchantId` string, required: Merchant identifier
  - `terminalId` string, required: Terminal identifier
  - `userId` string, nullable: User identifier
  - `orderId` string, required: Order identifier
  - `virtualAccountPrefix` string, required: Virtual account prefix
  - `beneficiaryName` string, required: Name of the beneficiary
  - `amount` integer, required: Transaction amount (min: 0, max: 1,000,000,000)
  - `voucherCode` string, nullable: Voucher code
  - `loyaltyCode` string, nullable: Loyalty program code
  - `description` string, nullable: Transaction description
  - `additionalInfo` AdditionalInfo[], nullable: Additional information as key-value pairs
    - `key` string, required: Key for additional information
    - `value` string, required: Value for additional information
  - `payer_email` string, email, nullable: Tuỳ chọn. Gửi biên lai Đã nhận thanh toán khi giao dịch khớp QR.

## Response `200`

Kết quả tạo QR, có qr_image_url trỏ tới ảnh PNG public.

- object
  - `success` boolean, required
  - `message` string, required
  - `data` object, required
    - `qr_image_url` string, uri, required: Ảnh PNG public của QR.

## Other responses

- `400`: Bad Request - The server cannot or will not process the request due to a client error.
- `401`: Unauthorized - Authentication is required and has failed or has not been provided.
- `422`: Validation Error
- `500`: Internal Server Error - The server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.dev/monapay/apis/mona-pay-api-v1.md) · [All operations](https://skmtc.dev/monapay/apis/mona-pay-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/monapay/apis/mona-pay-api-v1/revisions/ed3fbd821dce?raw)