Skip to main content
POST
/
user
/
phone-numbers
/
purchase
Comprar número de telefone
curl --request POST \
  --url https://suasofia.online/api/user/phone-numbers/purchase \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "<string>"
}
'
{
  "message": "Número de telefone comprado com sucesso.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}
Este endpoint permite que você compre um número de telefone que foi encontrado usando o endpoint de busca. A plataforma gerencia automaticamente preços, cobrança e provisionamento.
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.

​
Corpo da Requisição

​
phone_number
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.

​
Resposta

​
message
string
Mensagem de sucesso
​
data
object
Os detalhes do número de telefone comprado
{
  "message": "Número de telefone comprado com sucesso.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}

​
Como Funciona

  1. Buscar - Primeiro use o endpoint de busca 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
Compras de números de telefone não são reembolsáveis. A assinatura continuará até você liberar o número.