=== RoamGo eSIM for WooCommerce ===
Contributors: roamgo
Tags: esim, travel, mobile data, reseller, woocommerce
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sell travel eSIMs in your WooCommerce shop. Import RoamGo plans, set your prices, and every eSIM is delivered automatically under your brand.

== Description ==

Add travel eSIMs to your shop in minutes. Your customers buy mobile data for their trip like any other product, and receive their eSIM by email and on their order page right after payment, from your shop and in your shop's name.

You are the seller: you choose which plans to offer and what to charge. Each order is paid from your prepaid RoamGo reseller credit at your reseller price, and RoamGo issues the eSIM.

= Features =

* Import plans for more than 190 countries as WooCommerce products, priced by your own markup rule (with rounding and an exchange rate for shops that do not sell in US dollars).
* Automatic delivery: a paid order is sent to RoamGo, and the eSIM arrives in a "Your eSIM is ready" email from your shop, on the thank-you page and in an "eSIMs" tab in the customer's account.
* QR code, one-tap install links for iPhone and Android, and the manual activation codes, all served from your own domain.
* Test mode: connect a test key and run the whole flow without spending anything.
* Clear order states for you: a "RoamGo eSIM" box on every order shows each eSIM, and lets you retry, check, resend the email, or ask RoamGo for a refund of an eSIM that was not installed.
* Orders wait instead of failing when your credit runs out, and go out automatically once you add credit; you get an email and a notice.
* Daily catalog check: a plan RoamGo stops offering goes out of stock in your shop, and you are told about products priced below your cost.
* Works with the block and classic checkouts and with WooCommerce's order storage (HPOS).
* Templates you can override from your theme, like WooCommerce's own.

= What you need =

A RoamGo reseller account. Creating one is free: there is no monthly fee and no manual approval. Test keys work at once; to sell, add $50 of credit, which stays in your account as balance. Reseller prices are up to 60% below retail, depending on the plan.

[Create your free reseller account](https://roamgo.net/partners/start?utm_source=wordpress.org&utm_medium=readme)

More about the plugin: [partners.roamgo.net/woocommerce](https://partners.roamgo.net/woocommerce)

== External services ==

This plugin connects to the RoamGo Partner API (https://api.roamgo.net), run by RoamGo LLC, which issues the eSIMs your shop sells. Every request is signed with the API key you connect.

* When you connect a key, and when you press "Check again": your account name, test or live mode and credit balance are read.
* When you browse or import plans, and once a day: the plans you may sell and your cost for each are read. No customer data is sent.
* When a customer pays for an eSIM: the plan, the quantity, the customer's billing email address and name, your order and line numbers, and your shop's address are sent, to place the order. The order's status and its eSIMs (identifiers, activation code and QR code) are then read until the eSIM is ready.
* With a key that has Full access: your shop's webhook address is registered, and RoamGo then sends order and credit events to it.
* When you ask for a refund from an order's eSIM box: the RoamGo order and your order number are sent.

RoamGo [terms of service](https://roamgo.net/terms) and [privacy policy](https://roamgo.net/privacy).

== Installation ==

1. Install and activate the plugin. WooCommerce must be active.
2. Go to WooCommerce → RoamGo eSIM. If you do not have a reseller account yet, create one with the button there (it is free).
3. In your RoamGo panel, open API keys and create a key: start with Test mode on. Orders access is enough; Full access also lets the plugin set up instant delivery.
4. Paste the key id and secret into the plugin and press Connect.
5. On the Plans tab, pick the plans you want to sell and import them.
6. Place a test order in your shop to see the whole flow. When you are ready to sell, add credit in your RoamGo panel and connect a live key.

== Frequently Asked Questions ==

= Do my customers see RoamGo? =

No. The products, emails and pages are your shop's. The eSIM's activation code includes its network's provisioning address, as every eSIM's does.

= What does a test key do? =

Test orders spend no credit. Their eSIMs show exactly how delivery looks, but cannot be installed. Swap in a live key when you are ready to sell.

= My shop does not sell in US dollars. =

Your RoamGo costs are in US dollars. Set an exchange rate in the plugin's settings and imported plans are priced in your currency by your markup rule. You are always charged the dollar cost.

= How fast does the eSIM arrive? =

Usually within a minute of payment. With a Full access key, RoamGo tells your shop the moment the eSIM is ready. Otherwise the shop checks for it, every few seconds while the customer is on the thank-you page and in the background after that.

= What happens if my credit runs out? =

The order waits, you get an email and a notice, and it is ordered automatically once you add credit. Your customer is told their eSIM is on its way.

= Can I refund an eSIM? =

Refund your customer in WooCommerce as usual. To get your credit back for an eSIM that was not installed, use "Ask RoamGo for a refund" in the order's RoamGo eSIM box.

= I moved my shop to a new address. =

The plugin pauses eSIM orders when the shop's address changes, so that a staging copy of your shop cannot buy the same eSIMs again. Confirm the new address on the plugin's page and orders resume.

== Screenshots ==

1. Connect your RoamGo account.
2. Import plans with your own prices.
3. The eSIM on the customer's thank-you page.
4. The "Your eSIM is ready" email.
5. The RoamGo eSIM box on an order.

== Changelog ==

= 1.0.1 =
* The plugin's home page is now partners.roamgo.net/woocommerce.

= 1.0.0 =
* First release.
