Transfer to Bank Inquiry Status

POST/v1.0/emoney/transfer-bank-status.htm

This API is used for merchant to do inquiry status transfer to Bank transaction to DANA

API Type

SNAP API

Expected Timeout

4 second

SNAP Service Code

00

Accept

application/json

Content Type

application/json

This API is used for the following solution:

Disbursement to Bank Account

enables direct fund transfers from DANA to users' bank accounts. This API lets you validate bank details, transfer funds, receive status updates, and check transfer statuses.

Retry Mechanism

The following are the details of the retry mechanism in case merchant needs to initiate a retry process:

• Retry is a mandatory process.
• The maximum retry is 5 times.
• Using the following interval time: 5, 10, 20, 40, 60, till merchant’s cut off (in seconds).

---

Content-Type

string

1 - 127 charactersRequired

Content type, value always application/json

Authorization

string

1 - 2048 charactersConditional

Contains bearer JWT token, which has been obtained from Authorization Token Request API

Conditional Info

Y:= Signature option is symmetric approach

X-TIMESTAMP

string

25 charactersRequired

Transaction date time, in format YYYY-MM-DDTHH:mm:ss+07:00.
Time must be in GMT+7 (Jakarta time)

X-SIGNATURE

string

Required

Signature need to be generated with symmetricSignature or asymmetricSignature method

ORIGIN

string

Origin domain

X-PARTNER-ID

string

1 - 36 charactersRequired

Unique identifier for partner was generated by DANA, or known as clientId

X-EXTERNAL-ID

string

1 - 36 charactersRequired

Unique messaging reference identifier generated by merchant and should be unique within the same day

CHANNEL-ID

string

1 - 5 charactersRequired

Device identification on which the API services is currently being accessed by the end user (customer)

---

originalPartnerReferenceNo

string

1 - 64 characters

Original transaction identifier on partner system.
Note:
Required to be filled using the partnerReferenceNo that is the same as the one used in Transfer to Bank

originalReferenceNo

string

1 - 64 characters

Original transaction identifier on DANA system

originalExternalId

string

1 - 36 characters

Original external identifier on header message

serviceCode

string

2 charactersRequired

Transaction type indicator is based on the service code of the original transaction request, value always 00

additionalInfo

json object

Additional information

POST .../v1.0/emoney/transfer-bank-status.htm HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a
X-TIMESTAMP: 2020-12-21T17:07:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
CHANNEL-ID: 95221
{
    "originalPartnerReferenceNo": "2021072342358089475892734",
    "originalReferenceNo": "2021072342358089475892091",
    "originalExternalId": "2ads-2da-d23dasd-21dadjoiq-23ij4oinfoen",
    "serviceCode": "00",
    "additionalInfo": {
    } 
}

---

Content-Type

string

1 - 127 charactersRequired

Content type, value always application/json

X-TIMESTAMP

string

25 charactersRequired

Transaction date time, in format YYYY-MM-DDTHH:mm:ss+07:00.
Time must be in GMT+7 (Jakarta time)

---

responseCode

string

7 charactersRequired

Refer to response code list

responseMessage

string

1 - 150 charactersRequired

Refer to response code list

originalPartnerReferenceNo

string

1 - 64 characters

Original transaction identifier on partner system

originalReferenceNo

string

1 - 64 charactersConditional

Original transaction identifier on DANA system

Conditional Info

Y:= Order found

originalExternalId

string

1 - 36 characters

Original external identifier on header message

serviceCode

string

2 charactersRequired

Transaction type indicator is based on the service code of the original transaction request, value always 00

amount

money

Amount. Contains two sub-fields:

1. Value: Transaction amount, including the cents
2. Currency: Currency code based on ISO

value

string

1 - 19 charactersRequired

Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00

currency

string

Required

Currency

latestTransactionStatus

string

2 charactersRequired

Status of latest transaction:

• 00 - Success
• 01 - Initiated
• 02 - Paying
• 03 - Pending
• 04 - Refunded
• 05 - Canceled
• 06 - Failed
• 07 - Not found

transactionStatusDesc

string

1 - 50 characters

Description of transaction status

additionalInfo

json object

Additional information

Content-type: application/json
X-TIMESTAMP: 2020-12-21T14:36:19+07:00
{
    "responseCode": "2000000",
    "responseMessage": "Successful",
    "originalPartnerReferenceNo": "2021072342358089475892734",
    "originalReferenceNo": "2021072342358089475892091",
    "originalExternalId": "2ads-2da-d23dasd-21dadjoiq-23ij4oinfoen",
    "serviceCode": "00",
    "amount": {
        "value": "40000.00",
        "currency": "IDR"
    },
    "latestTransactionStatus": "00",
    "transactionStatusDesc": "Success",
    "additionalInfo": {
    }
}

---

Response	Cause	Solution
2000000Successful	Success to be processed	Mark Transfer to Bank Inquiry Status based on latestTransactionStatus: 00 - Order has been successfully paid, mark Transfer to Bank as Success 01 - Order waiting payment process, mark Transfer to Bank as Pending. Hold the money and retry periodically 02 - Order waiting payment result, mark Transfer to Bank as Pending. Hold the money and retry periodically 03 - Order waiting payment result, mark Transfer to Bank as Pending. Hold the money and retry periodically 04 - Order has been refunded, mark Transfer to Bank as Failed 05 - Order has been cancelled, mark Transfer to Bank as Failed 06 - Order payment failed, mark Transfer to Bank as Failed 07 - Order not found, mark Transfer to Bank as Failed
4000000Bad Request	General request failed error	Mark Transfer to Bank Inquiry Status process as Failed and mark Transfer to Bank as Pending. Hold the money and retry request with proper parameter
4000001Invalid Field Format	Invalid format for certain field	Mark Transfer to Bank Inquiry Status process as Failed and mark Transfer to Bank as Pending. Hold the money and retry request with proper parameter
4000002Invalid Mandatory Field	Missing or invalid format on mandatory field	Mark Transfer to Bank Inquiry Status process as Failed and mark Transfer to Bank as Pending. Hold the money and retry request with proper parameter
4010000Unauthorized. [reason]	General unauthorized error	Mark Transfer to Bank Inquiry Status process as Failed and mark Transfer to Bank as Pending. Hold the money and retry request with proper parameter
4010001Invalid Token (B2B)	Authorization token are invalid, perhaps due to token expiry for B2B	Mark Transfer to Bank Inquiry Status process as Failed and mark Transfer to Bank as Pending. Hold the money and retry request with proper parameter
4040001Transaction Not Found	Transaction not found	Mark Transfer to Bank Inquiry Status process as Failed and mark Transfer to Bank as Failed. Retry new Customer Top Up Inquiry Status process
4290000Too Many Requests	Maximum transaction limit exceeded	Mark Transfer to Bank Inquiry Status process as Pending and mark Transfer to Bank as Pending. Hold the money and retry request periodically
5000001Internal Server Error	Unknown internal server failure, please retry the process again	Mark Transfer to Bank Inquiry Status process as Pending and mark Transfer to Bank as Pending. Hold the money and retry request periodically
Total Timeout	Total timeout, the client side does not get any responses from the server side (can be due to network issue, server slowing down, and so on)	Do a retry maximum 5 attempts, if still fails mark Transfer to Bank Inquiry Status process as Pending and mark Transfer to Bank as Pending. Hold the money
Unexpected response (empty field/field does not exist/undefined response code)	The server does not produce expected responses (can be due to hardware failure, bugs, and so on)	If the response code prefix are 202 and 5XX, mark Transfer to Bank Inquiry Status process as Pending and mark Transfer to Bank as Pending. Hold the money If empty field/field does not exist, mark Transfer to Bank Inquiry Status process as Pending and mark Transfer to Bank as Pending. Hold the money