Skip to main content

Order and payment events

These events cover payment flows that fall outside the standard card transaction path.

Events

Event typeWhen it fires
offsite-payment-completedThe customer completed a payment on the offsite hosted form and returned to your site.

Payload

type Event = {
deduplicationId: string;
type: 'offsite-payment-completed';
organizationId: string;
metadata: object;
};

See Schemas for full type definitions.

offsite-payment-completed

Fires when a customer returns from the hosted payment form. This event signals the customer completed the form flow. It does not confirm a successful charge. Wait for the subsequent transaction-processed event to confirm the payment outcome.

This event is part of the first subscription flow for new payment instruments. See Subscription events — first subscription sequence.