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": "2024-04-17T11:15:36Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "created",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"created_at": "2024-04-17T11:15:36Z",
"archived_at": null,
"metadata": {
},
"address": {
"address": "Calle Barquillo, 40",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES"
}
}
}
}
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": "2024-04-17T11:15:36Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "validating",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"created_at": "2024-04-17T11:15:36Z",
"archived_at": null,
"metadata": {
},
"address": {
"address": "Calle Barquillo, 40",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES"
}
}
}
}
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": "2024-04-17T11:15:36Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "active",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"created_at": "2024-04-17T11:15:36Z",
"archived_at": null,
"metadata": {
},
"address": {
"address": "Calle Barquillo, 40",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES"
}
}
}
}
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": "2024-04-17T11:15:37Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "deactivated",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"created_at": "2024-04-17T11:15:37Z",
"archived_at": null,
"metadata": {
},
"address": {
"address": "Calle Barquillo, 40",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES"
}
}
}
}
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": "2024-04-17T11:15:37Z",
"data": {
"object": {
"id": "ach_2DEDf41T7CND0cA4SxnoBY",
"slug": "devengo",
"status": "archived",
"legal_name": "Devengo",
"taxid": "B88353412",
"commercial_name": "Devengo S.L",
"company_reference": "Example reference",
"created_at": "2024-04-17T11:15:37Z",
"archived_at": "2024-04-17T11:15:37Z",
"metadata": {
},
"address": {
"address": "Calle Barquillo, 40",
"postal_code": "28004",
"city": "Madrid",
"province": "Madrid",
"country": "ES"
}
}
}
}
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": 12000,
"currency": "EUR"
},
"available": {
"cents": 12000,
"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": 12000,
"currency": "EUR"
},
"available": {
"cents": 12000,
"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": 12000,
"currency": "EUR"
},
"available": {
"cents": 12000,
"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": 12000,
"currency": "EUR"
},
"available": {
"cents": 12000,
"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": 12000,
"currency": "EUR"
},
"available": {
"cents": 12000,
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": {
"receipt": "http://api.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"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": null
}
},
"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.development.devengo.com/v1/payments/pyo_7C0jYxcbxjG1LIq2UQ52E9/receipt"
},
"third_party": {
"name": "Ana Devenger",
"account": {
"identifiers": [
{
"type": "iban",
"iban": "ES2914653111661392648933"
}
],
"bank": null
}
},
"metadata": {
},
"retried": false,
"internal": false,
"fee": null,
"account_holder_id": "ach_2DEDf41T7CND0cA4SxnoBY"
}
}
}
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,
"fee": 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,
"fee": 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"
},
"fee": null
}
}
}
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,
"fee": 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,
"fee": 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,
"fee": null
}
}
}
Updated 8 days ago