Ciclo de uma ativação

Uma ativação nasce como um pedido, é provisionada na operadora e termina concluída ou cancelada. Fluxo ponta a ponta: criar → acompanhar → cancelar.

Antes de começar

Você vai precisar do product_id e do variation_id — veja Produtos e operadoras — e de saldo na carteira, já que criar a ativação debita o valor (veja Créditos e saldo).

1. Crie a ativação

POST /activations com o item, os dados do cliente e do chip. Repare no contrato aninhado (client, items):

bash

curl --request POST \
  --url 'https://portal.woo-fi.com/api/webservice/v2/activations' \
  --header 'Authorization: Bearer {seu-token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "product_id": 63,
    "variation_id": 232,
    "activation_type": "esim",
    "activation_date": "2026-05-20",
    "client": {
      "name": "João Silva",
      "email": "joao.silva@example.com",
      "phone": "(11) 98765-4321",
      "document": "182.177.290-34"
    },
    "items": [
      { "eid": "89852342022137421003", "imei": "351756051523999" }
    ],
    "external_id": "434"
  }'

Campo	Tipo	Obrigatório	Descrição
`product_id`	Number	Sim	Produto escolhido no catálogo.
`variation_id`	Number	Sim	Variação (plano) escolhida.
`activation_type`	String	Sim	`esim` ou `chip`.
`activation_date`	String	Sim	Início do plano (`AAAA-MM-DD`).
`client`	Object	Sim	`name`, `email`, `phone` (obrigatórios) e `document`.
`items`	Array	Sim	Lista de chips (mín. 1). Campos técnicos de cada item — `icc`, `imei`, `imei2`, `eid`, `pin`, `line`
`external_id`	String	Não	Seu identificador para consultar a ativação depois.

A resposta (201) traz o pedido com os items já com o QR Code:

json

{
  "message": "Pedido realizado com sucesso!",
  "order": {
    "id": 25360,
    "status": 2,
    "total_price": 33.25,
    "external_id": "434",
    "items": [
      {
        "id": 25869,
        "product_name": "EUROPA ILIMITADO COM 2GB",
        "variation_description": "9 Dias 2GB",
        "eid": "8904...",
        "qrcode_url": "https://.../qr_codes/8904....png",
        "qr_content": "LPA:1$rsp.example.com$QR-G-01-..."
      }
    ]
  }
}

eSIM e chip físico

No eSIM, quando o QR Code está disponível cada item traz qrcode_url (imagem) e qr_content (a string LPA). No chip físico, não há QR Code — o icc vem impresso no chip.

2. Acompanhe a ativação

GET /activations/{id} — o {id} aceita o ID da ativação ou o external_id. Retorna o pedido com client e items.

O status percorre estes valores:

`status`	Rótulo	Significado
`2`	Aberto	Pedido criado, aguardando ativação.
`6`	Processando	Ativação em andamento na operadora.
`3`	Concluído	Linha ativada com sucesso.
`7`	Fechado	Pedido encerrado.
`10`	Parcial	Parte dos itens ativada (múltiplos itens).
`9`	Faltando ICC	Falta o `icc`/`eid` do chip para provisionar.
`8`	Cancelado	Pedido cancelado (com estorno).

3. Liste suas ativações

GET /activations?page=1 retorna as ativações da agência, paginadas. Veja Paginação.

4. Cancele uma ativação

POST /activations/cancel/{id} desfaz o pedido e devolve o valor à carteira (estorno).

bash

curl --request POST \
  --url 'https://portal.woo-fi.com/api/webservice/v2/activations/cancel/25360' \
  --header 'Authorization: Bearer {seu-token}'

json

{ "message": "Ativação cancelada com sucesso." }

Nem todo pedido pode ser cancelado

Só é possível cancelar enquanto o pedido não estiver Concluído nem Fechado. Um pedido já cancelado ou já concluído retorna 400.

Próximos passos

Garanta saldo em Créditos e saldo.
Teste na referência: Create Activation e Get one activation.