Webhooks

Webhooks are in early access. Request access to try them. Until you have access, read the setup link (GET /v1/payment-cards/setup-links/{linkId}) or the transaction (sapiom_get_transaction) to check for changes. You’ll register one HTTPS endpoint with your platform key, and it will receive events for all your buyers. Each event names the buyer and the card or transaction it’s about.

Event	When
`setup_link.completed`	A buyer saved a card.
`setup_link.expired`	A setup link expired, or the buyer canceled.
`card.removed`	A card was removed.
`transaction.action_required`	The buyer needs to act, such as confirming their security code. Includes the link.
`transaction.payment_ready`	Your browser worker can finish checkout.
`transaction.payment_submitted`	The card was sent to the merchant’s payment processor.
`transaction.order_confirmed`	The merchant confirmed the order.
`transaction.order_unknown`	The order’s outcome is unknown. Reconcile it before doing anything else.
`transaction.closed`	The transaction ended without an order. Includes the reason.

Deliveries will be signed and retried, and can arrive more than once or out of order. Treat each one as a signal, and read the card or transaction for its current state.

Get started

Buyers

Cards

Transactions

Governance

Security

Early access