Checkout success and cancel

After checkout completes the customer lands on default Zevio success/failure screens or successUrl / cancelUrl from session creation (or inherited from the offer if session does not override).

Default success

  • Green icon, Payment completed successfully title.
  • Short confirmation copy.
  • Optional button from resultPages.success (offer or session).

Default failure / cancel

  • Red icon, Payment failed title.
  • Retry encouragement message.
  • Try again - returns to same session form if still PENDING and before expiresAt.
  • When session EXPIRED or COMPLETED - button disabled; new session required from merchant API.

resultPages customization

On offer (Advanced) or session payload set custom title (120 chars), description (500), optional button (label 100 chars + HTTPS URL). Empty fields = default Zevio copy.

postMessage (iframe and popup)

Embedded checkout sends events to window.parent (iframe) and window.opener (popup). CHECKOUT_STARTED - after accept complete (sessionId, paymentId?, amount, currency, paymentMethod). CHECKOUT_SUCCESS - COMPLETED status. CHECKOUT_FAILED - CANCELLED/EXPIRED/failed. Filter event.data.type with CHECKOUT_ prefix. successUrl / cancelUrl may additionally redirect top-level window.

Hosted payment page (link/QR) uses offer result pages by default. POST /payments/{qrId} can optionally override successUrl / cancelUrl for that generated PayPage link (also overriding offer resultPages for the link). See Payment success and failure.
Checkout success and cancel | Zevio