Event Objects
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.
Account Holders
account_holder.created
This event notifies a new account holder has been created in your account.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "account_holder.created",
"created_at": "2025-05-12T14:48:40Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "created",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"legal_form": "company",
"director_email": "[email protected]",
"director_name": "Devengo Director",
"registration_id": "B88353412",
"web": "http://www.devengo.com",
"created_at": "2025-05-12T14:48:40Z",
"archived_at": null,
"metadata": {},
"address": {
"address": "Calle Barquillo",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES",
"street_number": "40"
}
}
}
}
account_holder.collecting
Devengo will generate this event when it sends the KYB (Know Your Business) form to the email provided. This process usually requires multiple checks and information requirements that Devengo will communicate to the user in a timely manner if needed.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "account_holder.collecting",
"created_at": "2025-05-12T14:48:40Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "collecting",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"legal_form": "company",
"director_email": "[email protected]",
"director_name": "Devengo Director",
"registration_id": "B88353412",
"web": "http://www.devengo.com",
"created_at": "2025-05-12T14:48:40Z",
"archived_at": null,
"metadata": {},
"address": {
"address": "Calle Barquillo",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES",
"street_number": "40"
}
}
}
}
account_holder.validating
Devengo will generate this event when the KYB process to validate this account holder starts. This process usually requires multiple checks and information requests that Devengo will communicate to the user in a timely manner.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "account_holder.validating",
"created_at": "2025-05-12T14:48:40Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "validating",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"legal_form": "company",
"director_email": "[email protected]",
"director_name": "Devengo Director",
"registration_id": "B88353412",
"web": "http://www.devengo.com",
"created_at": "2025-05-12T14:48:40Z",
"archived_at": null,
"metadata": {},
"address": {
"address": "Calle Barquillo",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES",
"street_number": "40"
}
}
}
}
account_holder.activated
Devengo will generate this event when the KYB process has been finished, and the conformity of the account holder is determined.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "account_holder.activated",
"created_at": "2025-05-12T14:48:40Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "active",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"legal_form": "company",
"director_email": "[email protected]",
"director_name": "Devengo Director",
"registration_id": "B88353412",
"web": "http://www.devengo.com",
"created_at": "2025-05-12T14:48:40Z",
"archived_at": null,
"metadata": {},
"address": {
"address": "Calle Barquillo",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES",
"street_number": "40"
}
}
}
}
account_holder.deactivated
Devengo will generate this event when an account holder has been deactivated. This may be produced for multiple reasons, and it's usually a temporary state. While the account holder is in this status, no new accounts can be opened with it, and existing accounts may undergo restrictions preventing new payments and funds movement.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "account_holder.deactivated",
"created_at": "2025-05-12T14:48:40Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "deactivated",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"legal_form": "company",
"director_email": "[email protected]",
"director_name": "Devengo Director",
"registration_id": "B88353412",
"web": "http://www.devengo.com",
"created_at": "2025-05-12T14:48:40Z",
"archived_at": null,
"metadata": {},
"address": {
"address": "Calle Barquillo",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES",
"street_number": "40"
}
}
}
}
account_holder.archived
Devengo will generate this event when the user has archived an account holder. Once an account holder has been archived, no new accounts can be opened with it.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "account_holder.archived",
"created_at": "2025-05-12T14:48:40Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "archived",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"legal_form": "company",
"director_email": "[email protected]",
"director_name": "Devengo Director",
"registration_id": "B88353412",
"web": "http://www.devengo.com",
"created_at": "2025-05-12T14:48:40Z",
"archived_at": null,
"metadata": {},
"address": {
"address": "Calle Barquillo",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES",
"street_number": "40"
}
}
}
}
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_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
account.closed
This event will be sent when an account is closed so you can't operate with it anymore.
{
"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",
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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,
"fee": null,
"processor": {
"network": "SEPA",
"scheme": "SCT-INST"
},
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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,
"fee": null,
"processor": {
"network": "SEPA",
"scheme": "SCT-INST"
},
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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,
"fee": null,
"processor": {
"network": "SEPA",
"scheme": "SCT-INST"
},
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": true,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": true,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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": null,
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": {
"name": "ING",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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.test.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": {
"name": "ING",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
Outgoing Payment Receipts
outgoing_payment_receipt.created
Devengo will generate this event when the payment receipt has been created successfully and it's already available.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "outgoing_payment_receipt.created",
"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.test.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": {
"name": "ING",
"bic": "BKBKESMMSAN"
}
}
},
"metadata": {},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
Access Verifications
access_verification.created
This event will be sent when a new access verification has been created, before it's delivered to the recipient.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "access_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,
"fee": null
}
}
}
access_verification.delivered
This event will be sent when the access verification code was delivered to the recipient.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "access_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,
"fee": null
}
}
}
access_verification.rejected
This event will be sent when the access 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": "access_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"
},
"fee": null
}
}
}
access_verification.confirmed
This event will be sent when the access verification was confirmed providing the right code.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "access_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,
"fee": null
}
}
}
access_verification.failed
This event will be sent when the maximum number of confirmation attempts has been reached. Once the access verification has failed, no more attempts will be allowed.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "access_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,
"fee": null
}
}
}
access_verification.expired
This event will be sent when the access verification has not been confirmed and the expiration date has been reached.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "access_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,
"fee": null
}
}
}
Holder Verifications
holder_verification.created
This event will be sent when a new holder verification has been created, before it's processed.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "holder_verification.created",
"created_at": "2023-09-23T13:18:02Z",
"data": {
"object": {
"id": "vrh_4b2araZSZ1TVyK8DaYzjW8",
"counterparty": {
"name": "Devengo S.L",
"taxid": "B88353412",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES3969400001150000000001"
}
],
"bank": {
"name": "Devengo S.L",
"bic": "DEVNESM2XXX"
}
}
},
"status": "created",
"created_at": "2023-09-23T13:18:02Z",
"company_reference": "Example reference",
"fee": {
"cents": 0,
"currency": "EUR"
},
"metadata": {},
"response": null,
"error": null
}
}
}
holder_verification.processed
This event will be sent when the holder verification has been processed and it’s being evaluated.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "holder_verification.processed",
"created_at": "2023-09-23T13:18:02Z",
"data": {
"object": {
"id": "vrh_4b2araZSZ1TVyK8DaYzjW8",
"counterparty": {
"name": "Devengo S.L",
"taxid": "B88353412",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES3969400001150000000001"
}
],
"bank": {
"name": "Devengo S.L",
"bic": "DEVNESM2XXX"
}
}
},
"status": "processed",
"created_at": "2023-09-23T13:18:02Z",
"company_reference": "Example reference",
"fee": {
"cents": 0,
"currency": "EUR"
},
"metadata": {},
"response": null,
"error": null
}
}
}
holder_verification.rejected
This event will be sent when the holder verification ownership can't be verified. In this case the error field will contain more information about the problem.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "holder_verification.rejected",
"created_at": "2023-09-23T13:18:02Z",
"data": {
"object": {
"id": "vrh_4b2araZSZ1TVyK8DaYzjW8",
"counterparty": {
"name": "Devengo S.L",
"taxid": "B88353412",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES3969400001150000000001"
}
],
"bank": {
"name": "Devengo S.L",
"bic": "DEVNESM2XXX"
}
}
},
"status": "rejected",
"created_at": "2023-09-23T13:18:02Z",
"company_reference": "Example reference",
"fee": {
"cents": 0,
"currency": "EUR"
},
"metadata": {},
"response": null,
"error": {
"code": "ERR-0007",
"type": "wrong_account_number",
"reason": "AC01"
}
}
}
}
holder_verification.confirmed
This event will be sent when the holder verification was confirmed with a match.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "holder_verification.confirmed",
"created_at": "2023-09-23T13:18:02Z",
"data": {
"object": {
"id": "vrh_4b2araZSZ1TVyK8DaYzjW8",
"counterparty": {
"name": "Devengo S.L",
"taxid": "B88353412",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES3969400001150000000001"
}
],
"bank": {
"name": "Devengo S.L",
"bic": "DEVNESM2XXX"
}
}
},
"status": "confirmed",
"created_at": "2023-09-23T13:18:02Z",
"company_reference": "Example reference",
"fee": {
"cents": 0,
"currency": "EUR"
},
"metadata": {},
"response": {
"code": "match"
},
"error": null
}
}
}
holder_verification.failed
This event will be sent once the holder verification has failed because there is no match in its ownership.
{
"id": "evt_6xsNY3zhwuVHqeFCKrkgTT",
"api_version": "v1",
"type": "holder_verification.failed",
"created_at": "2023-09-23T13:18:02Z",
"data": {
"object": {
"id": "vrh_4b2araZSZ1TVyK8DaYzjW8",
"counterparty": {
"name": "Devengo S.L",
"taxid": "B88353412",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES3969400001150000000001"
}
],
"bank": {
"name": "Devengo S.L",
"bic": "DEVNESM2XXX"
}
}
},
"status": "failed",
"created_at": "2023-09-23T13:18:02Z",
"company_reference": "Example reference",
"fee": {
"cents": 0,
"currency": "EUR"
},
"metadata": {},
"response": {
"code": "no_match"
},
"error": null
}
}
}
Updated 4 days ago