FAQ - PressOne eSIM Developer Platform

How do I authenticate with the API?

PressOne offers different authentication methods depending on the service:

Data eSIM Service:

Obtain your API key from your dashboard

Generate a JWT access token by calling POST /customer/v2/token with your API key

Include the JWT token in the Authorization header for all API requests: Bearer <your_token>

Tokens are valid for 24 hours and can be refreshed using POST /customer/v2/auth/refresh

Example Authentication Flow for Data eSIM:

POST /customer/v2/token
Content-Type: application/json

{
  "api_key": "your_api_key_here"
}

Response:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 86400
}

Voice-Only eSIM Service:

PressOne Africa will provide you with an API key

Use the Bearer token authentication method

Add the "Authorization" header to every request: Authorization: Bearer YOUR_API_KEY

Base URL: https://api.pressone.co/

All subsequent API requests must include:

Authorization: Bearer YOUR_API_KEY

What is the difference between pre-paid and post-paid billing?

How do I check my account balance?

Where can I find the retail and net prices in the responses?

What are the supported languages?

Where can I find the complete list of country codes supported?

How can I use universal links to support direct installation on iOS?

How often are package prices updated?

How can I purchase a top-up package?

Can your eSIMs switch between multiple operators automatically?

How can I determine if status and usage information is available for an eSIM package?

How can I generate a QR code?

How do packages with calls and texts work?

How can I send additional parameters in Submit Order / Submit Top-up Order API methods?

What types of errors can occur during eSIM activation?

Does your API support direct installation?

What is a 429 error?

Do users need to activate an eSIM within a specific time period?

Can I store eSIM packages?

What steps to take when an order fails?

How can I find countries in the partner country code list?

Where can I find the SM-DP+ Address and activation code?

Can I build a complete white label experience using the PressOne Partner API?

How is the activation policy provided for eSIM packages in the Partner API?

Do my users need to set up an APN to install the eSIM?

How can I access regional packages?

What are the different statuses of eSIM packages?

Where can I find information for the manual and QR code installation methods on iOS and Android devices?

Is there an order cancellation API available via an endpoint?

How do I list available phone numbers?

How do I claim a phone number for a user?

How do I renew a phone number subscription?

How do I retrieve users who signed up via my platform?

What information is required to claim a phone number?

What is the NIN requirement?

How do subscriptions work for Voice-Only eSIM?

What happens when a subscription expires?

Are there rate limits for Voice-Only eSIM API?

What error responses can I expect from Voice-Only eSIM endpoints?