Notify Disbursement Result (Webhook)

An endpoint that will be triggered to send the payment result of the transaction to the integrator- defined notification URL upon boarding.

When integrator register a webhook, integrator will receive notifications on the registered URL. This notification is standard responses wrapped in the “payload”.

To be notified with the payment result, integrator will need to prepare the endpoint that accepts the following requirements.

POST https://merchant.com/accept-notify-from-diz/{{merchantReference}}

Triggered automatically every 5 minutes (server time), if the transaction is not yet synced.
Notifies only when the disbursement transaction is SUCCESSFUL or REJECTED.
Create a POST method that includes the merchantReference:
- merchantReference must be passed as the common key between merchant and DIZ.
  This ensures the specific and correct disbursement transaction is updated based on the provided merchantReference.
- To verify check signature, must match with the key.

Header Parameters

Parameter	Required?	Type	Description
Content-Type	Optional	string	Default content type of the API.
Authorization	Required	string	Unique identifier of the integrator.

Query Parameters

Parameter	Required?	Type	Description
merchantReference	Required	string	Merchant reference of transaction

Request Sample

cURL

curl 
-X GET "https://merchant.com/accept-notify-from-diz/TRX001" \
-H "Content-Type: application/json" \
-H "Authorization: {integratorToken}" \

Response Sample

{
    "transactionReference": "TRX001",
    "statusCode": "OK.00.00",
    "statusDescription": "Disbursement Successful"
}