Sell travel eSIMs with the ChoEsim Partner API

Buy travel eSIMs for your own customers at wholesale prices and receive the activation details (LPA code) in the API response. Pay from a prepaid USD wallet. No per-order card payments, no end-customer data exchanged.

Apply now Read the quick start Partner terms OpenAPI file

What you get

• A JSON REST API (/partner/v1) with an OpenAPI 3.1 file you can import into your tools.
• Wholesale prices for every plan you are allowed to sell, returned by the API. The price list is not public.
• Orders that are safe to retry: every order needs an Idempotency-Key and your own reference, so a timeout never creates a second eSIM.
• Delivery in the response: when the order is fulfilled you get the eSIM activation data (ICCID and LPA string) for your own customer. ChoEsim never e-mails your customers.
• Cancel an unused eSIM within the cancellation window (14 days by default) and the price is credited back to your wallet.
• Signed webhooks (Standard Webhooks) for order and eSIM events, with automatic retries, plus a pull endpoint for events you missed.
• A full sandbox with test keys, a separate test wallet and magic plan ids that simulate success, delay, failure and price changes. Nothing real is bought.

How it works

1. Apply online. Apply now: sign in with a verified email address, tell us about your business and tick the partner terms. There is nothing to sign and no one to wait for. If you prefer, write to support@choesim.com with the subject "Partner API".
2. Get your keys. Your account opens straight away, with a test wallet and your limits (largest order, daily spend, open orders). Sign in to the partner portal and create a test key yourself.
3. Test. Build and test against the sandbox; it needs no money.
4. Fund the balance. Pay by card on the portal through OnePay and choose the amount yourself; the card is charged in Vietnamese dong at the ChoEsim system exchange rate with no margin, and the balance is credited when the payment is confirmed. The first top-up is at least USD 50 and later top-ups at least USD 25.
5. Go live. Once the first top-up is credited, create a live key in the portal. Orders are paid from the wallet.

Good to know

• v1 sells fixed-data plans. Pay-per-day plans are not available through the API yet.
• One level only: partners may sell to end customers directly, but may not resell eSIMs to other resellers.
• Coverage, speed and device compatibility follow the underlying network operators and are not guaranteed by ChoEsim or by you. See the terms for the exact wording.
• We answer on business days, Vietnam time (GMT+7), by e-mail. There is no uptime guarantee in v1; the changelog tells you what changes and when.

Documentation

• Quick start: your first sandbox order in about ten minutes.
• API guide: authentication, errors, idempotency, orders, cancellation, wallet, webhooks.
• Sandbox guide: test keys and magic plan ids.
• Partner FAQ
• Changelog

Content creators and bloggers who want to earn a commission without writing code: see the affiliate programme.