Create VA

API Create VA.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request body for Create VA API

additionalInfo
object
required

Additional metadata or remarks for merchant-specific information (e.g., bill name, item name, reference tags, customer info). Supports up to 3 additional fields i.e. additionalInfo1, additionalInfo2, additionalInfo3.

string
required
6 to 20

Unique identifier of the merchant's customer. Used to link the VA or transaction to a specific end user.

string
required
32 to 32

Unique transaction ID generated by the merchant. Used for tracing and reconciliation.

string
required
1 to 100

Customer's name displayed on ATM or mobile banking screens during payment.

string
11 to 18

Unique Virtual Account number (11–18 numeric digits). If this field is left empty in the VA creation request, Ayoconnect will automatically generate a random number. Each Virtual Account can have only one active session before expiry, even if the merchant requests the same number again, it cannot be reused until the existing one has expired or been paid.

Bank-specific length constraints:

  • Mandiri: Min 11, Max 14
  • BCA: Min 11, Max 18
  • BNI: Fixed 12
  • BRI: Min 11, Max 13
string
10 to 15

Customer's phone number used to refer to customer and record purposes. It should start with the Indonesian country code '62' and be followed by at least 10 and at most 15 numeric characters.

totalAmount
object
required
string
25 to 25

Expiry date and time of the Virtual Account following ISO 8601 format. Once expired, the VA cannot accept further payments until it is re-created or updated to reactivate.

Headers
string
required
length between 25 and 25

Client's current local time in 'yyyy-MM-ddTHH:mm:ssTZD' format

string
required

Request body signature

string
required
length between 6 and 6

Merchant identifier consisting of 6 alphanumeric characters. It is used to uniquely identify the merchant or partner in all API requests and responses. The value is assigned by Ayoconnect after successful onboarding and registration.

string
required
length between 32 and 32

Unique identifier provided by the merchant for each API request. It is used for idempotency, tracking, and to populate the referenceNo and originalReferenceNo fields in responses. The value must be unique per request attempt and contain 32 alphanumeric characters.

string
required

Channel ID

string
required

Bearer token

Responses

Callback
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json