API de revendedor eSIMDual

Utilice la API de revendedor de eSIMDual en su propio sitio web o aplicación.

Esta documentación cubre autenticación, paquetes, precios para revendedores, planes VPN, pedidos, recursos eSIM, datos de wallet y payloads de webhooks de la API reseller. Usa la referencia en línea o descarga el archivo OpenAPI JSON para Postman, Insomnia o tus herramientas de integración.

Descargar OpenAPI JSON Ver JSON sin procesar

Inicio rápido

1Crea un token de API con POST /login
2Enviar tokens de portador en todos los puntos finales protegidos.
3Utilice la clave de idempotencia al crear el pedido.
4Consulta los planes VPN con GET /vpn/plans cuando vendas opciones Secure VPN
5Cancela suscripciones VPN reseller con POST /vpn/subscriptions/{id}/cancel cuando tu cliente finalice el servicio
6Comprueba actualizaciones SaaS con GET /updates/latest
7Valida las firmas de webhook con tu clave secreta compartida.

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

Autenticación Authorization: Bearer <token>

Idempotencia Idempotency-Key: unique-order-key

Ejemplo de solicitud de inicio de sesión

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"
  }'

Solicitud de pedido de muestra

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"
  }'

Ejemplo de solicitud de planes VPN

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

El campo price_for_reseller es el importe que eSIMDual cobra al reseller. Tu tienda puede añadir su propio precio de venta al cliente.

Ejemplo de pedido 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
  }'

Ejemplo de comprobación de actualización SaaS

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

Los endpoints de actualización son para versiones de tiendas SaaS alojadas o autoalojadas. Se autentican con el mismo token Bearer reseller.

Eventos de webhook

eSIMDual firma las cargas útiles de los webhooks con HMAC SHA-256 utilizando su clave secreta de 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