API per rivenditori eSIMDual

Use the eSIMDual reseller API in your own website or app

This documentation covers authentication, packages, 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
4Convalida 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"
  }'

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