> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Comprar número de telefone

> Comprar um número de telefone dedicado

Este endpoint permite que você compre um número de telefone que foi encontrado usando o [endpoint de busca](/api-reference/phone-numbers/search-phone-numbers). A plataforma gerencia automaticamente preços, cobrança e provisionamento.

<Note>
  Você deve ter um método de pagamento válido registrado antes de comprar um número de telefone. A compra cria uma assinatura mensal que será renovada automaticamente.
</Note>

### Corpo da Requisição

<ParamField body="phone_number" type="string" required>
  O número de telefone a ser comprado no formato E.164 (ex: +14155551234). Deve ser um número retornado pelo endpoint de busca.
</ParamField>

### Resposta

<ResponseField name="message" type="string">
  Mensagem de sucesso
</ResponseField>

<ResponseField name="data" type="object">
  Os detalhes do número de telefone comprado

  <Expandable title="propriedades de data">
    <ResponseField name="id" type="integer">
      O identificador único do número de telefone
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      O número de telefone no formato E.164
    </ResponseField>

    <ResponseField name="country_code" type="string">
      O código do país ISO
    </ResponseField>

    <ResponseField name="type" type="string">
      O tipo do número de telefone (sempre `normal` para números comprados)
    </ResponseField>

    <ResponseField name="sms_capable" type="boolean">
      Se o número suporta SMS
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "message": "Número de telefone comprado com sucesso.",
    "data": {
      "id": 123,
      "phone_number": "+14155551234",
      "country_code": "US",
      "type": "normal",
      "sms_capable": true
    }
  }
  ```

  ```json 400 Already In Use theme={null}
  {
    "error": "Este número de telefone já está em uso."
  }
  ```

  ```json 400 Not Available theme={null}
  {
    "error": "Este número de telefone não está disponível para compra. Pesquise primeiro por números disponíveis."
  }
  ```

  ```json 402 No Payment Method theme={null}
  {
    "error": "Nenhum método de pagamento encontrado. Adicione um método de pagamento à sua conta."
  }
  ```

  ```json 402 Payment Failed theme={null}
  {
    "error": "Falha no pagamento. Atualize seu método de pagamento."
  }
  ```

  ```json 422 Invalid Format theme={null}
  {
    "error": "Não foi possível analisar o número de telefone. Forneça um número no formato E.164 válido."
  }
  ```

  ```json 500 Provider Error theme={null}
  {
    "error": "Falha ao comprar número de telefone do provedor. Entre em contato com o suporte."
  }
  ```
</ResponseExample>

### Como Funciona

1. **Buscar** - Primeiro use o [endpoint de busca](/api-reference/phone-numbers/search-phone-numbers) para encontrar números disponíveis
2. **Comprar** - Envie o número de telefone que você deseja para este endpoint
3. **Processamento Automático** - A plataforma:
   * Valida se o número ainda está disponível
   * Determina o preço correto baseado no país
   * Cria uma assinatura mensal no seu método de pagamento
   * Provisiona o número com nosso provedor de telefonia
   * Cria o registro do número de telefone na sua conta

<Warning>
  Compras de números de telefone não são reembolsáveis. A assinatura continuará até você [liberar o número](/api-reference/phone-numbers/release-phone-number).
</Warning>