Indodana

Last updated 1 month ago

DOKU API

DOKU has partenered with various Paylater Providers and one of them is Indodana to provide Buy Now Pay Later. Learn more about how DOKU can help you integrate with Indodana here.

Integration steps

Here is the overview of how to integrate with Indodana:

Obtain payment.url by generating order
Display Indodana payment page to customer
Acknowledge payment result

1. Obtain `payment.url` by generating order

To generate order, you will need to hit this API through your Backend:

API Request

Here is the sample of request header to generate order:

Client-Id: MCH-0001-10791114622547
Request-Id: baec7d95-f30a-4b78-b711-6ebe0ccdf50b
Request-Timestamp: 2021-07-07T08:45:42Z
Signature: HMACSHA256=vl9DBTX5KhEiXmnpOD0TSm8PYQknuHPdyHSTSc3W6Ps=

Request Header Explanation

Here is the sample request body to generate order:

{
    "order": {
        "invoice_number": "MINV20201231468",
        "line_items": [
             {
               "name":"Ayam",
               "price":50000,
               "quantity":2,
               "id":"1002",
               "category":"ELECTRONIC",
               "url":"https://merchant.com/product_1002",
               "image_url":"https://merchant.com/product_1002/image",
               "type":"handphone"
             }
          ],
        "amount": 100000,
        "callback_url":"https://merchant.com/return-url",
        "callback_url_cancel":"https://merchant.com/cancel-url"
    },
    "peer_to_peer_info": {
        "expired_time":60,
        "merchant_unique_reference": "60123"
    },
    "customer": {
        "first_name":"andreas",
        "last_name":"dharmawan",
        "phone":"081939815480",
        "email":"andreas@email.com"
    },
    "billing_address": {
        "first_name":"andreas",
        "last_name":"dharmawan",
        "address":"Jalan Teknologi Indonesia No. 25",
        "city":"Jakarta",
        "postal_code":"12960",
        "phone":"081513114262",
        "country_code":"IDN"
    },
    "shipping_address": {
        "first_name":"andreas",
        "last_name":"dharmawan",
        "address":"Jalan Teknologi Indonesia No. 25",
        "city":"Jakarta",
        "postal_code":"12960",
        "phone":"081513114262",
        "country_code":"IDN"
    },
    "additional_info": {
        "override_notification_url": "https://another.example.com/payments/notifications"
    }
}

Request Body Explanation

API Response

After hitting the above API request, DOKU will give the response.

Client-Id: MCH-0001-10791114622547
Request-Id: baec7d95-f30a-4b78-b711-6ebe0ccdf50b
Response-Timestamp: 2021-07-07T08:45:42Z
Signature: HMACSHA256=9UPUFzOqJc47aJzD9ESOTcWg6TMsg3mqSP+DnUO8ENE=

Response Header Explanation

Here is the sample of response body:

{
    "order": {
        "amount": 200000,
        "invoice_number": "INVQ01W"
    },
    "payment": {
        "status": "PENDING",
        "url": "https://sandbox01.indodana.com/product-installment/payment?purchaseTransactionId=<generated-purchase-transaction-id>&tenure=3"
    },
    "peer_to_peer_info": {
        "identifier": [
            {
                "name": "INDODANA_ORDER_ID",
                "value": "<MERCHANT-ORDER-ID>"
            }
        ],
        "created_date": "20220217222048",
        "expired_date": "20220217232048",
        "created_date_utc": "2022-02-17T15:20:48Z",
        "expired_date_utc": "2022-02-17T16:20:48Z",
        "merchant_unique_reference": "MURQ01W"
    },
    "additional_info": {
        "override_notification_url": "https://another.example.com/payments/notifications"
    }
}

Response Body Explanation

2. Display Indodana payment page to customer

Once you have the payment.url, you can now display the payment page by redirecting your customer to the Indodana payment page.

After the customer completed the payment, they will be redirected to the defined order.callback_url that you set on the API request.

3. Acknowledge payment result

After the payment is being made by your customer, DOKU will send HTTP Notification to your defined Notification URL. Learn how to handle the notification from DOKU:

Handling DOKU HTTP Notification

Additional features

We provide various additional features to suited your needs. Learn more here.

Split Settlement

If you are a platform or a marketplace, you can use this feature to settle the funds to your sellers or partners programmatically, save many operational efforts.

Settlement