Step 2 - Create VA (MGPC) - API Reference (NEW)

Merchant Generate Payment Code

Request

Header Params

X-TIMESTAMP

string

required

Client's current local time in yyyy-MM-dd'T'HH:mm:ssXXX format. Sample: 2024-03-19T14:39:01+07:00

Example:

2024-03-19T14:39:01+07:00

X-SIGNATURE

string

required

Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)

Example:

85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5

X-PARTNER-ID

string

required

Unique ID for a partner (DOKU'S Client ID)

Example:

BRN-0259-1678068334526

X-EXTERNAL-ID

string

required

Numeric String. Reference number that should be unique in the same day (request-id)

Example:

418075533589

CHANNEL-ID

string

required

Channel Id for VA. Please fill with H2H (Host-To-Host)

Example:

H2H

Authorization

string

required

Access Token obtained from Get B2B Token API | Go to here for detailed documentation

Example:

Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ

Body Params application/json

partnerServiceId

string

required

similar to company code/BIN,8 digit left padding space. | Mandatory | min length: 1 | max length: 8

Example:

19008

customerNo

string

required

Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 20

Example:

00000000000000000001

virtualAccountNo

string

required

partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 28

Example:

19008000000000000000000001

virtualAccountName

string

required

Customer Name | min length: 1 | max length: 255

Example:

Customer Name

virtualAccountEmail

string

optional

Customer Email | min length: 1 | max length: 255

Example:

customer.email@mail.com

virtualAccountPhone

string

optional

Customer Phone, Format: 62xxxxxxxxx xxxx | min length: 9 | max length: 30

Example:

0816291271826

trxId

string

required

Invoice number in Partner system. | Mandatory | min length: 1 | max length: 64

Example:

23219829713

totalAmount

object (TotalAmountRef)

required

value

string

optional

Transaction Amount. Total Amount with 2 decimal, format ISO 4217 | min length: 1 | max length: 16.2

Example:

11500.00

currency

string

optional

Currency | min length: 1 | max length: 3

Example:

IDR

additionalInfo

object (AdditionalInfoCreateVARequestRef)

required

channel

enum<string>

required

Channel that will be apply for this VA | Mandatory | min length: 1 | max length: 30

Allowed value:

VIRTUAL_ACCOUNT_BCA

virtualAccountTrxType

string

required

Transaction type for this transaction. C (Closed Amount), O (Open Amount), V (Bill Variable Amount) | Mandatory | min length: 1 | max length: 1

Example:

expiredDate

string

optional

Expiration date for Virtual Account. ISO-8601

Example:

2023-01-01T10:55:00+07:00

freeText

array [object {2}]

optional

Free text for additional description. | Optional | min length: 1 | max length: 64

english

string

optional

Example:

Free text

indonesia

string

optional

Example:

Tulisan Bebas

Example

{
    "partnerServiceId": "   19008",
    "customerNo": "00000000000000000001",
    "virtualAccountNo": "  19008000000000000000000001",
    "virtualAccountName": "Customer Name",
    "virtualAccountEmail": "customer.email@mail.com",
    "virtualAccountPhone": "0816291271826",
    "trxId": "23219829713",
    "totalAmount": {
        "value": "11500.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "channel": "VIRTUAL_ACCOUNT_BCA"
    },
    "virtualAccountTrxType": "C",
    "expiredDate": "2023-01-01T10:55:00+07:00",
    "freeText": [
        {
            "english": "Free text",
            "indonesia": "Tulisan Bebas"
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

item created

Body

responseCode

string

required

Response Code with format HTTP status code + service code + case code. service code and status code refer to: https://developers.doku.com/getting-started-with-doku-api/error-handling/http-status-and-case-code#id-1.-virtual-account . | Mandatory | min length: 1 | max length: 7.

Example:

2002700

responseMessage

string

required

Response Description. | min length: 1 | max length: 150

Example:

Successful

virtualAccountData

object

required

partnerServiceId

string

required

similar to company code/BIN,8 digit left padding space. | Mandatory | min length: 1 | max length: 8

Example:

19008

customerNo

string

required

Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 20

Example:

00000000000000000001

virtualAccountNo

string

required

partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 28

Example:

19008000000000000000000001

virtualAccountName

string

required

Customer Name | min length: 1 | max length: 255

Example:

Customer Name

virtualAccountEmail

string

optional

Customer Email | min length: 1 | max length: 255

Example:

customer.email@mail.com

virtualAccountPhone

string

optional

Customer Phone, Format: 62xxxxxxxxx xxxx | min length: 9 | max length: 30

Example:

081293912081

trxId

string

required

Transaction ID in Partner system. | Mandatory | min length: 1 | max length: 64

Example:

23219829713

totalAmount

object (TotalAmountRef)

required

virtualAccountTrxType

string

optional

Transaction type for this transaction. C (Closed Amount), O (Open Amount), V (Bill Variable Amount) | Mandatory | min length: 1 | max length: 1

Example:

expiredDate

string

required

Expired date this VA | Mandatory

Example:

2023-01-01T10:55:00+07:00

additionalInfo

object (AdditionalInfoCreateVAResponseRef)

optional

Example

{
    "responseCode": "2002700",
    "responseMessage": "Successful",
    "virtualAccountData": {
        "partnerServiceId": "   19008",
        "customerNo": "00000000000000000001",
        "virtualAccountNo": "  19008000000000000000000001",
        "virtualAccountName": "Customer Name",
        "virtualAccountEmail": "customer.email@mail.com",
        "virtualAccountPhone": "081293912081",
        "trxId": "23219829713",
        "totalAmount": {
            "value": "11500.00",
            "currency": "IDR"
        },
        "virtualAccountTrxType": "C",
        "expiredDate": "2023-01-01T10:55:00+07:00",
        "additionalInfo": {
            "channel": "VIRTUAL_ACCOUNT_BCA",
            "howToPayPage": "https://app.doku.com/how-to-pay/virtual-account/bca/19008000000000000000000001/2226240319101120691107165798734001192511",
            "howToPayApi": "https://api.doku.com/pay-instruction/bca/19008000000000000000000001/2226240319101120691107165798734001192511"
        }
    }
}

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

🟠409409

🔴500Server Error

🔴504Gateway Timeout