eSIMfly MCP

API de eSIM para Desenvolvedores: Venda eSIMs no Seu Próprio Produto

Integre planos de dados eSIM no atacado para 200 países no seu aplicativo, plataforma ou loja por meio de uma única API REST — catálogo, pedidos, recargas, uso e gerenciamento completo do ciclo de vida.

Quem Desenvolve com a API de eSIM

Empresas usam a integração de eSIM no atacado para adicionar receita de conectividade ao seu produto existente.

Aplicativos de Viagem e OTAs

Ofereça um upsell de eSIM no momento da reserva. Seus viajantes chegam conectados, e você mantém a margem em cada plano vendido.

Revendedores e MVNOs

Compre eSIMs a preços de atacado e venda pelos seus próprios canais, com seus próprios preços e pacotes.

Plataformas de IoT e Frotas

Provisione e monitore conectividade para dispositivos e veículos além-fronteiras a partir de uma única integração.

Superapps e Fintechs

Adicione planos de dados internacionais como um recurso nativo ao lado de pagamentos, serviços bancários ou programas de fidelidade.

RECURSOS DA API

Tudo o Que Você Precisa para Gerenciar eSIMs Programaticamente

A API cobre toda a jornada, desde a navegação pelos pacotes de atacado até o gerenciamento de eSIMs ativos em campo.

Catálogo e Preços

Navegue por todos os pacotes de dados disponíveis com preços de atacado para 200 países e consulte o saldo da sua conta antes de fazer pedidos.

Obter Todos os PacotesConsulta de Saldo

Pedidos e Recargas

Provisione novos eSIMs instantaneamente e faça recargas nos existentes. Os pedidos retornam códigos QR e detalhes de ativação prontos para entregar aos seus usuários.

Criar PedidoRecarga de Pacotes e Pedidos

Ciclo de Vida do eSIM

Gerencie cada eSIM emitido: consulte status e uso de dados, suspenda ou cancele linhas, revise eventos de rede e envie SMS.

Listar / Consultar eSIMsStatus do eSIMCancelar / Suspender / AtivarRelatório de UsoEventos de RedeEnviar SMS

Webhooks

Registre endpoints para receber notificações em tempo real sobre pedidos e eventos do ciclo de vida do eSIM — sem necessidade de polling.

Gerenciamento de WebhooksNotificações de Eventos

Tarifas de Atacado para eSIM, Sua Margem

Parceiros da API compram pacotes de dados a preços de atacado e definem seus próprios preços de varejo. O catálogo abrange planos locais, regionais e globais em 200 países e mais de 450 redes, então uma única integração cobre todos os destinos para onde seus usuários viajam. A cobrança baseada em saldo simplifica a liquidação: credite sua conta e cada pedido debita dela à sua tarifa de atacado.

Se você preferir uma loja completa em vez de construir a sua própria, nossa plataforma white-label de revenda de eSIM inclui um site com marca, painel e aplicativos móveis sobre a mesma infraestrutura.

Seguro por Design: Requisições Assinadas com HMAC

Toda chamada à API é autenticada com uma assinatura HMAC-SHA256 sobre o timestamp da requisição, um ID de requisição único, seu código de acesso e o corpo da requisição — fornecendo verificação de integridade e proteção contra ataques de repetição. Exemplos prontos de assinatura para Node.js, Python e PHP estão na documentação.

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

Obtenha Acesso à API em Três Etapas

1. Crie uma conta empresarial

Cadastre-se para uma conta empresarial eSIMfly e conte-nos sobre seu caso de uso e volume esperado.

2. Gere suas chaves de API

Crie e gerencie credenciais de acesso pelo painel empresarial e depois credite seu saldo.

3. Integre e lance

Siga a documentação para navegar pelos pacotes, fazer um pedido de teste e, opcionalmente, registrar um webhook para eSIMs provisionados de forma assíncrona.

FAQ

Perguntas Frequentes sobre a API de eSIM

O que é a API de eSIM da eSIMfly?+

A API da eSIMfly é uma API REST que permite comprar, provisionar e gerenciar eSIMs programaticamente a tarifas de atacado. Você pode navegar pelo catálogo de pacotes, criar pedidos, fazer recargas de planos, monitorar o uso e gerenciar todo o ciclo de vida do eSIM (ativar, suspender, cancelar) a partir do seu próprio aplicativo, com cobertura em 200 países e mais de 450 redes.

Para quem é a API de eSIM?+

A API foi criada para empresas que desejam incorporar conectividade eSIM ao seu próprio produto: aplicativos de viagem e plataformas de reserva, revendedores de telecom e MVNOs, plataformas de IoT e frotas, e qualquer serviço que queira oferecer dados internacionais aos seus usuários sem construir relacionamentos com operadoras.

Como funciona a autenticação na API?+

As requisições são autenticadas com assinaturas HMAC-SHA256. Cada requisição carrega um código de acesso, um ID de requisição único, um timestamp e uma assinatura calculada com sua chave secreta, o que garante a verificação de integridade da requisição e previne ataques de repetição. Exemplos de código para Node.js, Python e PHP estão disponíveis na documentação.

Como obtenho acesso à API de eSIM?+

Crie uma conta empresarial eSIMfly e depois gere chaves de API pelo painel empresarial. Os níveis de preço de atacado dependem do volume — entre em contato com nossa equipe de vendas para discutir tarifas para o volume de pedidos esperado.

A API suporta webhooks?+

Sim. Os webhooks notificam você quando eSIMs provisionados de forma assíncrona estão prontos — algumas operadoras (como a KDDI Japan) levam alguns minutos, e em vez de fazer polling você recebe um POST assinado com os detalhes do eSIM. A maioria dos provedores provisiona de forma síncrona na resposta do pedido, e o status e o uso são consultados pelos endpoints de status e uso.

Quais são os limites de taxa da API?+

A API permite 1.000 requisições por hora por conta. Requisições com mais de 5 minutos são rejeitadas como parte da proteção contra ataques de repetição. Se você precisar de limites maiores para sua integração, entre em contato com vendas.

SDK OFICIAL · NODE.JS / TYPESCRIPT

Pule o código de assinatura — instale o SDK

npm install @esimfly/sdk oferece acesso tipado a toda a API — assinatura HMAC, IDs de requisição atualizados, pedidos idempotentes, sincronização de catálogo com ritmo controlado e verificação de assinatura de webhooks já incluídos. Zero dependências, Node.js 18+, licença MIT e código aberto. SDKs para PHP e Python estão a caminho.

Usando um agente de IA? Adicione o servidor MCP hospedado https://mcp.esimfly.net/mcp ao Claude, ChatGPT ou Cursor e entre com sua conta empresarial — sem precisar colar chaves. Pesquise planos, consulte o uso e diagnostique eSIMs contra a API ao vivo; somente leitura por padrão, com uma etapa de confirmação antes de qualquer pedido. Prefere local? npx -y @esimfly/mcp.

Tutoriais de Integração

Código Node.js funcional, da primeira requisição aos webhooks de produção.

[

COMEÇE AQUI · GUIA DE ARQUITETURA

Guia de Integração da API de eSIM

Os quatro blocos fundamentais, autenticação assinada, provisionamento síncrono vs. webhook, uma lista de verificação para avaliar provedores e as armadilhas que só aparecem em produção.

Leia o guia](https://esimfly.net/esim-api/integration-guide)

[

PARTE 1 · ~30 MIN

Venda eSIMs no Seu Aplicativo com Node.js

Autenticação HMAC, catálogo de pacotes, criação de pedidos e entrega de código QR — uma loja completa e funcional.

Inicie o tutorial](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

PARTE 2 · CICLO DE VIDA

Recargas, Monitoramento de Uso e Webhooks

Consultas de uso em tempo real, vendas de recarga em eSIMs existentes e webhooks assinados sem polling.

Continue para a parte dois](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

Pronto para integrar eSIMs ao seu produto?

Comece pela documentação ou fale com nossa equipe sobre tarifas de atacado para o seu volume.