Integration
Lifecycle events
Listen for checkout state and redirect requests.
Event names
The embedded checkout posts events from the iframe to the host page. The script forwards those events to your callback and dispatches CustomEvent instances on window.
| Event | Use it for |
|---|---|
makepay.ready | Confirm the iframe checkout is loaded. |
makepay.close_requested | Close the modal when the checkout asks to exit. |
makepay.payment.status | Track payment session status changes. |
makepay.payment.redirect_requested | Navigate the host page to the resolved return URL. |
Payload shape
Event payloads include paymentUid, sessionId, status, redirectUrl, returnUrl, successUrl, failureUrl, and expiresAt.