Step 3 - Create VA (DGPC)

POST

/bi-snap-va/maybank/v1/transfer-va/create-va

List of virtualAccountTrxType:

1 = C = Closed Payment

2 = O = Open Payment

3 = I = Partial

4 = M = Minimum - Only can be paid once with minimum amount

5 = L = Maximum

6 = N = Open Minimum - Can be paid multiple with minimum amount

7 = X = Open Maximum - Can be paid multiple with cumulative maximum amount

8 = V = Bill Variable

9 = W = Multi Bill Variable

Request

Header Params

X-PARTNER-ID

string

required

Example:

X-EXTERNAL-ID

string

required

Example:

X-TIMESTAMP

string

required

Example:

X-SIGNATURE

string

required

Example:

Authorization

string

required

Example:

Bearer {{snap_access_token_merchant}}

CHANNEL-ID

string

required

http://confluence.doku.com/display/GAT/SNAP+CHANNEL-ID+List

Example:

VA009

Body Params application/json

partnerServiceId

string

required

trxId

string

required

virtualAccountTrxType

string

required

totalAmount

object

required

value

string

required

currency

string

required

expiredDate

string

required

virtualAccountName

string

required

virtualAccountEmail

string

required

virtualAccountPhone

string

required

billDetails

array [object {8}]

required

billCode

string

optional

billNo

string

optional

billName

string

optional

billShortName

string

optional

billDescription

object

optional

billSubCompany

string

optional

billAmount

object

optional

additionalInfo

object

optional

freeTexts

array [object {2}]

required

english

string

optional

indonesia

string

optional

additionalInfo

object

required

virtualAccountConfig

object

required

deviceId

string

required

channel

string

required

Example

{
    "partnerServiceId": "{{partner_service_id}}",
    "trxId": "{{invoice_number}}",
    "virtualAccountTrxType": "1",
    "totalAmount": {
        "value": "12500.00",
        "currency": "IDR"
    },
    "expiredDate": "{{expired_date}}",
    "virtualAccountName": "Testing VA",
    "virtualAccountEmail": "testing@doku.com",
    "virtualAccountPhone": "6281200001111",
    "billDetails": [
        {
            "billCode": "01",
            "billNo": "123456789012345678",
            "billName": "Bill A for Jan",
            "billShortName": "Bill A",
            "billDescription": {
                "english": "Maintenance",
                "indonesia": "Pemeliharaan"
            },
            "billSubCompany": "00001",
            "billAmount": {
                "value": "20000.00",
                "currency": "IDR"
            },
            "additionalInfo": {}
        }
    ],
    "freeTexts": [
        {
            "english": "Free text",
            "indonesia": "Tulisan bebas"
        }
    ],
    "additionalInfo": {
        "virtualAccountConfig": {
            "reusableStatus": true
        },
        "deviceId": "12345679237",
        "channel": "mobilephone"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/bi-snap-va/maybank/v1/transfer-va/create-va' \
--header 'X-PARTNER-ID: {{x_client_key}}' \
--header 'X-EXTERNAL-ID: {{x_external_id}}' \
--header 'X-TIMESTAMP: {{x_timestamp}}' \
--header 'X-SIGNATURE: {{x_signature}}' \
--header 'Authorization: Bearer {{snap_access_token_merchant}}' \
--header 'CHANNEL-ID: VA009' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partnerServiceId": "{{partner_service_id}}",
    "trxId": "{{invoice_number}}",
    "virtualAccountTrxType": "1",
    "totalAmount": {
        "value": "12500.00",
        "currency": "IDR"
    },
    "expiredDate": "{{expired_date}}",
    "virtualAccountName": "Testing VA",
    "virtualAccountEmail": "testing@doku.com",
    "virtualAccountPhone": "6281200001111",
    "billDetails": [
        {
            "billCode": "01",
            "billNo": "123456789012345678",
            "billName": "Bill A for Jan",
            "billShortName": "Bill A",
            "billDescription": {
                "english": "Maintenance",
                "indonesia": "Pemeliharaan"
            },
            "billSubCompany": "00001",
            "billAmount": {
                "value": "20000.00",
                "currency": "IDR"
            },
            "additionalInfo": {}
        }
    ],
    "freeTexts": [
        {
            "english": "Free text",
            "indonesia": "Tulisan bebas"
        }
    ],
    "additionalInfo": {
        "virtualAccountConfig": {
            "reusableStatus": true
        },
        "deviceId": "12345679237",
        "channel": "mobilephone"
    }
}'

Responses

🟢200Success

application/json

Body

object {0}

Example

{}

Modified at 2025-07-10 04:19:31

Step 2 - Get Token

Step 1 - Init KJUR