ES | EN

Webhooks

📨 Account certification update

Description of the event ACCOUNT.CERTIFICATIONUPDATE

This webhook notification will be triggered for subscriptions under event ACCOUNT.CERTIFICATIONUPDATE. It is used to get notifications on new accounts that are being enabled and/or certified through the tax authority.

Please check each country's examples to learn more about status IDs.

This webhook is related to the /accounts endpoint.

Event triggers

  • Each time an account is created with a new certification status
  • Each time an account changes its certification status

Webhook notification format

We will notify you at the subscribed URL every time the account certification status changes. We will include the new status and the date when it changed. The observations field might include additional information in cases when issues have arisen that may require your attention.

Please check certification statuses for each country in order to understand how to proceed.

event_id: ACCOUNT_CERTIFICATIONUPDATE

{
    "account_id": 330,
    "certification_status": 80,
    "observations": "<string>",
    "date": "2025-02-24 19:41:17"
}

Account certification status by country

Below you will find the lists of account statuses for each country available in our API: