Overview
Account webhooks notify the merchant system about account top-up events, compliance checks, and successful delivery of incoming funds to the account.
Use these webhooks to track deposits credited to the merchant account and compliance-related top-up states.
Event types
| Event type | When it is sent |
|---|
| TOP_UP_PENDING_COMPLIANCE | Top-up transaction is under compliance review. |
| TOP_UP_COMPLIANCE_DECLINED | Top-up transaction was declined by compliance. |
| WALLET_FUNDS_DELIVERED_ACCOUNT | Funds were successfully delivered to the merchant account balance. |
Webhook payload structure
Each webhook request contains a common envelope and an event-specific data object.
Common data fields
| Field | Type | Description |
|---|
| type | string | Event type. |
| amount | number | Incoming amount. |
| currency | string | Currency of the top-up. |
| senderAddress | string | Address that sent funds. |
| paymentDate | string | Date and time of the incoming transaction. |
| transactionHash | string | Blockchain transaction hash. |
| fiatAmount | object | Fiat equivalent amount, if included in the event. |
Recommended handling
| Event | Recommended merchant action |
|---|
| TOP_UP_PENDING_COMPLIANCE | Keep the deposit in a pending state until the compliance result is received. |
| TOP_UP_COMPLIANCE_DECLINED | Mark the deposit as declined and follow internal support or refund procedures. |
| WALLET_FUNDS_DELIVERED_ACCOUNT | Update account balance or refresh it through [POST] account. |