> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onstacks.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook events

> Events the Ramp product emits to your webhook.

Delivery, headers, and signature verification are the same for every product and are documented once under [Webhooks](/basics/webhooks). This page lists Ramp event names.

| Event | Delivered today | Meaning |
| - | - | - |
| `webhook.test` | Yes | Sent by the **Test** action so you can verify your endpoint. |
| `ramp.payment.pending` | Yes | Payment created. |
| `ramp.payment.processing` | Yes | Provider accepted and is settling. |
| `ramp.payment.requires_action` | Yes | Payer or customer input needed. |
| `ramp.payment.succeeded` | Yes | Delivered. |
| `ramp.payment.failed` | Yes | Settlement failed. |
| `ramp.payment.cancelled` | Yes | Cancelled before settlement. |
| `ramp.payment.expired` | Yes | Not funded in time. |
| `ramp.virtual_account.credited` | Yes | A transfer landed in a virtual account; a payment with `direction: on_ramp` was created. |

The `data` object of a `ramp.payment.*` event is the payment as returned by `GET /v1/ramp/payments/{reference}`.

<Note>
  Build your handler to ignore unknown types; new events are added without notice.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.