Additional - Payment Notification

Payment Notification

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:

821508239190

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

trxId

string

required

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

Example:

23219829713

paymentRequestId

string

optional

Unique identifier generated by PJP. If Payment comes from the Inquiry process, this value must be the same with inquiryRequestId. | Mandatory | min length: 1 | max length: 30

Example:

12839218738127830

paidAmount

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

virtualAccountPhone

string

optional

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

Example:

081293912081

additionalInfo

object (AdditionalInfoRequestRef)

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

virtualAccountConfig

object

optional

trxDateTime

string

optional

DOKU's transaction date time

Example:

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

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:

Example

{
    "partnerServiceId": "   19008",
    "customerNo": "00000000000000000001",
    "virtualAccountNo": "  19008000000000000000000001",
    "virtualAccountName": "Customer Name",
    "virtualAccountEmail": "customer.email@mail.com",
    "trxId": "23219829713",
    "paymentRequestId": "12839218738127830",
    "paidAmount": {
        "value": "11500.00",
        "currency": "IDR"
    },
    "virtualAccountPhone": "081293912081",
    "additionalInfo": {
        "channel": "VIRTUAL_ACCOUNT_BCA",
        "virtualAccountConfig": {
            "minAmount": "10000.00",
            "maxAmount": "5000000.00"
        }
    },
    "trxDateTime": "2023-01-01T10:55:00+07:00",
    "virtualAccountTrxType": "C"
}

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:

2002500

responseMessage

string

required

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

Example:

Success

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

paymentRequestId

string

required

Unique identifier generated by PJP. If Payment comes from the Inquiry process, this value must be the same with inquiryRequestId. | Mandatory | min length: 1 | max length: 30

Example:

12839218738127830

paidAmount

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:

additionalInfo

object (AdditionalInfoRequestRef)

optional

channel

enum<string>

required

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

Allowed value:

VIRTUAL_ACCOUNT_BCA

virtualAccountConfig

object

optional

Example

{
    "responseCode": "2002500",
    "responseMessage": "Success",
    "virtualAccountData": {
        "partnerServiceId": "   19008",
        "customerNo": "00000000000000000001",
        "virtualAccountNo": "  19008000000000000000000001",
        "virtualAccountName": "Customer Name",
        "virtualAccountEmail": "customer.email@mail.com",
        "paymentRequestId": "12839218738127830",
        "paidAmount": {
            "value": "11500.00",
            "currency": "IDR"
        },
        "virtualAccountTrxType": "C"
    },
    "additionalInfo": {
        "channel": "VIRTUAL_ACCOUNT_BCA",
        "virtualAccountConfig": {
            "minAmount": "10000.00",
            "maxAmount": "5000000.00"
        }
    }
}

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

🟠409409

🔴500Server Error

🔴504Gateway Timeout