Um checklist para receber códigos de verificação de São Bartolomeu (+590)

Checklist prévio antes de pedir um número +590

São Bartolomeu é uma das menores rotas da OTP Route, então um pouco de preparação evita tentativas desperdiçadas:

• Confirme se o serviço está listado hoje. Chame GET /api/v1/countries e GET /api/v1/services, ou abra o painel; o id do país é bl.
• Verifique o preço. GET /api/v1/prices?country=bl&service=<id> retorna o valor atual para esse par.
• Abasteça a carteira e, para jobs automatizados, confira GET /api/v1/balance antes.
• Prepare o seu campo de telefone para aceitar um número +590 com nove dígitos depois do código.
• Conheça a posição do serviço sobre números virtuais; alguns os recusam.
• Tenha uma rota alternativa pronta, já que a cobertura aqui muda com frequência.

Se você é novo no modelo, o que é um gateway de OTP explica o básico.

Quais serviços podem enviar códigos para números de São Bartolomeu?

A rota lista atualmente mais de 20 serviços, um catálogo bem menor que o dos mercados maiores. O snapshot ao vivo inclui TikTok, Amazon, LinkedIn, AliExpress, Flipkart, Mercado Libre, Mercado Pago, Coinbase, Bumble e Swiggy.

Como a lista é curta e muda durante o dia, leia sempre a disponibilidade na API no momento do pedido. Se o serviço de que você precisa não estiver presente, a vizinha rota de Guadalupe, que compartilha o código de discagem +590, ou a rota da França podem servir a um caso de teste em francês.

Passo a passo: o fluxo da API para o roteamento de OTP de São Bartolomeu

1. Autentique-se em https://otproute.com/api/v1 com uma chave Bearer que começa com or_live_ (até 10 chaves por conta, 300 requisições por minuto).
2. Faça o pedido: POST /api/v1/activations com {"service": "linkedin", "country": "bl"}. Guarde o id da ativação e o número retornado.
3. Envie o número +590 no app ou site que você está testando.
4. Obtenha o código +590 pelo evento activation.sms_received, ou recorra ao polling em GET /api/v1/activations/{id} a cada poucos segundos.
5. Verifique o cabeçalho X-OTPRoute-Signature, no formato t=<unix>,v1=<hex>, calculando o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint, e rejeite timestamps antigos.
6. Cancele com POST /api/v1/activations/{id}/cancel se o teste terminar antes.

A visão geral para desenvolvedores reúne chaves, webhooks e exemplos em um só lugar.

Como os números +590 são formatados e armazenados?

São Bartolomeu usa o código de país +590 junto com Guadalupe e a parte francesa de São Martinho, seguindo as convenções de numeração francesas. Localmente, os números são escritos com dez dígitos e um 0 de tronco: os fixos costumam começar com 0590 e os celulares com 0690. Em E.164 o 0 é removido, então um celular vira +590 690 seguido de seis dígitos.

Um detalhe pega muitas equipes: o código de discagem sozinho não diz em qual território o cliente mora. Se o seu produto mostra conteúdo específico por região, pergunte o território separadamente em vez de inferi-lo a partir do +590. Armazene a string E.164 sem espaços e mantenha o território como um campo próprio.

O francês é o idioma oficial, então as mensagens com o código costumam chegar em francês ou em inglês, conforme o serviço remetente as localiza.

Por que uma equipe testaria ou operaria em São Bartolomeu?

A economia da ilha gira em torno do turismo, então apps de viagem, aluguel de vilas, concierge, fretamento de barcos e hotelaria são os motivos habituais. As equipes querem confirmar que um hóspede ou funcionário local com um número +590 consegue concluir o cadastro, e agências que fazem campanhas no Caribe para hotéis às vezes verificam perfis empresariais de clientes ali. O QA de localização para fluxos em francês no Caribe é outro motivo, e a página de equipes de operações cobre esse uso.

Solução de problemas: nenhum código chegou

Cada ativação fica aberta por 20 minutos, e você só paga se o código chegar. Uma janela que se fecha vazia, ou um pedido cancelado, reembolsa o valor integral na carteira automaticamente, e o seu webhook recebe activation.expired ou activation.cancelled.

• Deixe a janela completa correr antes de desistir.
• Verifique se o serviço aceita números virtuais.
• Tente de novo mais tarde, ou troque para outra rota de serviço ou para um país vizinho.
• Nunca refaça o pedido em um laço rápido; espere um pouco entre as tentativas.

Caminho sem código: cadastre-se com e-mail e um código de 6 dígitos por e-mail ou login com o Google, ative o TOTP, recarregue, selecione São Bartolomeu e o serviço, aceite o preço exibido e leia o código no painel.

Linhas de longo prazo, cobrança e sandbox

São Bartolomeu não tem número de longo prazo em autoatendimento. As linhas dedicadas são um produto dos Estados Unidos e do Canadá a partir de $1.95/mês; para uma linha +590 duradoura, escreva para [email protected] para perguntar, embora a disponibilidade dependa das regras locais e não seja garantida.

Os pagamentos usam uma única carteira pré-paga em USD, conforme o uso, sem mensalidade nem plano. Recarregue por cartão ou com USDT/USDC e receba uma fatura em PDF por e-mail a cada recarga. As contas de desenvolvimento podem pedir o modo sandbox, que retorna números e códigos simulados para que a integração seja testada de ponta a ponta sem gastar saldo.

Use números +590 apenas para os seus próprios produtos e contas, siga os termos de cada serviço e note que a Política de Uso Aceitável da OTP Route se aplica.

Perguntas frequentes

Posso receber um código de verificação de São Bartolomeu sem um chip local?

Sim, se o serviço estiver na rota naquele momento. Peça um número +590 no OTP Gateway e leia o código no painel ou pela API.

Qual é o id de país de São Bartolomeu na API?

É bl, então o corpo de um pedido fica como {"service": "tiktok", "country": "bl"}.

Por que a lista de serviços de São Bartolomeu é tão curta?

É uma rota pequena e a cobertura muda com frequência. Consulte GET /api/v1/countries ou o painel para ver a lista atual e considere Guadalupe ou a França como alternativas.

O +590 sempre significa que o cliente está em São Bartolomeu?

Não. Guadalupe e a parte francesa de São Martinho compartilham o +590, então colete o território separadamente se isso importar para o seu produto.

Quanto custa um número +590 para testes?

A partir de $0.20 por código, com o valor exato definido por serviço e retornado ao vivo pela API antes de você pedir.

Perco dinheiro se o código nunca chegar?

Não. Após 20 minutos sem SMS, ou em caso de cancelamento, o valor integral volta para a sua carteira.

Posso manter um número de São Bartolomeu para logins recorrentes?

Não em autoatendimento. Os números dedicados só estão disponíveis nos EUA e no Canadá; escreva para [email protected] para perguntar sobre outras opções.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.