logo
English
English
API ReferenceSign In

Testing Disbursements

Last updated 09/20/2019

Testing your integration

Before taking your integration live, you’ll want to test your integration thoroughly in development mode. Use our test information to simulate various positive and negative scenarios and ensure the flows in your integration are handled correctly.

Note: We recommend using Postman collections for testing.  Please see our postman integrations page for more details on how to set up your collections.

Instructions

  1. Be sure to use your Development API keys to test disbursements.
  2. Post a Create Disbursement request using any of the following test details to simulate successful and failed disbursements.
  3. When a Disbursement is successfully created (but still in the process of sending out), you will receive a response with status “PENDING”.
  4. When the Disbursement has been successfully executed, you will receive a callback at your callback URL with status “COMPLETED”. If the disbursement failed, you will receive a callback at your callback URL with status “FAILED”; refer to the failure_code for more details of the failure.

Testing for specific responses and errors

Successful disbursement   Will complete payment and initiate callback API to your callback URL with status: “COMPLETED”PARAMETER amountVALUE (any of below) 90000 250000 3000000
Bank account does not exist  Will return error: “INVALID_DESTINATION”. PARAMETER bank_code account_holder_name account_numberVALUE  MANDIRI Rizky 7654321
Switching network is experiencing downtime  Will return error: SWITCHING_NETWORK_ERRORPARAMETER bank_code account_holder_name account_numberVALUE MANDIRI Siti 12121212
Bank networks have rejected the transaction for an unknown reason  Will return error: “UNKNOWN_BANK_NETWORK_ERROR”PARAMETER bank_code account_holder_name account_numberVALUE MANDIRI Andri 987654321
Bank is undergoing unscheduled maintenance  Will return error: “TEMPORARY_BANK_NETWORK_ERROR”PARAMETER bank_code account_holder_name account_numberVALUE MANDIRI Yono 321321321
Transaction has been rejected by the destination bank without a clear error reason Will return error: “REJECTED_BY_BANK”PARAMETER bank_code account_holder_name account_numberVALUE MANDIRI Budi 8787878
Transaction was rejected because of a fatal error Will return error: “TRANSFER_ERROR”PARAMETER bank_code account_holder_name account_numberVALUE  MANDIRI Adnin 1351357
Transaction failed because of a known temporary issue  Will return error: “TEMPORARY_TRANSFER_ERROR”PARAMETER bank_code account_holder_name account_numberVALUE  MANDIRI Sutiono 868686
Description not found  Will return error: "API_VALIDATION_ERROR"Send a disbursement with the “description” parameter empty 
Not enough balance Will return error: "INSUFFICIENT_BALANCE"Send a disbursement with amount greater than the balance available in your account 
Invalid API Key Will return error: "INVALID_API_KEY"Try using a random API key 
Was this page helpful?
Yes No