Webhook events

Delivery, headers, and signature verification are the same for every product and are documented once under 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}.

Build your handler to ignore unknown types; new events are added without notice.

Welcome

API basics

Ramp

Orchestration

Wallets

Agentic Payments