Check available events and their corresponding payloads

Available events

A webhook will receive multiple business events generated in our systems, and the receiving URL should be able to manage them appropriately. The following list provides examples of the payload you may receive for each event.

Accounts

account.created

This event notifies a new account has been created in your account. Its initial status will be created until it's finally activated.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "account.created",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "status": "created",
      "created_at": "2023-01-01T12:00:00Z",
      "name": "Devengo Account",
      "bank": null,
      "identifiers": [

      ],
      "currency": "EUR",
      "balance": {
        "total": {
          "cents": 0,
          "currency": "EUR"
        },
        "available": {
          "cents": 0,
          "currency": "EUR"
        }
      },
      "metadata": {
      },
      "closed_at": null
    }
  }
}

account.delayed

Devengo will generate this event if any kind of incident in the underlying banking infrastructure prevents us from activating the recently created account. Eventually, the account will be activated, sending you an account.active event. Until that moment, the account is not suitable for any operations.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "account.delayed",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "status": "delayed",
      "created_at": "2023-01-01T12:00:00Z",
      "name": "Devengo Account",
      "bank": null,
      "identifiers": [

      ],
      "currency": "EUR",
      "balance": {
        "total": {
          "cents": 0,
          "currency": "EUR"
        },
        "available": {
          "cents": 0,
          "currency": "EUR"
        }
      },
      "metadata": {
      },
      "closed_at": null
    }
  }
}

account.activated

This event informs you when an account is fully available to be used.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "account.activated",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "status": "active",
      "created_at": "2023-01-01T12:00:00Z",
      "name": "Devengo Account",
      "bank": {
        "name": "Modulr FS Europe Limited",
        "bic": "MODRGB2LXXX"
      },
      "identifiers": [
        {
          "type": "iban",
          "iban": "IE64MODR99035502300000"
        }
      ],
      "currency": "EUR",
      "balance": {
        "total": {
          "cents": 0,
          "currency": "EUR"
        },
        "available": {
          "cents": 0,
          "currency": "EUR"
        }
      },
      "metadata": {
      },
      "closed_at": null
    }
  }
}

account.deactivated

Devengo will generate this event if any kind of incident in the underlying banking infrastructure prevents us from closing your account. At this point, the account is not suitable for any operations in Devengo anymore, but the actual closing of the bank account is still in process. Eventually, the account will be closed, sending you the final account.closed event.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "account.deactivated",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "status": "deactivated",
      "created_at": "2023-01-01T12:00:00Z",
      "name": "Devengo Account",
      "bank": {
        "name": "Modulr FS Europe Limited",
        "bic": "MODRGB2LXXX"
      },
      "identifiers": [
        {
          "type": "iban",
          "iban": "IE64MODR99035502300000"
        }
      ],
      "currency": "EUR",
      "balance": {
        "total": {
          "cents": 0,
          "currency": "EUR"
        },
        "available": {
          "cents": 0,
          "currency": "EUR"
        }
      },
      "metadata": {
      },
      "closed_at": null
    }
  }
}

account.closed

This event notifies a new account has been created in your account. Its initial status will be created until it's finally activated.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "account.closed",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "status": "closed",
      "created_at": "2023-01-01T12:00:00Z",
      "name": "Devengo Account",
      "bank": {
        "name": "Modulr FS Europe Limited",
        "bic": "MODRGB2LXXX"
      },
      "identifiers": [
        {
          "type": "iban",
          "iban": "IE64MODR99035502300000"
        }
      ],
      "currency": "EUR",
      "balance": {
        "total": {
          "cents": 0,
          "currency": "EUR"
        },
        "available": {
          "cents": 0,
          "currency": "EUR"
        }
      },
      "metadata": {
      },
      "closed_at": "2022-01-01T13:00:00Z"
    }
  }
}

Incoming Payments

incoming_payment.created

Devengo will generate this event when we get notice of the arrival of funds in any of your accounts and create the corresponding incoming payment to represent them.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "incoming_payment.created",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyi_1J8ohdYQxuGhXslvJDlFVC",
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "status": "created",
      "description": "Transaction description",
      "company_reference": "Example reference",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "created_at": "2023-01-01T12:00:00Z",
      "internal": false,
      "instant": true,
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      }
    }
  }
}

incoming_payment.confirmed

Devengo will generate this event when an incoming payment is confirmed after its creation. At this point, the funds are available in your account.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "incoming_payment.confirmed",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyi_1J8ohdYQxuGhXslvJDlFVC",
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "status": "confirmed",
      "description": "Transaction description",
      "company_reference": "Example reference",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "created_at": "2023-01-01T12:00:00Z",
      "internal": false,
      "instant": true,
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      }
    }
  }
}

incoming_payment.rejected

Devengo will generate this event when an incoming payment is rejected.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "incoming_payment.rejected",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyi_1J8ohdYQxuGhXslvJDlFVC",
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "status": "rejected",
      "description": "Transaction description",
      "company_reference": "Example reference",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "created_at": "2023-01-01T12:00:00Z",
      "internal": false,
      "instant": true,
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      }
    }
  }
}

Outgoing Payments

outgoing_payment.created

Devengo will generate this event when the payment needs to go through an extra verification process.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.created",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "created",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

outgoing_payment.validating

Devengo will generate this event when you create a payment before the banking processing starts.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.validating",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "validating",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

outgoing_payment.blocked

Devengo will generate this event while the payment is being validated and before the banking processing starts.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.blocked",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "blocked",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

outgoing_payment.denied

Devengo will generate this event when the payment couldn't be validated so it won't be processed.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.denied",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "denied",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

outgoing_payment.delayed

Devengo will generate this event when the payment couldn't be processed due to a temporary outage of an external service. The payment will be set to "pending" when the service is up again.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.delayed",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "delayed",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

outgoing_payment.pending

Devengo will generate this event once the payment has been validated and before the banking processing starts.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.pending",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "pending",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

outgoing_payment.processing

Devengo will generate this event when the banking processing starts.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.processing",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "processing",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

outgoing_payment.retrying

Devengo will generate this event when the banking process has failed and is being retried.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.retrying",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "retrying",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": true,
      "internal": false
    }
  }
}

outgoing_payment.rejected

This event informs you the payment has been rejected.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.rejected",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "rejected",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": {
        "code": "ERR-0001",
        "type": "blocked_account",
        "reason": "AG01"
      },
      "links": null,
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": true,
      "internal": false
    }
  }
}

outgoing_payment.confirmed

This event informs you the payment has been successfully confirmed.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.confirmed",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "confirmed",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": null,
      "links": {
        "receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
      },
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

outgoing_payment.reversed

This event informs you the payment has been reversed. Only if the payment had been previously confirmed.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "outgoing_payment.reversed",
  "created_at": "2023-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_7C0jYxcbxjG1LIq2UQ52E9",
      "status": "reversed",
      "recipient": "Ana Devenger",
      "company_reference": "Example reference",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES2914653111661392648933"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true,
      "eta": "2023-01-01T12:00:10Z",
      "created_at": "2023-01-01T12:00:00Z",
      "processor": {
        "network": "SEPA",
        "scheme": "SCT-INST"
      },
      "error": {
        "code": "ERR-0002",
        "type": "closed_account",
        "reason": "AC04"
      },
      "links": {
        "receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
      },
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "metadata": {
      },
      "retried": false,
      "internal": false
    }
  }
}

Verifications

verification.created

This event will be sent when the verification code was delivered to the recipient.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "verification.created",
  "created_at": "2023-09-23T13:18:02Z",
  "data": {
    "object": {
      "id": "vrf_6gwS6FHtPRcahLBSlsG7TW",
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "status": "created",
      "company_reference": "Example reference",
      "metadata": {
      },
      "expired_at": "2023-09-30T13:18:02Z",
      "created_at": "2023-09-23T13:18:02Z",
      "eta": "2023-09-23T13:18:12Z",
      "attempts": 0,
      "error": null
    }
  }
}

verification.delivered

This event will be sent when a new verification has been created, before it's delivered to the recipient.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "verification.delivered",
  "created_at": "2023-09-23T13:18:02Z",
  "data": {
    "object": {
      "id": "vrf_6gwS6FHtPRcahLBSlsG7TW",
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "status": "delivered",
      "company_reference": "Example reference",
      "metadata": {
      },
      "expired_at": "2023-09-30T13:18:02Z",
      "created_at": "2023-09-23T13:18:02Z",
      "eta": "2023-09-23T13:18:12Z",
      "attempts": 0,
      "error": null
    }
  }
}

verification.rejected

This event will be sent when the verification code couldn't be delivered to the recipient. In this case the error field will contain more information about the problem.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "verification.rejected",
  "created_at": "2023-09-23T13:18:02Z",
  "data": {
    "object": {
      "id": "vrf_6gwS6FHtPRcahLBSlsG7TW",
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "status": "rejected",
      "company_reference": "Example reference",
      "metadata": {
      },
      "expired_at": "2023-09-30T13:18:02Z",
      "created_at": "2023-09-23T13:18:02Z",
      "eta": "2023-09-23T13:18:12Z",
      "attempts": 0,
      "error": {
        "code": "ERR-0001",
        "type": "blocked_account",
        "reason": "AC06"
      }
    }
  }
}

verification.confirmed

This event will be sent when the verification was confirmed providing the right code.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "verification.confirmed",
  "created_at": "2023-09-23T13:18:02Z",
  "data": {
    "object": {
      "id": "vrf_6gwS6FHtPRcahLBSlsG7TW",
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "status": "confirmed",
      "company_reference": "Example reference",
      "metadata": {
      },
      "expired_at": "2023-09-30T13:18:02Z",
      "created_at": "2023-09-23T13:18:02Z",
      "eta": "2023-09-23T13:18:12Z",
      "attempts": 1,
      "error": null
    }
  }
}

verification.failed

This event will be sent when the maximum number of confirmation attempts has been reached. Once the verification has failed, no more attempts will be allowed.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "verification.failed",
  "created_at": "2023-09-23T13:18:02Z",
  "data": {
    "object": {
      "id": "vrf_6gwS6FHtPRcahLBSlsG7TW",
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "status": "failed",
      "company_reference": "Example reference",
      "metadata": {
      },
      "expired_at": "2023-09-30T13:18:02Z",
      "created_at": "2023-09-23T13:18:02Z",
      "eta": "2023-09-23T13:18:12Z",
      "attempts": 5,
      "error": null
    }
  }
}

verification.expired

This event will be sent when the verification has not been confirmed and the expiration date has been reached.

{
  "id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
  "api_version": "v1",
  "type": "verification.expired",
  "created_at": "2023-09-23T13:18:02Z",
  "data": {
    "object": {
      "id": "vrf_6gwS6FHtPRcahLBSlsG7TW",
      "third_party": {
        "name": "Ana Devenger",
        "account": {
          "identifiers": [
            {
              "type": "iban",
              "iban": "ES2914653111661392648933"
            }
          ],
          "bank": {
            "name": "ING Bank, N.V. S.E",
            "bic": "INGDESMMXXX"
          }
        }
      },
      "status": "expired",
      "company_reference": "Example reference",
      "metadata": {
      },
      "expired_at": "2023-09-30T13:18:02Z",
      "created_at": "2023-09-23T13:18:02Z",
      "eta": "2023-09-23T13:18:12Z",
      "attempts": 0,
      "error": null
    }
  }
}