ChoEsim Partner API Terms
Version 1.0, effective 2026-11-06. Also available in Vietnamese. See also the Partner API overview and the API guide.
These Terms apply between TECHWAY JOINT STOCK COMPANY ("ChoEsim", "we", "us"), operator of choesim.com, and the business that accepts them ("Partner", "you"). Our company registration details and registered address are stated in the acceptance email we send you. Contact: support@choesim.com, subject "Partner API".
1. Definitions
1.1. API means the /partner/v1 programming interface with its documentation and OpenAPI file. Sandbox means the test environment: it creates no real orders, contacts no supplier and charges nothing.
1.2. API Key means a secret credential we issue to you. A live key places real orders; a test key works only in the Sandbox.
1.3. Prepaid Balance means the amount you have paid to ChoEsim in advance to buy ChoEsim eSIMs (section 7). The API and its documentation may call it the "wallet" (/wallet, balance); the meaning is the same.
1.4. Wholesale Price means the price we apply to you when an Order is placed (section 6). Order means a request to buy one or more eSIMs through the API.
1.5. eSIM means a prepaid travel data plan. LPA means the activation string used to install it. The LPA is a secret: anyone who holds it can install the eSIM.
1.6. End Customer means a person who installs and uses an eSIM that you sold. Supplier means the third party whose infrastructure ChoEsim uses to issue eSIMs.
1.7. Business Day means Monday to Friday in Vietnam time (ICT, UTC+7), excluding Vietnamese public holidays. Day in the context of daily limits means a calendar day in UTC, as in the API documentation.
1.8. Sub-reseller means anyone who buys eSIMs or API access from you in order to resell or redistribute them, or a marketplace where others list them for resale.
1.9. Acceptance Email means the email in which we accept you as a Partner. It states your legal details, limits, cancellation window and any agreed invoicing method.
2. Acceptance and eligibility
2.1. These Terms govern your purchase of eSIMs from ChoEsim through the API for sale to your own End Customers.
2.2. The API is open only to businesses we accept, either in writing by email or through the online application after an automatic screening. We may decline, suspend or close an application or account without detailed reasons.
2.3. You confirm that you are a lawfully operating business with authority to accept these Terms, that the information you give us (legal name, tax ID, address, contacts, beneficial owners) is accurate and kept up to date, and that you will tell us promptly when it changes.
2.4. You agree to provide the documents and information that ChoEsim reasonably requests to verify identity, beneficial owners and source of funds (section 16), and you agree that ChoEsim may screen you against sanctions lists.
2.5. You accept these Terms by ticking the acceptance box in the online application, or by replying to the Acceptance Email and quoting the version number. For an online application we record the version, the date and time, your verified email address and a hashed form of your IP address; the welcome email we send then serves as the Acceptance Email. For a reply by email we record the date, the sender address and the version.
2.6. The relationship is independent and non-exclusive. You are not our employee, agent or joint venturer and cannot bind ChoEsim or the Supplier. We may work with other Partners and you may buy from other sources.
3. API access and keys
3.1. We create your account and issue keys. A key is shown once; we store only a hash and cannot recover it. If you lose a key, we issue a new one.
3.2. Keep keys secret. Do not put them in browsers or mobile apps, public repositories, logs, emails, screenshots or chat. Call the API only from your servers.
3.3. Keys are issued to you only. Do not share, sell, rent or re-issue a key to anyone else, including affiliated companies, unless we agree in writing.
3.4. Each key carries the minimum scopes needed. We may enable or disable scopes, apply an IP allowlist and set an expiry date.
3.5. Key rotation: you may hold two active keys. When a key is replaced, the old key keeps working for 7 days and then stops.
3.6. Tell us immediately if you know or suspect that a key has leaked. If we receive your report before 16:00 ICT on a Business Day, we revoke the key the same Business Day. We may revoke a key at once on signs of leak, abuse or breach.
3.7. You are responsible for all actions taken with your keys, unless you prove that the fault was ChoEsim's.
4. Permitted use
4.1. You may view the catalogue and your Wholesale Prices, place Orders from your Prepaid Balance to sell eSIMs to your own End Customers, check the status and usage of your Orders, cancel unused eSIMs under section 10, and receive webhooks about your Orders and balance.
4.2. You set your own retail prices. ChoEsim does not publish a suggested retail price and does not restrict your resale price.
4.3. The Sandbox is free for integration and testing. Its prices, catalogue and timings are simulated and must not be quoted to End Customers.
4.4. You bear your own integration, operations, End Customer support and End Customer payment costs.
5. Restrictions and supplier dependency
5.1. No data resale. You may supply an eSIM to an End Customer. You may not otherwise redistribute or commercially exploit data capacity, for example by reselling unused capacity or splitting one eSIM among several people.
5.2. No Sub-resellers. You may not resell eSIMs to other resellers, give anyone API access, or list eSIMs on an open marketplace for others to resell. The programme has one level only.
5.3. No abnormal use. You may not sell or promote eSIMs for routers, USB dongles, IoT devices or fixed hotspots. Whether tethering is allowed depends on the plan; describe it only as ChoEsim tells you in writing.
5.4. We may stop selling a plan or country, limit quantities or refuse an Order, and we do not guarantee that a plan stays in the catalogue.
5.5. Not guaranteed. Coverage, speed, networks and device compatibility are described in the API by plan. ChoEsim gives no guarantee about them beyond those descriptions.
5.6. No naming of the Supplier. You may not name the Supplier or use its trademarks in public content.
5.7. You understand and agree that ChoEsim depends on its eSIM infrastructure Supplier. If the Supplier changes prices, restricts, suspends or terminates supply, ChoEsim may adjust the service to you accordingly under clause 21.4 and is not liable for indirect loss arising from it.
5.8. You comply with all laws that apply to your business, including sales, consumer protection, advertising, tax, personal data, sanctions and anti-money-laundering law.
6. Wholesale prices
6.1. Wholesale Prices are shown only through the API, in USD, and exclude VAT and other taxes. Prices from GET /plans are current and may be cached for up to 5 minutes. We never expose our cost price.
6.2. The price is fixed when ChoEsim accepts the Order. A quote is indicative. If you send expected_total_minor and the price has changed, the API returns 409 price_changed and does not charge your Prepaid Balance. Accepted Orders are never repriced.
6.3. We may change Wholesale Prices, discount rules and the catalogue by giving at least 14 days' notice by email. A change applies only to Orders placed after its effective date. Orders already placed keep their price.
6.4. If the Supplier gives us shorter notice of a price increase, we may apply an increase on shorter notice, but never less than 72 hours. A shorter period applies to increases only.
6.5. If you do not accept a price change, you may terminate under clause 21.2 and receive a refund of your Prepaid Balance under clause 7.8.
6.6. You are responsible for your own retail prices and for any discounts you give End Customers. Promo codes and referral commission do not apply to API Orders.
7. Prepaid balance
7.1. Prepaid, no credit. You top up before ordering. We extend no credit. The balance never goes negative; an Order above your balance is rejected (402 insufficient_balance).
7.2. Nature of the balance. The Prepaid Balance is an advance payment by you for eSIMs sold by ChoEsim. It is not a payment account, an e-wallet or a bank account. It earns no interest. It may not be assigned, transferred to another person, used to pay a third party or converted into cash.
7.3. Top-ups are made by card payment through the OnePay payment gateway, in Vietnamese dong, for the amount you choose in the partner portal, or, where we agree, by bank transfer from a bank account in your name to the account we give you. We credit the balance when the payment is confirmed or the funds arrive. PayPal top-ups are not accepted. We may refuse, hold or return funds that cannot be matched to you or that do not come from an account in your name.
7.4. Amounts. The first top-up is at least USD 50 and each later top-up at least USD 25. The balance may not exceed 3 times your daily spend limit; we may refuse or return any excess.
7.5. Fees. ChoEsim bears the payment gateway fees of card top-ups. For a bank transfer you bear the sender-side and intermediary bank fees, and the credited amount is what ChoEsim actually receives.
7.6. Currency. The balance is recorded in USD. A Partner established in Vietnam pays top-ups and receives invoices in Vietnamese dong. The balance is credited in USD at the ChoEsim system exchange rate at the time ChoEsim receives the funds, with no margin added, and the rate appears in the statement. ChoEsim bears the exchange difference.
7.7. Statement. You can view your balance and entries (top-up, Order charge, refund, adjustment) through the API. Entries are append-only. Report a discrepancy within 30 days of the entry appearing; after that the statement is treated as correct, except in case of fraud or obvious error. ChoEsim keeps balance statements, invoices and related records for the period required by accounting and tax law, including after you terminate; this does not conflict with the deletion of operational data under clause 15.4.
7.8. Refund of unused balance. On termination, or on your written request, ChoEsim refunds the unused balance, after deducting transfer fees and amounts you owe us, only to the card or bank account used for the top-up and held in your name (a card refund is made through the payment gateway). A refund to a Partner established in Vietnam is converted at the rate applied to the corresponding top-up, oldest top-up first, and never exceeds the amount you actually paid for the remaining portion. ChoEsim may delay a refund for up to 30 days to verify suspected fraud or breach of law, unless an authority requires otherwise.
7.9. Idle balance. If the balance has no activity for 12 months, we notify you and you choose to take a refund or keep the balance. We do not forfeit idle balances.
7.10. Freeze. We may freeze the balance (no debits) on a reconciliation mismatch, suspected fraud, a leaked key, a reversed top-up or a legal requirement. A frozen balance still accepts top-ups and valid refunds.
7.11. Reversed top-ups. If a bank reverses a top-up after we credited it, we may reverse the credit, freeze the balance and claim the shortfall from you.
7.12. Your Prepaid Balance is ChoEsim's obligation to deliver eSIMs or refund under this section. It is separate from any balance ChoEsim holds with the Supplier.
8. Orders
8.1. Idempotency-Key is required on POST /orders and POST /orders/{id}/cancel, so that you can retry safely after a network error. The same key with the same body returns the original result; the same key with a different body is rejected.
8.2. reference is required and unique per Partner and environment. A duplicate is rejected and returns the existing Order.
8.3. Each Order may contain at most 30 eSIMs, 10 per line and 10 lines. Only plans in the API catalogue can be ordered. Daily plans are not available in version 1.
8.4. Your balance is charged when we accept the Order, before delivery. Before charging, we may reject an Order for supply limits, system protection or maintenance, returning 503 with Retry-After. A rejection before charging costs you nothing.
8.5. Unknown outcome. If the purchase with the Supplier is in an unclear state (timeout, network error), the Order stays processing and the balance stays charged until we confirm the result. Do not re-order with a new reference. We investigate and credit your balance if we establish that nothing was purchased. The status of an Order is always available from GET /orders/{id}.
9. Delivery
9.1. We return the LPA through GET /orders/{id} (and in the create response if the Order completes within the synchronous wait). ChoEsim sends no email, LPA or invoice to your End Customers. You deliver the LPA to your End Customer.
9.2. Protect the LPA as a secret: do not log it, send it over insecure channels or put it in URLs. You generate QR codes yourself.
9.3. We do not promise a delivery time. Track the Order with GET /orders/{id} or webhooks. Webhooks can be duplicated, delayed or out of order; GET /orders/{id} is the source of truth.
9.4. Usage, remaining data and expiry data come from the Supplier and may be delayed or unavailable.
10. Cancellation and refunds
10.1. Unused eSIMs. You may cancel a whole Order if every eSIM in it is unused and the cancel request arrives within the cancellation window. The default window is 14 days from the Order date and is set per Partner in the Acceptance Email. A cancelled Order is credited to your Prepaid Balance in full, once. Partial cancellation is not available.
10.2. Installed or used eSIMs cannot be cancelled or refunded (409 esim_not_cancellable).
10.3. Partial failure. If some eSIMs cancel and some do not, we review the Order manually and credit the eligible part once confirmed.
10.4. Technical faults. If an eSIM cannot be delivered or used because of a fault on ChoEsim's or the Supplier's side, tell us within 30 days of the Order date. We handle each case individually and, where the fault is on ChoEsim's or the Supplier's side, we credit the affected part to your balance at our discretion.
10.5. No refund where the End Customer changes their mind after installing or using the eSIM, the device is incompatible, the wrong destination or plan was chosen, or the eSIM was used in breach of section 5.
10.6. Refunds to your End Customers are your responsibility. Tell End Customers to check device compatibility and destination before buying.
10.7. If we refund or suffer a loss because of your breach (for example a fraudulent Order), we may deduct it from your balance or claim the shortfall.
10.8. These rules apply to Partner Orders only. Retail purchases on choesim.com follow the Terms of Use and the Refund Policy.
11. Limits
11.1. We set per-Partner limits for the maximum value of an Order, spend per Day, open Orders and cancellations per Day. They are stated in the Acceptance Email and returned by GET /me.
11.2. We may lower limits for risk reasons by notifying you, and immediately where we suspect abuse. We may raise limits on request after review.
11.3. Rate limits apply per key and are returned in the X-RateLimit-* headers; exceeding them returns 429 with Retry-After. Retry with exponential backoff and, for POST /orders, always reuse the same Idempotency-Key.
11.4. You may not use multiple keys, accounts or IP addresses to evade limits, split Orders to avoid caps, scrape the catalogue or probe prices by constant polling. Cache the catalogue for at least 5 minutes.
12. Your customers
12.1. You are fully responsible for your relationship with End Customers: the sale contract, price, payment, invoicing, support, refunds and complaints. ChoEsim has no contract with your End Customers and does not support them.
12.2. Give End Customers clear sale terms, including validity, data allowance, activation conditions, your cancellation and refund terms and the usage restrictions in section 5.
12.3. Do not promise or advertise coverage, speed, networks, "unlimited", "instant", device compatibility or tethering beyond the plan descriptions ChoEsim gives in the API documentation, and quote those descriptions accurately. Do not make "cheapest" claims.
12.4. Screen your own End Customer payments for fraud. Do not sell eSIMs paid for with stolen funds or sell to sanctioned parties.
13. Acceptable use and compliance
13.1. You must not use the API or sell eSIMs for fraud, money laundering, spam, harassment, or any unlawful activity, or in a way that harms ChoEsim, the Supplier or other users.
13.2. You must not attempt to access data that is not yours, bypass security or limits, disrupt the service, decompile or copy the API, or build a competing service by republishing the catalogue and Wholesale Prices.
13.3. You must not use stolen payment instruments, place Orders you intend to cancel for profit, or top up and then request a refund without buying (clause 16.5).
13.4. We may review activity on your account for fraud and abuse. You will answer our reasonable questions promptly.
13.5. On a breach or suspected breach we may take the steps in section 21, including reducing limits, freezing the balance, suspending keys and recovering losses under clause 10.7.
14. Taxes and invoices
14.1. Each party bears its own taxes. Wholesale Prices exclude VAT; we add tax as required at the time of invoicing.
14.2. A top-up is an advance payment, not ChoEsim's revenue, until it is deducted for an Order. We issue an e-invoice when a top-up is credited, unless we agree with you in writing on monthly invoicing for the portion consumed. Invoices are adjusted on refund.
14.3. For a Partner established in Vietnam, top-ups and invoices are in Vietnamese dong, converted as set out in clause 7.6.
14.4. For a Partner established outside Vietnam, VAT is 0% only where the legal conditions for exported services are met: a written contract, payment by bank transfer from the Partner's bank account, and consumption of the service outside Vietnam. Otherwise Vietnamese VAT applies, and packages that cover Vietnam may be subject to standard VAT. Invoices are in USD.
14.5. Give us your correct legal name, tax code, address and invoice email. You bear the consequences of incorrect information.
14.6. API Orders do not generate invoices to End Customers.
15. Data protection
15.1. Each party complies with personal data protection law for the data it processes, and each acts as an independent controller of the data it decides how to use.
15.2. You must not place personal information of End Customers (such as name, email, phone number or ID) in customer_reference or any other API field. customer_reference must be an opaque code you choose. If you include personal data anyway, you are responsible for its legal basis and ChoEsim may delete it.
15.3. For customer_reference, order data, ICCID and activation codes, ChoEsim processes data on your instructions to fulfil Orders, and for reconciliation, fraud prevention, accounting and legal compliance. ChoEsim does not use customer_reference for marketing.
15.4. Activation codes (LPA) are deleted 90 days after the installation window ends. Order records and customer_reference are kept for 12 months, unless the law requires a longer period.
15.5. A party that discovers a security incident affecting the other party's API keys or data notifies the other party within 24 hours and cooperates on remediation.
15.6. You are responsible under data protection law for End Customer data that you collect yourself, including privacy notices and data subject rights. See also our Privacy Policy.
16. KYC and sanctions
16.1. Before and during the relationship we may ask for your business registration, tax ID, the name and title of your representative, beneficial owners, and the website or app where you will sell.
16.2. The Partner agrees to provide the documents and information ChoEsim reasonably requests to verify identity, beneficial owners and source of funds, and agrees that ChoEsim may screen against sanctions lists of the United Nations, the United States, the European Union and the United Kingdom.
16.3. The Partner warrants that it, its representatives and its beneficial owners are not listed on those lists and are not established or resident in a comprehensively sanctioned territory. We do not accept Partners from such territories.
16.4. Top-ups must come from a bank account in the Partner's name. ChoEsim may refuse, freeze or return any funds that do not meet this condition.
16.5. We may ask about the source of funds and purpose when a single top-up reaches USD 1,000 or top-ups in a month reach USD 3,000. If you top up and ask for a refund without buying, we may hold the funds for 30 days before refunding.
16.6. We may re-screen at onboarding, when your information changes, and periodically. We may refuse, freeze or return transactions to comply with the law.
17. Intellectual property and brand
17.1. ChoEsim keeps all rights in the API, documentation, code, trademarks and content. You receive a non-exclusive, non-transferable, revocable right to use the API during the term. You keep your own brand and content.
17.2. You may use the ChoEsim name and logo only as set out in ChoEsim's written brand guidelines, for example to state the source of your eSIMs. Do not use them in a way that suggests an official ChoEsim product, and do not register domains or account names that contain "ChoEsim".
17.3. You must not bid on advertising keywords containing "ChoEsim" or its variants.
17.4. Co-branding or white-label use needs a separate written agreement. You may say that you are a ChoEsim partner only with our written consent, and you must not imply that ChoEsim guarantees your products or services.
17.5. We may use your feedback on the API without payment or credit.
18. Service and support
18.1. The API is provided "as is". We aim for continuous operation but give no uptime, latency or delivery-time guarantee in version 1, and offer no service credits.
18.2. We depend on the Supplier, whose faults or outages can delay, fail or reject Orders. We will email you about major incidents when we know of them.
18.3. Support is by email at support@choesim.com, subject "Partner API", on Business Days. We aim to reply within 2 Business Days; this is a target, not a commitment. Include the request_id, order_id or reference, the time and a description. Never send API keys or LPAs by email.
18.4. The Sandbox carries no commitments.
19. Changes and deprecation
19.1. The API is versioned in the path (/partner/v1). Backwards-compatible changes, such as new fields or endpoints, may happen at any time; ignore fields you do not recognise.
19.2. We give at least 6 months' notice before retiring an API version or making a breaking change, by email to your contact address and by Deprecation and Sunset headers. We may act sooner for urgent security, legal or abuse reasons, and will notify you as soon as possible.
19.3. We may amend these Terms by giving 30 days' notice by email, or less where the law or the Supplier requires. If you continue to use the API after the effective date, you accept the change; if you disagree, you may terminate under clause 21.2.
19.4. Notices go to your registered contact email. Keep it working and up to date.
20. Confidentiality
20.1. Confidential Information includes API keys, LPAs, your limits and discount terms, the commercial terms between us, unpublished technical documentation, and each party's financial information.
20.2. The recipient uses Confidential Information only to perform this agreement, protects it with at least the care it gives its own, and discloses it only to employees and advisers who need to know and are bound by equivalent duties, or as required by law.
20.3. This does not apply to information that is public without breach, lawfully known before, independently developed, or required by law or a competent authority to be disclosed.
20.4. Confidentiality lasts 3 years after termination, and without limit for keys and LPAs.
21. Suspension and termination
21.1. Suspension. We may suspend your keys, scopes, limits or balance at once if a key may have leaked, you breach these Terms, we suspect fraud or an unclear source of funds, reconciliation does not match, an authority or the Supplier requires it, or there is a security risk. We notify you within 1 Business Day.
21.2. Termination for convenience. Either party may terminate on 30 days' written notice. You may terminate with immediate effect if you do not accept a change under clauses 6.3, 6.4 or 19.3.
21.3. Termination for breach. Either party may terminate if the other fails to cure a breach within 10 Business Days of notice, or immediately for an incurable breach such as fraud, a deliberate key leak, a sanctions breach or a breach of clauses 5.1 to 5.3.
21.4. Supplier events. If the Supplier ends, suspends, restricts or changes its service to ChoEsim, we may restrict, suspend or end the service to you immediately. We will try to warn you early and will refund your unused balance within 30 days under clause 7.8.
21.5. Effects. Keys are revoked. Valid accepted and delivered Orders stand; Orders in progress are completed or credited under clauses 8.5 and 10. Unused balance is refunded under clause 7.8. Accrued rights and sections 7.7, 15, 17, 20, 22 and 23 survive. eSIMs already delivered keep working for the plan's validity unless the Supplier revokes them.
22. Liability
22.1. ChoEsim's total liability to the Partner arising out of or in connection with these Terms, for all claims relating to the same event, will not exceed the amount the Partner paid to ChoEsim in the 3 months immediately preceding that event, and will not exceed the value of the affected Orders. This limit does not apply to loss caused by ChoEsim's wilful misconduct or fraud, or where the law does not permit such limitation.
22.2. We are not liable for indirect loss, lost profit, lost goodwill, data loss, loss caused by Supplier price changes, outages or faults, force majeure, or your breach.
22.3. You indemnify ChoEsim for reasonable loss and costs arising from third-party claims caused by your breach of these Terms, your advertising or statements to End Customers, or your breach of law.
22.4. Each party must take reasonable steps to limit its loss.
23. Governing law and disputes
23.1. These Terms are governed by the laws of Vietnam.
23.2. Disputes are first negotiated for 30 days after one party gives written notice of the dispute. If unresolved: (a) for a Partner established in Vietnam, by the competent court at ChoEsim's registered seat; (b) for a Partner established outside Vietnam, by the Vietnam International Arbitration Centre (VIAC) under its Rules of Arbitration, with one arbitrator, in English.
24. General
24.1. Language. These Terms exist in English and Vietnamese. The English version prevails for Partners established outside Vietnam; the Vietnamese version prevails for Partners established in Vietnam.
24.2. Entire agreement. These Terms, the Acceptance Email (or, for an online application, the application you submitted and the limits shown in your portal) and the API documentation form the whole agreement. If they conflict, the Acceptance Email prevails for your limits and commercial details, then these Terms, then the documentation.
24.3. You may not assign your rights or obligations without our written consent. We may assign to a successor to the business.
24.4. Neither party is liable for delay or failure caused by events beyond reasonable control, including Supplier outages and failures of networks and infrastructure providers.
24.5. If a provision is invalid, the rest remains in force. Not exercising a right is not a waiver of it.
24.6. Notices are sent by email to each party's registered address and take effect when sent.
24.7. Questions about these Terms: support@choesim.com, subject "Partner API". The referral programme for content creators has separate terms.