A callback (webhook) is the HTTP request we send to your server when a deposit arrives, so you don't have to poll. You choose its URL with callback_url in Request Wallet (VIP) or Request Ramzlink.
Any HTTP 2xx within 10 seconds. The body is ignored.Answer first, then do your own work (database, emails, your own API calls) in the background. If your handler takes longer than 10 seconds, we count the attempt as failed even if you processed it.
An attempt fails when your server answers anything but 2xx, doesn't answer within 10 seconds, or can't be reached (DNS, TLS, connection refused). Then we try again:
Attempt
When
1
Right after the deposit is credited
2
1 minute after attempt 1 failed
3
10 minutes after attempt 2 failed
4
30 minutes after attempt 3 failed
5
60 minutes after attempt 4 failed (last)
Missed all five (for example during a long outage)? Send it again from the dashboard, or reconcile with Get Deposits.
Don't trust the body. Callbacks are not signed, so anyone who knows your URL could call it. Always confirm with Inquiry or Get Ramzlink Status, which need your merchant code, and credit from their answer.
2.
Credit each deposit once. The same callback can arrive more than once (a retry after your server answered too late, or Send callback again). Store trxRefId with a unique constraint and skip it when it's already there. For Ramzlink, act once per invoice when it becomes SUCCESS.
3.
Map the terminal to your user: terminalId is the nounce you gave that user.
Open the deposit in the dashboard (Transactions → the deposit). Its Callback section shows:
the callback URL,
every attempt: Delivered or Failed, the HTTP status your server answered (or the error, e.g. no answer within 10 s), and the time,
a Send callback again button: it sends the same callback right away and shows your server's answer. Use it after you fix your endpoint; there is no need to pay again.
Use a free webhook.site URL as callback_url, make a small deposit, and see the exact request arrive there. Then point callback_url at your server (call Request Wallet again for the terminal: it keeps the addresses and replaces the URL) and use Send callback again to replay it.