The Preview screen is a valuable tool for validating and testing your configured payment workflows and widget customisation. It not only displays how your Master Widget will appear to end users, but also illustrates the structure of a proper ‘create intent’ API call.
Here’s how the flow works:
1. Initiate a ‘create intent’ API call to generate a unique intent_token.
2. Use this intent_token to initialise the Master Widget.
The preview screen automatically completes these steps in the background, giving you real-time feedback on both your API request format and the resulting checkout experience.
To generate an intent token in the preview screen, provide the following information:
- Payment amount
- Currency
- Version
- Optionally, select a customisation template (templates are labelled for clarity)
- Depending on the configured payment methods, additional fields such as customer.email, customer.phone, and customer.billing_address{} may be required
Required fields are marked with an asterisk (*) for easy identification.
To preview your templates, select ‘Preview’ from the Checkout page, complete the mandatory fields, and click 'Create' to see your widget in action.
If the user interacts with the Master Widget that is displayed on the right-hand side of the Preview screen, it will generate a genuine charge.