FrançaisTalk to us

Quickstart

Put a Terudo eSIM offer on your booking or visa confirmation page in five minutes, with the public demo key, then go live.

Goal: on the page a traveller sees after booking (or after their visa is approved), show the eSIM plan that fits their trip, with a button that takes them to Terudo's checkout. No backend change.

1. Add the script

Anywhere in the page, once:

<script src="https://terudo.com/elements/v1.js" data-key="pk_test_terudo_demo_public" data-locale="en" defer></script>

pk_test_terudo_demo_public is Terudo's public demo key: real catalogue and prices, payment links disabled. Replace it with your own pk_test_… key to test the full payment, then your pk_live_… key.

2. Place the element

Where the offer should appear, with the trip your page already knows:

<div data-terudo="booking-banner"
     data-destination="MA"
     data-start="2026-12-03"
     data-end="2026-12-09"
     data-email="[email protected]"
     data-return-url="https://www.your-agency.example/bookings/48213"></div>
  • data-destination: ISO country code (MA, JP, US) or a region (EU-35).
  • data-start, data-end: arrival and departure dates, YYYY-MM-DD.
  • data-email: optional; without it, the element asks the traveller.
  • data-return-url: where Terudo's checkout sends the traveller once paid. Kept only if its site is listed on your publishable key.

The banner shows one recommended plan sized to the trip (one buffer day for a late flight). A click opens the full trip offer, then an email field and the checkout.

3. Match your look

Elements inherit your font. Set your colour and corners:

<style>
  [data-terudo] { --tdo-color: #0a5b8a; --tdo-on: #fff; --tdo-radius: 10px; }
</style>

4. Test a payment

With your own pk_test_… key, click through: the pay page simulates the payment, the eSIM is a sandbox one, nothing is charged. With a secret test key you can follow the order through the API or webhooks.

5. Go live

  1. In the portal (Développeurs), create a pk_live_… key and list the sites that will use it (https://www.your-agency.example).
  2. Swap the key in the script tag.
  3. If you set a Content Security Policy, allow script-src https://terudo.com, connect-src https://terudo.com and img-src https://terudo.com.

Next: Elements reference, recipes for your flow.