Callbacks¶
When a settlement reaches a terminal state (executed or failed), Bitlipa sends a POST request to the partner's callback_url provided at confirmation.
Callback body¶
| Field | Type | Description |
|---|---|---|
tx_id |
string | Bitlipa transaction ID. |
external_tx_id |
string | Partner's transaction reference. |
status |
string | executed or failed. |
tx_hash |
string | Blockchain hash (when executed). |
chain |
string | Blockchain network (CAIP-2). |
destination_amount |
number | Net amount delivered (after fee). |
platform_fee |
number | Fixed platform fee (in destination currency). |
failure_reason |
string | Error description (when failed). |
executed_at |
string | Execution timestamp (when executed). |
About destination_amount
This is the net amount actually delivered to the wallet, after platform_fee deduction.
Expected response¶
Return HTTP 200 with an acknowledgment:
Retry policy¶
| Attempt | Delay |
|---|---|
| 1 | Immediate |
| 2 | 1 minute |
| 3 | 5 minutes |
| 4 | 30 minutes |
| 5 | 2 hours |
| 6 | 12 hours |
- Callbacks time out after 30 seconds.
- Success = any HTTP 2xx response.
- After 6 failed attempts, the callback is marked as undelivered.
- Undelivered callbacks can be retrieved via GET /settlements/:tx_id.