LinkAja

DOKU has partnered with various e-money providers and one of them is Link Aja to provide E-Money Payment. Learn more about how DOKU can help you integrate with Link Aja here.


Integration steps

Here is the overview of how to integrate with Link Aja:

  1. Generate request

  2. Complete payment in Link Aja App

  3. Acknowledge payment result


1. Generate Request

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

API Request

Here is the sample of request header to create an order:

Client-Id: OCO-0203-1676104296656
Request-Id: 24bb5232-3fe6-47a5-b0b0-d0fc3c6b5fdb
Request-Timestamp: 2023-06-08T08:50:00Z
Signature: HMACSHA256=vl9DBTX5KhEiXmnpOD0TSm8PYQknuHPdyHSTSc3W6Ps=

Request Header Explanation

Here is a sample of request body to create an order:

{
    "order": {
        "invoice_number": "INV-20210124-0001",
        "amount": 150000,
        "callback_url": "https://merchant.com/return-url",
        "line_items": [
             {
               "name":" Roti",
               "price": 10000,
               "quantity": 1
             } 
        ]
    },
    "additional_info": {

    },
    "customer": {
            "name": "Jessica Tessalonika",
            "email": "example@doku.com",
            "phone" : "081112345678"
    }
}

Request Body Explanation

API Response

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

Client-Id: MCH-0001-10791114622547
Request-Id: 24bb5232-3fe6-47a5-b0b0-d0fc3c6b5fdb
Response-Timestamp: 2021-07-09T02:05:14Z
Signature: HMACSHA256=9UPUFzOqJc47aJzD9ESOTcWg6TMsg3mqSP+DnUO8ENE=

Response Header Explanation

Here is the sample of response body:

{
"order": {
        "invoice_number": "LINKAJA23052595",
        "amount": "10000.00"
    },
    "emoney_configuration": {
        "identifier": [
            {
                "name": "TERMINAL_ID",
                "value": "e2etest"
            } 
        ]
    },
    "emoney_payment": {
        "redirect_method_http": "POST",
        "redirect_url_http": "https://api-uat.doku.com/doku/simulator/v1/linkaja/redirectPostToPost",
        "redirect_parameter": [
            {
                "name": "Message",
                "value": 
                "cXAwdzcvd3VEeDlRTzl0V1g1NGZyMmpQbFBPMDQxaHpyclNLazdlV09PTUZ1Z1lJaDlscjU1QmZNS2VPTTNiOGpFY3Mzbmp1dStqUjRWL3FaTGRsekVQWVF3YWRRUVQ2UzZsQkFRSzl2ek1zbERWQWtEY01EV0xpaTYrcnRYVUJmSkYvc0tXbGpRWXFCMHVMVHpKMXZTRSt2eTY5K2lOQ3k4aFdCTTBUc2ZGaTlYaWdQZ1JGZ2VjWTNaUlBNT0JCaTNnUzdhMitrNkRlY2hZMWh1R2xpQWtLMTlrLzIyWkxLWnNxQXZTU1VkdllqV0FmeGtqVTVzUjM3ZUIvSE9mag=="
            } 
        ],
        "status": "PENDING"
    }
}

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

3. Acknowledge payment result

DOKU will send HTTP Notification to your defined Notification URL. Learn how to handle the notification from DOKU:


Last updated