Step 1 - Account Binding - 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-DEVICE-ID

string

required

Hashed value device id customer | max: 64 | Mandatory

Example:

912f12e223624d2e94828b168199aa

X-IP-ADDRESS

string

required

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

Example:

192.168.1.1

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

phoneNo

string

required

Phone Number Customer | Format: 628238748728423 | min length: 9 max length: 16 | Mandatory

Example:

628238748728423

additionalInfo

object (AdditionalInfo)

required

channel

string

required

Value should be always EMONEY_OVO_SNAP | Mandatory

Example:

EMONEY_OVO_SNAP

custIdMerchant

string

required

Customer id from merchant | max length: 64

Example:

cust-001

customerName

string

optional

Customer name from merchant | max length: 70

Example:

John Doe

email

string

optional

Customer email from merchant | max length: 64

Example:

john.doe@doku.com

idCard

string

optional

Customer id card from merchant | max length: 20

Example:

12345

country

string

optional

Customer country | max length: 60

Example:

Indonesia

address

string

optional

Customer Address | max length: 255

Example:

Bali

dateOfBirth

string

optional

Customer Date of Birth | format: YYYYMMDD

Example:

19990101

successRegistrationUrl

string

required

Redirect URL when binding is success

Example:

https://merchant.doku.com/success

failedRegistrationUrl

string

required

Redirect URL when binding is fail

Example:

https://www.merchant.com/failed

merchantId

string

required

merchant id from DOKU

Example:

BRN-0001-013988108011

Example

{
    "phoneNo": "628238748728423",
    "additionalInfo": {
        "channel": "EMONEY_OVO_SNAP",
        "custIdMerchant": "cust-001",
        "customerName": "John Doe",
        "email": "john.doe@doku.com",
        "idCard": "12345",
        "country": "Indonesia",
        "address": "Bali",
        "dateOfBirth": "19990101",
        "successRegistrationUrl": "https://merchant.doku.com/success",
        "failedRegistrationUrl": "https://www.merchant.com/failed",
        "merchantId": "BRN-0001-013988108011"
    }
}

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/registration-account-binding' \
--header 'X-TIMESTAMP;' \
--header 'X-SIGNATURE;' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID;' \
--header 'X-DEVICE-ID;' \
--header 'X-IP-ADDRESS;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phoneNo": "628238748728423",
    "additionalInfo": {
        "channel": "EMONEY_OVO_SNAP",
        "custIdMerchant": "cust-001",
        "customerName": "John Doe",
        "email": "john.doe@doku.com",
        "idCard": "12345",
        "country": "Indonesia",
        "address": "Bali",
        "dateOfBirth": "19990101",
        "successRegistrationUrl": "https://merchant.doku.com/success",
        "failedRegistrationUrl": "https://www.merchant.com/failed",
        "merchantId": "BRN-0001-013988108011"
    }
}'

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:

2000700

responseMessage

string

required

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

Example:

Successfull

referenceNo

string

optional

Reference Number

Example:

129260743966

redirectUrl

string

required

Redirect URL to Merchant's page/platform for customer to input OTP/PIN

Example:

https://doku.com/direct-debit/ui/binding/2238230713001534401107183161486001168389

additionalInfo

object

required

custIdMerchant

string

required

Customer id from merchant | max length: 64

Example:

12345679504

status

string

required

Current binding status | value always be PENDING

Example:

PENDING

authCode

string

required

Authentication Code from OVO

Example:

2.23823090518282e+39

Example

{
    "responseCode": "2000700",
    "responseMessage": "Successfull",
    "referenceNo": "129260743966",
    "redirectUrl": "https://doku.com/direct-debit/ui/binding/2238230713001534401107183161486001168389",
    "additionalInfo": {
        "custIdMerchant": 12345679504,
        "status": "PENDING",
        "authCode": 2.23823090518282e+39
    }
}