INinfiniaweb
Webhooks

Account status updated

Sent when an account changes status (e.g. PROVISIONING → ACTIVE, ACTIVE → SUSPENDED, CLOSED, REJECTED). No notification is sent when the status does not change. Set the destination URL using status_callback_url when creating the account or with Update Account. The body is identical to the Get Account Details response.

postWebhookaccount.status_updated

Payload

idinteger required

Account ID

created_atstring date-time

Creation date of the account

updated_atstring date-time

Last update date of the account

status'PROVISIONING' | 'ACTIVE' | 'SUSPENDED' | 'CLOSED' | 'REJECTED'
status_reasonstring

Why the account is in its current status, when known (e.g. the reason a KYC/KYB verification was rejected). Usually set for SUSPENDED, REJECTED or CLOSED accounts; null otherwise.

labelstring

Account label

idempotency_keystring

Idempotency key for the account creation, it can also be used as an external identifier

bankstring required

Name of the bank where the account is held

company_idinteger

Company ID associated with the account

currency'BRL' | 'BRLA' | 'MXN' | 'ARS' | 'COP' | 'CLP' | 'BOB' | 'PYG' | 'SGD' | 'PEN' | 'EUR' | 'GBP' | 'USD' | 'USDT' | 'USDC' | 'UYU' | 'USDC_POL' | 'USDT_POL' | 'EURC_BASE' | 'USDC_BASE' | 'USDT_BASE' | 'USDC_ETH' | 'USDT_ETH' | 'EURC_ETH' | 'USDC_TEMPO' | 'USDT_TEMPO' | 'EURC_TEMPO' | 'OUSD_TEMPO' | 'USDC_MONAD' | 'USDT_MONAD' | 'OUSD_BASE' | 'OUSD_ETH' | 'OUSD_SOL' | 'BRLA_ETH' | 'BRLA_POL' | 'BRLA_BASE' | 'TGBP_ETH' | 'TGBP_POL' | 'TGBP_BASE' | 'USDC_SOL' | 'USDT_SOL' | 'USDT_TRX' | 'MXNB_BASE' required
country'BR' | 'AR' | 'CO' | 'CL' | 'BO' | 'PY' | 'SG' | 'PE' | 'MX' | 'UY' | 'US' | 'EU' | 'XX' | 'GB' required
account_numberstring

Account number

enabledboolean

Indicates if the account is enabled or not. Disabled accounts will not be able to perform any operations until they are enabled again.

account_typestring

Type of the account

document_numberstring

Document number of the account holder

document_typestring

Document type of the account holder

is_virtual_accountboolean

Indicates if the account is a virtual account

webhook_urlstring

Webhook URL for movement notifications

status_callback_urlstring

Callback URL for account-level events

productsAccountProductsEnum[]

List of products associated with the account

owner_idstring

UUID of the Account Owner linked to this account

Response

Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.