API per rivenditori eSIMDual

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

Questa documentazione copre autenticazione, pacchetti, prezzi reseller, piani VPN, ordini, risorse eSIM, dati del wallet e payload webhook dell’API reseller. Usa il riferimento online o scarica il file OpenAPI JSON per Postman, Insomnia o i tuoi strumenti di integrazione.

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.
4Leggi i piani VPN con GET /vpn/plans quando vendi opzioni Secure VPN
5Annulla gli abbonamenti VPN reseller con POST /vpn/subscriptions/{id}/cancel quando il cliente termina il servizio
6Controlla gli aggiornamenti SaaS con GET /updates/latest
7Convalida 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"
  }'

Esempio di richiesta piani VPN

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

Il campo price_for_reseller è l’importo addebitato da eSIMDual al reseller. Il tuo storefront può aggiungere il proprio prezzo di vendita al cliente.

Esempio di ordine VPN

curl --request POST 'https://esimdual.com/api/reseller/v1/vpn/orders' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Idempotency-Key: VPN-2026-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "vpn_plan_id": 1,
    "external_subscription_id": "VPN-CUSTOMER-0001",
    "customer_reference": "customer@example.com",
    "customer_price": 4.99
  }'

Esempio di controllo aggiornamento SaaS

curl --request GET 'https://esimdual.com/api/reseller/v1/updates/latest?current_version=1.0.0&channel=stable' \
  --header 'Authorization: Bearer YOUR_TOKEN'

Gli endpoint di aggiornamento sono per le release degli storefront SaaS ospitati o self-hosted. Usano lo stesso token Bearer reseller.

Eventi Webhook

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

ping order.completed order.processing order.failed vpn.subscription.active vpn.subscription.cancelled vpn.subscription.expired vpn.subscription.failed

X-eSIMDual-Event

X-eSIMDual-Delivery

X-eSIMDual-Signature