Kirim DOKU

Kirim DOKU is a service designed to facilitate seamless domestic fund transfers. With Kirim DOKU, users can send money directly to recipients' bank accounts within the country without the need to visit a physical bank.

How Kirim DOKU works ?

Kirim DOKU

1. Account Inquiry

Before initiating a fund transfer, it is crucial to verify the validity of both the sender's and the recipient's bank accounts. Ensuring account accuracy helps prevent transaction errors and supports a seamless transfer process.

Completing an Account Inquiry is mandatory before proceeding with a bank transfer.

1. Balance Inquiry

Perform a Balance Inquiry to confirm that sufficient funds are available in the sender's account to complete the transaction. This step minimizes the risk of failed transactions due to insufficient balance.

1. Transfer Bank

This process involves transferring funds from the sender's account to the recipient's account. Ensure all required details, including the recipient's bank account information and the transfer amount, are accurately provided.

1. Check Status

Track the status of your transfer to confirm its completion. This feature allows real-time monitoring and provides transparency for both the sender and recipient.

Integration Guide

1. Account Inquiry

post

/v1.0/emoney/bank-account-inquiry

Header parameters

X-EXTERNAL-IDstringrequired

Numeric String. Reference number that should be unique in the same day (Request Id)

Example: 41807553358950093184162180797837

X-PARTNER-IDstringrequired

Client Id for merchant that generated by DOKU

Example: 82150823919040624621823174737537

X-SIGNATUREstringrequired

Symmetric Signature with Get Token (Default)HMAC_SHA512 (clientSecret, stringToSign) dengan formula stringToSign = HTTPMethod +”:“+ EndpointUrl +":"+ AccessToken +":“+ Lowercase(HexEncode(SHA-256(minify(RequestBody))))+ ":“ + TimeStamp

Example: ieNOENDdN4MnectGytx5UvmOfASZ2oGWMCJ8gVqkw3tB98ofgY9cbxSeY4IYoYeoKs+0QP4h8BTBhemlfeXp1w==

X-TIMESTAMPstringrequired

Client's current local time with format YYYY-MM-DDTHH:mm:ssZD

Example: 2020-12-21T14:56:11+07:00

Body

partnerReferenceNostringrequired

Transaction identifier on service consumer system, generated by KD partner

Example: hsjkans284b2he54

customerNumberstringrequired

Customer account number in phone number format

Example: 628115678890

amountobjectrequired

beneficiaryAccountNumberstring · max: 32required

Destination account number

Example: 8377388292

additionalInfoobject

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-sandbox.doku.com/v1.0/emoney/bank-account-inquiry' \
  --header 'X-EXTERNAL-ID: text' \
  --header 'X-PARTNER-ID: text' \
  --header 'X-SIGNATURE: text' \
  --header 'X-TIMESTAMP: text' \
  --header 'Content-Type: application/json' \
  --data '{"partnerReferenceNo":"hsjkans284b2he54","customerNumber":"628115678890","amount":{"value":"200000.00","currency":"IDR"},"beneficiaryAccountNumber":"8377388292","additionalInfo":{"channelCode":"07","beneficiaryBankCode":"014","beneficiaryAccountName":"FHILEA HERMANUS","senderCountryCode":"ID"}}'

200

400

200

{
  "responseCode": 2004200,
  "responseMessage": "Successful",
  "referenceNo": "I0438729855304540",
  "partnerReferenceNo": "hsjkans284b2he54",
  "beneficiaryAccountNumber": "8377388292",
  "beneficiaryAccountName": "SUHUT",
  "beneficiaryBankCode": "014",
  "beneficiaryBankShortName": "Bank Central Asia BCA",
  "beneficiaryBankName": "Bank Central Asia BCA",
  "amount": {
    "value": "200000.00",
    "currency": "IDR"
  },
  "sessionId": "I0438729855304540",
  "additionalInfo": {
    "senderCountryCode": "ID",
    "forexRate": "1.00",
    "forexOriginCurrency": "IDR",
    "feeAmount": "4500.00",
    "feeCurrency": "IDR",
    "beneficiaryAmount": "200000.00",
    "referenceNumber": "c5fe5465-0843-4ac7-9c93-57cb2c5ef6b2"
  }
}

Transfer bank processed

---

2. Balance Inquiry

post

/v1.0/balance-inquiry

Header parameters

X-EXTERNAL-IDstringrequired

Numeric String. Reference number that should be unique in the same day (Request Id)

Example: 41807553358950093184162180797837

X-PARTNER-IDstringrequired

Client Id for merchant that generated by DOKU

Example: 82150823919040624621823174737537

X-SIGNATUREstringrequired

Symmetric Signature with Get Token (Default)HMAC_SHA512 (clientSecret, stringToSign) dengan formula stringToSign = HTTPMethod +”:“+ EndpointUrl +":"+ AccessToken +":“+ Lowercase(HexEncode(SHA-256(minify(RequestBody))))+ ":“ + TimeStamp

Example: ieNOENDdN4MnectGytx5UvmOfASZ2oGWMCJ8gVqkw3tB98ofgY9cbxSeY4IYoYeoKs+0QP4h8BTBhemlfeXp1w==

X-TIMESTAMPstringrequired

Client's current local time with format YYYY-MM-DDTHH:mm:ssZD

Example: 2020-12-21T14:56:11+07:00

Body

partnerReferenceNostring · max: 64

Transaction identifier on service consumer system, generated by partner.

accountNostring · max: 16required

Example: A41879

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-sandbox.doku.com/v1.0/balance-inquiry' \
  --header 'X-EXTERNAL-ID: text' \
  --header 'X-PARTNER-ID: text' \
  --header 'X-SIGNATURE: text' \
  --header 'X-TIMESTAMP: text' \
  --header 'Content-Type: application/json' \
  --data '{"accountNo":"A41879"}'

200

400

200

{
  "responseCode": 2001100,
  "responseMessage": "Successful",
  "accountNo": "A41879",
  "name": "Simulator Indo Agent",
  "additionalInfo": {
    "creditAlertLimit": {
      "value": "65000.00",
      "currency": "IDR"
    }
  },
  "accountInfos": {
    "holdAmount": {
      "value": "0.00",
      "currency": "IDR"
    },
    "avaliableBalance": {
      "value": "823781442.13",
      "currency": "IDR"
    }
  }
}

Transfer bank processed

---

3. Transfer Bank

post

/v1.0/emoney/transfer-bank

Header parameters

X-EXTERNAL-IDstringrequired

Numeric String. Reference number that should be unique in the same day (Request Id)

Example: 41807553358950093184162180797837

X-PARTNER-IDstringrequired

Client Id for merchant that generated by DOKU

Example: 82150823919040624621823174737537

X-SIGNATUREstringrequired

Symmetric Signature with Get Token (Default)HMAC_SHA512 (clientSecret, stringToSign) dengan formula stringToSign = HTTPMethod +”:“+ EndpointUrl +":"+ AccessToken +":“+ Lowercase(HexEncode(SHA-256(minify(RequestBody))))+ ":“ + TimeStamp

Example: ieNOENDdN4MnectGytx5UvmOfASZ2oGWMCJ8gVqkw3tB98ofgY9cbxSeY4IYoYeoKs+0QP4h8BTBhemlfeXp1w==

X-TIMESTAMPstringrequired

Client's current local time with format YYYY-MM-DDTHH:mm:ssZD

Example: 2020-12-21T14:56:11+07:00

Body

partnerReferenceNostring · max: 64required

Transaction identifier on service consumer system, generated by KD partners. Must be unique per request.

Example: hsjkans284b2he54

customerNumberstring · max: 32required

Customer Account Number in Phone Number format

Example: 628115678890

beneficiaryAccountNumberstring · max: 32required

Destination account number

Example: 8377388292

beneficiaryBankCodestringrequired

Bank code

Example: 014

amountobjectrequired

sessionIdstring · max: 25

Inquiry invoice id

Example: I0438729855304540

feeTypeany · max: 25

Example:

additionalInfoobject

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-sandbox.doku.com/v1.0/emoney/transfer-bank' \
  --header 'X-EXTERNAL-ID: text' \
  --header 'X-PARTNER-ID: text' \
  --header 'X-SIGNATURE: text' \
  --header 'X-TIMESTAMP: text' \
  --header 'Content-Type: application/json' \
  --data '{"partnerReferenceNo":"hsjkans284b2he54","customerNumber":"628115678890","beneficiaryAccountNumber":"8377388292","beneficiaryBankCode":"014","amount":{"value":"200000.00","currency":"IDR"},"sessionId":"I0438729855304540","feeType":"","additionalInfo":{"channelCode":"07","beneficiaryFirstName":"FHILEA","beneficiaryLastName":"HERMANUS","beneficiaryPhoneNumber":"62811600174","beneficiaryBankName":"Bank BCA","beneficiaryAccountName":"FHILEA HERMANUS","senderCountryCode":"ID","senderFirstName":"JOHN","senderLastName":"DOE","senderPersonalId":"89012345","senderPersonalIdType":"KTP","remark":"Remark test"}}'

200

400

200

{
  "responseCode": 2004300,
  "responseMessage": "Successful",
  "referenceNo": "DK01123220",
  "partnerReferenceNo": "2020102900000000000001",
  "transactionDate": "2022-11-11T10:51:48+07:00",
  "referenceNumber": "39448581-c741-44f9-b3af-98616e2229b1",
  "additionalInfo": {
    "sessionId": "I0438729855304540",
    "amount": "200000.00"
  }
}

Transfer bank processed

4. Check Status

post

/v1.0/qr/qr-mpm-status

Header parameters

X-EXTERNAL-IDstringrequired

Numeric String. Reference number that should be unique in the same day (Request Id)

Example: 41807553358950093184162180797837

X-PARTNER-IDstringrequired

Client Id for merchant that generated by DOKU

Example: 82150823919040624621823174737537

X-SIGNATUREstringrequired

Symmetric Signature with Get Token (Default)HMAC_SHA512 (clientSecret, stringToSign) dengan formula stringToSign = HTTPMethod +”:“+ EndpointUrl +":"+ AccessToken +":“+ Lowercase(HexEncode(SHA-256(minify(RequestBody))))+ ":“ + TimeStamp

Example: ieNOENDdN4MnectGytx5UvmOfASZ2oGWMCJ8gVqkw3tB98ofgY9cbxSeY4IYoYeoKs+0QP4h8BTBhemlfeXp1w==

X-TIMESTAMPstringrequired

Client's current local time with format YYYY-MM-DDTHH:mm:ssZD

Example: 2020-12-21T14:56:11+07:00

Body

originalPartnerReferenceNostring · max: 64required

Original transaction identifier on service consumer system. Filled with partnerReferenceNo from remit/transfer API

Example: hsjkans284b2he54

originalReferenceNostring · max: 64

Original transaction identifier on service provider system. Can be filled with referenceNo or sessionId from remit/transfer API.

Example: hsjkans284b2he54

originalExternalIdstring · max: 32

Original transaction identifier on service provider system. Can be filled with X-EXTERNAL_ID from remit/transfer API.

Example: 892834eWg

serviceCodestring · max: 2required

Transaction type indicator (service code of the original transaction request).

Example: 43

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-sandbox.doku.com/v1.0/qr/qr-mpm-status' \
  --header 'X-EXTERNAL-ID: text' \
  --header 'X-PARTNER-ID: text' \
  --header 'X-SIGNATURE: text' \
  --header 'X-TIMESTAMP: text' \
  --header 'Content-Type: application/json' \
  --data '{"originalPartnerReferenceNo":"hsjkans284b2he54","originalReferenceNo":"hsjkans284b2he54","originalExternalId":"892834eWg","serviceCode":"43"}'

200

400

200

{
  "responseCode": 2005300,
  "responseMessage": "Successful",
  "originalReferenceNo": "DK01123220",
  "originalPartnerReferenceNo": "2020102900000000000001",
  "serviceCode": 43,
  "latestTransactionStatus": "00",
  "amount": {
    "value": "65000.00",
    "currency": "IDR"
  },
  "transactionDate": "2024-09-17T14:41:52. 022+07:00",
  "originalResponseCode": 0,
  "originalResponseMessage": "Transfer Approve",
  "transactionStatusDesc": "Transaction is successfully processed",
  "sessionId": "I0438729855304540",
  "additionalInfo": {
    "cashInTime": "2024-09-17 13:56:57",
    "remark": "Remark test",
    "beneficiaryAmount": "200000.00"
  }
}

check status processed

---

5. Unpaid Notification

For Sandbox Environment

• UNPAID to FAILED transaction

  • beneficiaryBankCode must be 002

  • beneficiaryAccountNumber must contain 12345

  • channel.code must be 07 (or not send the parameter at all)

• For UNPAID to SUCCESS/PAID transaction

  • beneficiaryBankCode must be other than 002, e.g. 014

  • beneficiaryAccountNumber must contain 12345

  • channel.code must be 07 (or not send the parameter at all)

This API is used to notify partners when the transaction status initially gets UNPAID status and then updated by DOKU's system to either Success or Failed. If partners don't want to implement Unpaid Notification API, they may opt to call the Transaction Info API to fetch the status of a transaction. To receive unpaid notifications, partners are required to prepare Callback URLs for sandbox and production environments. For UNPAID to PAID transactions. In the sandbox environment, the notification will be sent in under 5 minutes. For UNPAID to FAILED transactions In the sandbox environment, the notification will be sent at odd hours e.g. 1 P.M., 3 P.M., 5 P.M., and so on.

post

/{merchantUrlUnpaidNotification}

Path parameters

merchantUrlUnpaidNotificationstringrequired

Merchant url path for receiving Unpaid notification by KIRIMDOKU provided by partner

Header parameters

requestIdstringrequired

Unique reference identification sent by the API partner.

Example: fd53b1e3-9c35-4dfa-a95ca8dbc5695485

agentKeystringrequired

Hash key of authorization agent

Example: A41418

signaturestringrequired

Unique authorization code generated by partner validated by KIRIMDOKU

Example: ieNOENDdN4MnectGytx5UvmOfASZ2oGWMCJ8gVqkw3tB98ofgY9cbxSeY4IYoYeoKs+0QP4h8BTBhemlfeXp1w==

Content-Typestringrequired

The Content-Type field indicates that JSON type is acceptable to send to the recipient

Example: application/json

Body

sendTrxIdstring · max: 64

Transaction identifier on service consumer system, generated by partner.

transactionIdstring · max: 16required

Example: DK0018353

invoiceNumberstringrequired

Transaction ID that have been updated

Example: I088787987870912

transactionStatusstringrequired

Remit transaction status. Use this status to determine whether the beneficiary is receiving the funds or not. 50: Success, 35: Failed, 20: Unpaid, 40: Refunded.

Example: 50

activityCodestringrequired

Specific notification code

Example: 200

messagestringrequired

Notification message “Transaction is Success” or “Transaction is Failed”

Example: Transaction is Success

processDatestringrequired

Update time in yyyy-MM-ddTHH:mm:ss format

Example: 2024-01-12'T'07:30:12

createdTimestringrequired

Payment creation time in Epoch time format

Example: 1699520040340

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://{merchant-domain}/{merchantUrlUnpaidNotification}' \
  --header 'requestId: text' \
  --header 'agentKey: text' \
  --header 'signature: text' \
  --header 'Content-Type: application/json' \
  --data '{"transactionId":"DK0018353","invoiceNumber":"I088787987870912","transactionStatus":"50","activityCode":"200","message":"Transaction is Success","processDate":"2024-01-12'T'07:30:12","createdTime":"1699520040340"}'

200

200

{
  "status": true,
  "transactionId": "DK0018353",
  "responseCode": "00",
  "responseMessage": "Successfully processed"
}

Notification processed Successfully

---

6. Refund Notification

For Sandbox Environment, beneficiaryAccountNumber parameter must be 7746555134

This API is used to notify partners when a refund occurs in the KIRIMDOKU system. KIRIMDOKU will notify partners with the URL that has been registered, and the notification will be done maximum 3 times or until the notification callback response is correct. If partners don't want to implement Refund Notification API, they may opt to call the Transaction Info API to fetch the status of a transaction. To receive refund notifications, partners are required to prepare Callback URLs for sandbox and production environments. In the sandbox environment, the notification will be sent in 5 minutes after the partner hits the remit API.

post

/{merchantUrlRefundNotification}

Path parameters

merchantUrlRefundNotificationstringrequired

Merchant url path for receiving Refund notification by KIRIMDOKU provided by partner

Header parameters

requestIdstringrequired

Unique reference identification sent by the API partner.

Example: fd53b1e3-9c35-4dfa-a95ca8dbc5695485

agentKeystringrequired

Hash key of authorization agent

Example: A41418

signaturestringrequired

Unique authorization code generated by partner validated by KIRIMDOKU

Example: ieNOENDdN4MnectGytx5UvmOfASZ2oGWMCJ8gVqkw3tB98ofgY9cbxSeY4IYoYeoKs+0QP4h8BTBhemlfeXp1w==

Content-Typestringrequired

The Content-Type field indicates that JSON type is acceptable to send to the recipient

Example: application/json

Body

transactionIdstring · max: 16required

Example: DK0018353

activityCodestringrequired

Specific notification code

Example: 200

messagestringrequired

Notification message “Transaction is Success” or “Transaction is Failed”

Example: Transaction is Refunded

processDatestringrequired

Update time in yyyy-MM-ddTHH:mm:ss format

Example: 2024-01-12'T'07:30:12

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://{merchant-domain}/{merchantUrlRefundNotification}' \
  --header 'requestId: text' \
  --header 'agentKey: text' \
  --header 'signature: text' \
  --header 'Content-Type: application/json' \
  --data '{"transactionId":"DK0018353","activityCode":"200","message":"Transaction is Refunded","processDate":"2024-01-12'T'07:30:12"}'

200

200

{
  "status": true,
  "transactionId": "DK0018353",
  "responseCode": "00",
  "responseMessage": "Successfully processed"
}

Notification processed Successfully