HolidaySG has opened HolidaySG eSIM to partners. A travel business can list countries, regions and plans, order an eSIM from its wallet, hand the install details to a traveller, check data usage and top up, either through the Partner API or in the B2B portal. Every order carries a partner reference, so a lost answer can be retried without paying twice.
What partners can sell
HolidaySG eSIM covers country and regional data plans. A partner browses countries and regions, lists plans for exactly one of them and reads one plan in detail. A catalogue version call tells an integration when its cached plans may be out of date. The price on a plan is the partner price in Singapore dollars, and a suggested retail price is shown for reference, so partners decide their own selling price.
eSIM is switched on per partner and is paid from the wallet only. Sub-agent accounts cannot use it, and an order is always one eSIM.
Ordering without paying twice
Every order needs a partner reference of your own, unique across your orders and top-ups. The wallet is debited first, and only then is the eSIM issued. If an answer is lost to a timeout or a server error, repeat the call with the same reference: you receive the original order, marked as replayed, and are not charged again. The same reference for a different plan is refused.
A typical live order runs as follows.
- Fund the wallet and list the plans for the traveller's country or region.
- Post an order with a new partner reference and, if you wish, the price you expect. If the price has moved since you looked, the order is refused with nothing charged.
- Wait for the ready event, or poll the order until its status is completed. Payment shows as paid, checking or not charged.
- Give the traveller the install details.
Install details and usage
Once issued, an eSIM record carries its ICCID, the manual activation code, a link to a QR image on holidaysg.com, one-tap install links for iPhone and Android, an install-by date and an expiry. The activation code and the QR link should be treated like a password, because anyone holding them can install the eSIM. The links are HolidaySG addresses and do not point to any third party.
Usage is available per eSIM and refreshes every two to three hours, and unlimited plans are tracked by status. Statuses run from processing and ready through installed and active to used up, expired or cancelled.
Top-ups and cancellation
A partner can list the top-up packs available for an eSIM and order one with its own partner reference, under the same replay rules. A top-up must use the same kind of key, sandbox or live, as the eSIM it extends.
Cancellation is a request. Only an unused eSIM can be cancelled; an installed, used or expired one cannot. HolidaySG reviews the request and credits the wallet only after approval, so a refund is never automatic. Plans that include a phone number are different: they need the partner to accept the plan's terms with the order and cannot be topped up or cancelled.
Webhooks that tell you what happened
Up to five HTTPS endpoints can be registered, and each address must be reachable on the public internet. The signing secret is shown once and can be rotated, and a test event can be sent on demand. Events cover the whole life of an eSIM: ready, installed, active, low data, expiring, expired, cancelled and top-up completed.
Each delivery is signed with a timestamp and an HMAC, sent from a queue, usually within a minute, with an eight-second timeout. Redirects are not followed. A failed delivery is retried up to five times, so the same event can arrive twice and should be de-duplicated. An endpoint that fails ten deliveries in a row is switched off. Polling the order remains the source of truth.
Statements and the B2B portal
A monthly statement lists the orders paid in a month, in Singapore time, with sandbox and live orders kept apart. Teams that prefer a screen can order from the eSIM menu in the B2B portal. Portal orders use the same wallet and rules, appear in the API lists and statements marked as portal orders, and show the install links, a ready-to-copy text for the customer, data usage and a request-cancellation button. The portal does not offer top-ups, and eSIM access in the portal is a feature HolidaySG switches on for the company, then extends to staff members with the eSIM permission.
A sandbox that simulates the whole flow
A sandbox key can order and top up as a simulation. HolidaySG answers it directly without involving a supplier, so nothing is charged, no wallet is debited and no real eSIM is made. The test eSIM has an ICCID that starts with 89000SIM, an install address that cannot be installed and no QR image. Usage, the top-up list, top-ups and cancellation work with fixed test figures, and the ready and top-up events are sent so that an endpoint can be tested. Plans with a phone number are not simulated. To test a real order, use a live key and the smallest plan.
Frequently asked questions
What happens if my order request times out?
Retry with the same partner reference. You get the original order back and the wallet is not charged twice.
Can I protect myself from a price change?
Yes. Send the price you expect with the order. If the price has moved, the order is refused and nothing is charged.
Is the QR link safe to share?
It is a HolidaySG address. Treat it, and the activation code, like a password, because whoever holds them can install the eSIM.
Can an installed eSIM be cancelled?
No. Only an unused eSIM can be cancelled, and the wallet is credited only after HolidaySG approves the request.
Why did my webhook stop?
An endpoint is switched off after ten failed deliveries in a row. Fix it, then re-register or test it again.
Can a sandbox key order an eSIM with a phone number?
No. Those plans are not simulated; use a live key for them.
Can I order in the B2B portal instead?
Yes, once eSIM is switched on for your company. Portal orders appear in the same lists and statements.
About HolidaySG
HolidaySG.com is a Singapore travel platform for attractions and tours, visas, hotels, ferry tickets and eSIM plans, with a B2B portal and Partner API for travel businesses.
Media enquiries: contact us.