API de revenda eSIMDual

Use the eSIMDual reseller API in your own website or app

Esta documentação cobre autenticação, pacotes, preços de reseller, planos VPN, pedidos, recursos eSIM, dados da wallet e payloads de webhooks da API reseller. Use a referência online ou baixe o arquivo OpenAPI JSON para Postman, Insomnia ou suas ferramentas de integração.

Baixar JSON OpenAPI Visualizar JSON bruto

Início rápido

1Crie um token de API com POST /login
2Enviar tokens Bearer em todos os endpoints protegidos.
3Use a chave de idempotência na criação do pedido.
4Consulte os planos VPN com GET /vpn/plans quando vender opções Secure VPN
5Cancele assinaturas VPN reseller com POST /vpn/subscriptions/{id}/cancel quando seu cliente encerrar o serviço
6Verifique atualizações SaaS com GET /updates/latest
7Valide as assinaturas do webhook com sua chave compartilhada.

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

Autenticação Authorization: Bearer <token>

Idempotência Idempotency-Key: unique-order-key

Exemplo de solicitação de login

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

Pedido de amostra

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

Exemplo de solicitação de planos VPN

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

O campo price_for_reseller é o valor cobrado pela eSIMDual ao reseller. Sua loja pode adicionar o próprio preço de venda ao cliente.

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

Exemplo de verificação de atualização SaaS

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

Os endpoints de atualização são para releases de storefronts SaaS hospedados ou self-hosted. Eles usam o mesmo token Bearer reseller.

Eventos de webhook

O eSIMDual assina payloads de webhook com HMAC SHA-256 usando sua chave 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