Create VA

POST

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

虚拟账户号码将在 Ayolinx 注册，当客户在收单方渠道（自动取款机、手机银行、网上银行等）进行支付时，收单方会向我们这边查询。
3 种交互方式：
a. Ayolinx 生成的虚拟账户：虚拟账户号码由 Ayolinx 生成。适用于电子商务商业模式。
b. 商户生成的虚拟账户：虚拟账户号码由商户生成。适用于充值商业模式。
c. 直接查询：虚拟账户号码在商户端注册，当客户在收单方渠道（自动取款机、手机银行、网上银行等）进行支付时，Ayolinx 会将收单方的查询请求转发到商户端。

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: CK-11111abc-0000-2222-bbcc-dd55555ee666' \
--header 'X-EXTERNAL-ID: 418075533589' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_ 3EPXdbqb45N4ciQ' \
--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-06-20 09:34:46

Error Codes

Inquiry Va