Callbacks

When a disbursement is processed, 8B sends a callback notification to the client’s system. Clients are required to prepare and host an HTTP endpoint that meets the following specifications.

Endpoint Requirements

Parameter	Description
HTTP Method	POST
Path Parameter	disbursementId – The unique identifier of the disbursement
URL Structure Example	`https://your-domain.com/webhook/disbursements/{disbursementId}` Replace `{disbursementId}` with the actual numeric ID provided in the callback request
Path Parameter Type	integer (int64)
Protocol	HTTPS is mandatory to ensure secure data transmission

Request Body

The request body will contain the callback data in JSON format:

{  
  "status": "ACCEPTED",
  "errorCode": "CODE_PT0000",
  "errorMessage": "string"
}

Field Descriptions

Field	Type	Description
`status`	string	The status of the transaction from the client’s processing perspective
`errorCode`	string	Client-defined error code if the transaction cannot be processed
`errorMessage`	string	Human-readable description of the error. Optional for successful cases