spotsim API

Seu software.
O mundo conectado.

Leve eSIMs para dentro do seu OBT, plataforma de reservas ou software de turismo. Da emissão à recarga, na experiência que você construiu.

OBTsSoftwares de turismoPlataformas de reservas
spotsim / integraçãoDEMO
emissao.jsonJSON
POST/VendasESim/emitir
Trecho do payload
{
  "idProdutoSistema": "MM-123456",
  "codigoCliente": "OBT-2048",
  "pagamentoPix": true,
  "webHook":
    "https://sua-obt.example/webhooks/esim"
}
Seu sistema de viagens
Viagens OBT-2048

Uma viagem completa.

Pedido de exemplo
São PauloGRU
LisboaLIS
Ida e volta
Internet na bagagem.eSIM internacional · spotsim
Destino do viajantePortugal
Aguardando pagamento PixExemplo
A emissão depende da confirmação do pagamento.
Dentro da sua experiência.

Seu pedido acompanha a venda, do primeiro envio à conciliação.

Demonstração ilustrativa · nenhuma emissão é realizada

200 países. Um mundo de destinos.
HTTP + JSON. Para o seu stack.
JWT Bearer. Acesso autenticado.
Conectividade como parte do produto

Mais valor.
Em cada reserva.

A viagem já acontece na sua plataforma. Agora, a conexão pode fazer parte dela também.

A experiência é sua.

O eSIM entra.
Sua marca fica.

Você desenha a oferta, os passos da compra e a apresentação dos dados ao viajante. A API conecta essa jornada à operação de eSIMs da SpotSIM.

No fluxo da reserva Com a referência do seu pedido
Da busca ao embarque

Uma API.
A jornada inteira.

Conecte as operações de eSIM ao que seu sistema já faz.

  1. 01

    Encontre o plano.

    Consulte opções de eSIM para o destino e o período da viagem.

    POST/VendasESim/disponibilidade
  2. 02

    Emita no seu fluxo.

    Envie a emissão com os dados do viajante e a referência do seu pedido.

    POST/VendasESim/emitir
  3. 03

    Entregue a conexão.

    Consulte a venda para recuperar o QR Code e as informações de instalação.

    GET/VendasESim/consultar
  4. 04

    Acompanhe a viagem.

    Consulte consumo e disponibilidade de recarga para continuar a experiência.

    POST/VendasESim/recarga/disponibilidade
Seu pedido. Sempre como referência.

Do seu código.
À venda certa.

Envie codigoCliente na emissão e use a mesma referência para localizar as vendas na SpotSIM. Seu pedido e o eSIM passam a contar a mesma história.

No seu sistemaOBT-2048
Na SpotSIMidVenda: 123

Se a emissão tiver timeout, consulte pelo código antes de decidir reenviar. Essa referência ajuda na conciliação; não é uma garantia de idempotência.

reconciliacao.json
GET/VendasESim/consultarporcodigocliente
?codigoCliente=OBT-2048
{
  "sucesso": true,
  "codigo": 200,
  "dados": [
    {
      "idVenda": "123",
      "codigoCliente": "OBT-2048"
    }
  ]
}
Trecho de resposta ilustrativoJSON

A consulta considera o cliente autenticado pelo token JWT. Depois de localizar a venda, consulte os detalhes pelo idVenda.

Para quem vai construir

Do primeiro endpoint.
À próxima grande ideia.

Explore o contrato da API e converse com a nossa equipe sobre o acesso e as condições para integrar sua solução.

Abra a documentação.

Endpoints, modelos de requisição e respostas no Swagger.

Explorar Swagger
Vamos criar essa conexão.

O próximo destino
é o seu software.

Conte o que você está construindo. Vamos conversar sobre como levar a SpotSIM para o seu produto.

Falar sobre integração