Skip to main content
Each event includes a type field describing what happened and a data.object containing a point-in-time snapshot of the resource. Expand an event to see the full payload your webhook endpoint receives.

Payments

A payment resource was created before approval or money movement submission. The fee is assessed when the payment is sent, so it’s always null on payment.created. Only the sender’s copy carries it. Payments that pay a payment request never carry a fee; the request fee is on paymentRequest.completed.
A payment reached the public completed state.
A payment failed during submit or money movement processing.
A completed return-capable payment was returned.
A payment was canceled before money movement processing.
A payment approval was explicitly denied before money movement processing.

Payment intents

A payment intent was paid in full by a succeeded card payment.
A payment intent was canceled: an open intent, or a hold you released.
Early access (holds). The card issuer approved a hold. Capture the payment intent before captureBefore to charge the card, or cancel it to release the hold.

Card payments

A card payment was submitted and is processing. The fee is assessed when the card is authorized, so it’s always null on cardPayment.created. Read it from cardPayment.succeeded. A charge or hold you create with mandateId on POST /payment-intents doesn’t send it. Its only card payment events are cardPayment.succeeded and cardPayment.failed.
A card payment was approved by the card network.
A card payment was declined or could not be processed.

Voice sessions

A voice session closed as ended, expired, or canceled. Sent once per session. canceled and expired can arrive a few minutes late. A paid call whose call end never arrived closes as expired with payment.outcome paid. It does not mean paid. Read payment.outcome: paid, linkSent when voice payment did not succeed and the caller was texted the payment link, or unpaid. The payment intent is the source of truth for money, and delivery order is not guaranteed.

Refunds

A refund was requested and is pending.
A refund was processed by the card network.
A refund was declined or could not be processed.

Chargebacks

A chargeback case was opened against a card payment. The fee is billed when the case opens, so it’s already on chargeback.created.
A chargeback case moved: accepted, representment submitted, acknowledged, or the response window expired.
A chargeback case closed with a result.

Enrollment

A merchant submitted an Accept application.
An Accept application was approved and the merchant can accept payments.
An Accept application was rejected.
An Accept enrollment was closed; the party is no longer a merchant.

ACH

An ACH transfer resource was created. The fee is assessed when the transfer is submitted, so it’s always null on ach.created. Read it from ach.processing.
An ACH transfer was submitted to money movement processing.
An ACH transfer settled at the receiving bank. Settlement is the resting state; a return can still arrive afterward.
An ACH transfer failed before completion.
An ACH transfer was returned or reversed.

Realtime

A realtime payment was created. The fee is assessed when the payment is submitted, so it’s always null on realtime.created. Read it from realtime.processing.
A realtime payment was accepted by money movement and is processing.
A realtime payment settled. Settled realtime transfers are irrevocable; there is no return state.
A realtime payment was rejected and failed terminally.

Wire

A domestic wire was created. The fee is assessed when the wire is submitted, so it’s always null on wire.created. Read it from wire.processing.
A domestic wire was submitted for processing.
A domestic wire settled.
The bank rejected a domestic wire before settlement.
A domestic wire failed before completion.

Checks

A check payment was created and is waiting to be issued.
A check payment was submitted to money movement and is being issued, printed, mailed, or awaiting deposit.
A check was deposited and settled; the wallet was debited.
A settled check was returned by the paying bank; the funds were restored to the wallet.
A check was canceled before submission, or a requested stop payment was confirmed.
A check was not cashed before its void date and expired; the escrow was released.
The bank rejected a check payment at issuance; details are in failure.
A check payment failed before issuance; details are in failure.
A mailed check was undeliverable and returned to sender; the check stays outstanding.

Setup intents

Early access (setup intents). A payer saved a card. relationships.mandate links the new mandate, and mandate.created fires for it.
Early access (setup intents). You canceled an open setup intent. Its link no longer saves a card.

Mandates

A payer authorized a card mandate.
A mandate expired, was superseded, or was consumed.
A mandate was revoked.

Subscriptions

Early access (subscriptions). The payer paid payment 1 in checkout, so the subscription is active.
Early access (subscriptions). A subscription’s status changed without starting or ending it, for example from active to past_due or needs_attention. data.previousStatus has the status it left.
Early access (subscriptions). A subscription was canceled. Natural starts no new charges, though a charge already under way can still go through. It also fires when a pending subscription’s checkout ends without payment 1, so it can follow no subscription.activated.
Early access (subscriptions). Every payment of a subscription in installments is paid or marked paid.

Deposits

The public deposit transfer resource became visible. API-initiated deposits emit with status “created” once they pass approval checks, before money movement submission. Deposits denied or canceled by those checks don’t emit it; deposits discovered from money movement may emit with the current status, such as “processing”. Deposits carry no fee, so fee is always null on deposit.* events.
A deposit reached the public completed state.
A deposit failed during submit or money movement processing.
An incoming deposit was returned by the bank.
A deposit was canceled before money movement processing.
A deposit approval was explicitly denied before money movement processing.

Withdrawals

A withdrawal was created and funds are being moved out of a wallet. Instant withdrawals carry a fee, assessed when the withdrawal is submitted, so it’s always null on withdrawal.created. Read it from withdrawal.completed.
A withdrawal completed successfully.
A withdrawal failed before settling.
A settled withdrawal was returned or reversed.
A withdrawal was canceled before money movement processing.
A withdrawal approval was explicitly denied before money movement processing.

Payment requests

A merchant created a payment request. The fee is assessed when the request is paid, so it’s null until paymentRequest.completed. paymentRequest.incoming, sent to the payer, never carries it.
The linked payment for a payment request completed successfully.
A merchant canceled an open payment request.
The payer declined an open payment request.
A payment request was created naming this party as the payer.

Approvals

A customer approval is required before the payment can continue.
A customer approval was approved.
A customer approval was denied.
A customer approval was canceled before completion.

Parties

A party’s information was updated.

Compliance

A party’s canonical compliance case reached a public verification outcome.

Wallets

A wallet was created for a party.

Connections

A customer connection was created.
The customer connection was ended. Fires when either party explicitly disconnects; revoking individual agents, even the last one, does not revoke the parent connection.

Agent connections

A per-agent grant was revoked.

Agent connection invitations

A developer created a per-agent invitation for a customer to accept.
A customer accepted a per-agent invitation; the per-agent grant is now active.
A customer declined a per-agent invitation.
A pending per-agent invitation was canceled.

External party accounts

An external party bank account passed validation.

External accounts

An external bank account was linked.