---
title: "Đăng ký tài khoản VA"
method: POST
path: "/api/v1/acb/virtual-account/registration"
tags: ["ACB VA Banking"]
---

# Đăng ký tài khoản VA

`POST /api/v1/acb/virtual-account/registration`

## Request

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

Đối tác gọi API này của ACB để gửi yêu cầu đăng ký tài khoản VA.
            ACB sẽ nhận và kiểm tra thông tin đầu vào.
            Yêu cầu:
            Phải truyền đầy đủ các thông tin bắt buộc.
            Mã đăng ký dịch vụ phải trùng khớp với thông tin đăng ký trong hệ thống và còn đang hoạt động

## Request body

- VirtualAccountRegistrationRequest
  - `bank_account_id` string, uuid, nullable: ID bank_account có sẵn (ưu tiên dùng khi chọn từ danh sách)
  - `customer_type` string, nullable: Loại khách hàng (ví dụ: PERS)
  - `account_number` integer, nullable: Số tài khoản thanh toán chính
  - `phone_number` string, nullable: Số điện thoại khách hàng
  - `virtual_account_info` VirtualAccountInfo, required
    - `virtual_account_prefix_code` string, required: Đầu số tài khoản định danh
    - `virtual_account_content` string, nullable: Nội dung tài khoản định danh
    - `virtual_account_explain` string, nullable: Nội dung diễn giải khi đăng ký
    - `beneficiary_name_rule` integer, nullable: Loại hiển thị tên đơn vị hưởng
  - `user_agreement` boolean, nullable: Sự đồng ý của KH khi đăng ký dịch vụ

## Response `200`

OK - The request has succeeded.

- Response
  - `success` boolean, required
  - `message` string, required
  - `data` unknown

## 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)