API de revenda eSIMDual

Use a API de revendedor eSIMDual em seu próprio site ou aplicativo

Esta documentação abrange as API de produção e de testes: autenticação, pacotes públicos, compras, entrega de eSIM, utilização, recargas compatíveis, cancelamento de eSIM não utilizadas, reembolsos, dados da carteira e webhooks assinados.

Baixar JSON OpenAPI Visualizar JSON bruto

Início rápido

1Comece em segurança com POST /sandbox/login
2Enviar tokens Bearer em todos os endpoints protegidos.
3Utilize Idempotency-Key em cada compra, recarga e cancelamento
4Passe para produção apenas após a aprovação do revendedor

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

URL do ambiente de testes https://esimdual.com/api/reseller/v1/sandbox

Autenticação Authorization: Bearer <token>

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

Segurança do ambiente de testes

As encomendas de teste utilizam um saldo fictício e eSIM simuladas. Nunca contactam um fornecedor a montante nem debitam a carteira de produção. Utilize o endpoint de simulação para testar os estados instalada, ativa e consumida e, em seguida, verifique os fluxos de reembolso aceite, recusado e sujeito a revisão manual.

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

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",
    "expires_in_days": 90
  }'

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

Fluxo de recarga compatível

GET /esims/{id}/topup-options

POST /topups
Idempotency-Key: TOPUP-2026-0001
{
  "esim_id": "{id}",
  "package_id": 456
}

Cancelamento de eSIM não utilizada

POST /esims/{id}/cancel
Idempotency-Key: CANCEL-2026-0001

Automatic refund only when the supplier confirms:
- zero usage
- never installed
- never activated
- no completed recharge exists
- original wallet debit is verified

Eventos de webhook

A eSIMDual assina timestamp.raw_payload com HMAC SHA-256. O segredo é gerado pela eSIMDual e apresentado apenas após a criação ou rotação. Rejeite carimbos de data/hora com mais de cinco minutos e elimine duplicados através de X-eSIMDual-Delivery.

ping order.completed order.processing order.failed topup.completed topup.processing topup.failed esim.cancelled refund.completed refund.failed

X-eSIMDual-Event

X-eSIMDual-Delivery

X-eSIMDual-Timestamp

X-eSIMDual-Signature: v1=…

Verificação da assinatura PHP

$rawBody = file_get_contents('php://input');
$timestamp = $_SERVER['HTTP_X_ESIMDUAL_TIMESTAMP'] ?? '';
$received = $_SERVER['HTTP_X_ESIMDUAL_SIGNATURE'] ?? '';
$fresh = ctype_digit($timestamp) && abs(time() - (int) $timestamp) <= 300;
$expected = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $webhookSecret);

if (!$fresh || !hash_equals($expected, $received)) {
    http_response_code(401);
    exit('Invalid or stale signature');
}

Guarde cada valor X-eSIMDual-Delivery e rejeite entregas duplicadas. Devolva uma resposta HTTP 2xx apenas depois de o evento ter sido aceite.