Payment-method icon

API only integration

Learn how to add Indonesian payment methods to an existing API-only integration for mobile and web banking.

On this page, you can find information for accepting DOKU payment methods using our APIs, and build your own payment form to have full control over the look and feel of your checkout page.

Through our partner DOKU, we offer various bank transfer payment methods and convenience store payment methods in Indonesia.

Before you begin

Before starting your integration:

  1. Make sure that you have set up your back end implementation.
  2. Add the payment method in your test Customer Area.

Build your payment form

To make a payment, you need to collect the following shopper details:

Name Description
firstName Shopper's first name.
lastName Shopper's last name.
shopperEmail Shopper's email address.

We provide logos for the different payment method types which you can use in your payment form. For more information, refer to Downloading logos.

You can also get the required fields from the /paymentMethods response as explained in our API-only integration guide.

In your /paymentMethods request, specify the following combination of countryCode and amount.currency:

Country countryCode amount.currency
Indonesia ID IDR

The required fields for different Doku payments are included in the object with the type that you want to integrate with.

name type Kind of payment method
Alfamart doku_alfamart Convenience store
Bank Transfer (Permata) doku_permata_lite_atm Bank transfer
BCA Bank Transfer doku_bca_va (only available with a local entity) Bank transfer
BNI VA doku_bni_va Bank transfer
BRI VA doku_bri_va (only available with a local entity) Bank transfer
CIMB VA doku_cimb_va Bank transfer
Danamon VA doku_danamon_va Bank transfer
Indomaret doku_indomaret Convenience store
Mandiri VA doku_mandiri_va Bank transfer

Make a payment

From your server, make a /payments request, specifying:

  • paymentMethod.type: The type of payment method, for example, doku_alfamart.
  • paymentMethod.firstName: The shopper's first name.
  • paymentMethod.lastName: The shopper's last name.
  • paymentMethod.shopperEmail: The shopper's email address.
  • amount.value: The amount of the transaction, in minor units without decimals. For example, submit a value of 10000 IDR as 10000.

The /payments response contains:

  • resultCode: PresentToShopper
  • action: Object containing information about the voucher.

Present the payment result

Because the voucher is an offline payment method, there is no need to handle the redirect back from the acquirer. We send you a webhook informing you about the payment status.

The eventCode values you receive with your notification are:

eventCode success field Description Action to take resultCode
PENDING true The voucher reference is successfully created and the transaction is pending. Present the shopper with the voucher and wait for the payment. PresentToShopper
AUTHORISATION false The voucher reference is not successfully generated and the transaction failed. Cancel the order and inform the shopper that the payment failed. Error
AUTHORISATION true The shopper successfully completed the payment. Inform the shopper that the payment has been successful and proceed with the order. PresentToShopper
OFFER_CLOSED true The shopper did not complete the payment before the voucher expired. Cancel the order and inform the shopper that the payment timed out. PresentToShopper

Customization

You can customize the expiry date of the virtual bank account (for bank transfers) or the voucher (for convenience store payments). By default, the validity period is 48 hours. To change the validity period, contact the Support Team.

Test and go live

Use our test vouchers and card numbers to simulate the payments.

Check the status of the test payments in your Customer Area, under Transactions > Payments.

Before you can accept live payments, you need to submit a request for one or more Indonesian DOKU online banking or convenience store payment methods in your live Customer Area.

See also