Visão Geral

Versão

2.0.0

Endpoints

Autenticação

Authorization

Base URL

https://portal.woo-fi.com/api/webservice/v2

Header de autenticação

Authorization: Bearer {{TOKEN}}

Sobre a API

O Webservice V2 é a versão REST da API de revenda: mesmos recursos da V1 (catálogo, ativações, carteira, dashboard).

Nova integração

Se você já usa a V1, a V2 não é compatível campo a campo: os payloads mudam (ex.: product_id/variation_id em vez de idProduct/sequence_item). Trate como uma integração nova.

Conceitos-chave

Agência (dealer) — sua conta revendedora, com carteira pré-paga.
Catálogo — operadoras, produtos e variações; cada variação tem um variation_id e um preço por agência.
Ativação — o pedido que provisiona uma linha (eSIM ou chip físico). A resposta traz os items com qrcode_url e qr_content.
Carteira — cada ativação debita o saldo; recargas (Stripe/Ebanx) creditam.

Todos os termos estão no Glossário.

Por onde começar

1. Gere seu token — Quick Start.
2. Autentique cada chamada com o token Bearer — Autenticação.
3. Descubra o que vender — Produtos e operadoras.
4. Crie sua primeira ativação — Ciclo de uma ativação.

Baixe a collection

Importe a collection do Postman ou o OpenAPI (logo abaixo) para testar a API e gerar SDKs.

Downloads

Collection do PostmanImporte no Postman ou Insomnia OpenAPI 3.0 (JSON)Swagger, geradores de SDK e afins