API Documentation
NeoX documents
NeoX documents
  • Introduction
  • NeoX App
    • E-Wallet
    • eKYC
    • Functionality
  • Payment Gateway
    • Payment Methods
    • Integrations
      • Hosted Checkout
        • Plugin/Extenstion
        • iOS SDK
        • Android SDK
        • React Native SDK
        • Web SDK
        • APIs
      • Direct API
        • Tokenization
      • Refund
        • APIs
        • IPN
    • Transaction Management
      • Query DR
      • Cancel
      • IPN
      • Error Codes
      • Refund on portal
    • Reconciliation
    • Settlement
  • Disbursement
    • Integration
      • Introduction
      • How To Register
      • Security Method
      • Generate token API
      • Get merchant profile API
      • Request disbursement API
      • Get disbursement transaction API
      • Get exchange rate API
      • Inquiry bank account API
      • Currency conversion API
      • Event Notification
      • Response Data Structure
      • Error codes
    • Disbursement Account
    • Disbursement request
    • Transaction Management
      • Query Request/Transaction
      • Webhook
      • Error Codes
    • Reconciliation
  • Collections
    • Integration
      • Introduction
      • How To Register
      • Security Method
      • API authenPlatform
      • API upload file
      • APIs for virtual accounts management
        • API create list of virtual accounts
        • API update KYC virtual account information
        • API update Virtual Account transaction data from merchant
        • API set active/inactive Virtual Account
        • API get list virtual accounts
        • API get detail virtual account
      • APIs for transactions management
        • API update transaction documents
        • API get list transactions
        • API get detail transaction
      • APIs for refund requests management
        • API create refund request
        • API get list refund requests
        • API get detail refund request
      • APIs for withdraw requests management
        • API get list withdraw banks
        • API create withdraw request
        • API get list withdraw requests
        • API get detail withdraw request
      • Event Notification
      • SFTP upload document file of collection transaction
      • Error Codes
    • Virtual Account Management
      • Virtual Account
      • Virtual Account Status
      • Webhook
    • Transaction Management
      • Webhook
    • Transaction Status Management
      • Webhook
    • Refund Request Management
      • Webhook
    • Withdraw Request Management
      • Webhook
    • Reconciliation
    • Settlement
  • Merchant Portal
    • Onboarding
    • Payment Gateway
      • Reconciliation
      • Withdraw
    • Disbursement
      • Reports
    • Collections
      • Reports
      • Withdraw
Powered by GitBook
On this page
  • Sequence Diagram:
  • Request Parameter
  • Response Data

Was this helpful?

  1. Collections
  2. Integration
  3. APIs for virtual accounts management

API create list of virtual accounts

PreviousAPIs for virtual accounts managementNextAPI update KYC virtual account information

Last updated 28 days ago

Was this helpful?

  • This is the API used to create a list of virtual accounts in the collection service.

Sequence Diagram:

  • API:

    • Path: v2/col/requests

    • Method: POST

    • Request: Content-Type: application/json

Request Parameter

Parameter
Data Type
Required
Description

requestId

String

Y

The ID of the request.

(UUID is generated by merchant)

virtualAccounts

Array

Y

The array contains the list of virtual accounts.

VirtualAccounts

Parameter
Data Type
Required
Description

accountName

String

Y

Bank account name Validate [A-Z0-9]{5,200}

virtualAccountRequestId

String

Y

The ID of seller/business is provided by merchant. This value is unique.

accountAddress

String

Y

The address of account.

(includes the district, province)

frontIdCard

String

N

The file name of photo of the front of the ID card

backIdCard

String

N

The file name of photo of the back of the ID card

profileImg

String

N

The file name of portrait

businessRegistration

String

N

The file name of the business license.

serviceInformation

Object

N

ServiceInformation

Parameter
Data Type
Required
Description

code

String(20) (alphanumeric)

N

Service code which is defined by the merchants. This code will be used to filter the VAs and grouped Reconciliations on Merchant Portal

groupId

String(20) (alphanumeric)

N

Id of VA group which is defined by the merchants. This id will be used to filter the VAs on Merchant Portal

desc

String(255)

N

Description of VA

Response Data

Parameter
Data Type
Description

code

Number

data

Object

message

String

Error description.

data object

Parameter
Data Type
Description

requestId

String

The requestId in the request body.

merchantId

String

The ID of the merchant

status

String

The status of virtual account creation request. PASSED: Waiting for approval FAILED: Failed request

message

String

Error message detail.

Refer to

Extra data about VA for classification purpose. Refer:

Error code, refer to .

Ref to object.

table of error codes
VirtualAccounts
ServiceInformation
data