---
title: "Chip Virtual"
description: "API Chip Virtual - Números temporários para ativação rápida de apps"
lang: pt-BR
canonical: https://doc.apibrasil.io/apis/creditos/592655a9-ecaf-44b7-a765-99b6741f2dbc
markdown: https://doc.apibrasil.io/apis/creditos/592655a9-ecaf-44b7-a765-99b6741f2dbc.md
source: apibrasil-documentation
---

# Chip Virtual

> API Chip Virtual - Números temporários para ativação rápida de apps

- **Categoria:** Comunicação
- **Cobrança:** por consulta, só com o Bearer Token
- **Preço:** R$ 12,90 por consulta
- **Limite:** 990.000 por mês
- **Cadastro:** CPF ou CNPJ
- **Versão:** v2
- **Publicada por:** APIBrasil
- **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/592655a9-ecaf-44b7-a765-99b6741f2dbc/openapi.json

## Como chamar

**Endereço base:** `https://gateway.apibrasil.io/api/v2`

Autenticação: cabeçalho `Authorization: Bearer <token>`. Nada além disso.

## Endpoints (4 endpoints)

**Sumário**

1. `POST /chip/virtual/buy`
2. `GET /chip/virtual/activation`
3. `GET /chip/virtual/operators`
4. `GET /chip/virtual/services`

### 1. POST /chip/virtual/buy

API Chip Virtual - Ativação Rápida de Números Temporários

Adquira números virtuais temporários de forma instantânea com o endpoint chip/virtual/buy. Integrando esta solução ao seu sistema via método POST, você adiciona valor ao seu negócio ao permitir a ativação rápida e segura de serviços que exigem verificação telefônica, sem complicações operacionais. O retorno claro e automatizado da API entrega as informações essenciais para uso imediato, tornando perfeita a experiência de onboarding em plataformas digitais, aplicativos de delivery, marketplaces ou redes sociais. Simplifique processos, reduza fraudes e aumente a velocidade das ativações com o Chip Virtual, elevando a experiência do usuário ao nível que seu negócio precisa.

- **Método:** `POST`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/chip/virtual/buy`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Corpo da requisição**

```json
{
  "service": "wa",
  "operator": "claro",
  "activationType": 0,
  "country": "br"
}
```

**Em cURL**

```bash
curl -X POST "https://gateway.apibrasil.io/api/v2/chip/virtual/buy" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN" \
  -d '{"service":"wa","operator":"claro","activationType":0,"country":"br"}'
```

**Resposta de exemplo, do catálogo**

```json
{
  "user": {
    "first_name": "[omitido]",
    "email": "[omitido]",
    "cellphone": "[omitido]",
    "notification": "yes"
  },
  "balance": "939,200",
  "error": false,
  "message": "Você comprou um número virtual com sucesso!",
  "data": {
    "activationId": "3253948187",
    "phoneNumber": "5542988073673",
    "tax": "R$ 12,90",
    "activationTime": "2025-02-07 23:17:30",
    "activationEndTime": "2025-02-07 23:37:30",
    "activationOperator": "claro"
  }
}
```

### 2. GET /chip/virtual/activation

API Chip Virtual - Ative Serviços com Agilidade e Segurança

Com a API Chip Virtual, você possibilita que seu sistema receba, de maneira rápida e automatizada, o conteúdo de SMS enviados para um número virtual temporário, essencial para a ativação imediata de diversos serviços. Ao integrar o endpoint chip/virtual/activation, sua plataforma passa a oferecer o benefício de receber e processar mensagens SMS em tempo real, acelerando processos de verificação e onboarding de usuários. O retorno claro e estruturado da API garante agilidade ao validar identidades, habilitar contas e autenticar logins, gerando mais valor para negócios que prezam por segurança, praticidade e experiência do cliente. Com poucos passos, sua empresa ganha eficiência operacional e amplia seu portfólio de soluções digitais.

- **Método:** `GET`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/chip/virtual/activation`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Corpo da requisição**

```json
{
  "activationId": 3254028308
}
```

**Em cURL**

```bash
curl -X GET "https://gateway.apibrasil.io/api/v2/chip/virtual/activation" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN"
```

**Resposta de exemplo, do catálogo**

```json
{
  "error": false,
  "message": "Número virtual encontrado!",
  "data": {
    "activationId": "3254028308",
    "service": "wa",
    "text": "Codigo do WhatsApp: 258-129\nOu toque neste link para verificar seu numero: v.whatsapp.com/258129\nNao compartilhe este codigo\n4sgLq1p5sV6",
    "code": "258129",
    "phoneNumber": "5517991817588",
    "status": "received",
    "receivedAt": "2025-02-07 11:05:16",
    "activationCost": "12.9",
    "activationTime": "2025-02-07 23:53:23",
    "activationEndTime": "2025-02-08 00:13:23",
    "activationOperator": "claro"
  }
}
```

### 3. GET /chip/virtual/operators

API Chip Virtual - Ative Números Temporários com Facilidade

Com a API Chip Virtual, seu sistema ganha agilidade para consultar rapidamente as principais operadoras disponíveis para ativação de números virtuais temporários, otimizando fluxos e ampliando oportunidades de negócio. Ao integrar este endpoint GET, você recebe uma lista completa e atualizada de operadoras em tempo real, tornando o processo de ativação muito mais eficiente para seus clientes. Essa integração rápida oferece flexibilidade e escalabilidade no seu serviço, permitindo habilitar números temporários para autenticação, testes, cadastros e outros usos que demandem comunicação segura e temporária em seu produto digital.

- **Método:** `GET`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/chip/virtual/operators`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Em cURL**

```bash
curl -X GET "https://gateway.apibrasil.io/api/v2/chip/virtual/operators" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN"
```

**Resposta de exemplo, do catálogo**

```json
{
  "error": false,
  "operators": {
    "br": [
      "algartelecom",
      "claro",
      "tim",
      "oi",
      "vivo",
      "correios_celular",
      "nlt",
      "arqia",
      "cellular",
      "links_field"
    ],
    "usa": [
      "tmobile",
      "lycamobile",
      "at_t",
      "moabits",
      "joltmobile",
      "mint_mobile",
      "us_mobile",
      "textnow",
      "boost_mobile",
      "ultra_mobile",
      "hello_mobile",
      "h2o_wireless",
      "physic",
      "cricket_wireless"
    ],
    "uruguai": [
      "claro",
      "antel"
    ],
    "argentina": [
      "movistar",
      "claro",
      "personal",
      "tuenti"
    ],
    "espanha": [
      "lycamobile",
      "lebara",
      "you_mobile",
      "orange",
      "movistar",
      "vodafone",
      "altecom",
      "euskaltel",
      "yoigo",
      "llamaya",
      "tmobile",
      "cube_movil",
      "masmovil",
      "finetwork"
    ],
    "portugal": [
      "vodafone",
      "lycamobile",
      "nos",
      "lebara"
    ]
  }
}
```

### 4. GET /chip/virtual/services

API Chip Virtual - Mais segurança e agilidade na ativação de serviços

Com a API Chip Virtual, você integra facilmente ao seu sistema a capacidade de listar serviços para ativar números temporários, garantindo mais privacidade e comodidade ao seu usuário final. Em uma única chamada GET ao endpoint chip/virtual/services, sua aplicação tem acesso imediato às opções disponíveis para ativação de números virtuais, fundamentais para cadastro e autenticação em diversas plataformas, sem comprometer dados sensíveis. Ganhe eficiência operacional, reduza fraudes e ofereça novas possibilidades de uso, agregando valor ao seu negócio e melhorando a experiência do cliente com segurança e flexibilidade.

- **Método:** `GET`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/chip/virtual/services`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Em cURL**

```bash
curl -X GET "https://gateway.apibrasil.io/api/v2/chip/virtual/services" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN"
```

**Resposta de exemplo, do catálogo**

```json
{
  "error": false,
  "wa": {
    "name": "WhatsApp",
    "price": 12.9
  },
  "tg": {
    "name": "Telegram",
    "price": 9.9
  },
  "tw": {
    "name": "Twitter",
    "price": 8.9
  },
  "wb": {
    "name": "WeChat",
    "price": 5.9
  },
  "tn": {
    "name": "LinkedIN",
    "price": 8.9
  }
}
```

Nos exemplos de resposta, os campos da conta que gerou o exemplo (`user.first_name`, `user.email`, `user.cellphone`) saem como `[omitido]`. O resto é o que o catálogo publica.

## Armadilhas: o que uma integração erra sem avisar

Apuradas nas respostas que o próprio catálogo publica. Em todas elas o código funciona no caminho feliz e falha em silêncio no resto:

1. **O erro chega no CORPO, com HTTP 200.**
   A resposta traz um campo `error` booleano e uma `message`. Checar só `response.ok` ou o status HTTP deixa passar falha como sucesso. Confira SEMPRE `error === false` antes de ler `data`.

2. **`balance`, `tax` e `extra_charges.total` são STRING em formato brasileiro — e o formato varia entre APIs.**
   Valores observados no catálogo: `"154,380"`, `"497,84"`, `"0,000"` e `"0.19"`. Vírgula em umas, ponto em outra; três casas decimais em umas, duas em outra. Em JavaScript, `parseFloat("154,380")` devolve `154` e perde os centavos sem erro nenhum, e `Number("154,380")` devolve `NaN`. Escreva um conversor que trate os dois separadores, e nunca use esses campos numa decisão financeira sem convertê-los.

3. **Cada chamada custa dinheiro.**
   Retry cego multiplica a conta. Nunca repita automaticamente um 4xx: parâmetro errado repetido continua errado e continua cobrando. Repita só tempo esgotado e 5xx, com recuo exponencial e um teto pequeno de tentativas.

4. **HTTP 402 é saldo insuficiente, e repetir não resolve.**
   É o único status que exige ação humana — recarregar. Trate-o como erro terminal, com mensagem própria, e não o jogue no mesmo balde dos 4xx genéricos.

5. **`extra_charges` cobra à parte do preço da consulta.**
   Quando o corpo pede serviços adicionais, a resposta traz cada um com o preço e um `total` que NÃO está incluso no valor base. Se você mostra custo a quem usa, some os dois.

## Ver também

- Especificação OpenAPI: https://doc.apibrasil.io/apis/creditos/592655a9-ecaf-44b7-a765-99b6741f2dbc/openapi.json
- Catálogo de APIs: [Catálogo de APIs](https://doc.apibrasil.io/apis.md)
- SDKs oficiais: [SDKs oficiais](https://doc.apibrasil.io/sdks.md)
- Índice da documentação: https://doc.apibrasil.io/llms.txt
- Versão HTML desta página: https://doc.apibrasil.io/apis/creditos/592655a9-ecaf-44b7-a765-99b6741f2dbc