Webhooks🏢 Account

📨 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 examples to learn more about statuses ID.

This webhook is related to the /accounts

Event triggers

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

Webhook notification format

We will notify you to the subscribed URL every time the account certification status changes. We will include the new status an the date when it changed. The observations field might include additional information in the cases when issues have arised that might require your attention. Please check certification statuses for each country in order to understand how to proceed.

  • event_id: ACCOUNT_CERTIFICATIONUPDATE
1{
2    "account_id": 330,
3    "certification_status": 80 ,
4    "observations": "<string>",
5    "date": "2025-02-24 19:41:17"
6}

Account certification status

Below you will find the lists of account statuses for each of the countries available in our API.