BIFAST Disbursement Callback

{
  "data": {
    "id": "84jt9r94jr4r84r894jr8j4",
    "type": "disbursement",
    "attributes": {
      "referenceId": "ref-disbursement-1",
      "description": "ref-disbursement-1",
      "amount": "30000",
      "status": "completed",
      "settlementStatus":null,
      "createdAt": "2023-09-21T13:49:39.752+08:00",
      "disbursementMethod": {
        "type": "bank_transfer",
        "bankAccountNo": "12345678",
        "bankShortCode": "BCA",
        "bankAccountHolderName": "BUDI SUSANTO",
        "bankName" : "Bank Central Asia",
        "sender": {
		      "name": "BUDI SUSANTO", 
		      "identityType": "KTP", 
		      "identityNumber": "350104635820003", 
		      "countryCode": "ID", 
		      "provinceCode": "35", 
		      "cityCode": "1226", 
		      "jobCode": "89", 
				  "address": "JAkarta Sudirman No 4", 
		      "placeOfBirth": "BAndung", 
		      "dateOfBirth": "2000-04-23" 
		    }
      }
    }
  }
}

{
  "data": {
    "id": "9cb8ba6c8aa644ff9a433ace9",
    "type": "disbursement",
    "attributes": {
      "referenceId": "sc-MAR-5437",
      "description": "Good Luck",
      "amount": "10000",
      "status": "failed",
      "settlementStatus": null,
      "createdAt": "2025-02-12T16:25:11.000+07:00",
      "errorCode": "5000100",
      "errorReason": "General Error",
      "errorDetail": {
        "code": "general_error",
        "message": "General Error",
        "action": "Please try again later or contact support if the issue persists.",
        "reason": "A general error occurred while processing the request. This may be due to a temporary issue on our end."
      },
      "disbursementMethod": {
        "type": "bank_transfer",
        "bankAccountNo": "010800041187",
        "bankShortCode": "BCA",
        "bankAccountHolderName": "JOHN CENA",
        "bankName": "BCA"
      }
    }
  }
}

Please note when you setup your callback endpoint :

Callback method : POST
Content type : app/json
Add whitelist to Brick server for secure connection

Response Parameters

Key Parameters	Data type	Description
id	String	Unique identifier
type	String	Type of transaction
status	String	The status of disbursement
createdAt	TimeStamp	Time at which the response was created.
amount	Integer	Amount of money to be disbursed
referenceId	String	A unique reference ID as a unique identifier
description	String	An arbitrary string attached to the object. Often useful for displaying to users what the transaction was for. Description length limit is 255 chars.
disbursementMethodType	String	Currently only support bank transfer
bankAccountNo	String	Account number of the user
bankShortCode	String	Institution short code of the user
bankAccountHolderName	String	Account name that the funds are intended to be sent to.
bankName	String	Name of the Institutions
settlementStatus	String	Status of the transaction
errorCode	String	A unique identifier representing the error that occurred during the transaction. See how to handle errors here .
errorReason	String	A brief explanation of the error that caused the transaction failure.
errorDetail	JSON Object	A detailed breakdown of the error, including specific information on the cause and possible resolution steps.

Additional Response Parameters:

sender (JSON object)

Key Parameters	Data Type	Description	Limitation
name	String	Name of the user that send the money	1. Alpha Numeric 2. Space Allowed 3. Max 40 Characters
identityType	String	Allowed Value only KTP/SIM/KITAS/NPWP	Allowed Value only KTP/SIM/KITAS/NPWP
identityNumber	String	Identity Number of the User	1. Alpha Numeric 2. Min 10 characters 3. Max 16 Characters
countryCode	String	Country Code based on the user	Allowed Value are 2 all caps characters
provinceCode	String	Province Code based on the user	Allowed Value are 2 all caps characters
cityCode	String	City Code based on the user	Allowed Value are 4 all caps characters
jobCode	String	Job Code based on the user	Allowed Value are 4 all caps characters
address	String	Address of the user	1. Alpha Numeric 2. Space Allowed 3. Max 40 Characters
placeOfBirth	String	Place of the user birth	1. Alpha Numeric 2. Space allowed 3. Max 40 Characters
dateOfBirth	String	Date of Birth of the user	YYYY-MM-DD Format

errorDetail (JSON object)

Key Parameters	Data Type	Description
code	String	A machine-readable error code categorizing the error.
message	String	A human-readable error message describing the issue.
action	String	Suggested actions that can be taken to resolve the error.
reason	String	Additional context explaining why the error occurred.