Step 2 - Balance Inquiry - API Reference (NEW)

Request

Header Params

X-TIMESTAMP

string <utc timestamp>

required

Client's current local time in yyyy-MM- ddTHH:mm:ssTZD format

Example:

2020-12-21T07:56:11.000Z

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

X-IP-ADDRESS

string

required

IP Address Customer | min: 10 max: 15 | Mandatory

Example:

192.168.1.1

Authorization-customer

string

required

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

Example:

Bearer fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a

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

additionalInfo

object

required

channel

string

required

Value should be always EMONEY_OVO_SNAP | Mandatory

Example:

EMONEY_OVO_SNAP

Example

{
    "additionalInfo": {
        "channel": "EMONEY_OVO_SNAP"
    }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/direct-debit/core/v1/balance-inquiry' \
--header 'X-TIMESTAMP;' \
--header 'X-SIGNATURE;' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID;' \
--header 'X-IP-ADDRESS;' \
--header 'Authorization-customer;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "additionalInfo": {
        "channel": "EMONEY_OVO_SNAP"
    }
}'

Responses

🟢200OK

application/json

Successful

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/response-code/http-status-and-case-code#id-3.-e-wallet . | Mandatory | min length: 1 | max length: 7.

Example:

2001100

responseMessage

string

required

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

Example:

Successfull

accountInfos

array [object {4}]

required

balanceType

string

optional

Balance type format: CASH / POINTS

Example:

CASH

amount

object (AmountObject)

optional

flatAmount

object (AmountObject)

optional

holdAmount

object (AmountObject)

optional

Example

{
    "responseCode": 2001100,
    "responseMessage": "Successfull",
    "accountInfos": [
        {
            "balanceType": "CASH",
            "amount": {
                "value": "10000.00",
                "currency": "IDR"
            },
            "flatAmount": {
                "value": "10000.00",
                "currency": "IDR"
            },
            "holdAmount": {
                "value": "10000.00",
                "currency": "IDR"
            }
        }
    ]
}