Account status updated

wbhk

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. The body is identical to the Get Account Details response.

Payload

integer

required

Account ID

created_at

date-time

Creation date of the account

updated_at

date-time

Last update date of the account

status

string

enum

Defaults to ACTIVE

Current lifecycle status of the account.

Allowed:

label

string

Account label

idempotency_key

string

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

bank

string

required

Name of the bank where the account is held

company_id

integer

Company ID associated with the account

currency

string

enum

required

Currency of the account

country

string

enum

required

Country of the account

account_number

string

Account number

enabled

boolean

Defaults to true

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

account_type

string

Type of the account

document_number

string

Document number of the account holder

document_type

string

Document type of the account holder

funding_instructions

Fiat Funding | Crypto Funding

Funding instructions for the account, if applicable

balance_details

object

Balance details of the account

is_virtual_account

boolean

Defaults to false

Indicates if the account is a virtual account

webhook_url

string

Webhook URL for movement notifications

status_callback_url

string

Callback URL for account-level events

products

array of objects

Defaults to []

List of products associated with the account

Products

Allowed:

owner_id

string

UUID of the Account Owner linked to this account

Response

200

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