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.

outgoing_payment.created

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

{
  "id": "evt_6y3steMFYNJS3rZvqzUNls",
  "api_version": "v1",
  "type": "payment.created",
  "created_at": "2022-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_2togcJuFHW1Vc0T8Cb2jy3",
      "status": "pending",
      "recipient": "Ana Devenguer",
      "company_reference": "example_reference",
      "description": "March payout",
      "amount": {
        "cents": 10000,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES6621000418401234567891"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true
    }
  }
}

outgoing_payment.confirmed

This event informs you the payment has been successfully confirmed. That usually happens just a few seconds after the payment creation, but depending on what banking infrastructure must execute the payment, it may take longer (up to a few days).

{
  "id": "evt_palpNUUmYPjRNnaUynqwz",
  "api_version": "v1",
  "type": "payment.confirmed",
  "created_at": "2022-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_2togcJuFHW1Vc0T8Cb2jy3",
      "status": "confirmed",
      "recipient": "Ana Devenguer",
      "company_reference": "example_reference",
      "description": "March payout",
      "amount": {
        "cents": 10000,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES6621000418401234567891"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true
    }
  }
}

outgoing_payment.rejected

This event informs you the payment has been rejected. That may happen for different reasons, from the destination account being closed or blocked to regulatory issues or anti-money laundering flagging.

{
  "id": "evt_palpNUUmYPjRNnaUynqwz",
  "api_version": "v1",
  "type": "payment.rejected",
  "created_at": "2022-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyo_2togcJuFHW1Vc0T8Cb2jy3",
      "status": "rejected",
      "recipient": "Ana Devenguer",
      "company_reference": "example_reference",
      "description": "March payout",
      "amount": {
        "cents": 10000,
        "currency": "EUR"
      },
      "destination": {
        "iban": "ES6621000418401234567891"
      },
      "account_id": "acc_fYpgX5Ytdxzexuf61lFmw",
      "instant": true
    }
  }
}

incoming_payment.created

Devengo will generate this event when funds are received in any of your accounts due to the arrival of an external pay-in.

{
  "id": "evt_3U1dmDy86c0MNsvncFDhMG",
  "api_version": "v1",
  "type": "incoming_payment.created",
  "created_at": "2022-01-01T12:00:00Z",
  "data": {
    "object": {
      "id": "pyi_FvfNdwkak009PWsv0wDRd",
      "account_id": "acc_5fthxGFigq1GnCRme5JV54",
      "status": "confirmed",
      "description": "Transaction description",
      "amount": {
        "cents": 1200,
        "currency": "EUR"
      },
      "third_party": {
        "name": "Other Company Name",
        "account_number": {
          "iban": "ES2914653111661392648933"
        },
        "bank": {
          "name": "Banco Santander",
          "bic": "BSCHESMMXXX"
        }
      }
    }
  }
}

account.created

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

{
    "id": "evt_6wQEYkfw2j8IQnUJsnLzBQ",
    "api_version": "v1",
    "type": "account.created",
    "created_at": "2022-01-01T12:00:00Z",
    "data": {
        "object": {
            "id": "acc_fYpgX5Ytdxzexuf61lFmw",
            "status": "creating",
            "name": "Devengo 1",
            "number": null,
            "bic": "PFSSESM1XXX",
            "currency": "EUR",
            "balance": null
        }
    }
}

account.activated

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

{
    "id": "evt_2DGyfRxWAsHBGDguztHeCQ",
    "api_version": "v1",
    "type": "account.activated",
    "created_at": "2022-01-01T12:00:00Z",
    "data": {
        "object": {
            "id": "acc_fYpgX5Ytdxzexuf61lFmw",
            "status": "active",
            "name": "Devengo 1",
            "number": "ES6621000418401234567891",
            "bic": "PFSSESM1XXX",
            "currency": "EUR",
            "balance": null
        }
    }
}

account.closed

This event will be sent when an account is closed so you can't operate with it anymore.

{
    "id": "evt_3M47rXi4HsWbAfv090wJ38",
    "api_version": "v1",
    "type": "account.closed",
    "created_at": "2022-01-01T12:00:00Z",
    "data": {
        "object": {
            "id": "acc_fYpgX5Ytdxzexuf61lFmw",
            "status": "closed",
            "name": "Devengo 1",
            "number": "ES6621000418401234567891",
            "bic": "PFSSESM1XXX",
            "currency": "EUR",
            "balance": null
        }
    }
}