Skip to content

Events

The complete, immutable stream of state changes on your account.

Updated Jul 15, 2026API 2026-07-01 Edit on GitHubReport an issue

Overview

Every webhook you receive is also queryable via the Events API for 30 days. Use it to backfill, reconcile, or replay.

Event types

FieldTypeDescription
payment.succeeded
—Payment captured and settled to your wallet.
payment.failed
—Payment failed. See failure_code and failure_message.
payment.refunded
—A refund succeeded, fully or partially.
withdrawal.succeeded
—Payout arrived at the destination.
withdrawal.failed
—Payout failed. Funds returned to your wallet.
settlement.completed
—Daily batch payout completed; statement attached.
remittance.received
—Beneficiary received the funds.
compliance.case.updated
—KYC/KYB case status changed.
key.rotated
—API key rotated.

Endpoints

MethodPathDescription
GET/v1/eventsList events with filters (type, created range, livemode).
GET/v1/events/{id}Retrieve a single event with full payload.
POST/v1/events/{id}/replayRedeliver to all subscribed webhook endpoints.