CIMB Direct Debit
CIMB direct debit offers tokenization scheme that requires customer to input OTP and/or PIN to verify every payment.
Integration Steps
Overview of integration process with CIMB Direct Debit.
1. Account Binding
Account Binding process should be done before payment can be made and processed. Merchant will send account binding request from customer to DOKU. The request includes customer's phone number that is registered to customer's CIMB account.
Each CIMB account can only be bind to one customer on one merchant. Customer needs to do verification for account binding process by inputting OTP and PIN.
Account Binding Flow
API Endpoint
Environment | Endpoint |
---|---|
HTTP Method | POST |
API Sandbox | |
API Production | |
Path |
|
Sample of Request Header, Request Body and Response Body
Notes:
Parameter with (*) is mandatory
Paramater without (*) is optional/conditional
2. Payment
After customer's account is bind/linked and customer has enough balance for payment, merchant can send payment request from customer to DOKU by bringing customer's token.
Payment Flow
API Endpoint
Environment | Endpoint |
---|---|
HTTP Method | POST |
API Sandbox | |
API Production | |
Path |
|
Sample of Request Header, Request Body and Response Body
Notes:
Parameter with (*) is mandatory
Paramater without (*) is optional/conditional
3. OTP Verification
Once customer has submitted their payment request along with the OTP, merchant needs to verify the payment. Merchant can hit this API to verify the OTP.
OTP Verification Flow
API Endpoint
Environment | Endpoint |
---|---|
HTTP Method | POST |
API Sandbox | |
API Production | |
Path |
|
Sample of Request Header, Request Body and Response Body
Notes:
Parameter with (*) is mandatory
Paramater without (*) is optional/conditional
4. Payment Notification
After payment is completed, DOKU will send HTTP Notification to merchant's defined Notification URL
. Learn how to handle the notification from DOKU.
5. Additional Feature
Online Refund
This endpoint is used to create refund request for previous successful payment. Merchant can request a transaction refund to DOKU. Full refund and partial refund are available to be requested.
Online Refund Flow
API Endpoint
Environment | Endpoint |
---|---|
HTTP Method | POST |
API Sandbox | |
API Production | |
Path |
|
Sample of Request Header, Request Body and Response Body
Notes:
Parameter with (*) is mandatory
Paramater without (*) is optional/conditional
Account Unbinding
If a registered customer no longer wants their account/card to be bind/linked and wish to remove themself from DOKU's and merchant’s system, merchant can send account unbinding request that is initiated by customer.
API Endpoint
Environment | Endpoint |
---|---|
HTTP Method | POST |
API Sandbox | |
API Production | |
Path |
|
Sample of Request Header, Request Body and Response Body
Notes:
Parameter with (*) is mandatory
Paramater without (*) is optional/conditional
Last updated