Create VA

POST

/v1.0/transfer-va/create-va

The VA number will be registered to Ayolinx and Acquirer will inquiry to our side when the customer make payment at the acquirer channel (ATM, mobile banking, internet banking, etc.).
3 Interact ways:
a. Ayolinx Generated VA: The VA number is generated by Ayolinx. Suitable for e-commerce business model.
b. Merchant Generated VA: The VA number is generated by Merchant. Suitable for top up business model.
c. Direct Inquiry: The VA number is registered on merchant side and Ayolinx will forward Acquirer inquiry request to merchant side when the customer make payment at the acquirer channel (ATM, mobile banking, internet banking, etc.).

Request

Header Params

Body Params application/json

Example

{
    "partnerServiceId": "98829172",
    "customerNo": "30000000000000000001",
    "virtualAccountNo": "4339382374532139",
    "virtualAccountName": "Customer Name",
    "trxId": "123321123321",
    "virtualAccountTrxType": "C",
    "totalAmount": {
        "value": "11500.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "channel": "VIRTUAL_ACCOUNT_BCA"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sandbox.ayolinx.id/v1.0/transfer-va/create-va' \
--header 'X-TIMESTAMP: 2024-09-12T12:55:00+07:00' \
--header 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \
--header 'X-PARTNER-ID: CKSandbox-100dc9aa-f8ee-4a00-a933-6f4e8963b666' \
--header 'X-EXTERNAL-ID: 418075533589' \
--header 'CHANNEL-ID: H2H' \
--header 'Authorization: Bearer d348e681b54e9a4e2368870bf9ae7d69' \
--header 'Content-Type:  application/json' \
--data-raw '{
    "partnerServiceId": "98829172",
    "customerNo": "30000000000000000001",
    "virtualAccountNo": "4339382374532139",
    "virtualAccountName": "Customer Name",
    "trxId": "123321123321",
    "virtualAccountTrxType": "C",
    "totalAmount": {
        "value": "11500.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "channel": "VIRTUAL_ACCOUNT_BCA"
    }
}'

Responses

🟢200OK

application/json

Body

Examples

SuccessException

{
    "responseCode": "2002700",
    "responseMessage": "",
    "virtualAccountData": {
        "partnerServiceId": "98829172",
        "customerNo": "30000000000000000001",
        "virtualAccountNo": "8473617259410240",
        "virtualAccountName": "Customer Name",
        "virtualAccountEmail": "",
        "virtualAccountPhone": "",
        "virtualAccountTrxType": "C",
        "trxId": "23219829714",
        "totalAmount": {
            "value": "11500.00",
            "currency": "IDR"
        },
        "billDetails": "",
        "freeTexts": "",
        "feeAmount": "",
        "additionalInfo": {
            "channel": "VIRTUAL_ACCOUNT_BCA"
        },
        "expiredDate": 1726371458
    }
}

Modified at 2025-10-31 06:02:09

Error Codes

Inquiry Va