post https://your.custom.endpoint.com/settlement_status/customendpoint
This callback is used by Decentro to trigger the status of a settlement to pre-configured endpoint of the platform.
Overview
This callback allows the platform to proactively receive a settlement's status to their pre-configured endpoint. The settlement transaction can be due to any collection mode.
- Virtual account-based collection
The platform can share the endpoint for configuring this callback before going live at [email protected].
Points to Note
Key points to note.
- This callback is triggered 3 times per transaction.
- This callback only propagates the transaction status
- This callback is triggered when a transaction status moves to one of SUCCESS or FAILURE.
Note: This callback is not triggered by Decentro if the settlement request itself fails due to an invalid payload, beneficiary details being incorrect, etc.
Flow
Below is the flow for using the callback capability as part of Decentro
- The platform has collected funds using Decentro using any of the modes supported.
- The platform requests a settlement using the Request settlements API or settlements are auto-triggered by Decentro as per the commercial agreement with the platform.
- The platform receives this callback on its pre-configured endpoint, including the settlement details like UTR, etc.