API per rivenditori eSIMDual

Utilizza l'API per rivenditori di eSIMDual nel tuo sito web o nella tua app.

This documentation covers authentication, packages, reseller pricing, VPN plans, orders, eSIM resources, wallet data and webhook payloads for the reseller API. Use the online reference below or download the OpenAPI JSON file for Postman, Insomnia or your own integration tools.

Scarica il file JSON di OpenAPI Visualizza il JSON non elaborato

Avvio rapido

1Crea un token API con POST /login
2Invia i token Bearer su tutti gli endpoint protetti
3Utilizzare la chiave di idempotenza nella creazione dell'ordine.
4Read VPN plans with GET /vpn/plans when you sell Secure VPN options
5Convalida le firme dei webhook con il tuo segreto condiviso

URL di base https://esimdual.com/api/reseller/v1

Autenticazione Authorization: Bearer <token>

Idempotenza Idempotency-Key: unique-order-key

Esempio di richiesta di accesso

curl --request POST 'https://esimdual.com/api/reseller/v1/login' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "partner@example.com",
    "password": "StrongPassword123!",
    "device_name": "production-server"
  }'

Richiesta di ordine campione

curl --request POST 'https://esimdual.com/api/reseller/v1/orders' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Idempotency-Key: ORDER-2026-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "package_id": 1120,
    "external_order_id": "NOANET-2026-0001",
    "device_imei": "356938035643809"
  }'

Sample VPN plans request

curl --request GET 'https://esimdual.com/api/reseller/v1/vpn/plans' \
  --header 'Authorization: Bearer YOUR_TOKEN'

The price_for_reseller field is the amount charged by eSIMDual to the reseller. Your storefront can add its own customer selling price on top.

Eventi Webhook

eSIMDual firma i payload dei webhook con HMAC SHA-256 utilizzando il tuo segreto webhook.

ping order.completed order.processing order.failed

X-eSIMDual-Event

X-eSIMDual-Delivery

X-eSIMDual-Signature