Simulator widget

The Subscriptions Simulator is a standalone React application that allows merchants to show their customers how the seQura subscription plan works. The merchant enters the products with their prices and the simulator calculates the estimated monthly fee, also showing a comparison view between one-off payment and subscription.

URLs

URL of the hosted simulator page. The iframe loads this page, which initialises the simulator using the merchant configuration fetched from the seQura API.

Iframe url

Environment	URL
Production	`https://live.sequracdn.com/assets/static/subscriptions-simulator.html`
Sandbox	`https://sandbox.sequracdn.com/assets/static/subscriptions-simulator.html`

The URL accepts the following query string parameters:

Parameter	Required	Description
`merchant`	Yes	The merchant reference in seQura, for example `my_merchant`.
`locale`	No	Locale to use, for example `es-ES` or `fr-FR`. If not provided, it is resolved from the merchant configuration.

Internal API endpoints (for reference only)

Environment	Endopoint
Production	https://instore.sequrapi.com/simulator/{merchantRef}
Sandbox	https://instore-sandbox.sequrapi.com/simulator/{merchantRef}

How to embed the simulator

Embed the simulator in your page with an iframe and pass the merchant reference in the merchant query string parameter.

<iframe
  id="sequra-subscriptions-simulator"
  src="https://live.sequracdn.com/assets/static/subscriptions-simulator.html?merchant=MY_MERCHANT"
  style="width: 100%; border: none; display: block;"
  title="seQura Subscriptions Simulator"
></iframe>

Replace MY_MERCHANT with your merchant reference in seQura.

Merchant configuration

The simulator automatically loads the merchant configuration from the seQura API using the reference passed as a parameter. This configuration determines:

The minimum number of products required (subscription_minimum_item_amount)
The markup applied to prices (subscription_mark_up)
The monthly fee range (subscription_fee_range)
The currency and default locale
The subscription plan name displayed in the simulator (plan_name)

If the configuration fails to load because the merchant is not found or because of a network error, the simulator displays an error message.