# Using the Web App

Dataplans.io is an eSIM API platform and management backend.  Currently proving eSIMs from 2 carriers: AIS and DTAC.

![eSIM Dashboard](https://1440676289-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQzTjvdng-Q8rz8uGfU%2F-MR4j3ElkVyvMy871Ag3%2F-MRIyJzjm_SnwHQQ31mv%2FScreen_Shot_2021-01-18_at_11_52_36.png?alt=media\&token=a94eb810-6c10-41c2-9a8f-ca08631a01fe)

## Getting Started <a href="#gettingstarted" id="gettingstarted"></a>

To get started:

1. [Create an account at esims.dataplans.io](https://esims.dataplans.io/signup) &#x20;
2. Make a test deposit - under Billing > [Make External Deposit](https://esims.dataplans.io/dashboard/billing/wires)
3. Make a test purchase in the Sandbox area - under [Products](https://esims.dataplans.io/dashboard/products)
4. Switch to **live mode**
5. Agree to the [User Agreement](https://dataplans.io/user-agreement/) and complete Identity Verification
6. Fund your account and purchase an eSIM

### **Sandbox Environment**

![Sandbox dashboard for making test purchases](https://1440676289-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQzTjvdng-Q8rz8uGfU%2F-MS0bvJzPCFLSuYRHkMp%2F-MS0fEnM_BBOgWwhEteT%2FScreen%20Shot%202021-01-27%20at%2009.28.30.png?alt=media\&token=17c3ff0e-f57d-4060-8716-6694dbce18b8)

After login, you will be in the sandbox testing  area, with test credit and eSIMs.  With in the sandbox account you can:

1. Make a deposit of test funds
   1. Navigate to Billing > Make External Deposit
2. Make a test  eSIM purchase
   1. Go to Products and choose one of the available choices
   2. Go to Purchases and review purchase history

### **Live Environment**

Once satisfied with your process, you can switch to the live environment.  You can use the same API key or roll a new one.  The API key is the same for both Sandbox and Live environments, but the base URL has a different sandbox and live subdomain.

## eSIM Delivery

Purchasing an eSIM is possible once you have a positive account balance.  When requesting the eSIM, your balance is deducted according to your current monthly tier.&#x20;

###

### Web app delivery&#x20;

When purchasing via the dashboard, you will receive the QR code and additional metadata. QR code can be delivered to a customer as is, or recreated as a new QR code.

![QR code payload purchased in the dashboard](https://1440676289-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQzTjvdng-Q8rz8uGfU%2F-MR4cajmd0HfjyXWhLFD%2F-MR4epttc270qcf-8wit%2FScreen%20Shot%202021-01-15%20at%2017.50.30.png?alt=media\&token=54a00e37-a74b-44e6-a2f7-32a74876fe36)

Provided is the connection string data, serial number and any additional data like phone or connection code.  Manual entry codes also provided.&#x20;

| **Parameters** | Description                                                            |
| -------------- | ---------------------------------------------------------------------- |
| manual1        | String for manual entry of SM-DP+ Address                              |
| manual2        | String for Activation Code                                             |
| optionalCode   | Confirmation Code. Used with some eSIM providers                       |
| phone          | eSIM phone number                                                      |
| serial         | eSIM Serial number                                                     |
| expiryDate     | eSIM expiry date                                                       |
| qrCodeString   | QR code payload string. Populate your customer QR code with this data. |
| qrCodeDataUrl  | QR code PNG imag                                                       |

###


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://esims.gitbook.io/dataplans/intergration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.