When you provide valid billingAddress or email to embeddedCheckout(), the widget now hides those form sections entirely - reducing checkout steps for customers whose details you already have on file.
See the embeddedCheckout() SDK reference for full parameter details.
What changed
The billingAddress and email parameters in embeddedCheckout() now control form visibility, not just pre-fill:
| Customer detail | Behaviour |
|---|---|
Valid billingAddress | The billing address form is hidden completely. The customer skips the address step entirely. |
Invalid or incomplete billingAddress | The billing address form is shown with the pre-filled values. The customer can review and correct any fields that failed validation. |
email provided | The email field is hidden completely - whether passed in the widget configuration or contained in the order via the API. |
For the billing form to be hidden, the widget pre-validates the address. The fields countryCode, postcode, streetLine1, and city must be present and valid. streetLine2 and region are not validated by the embedded checkout.
This applies only to embeddedCheckout(). The Card Field (createCardField()) and Pop-up (payWithPopup()) widgets are unaffected.
If you already pass billingAddress or email to embeddedCheckout(), no code changes are required. The widget now hides the corresponding form sections when the data is valid, instead of showing a pre-filled form.