Capturando códigos SMS do Vinted em números do OTP Route pela API

Qual é a sequência da API para uma ativação do Vinted?

O fluxo da API de código de verificação do Vinted usa os mesmos endpoints do OTP Gateway que qualquer outro serviço, em https://otproute.com/api/v1 com uma chave Bearer com prefixo or_live_:

1. Confirme o id do serviço com GET /api/v1/services; para o Vinted é vinted. Obtenha os ids dos países em GET /api/v1/countries.
2. Chame GET /api/v1/prices?country=<id>&service=vinted para ver o preço atual e se há números disponíveis para esse par.
3. Faça o pedido com POST /api/v1/activations e um corpo como {"service": "vinted", "country": "fr"}. Guarde o id da ativação e o número retornado.
4. Digite o número na etapa de telefone do Vinted da sua conta de teste e aguarde o código.
5. Se o cenário for abandonado, POST /api/v1/activations/{id}/cancel devolve o valor imediatamente.

As chaves são criadas no console do desenvolvedor, até 10 por conta, e a API aceita 300 requisições por minuto. GET /api/v1/balance é uma chamada barata de verificação prévia para um job de CI. A página para desenvolvedores reúne o material de referência em um só lugar.

Como um handler de webhook deve processar os códigos do Vinted?

Assine um endpoint (cinco são permitidos por conta) em activation.sms_received e também em activation.expired e activation.cancelled, para que os jobs em espera possam sair de forma limpa. Cada entrega inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>.

• Calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint e compare com o v1 em tempo constante.
• Descarte requisições com timestamps antigos para bloquear replays.
• Grave cada evento usando o id da ativação como chave, para que uma segunda entrega do mesmo evento não altere nada.
• Responda primeiro com um 2xx e entregue o trabalho lento a uma fila.

O polling é a alternativa mais simples para um único teste: chame GET /api/v1/activations/{id} a cada poucos segundos até o código aparecer ou a ativação terminar. Nosso guia sobre como proteger webhooks de OTP com HMAC mostra a verificação da assinatura em detalhes.

Quando o Vinted pede um número de telefone?

O Vinted é um marketplace de roupas de segunda mão e outros itens usados, operado como sites separados por país, principalmente na Europa. Como muitos marketplaces, ele pode pedir que os membros adicionem e confirmem um número de telefone do Vinted, por exemplo durante a criação da conta, quando um login vem de um dispositivo desconhecido ou antes de alterações em dados sensíveis da conta. Os avisos exatos diferem por mercado e mudam com o tempo, então trate qualquer plano de testes como algo a revisar depois que o Vinted atualizar o app.

Para equipes que criam soluções em torno do Vinted, como ferramentas para vendedores, agências que gerenciam a loja de uma marca ou engenheiros de QA que verificam uma integração, a verificação por SMS do Vinted para testes significa simplesmente levar esse código a um número que você controla.

Quais países posso escolher para um número do Vinted?

Os números do Vinted estão listados em 198 países. Entre as opções europeias estão França, Alemanha, Reino Unido, Espanha, Itália, Polônia, Lituânia, Países Baixos, Bélgica, República Tcheca, Portugal, Áustria, Suécia, Irlanda e Romênia, e a lista completa em GET /api/v1/countries vai muito além da Europa.

Em um marketplace, o país do número pesa mais do que em um app de mensagens. Escolha o número do mesmo mercado da conta que você está testando, porque um perfil do Vinted pertence a um site de país, e um número de outro lugar pode ser rejeitado ou simplesmente parecer estranho para o usuário. Nosso texto sobre roteamento por país para OTP explica como associar casos de teste a rotas.

Posso receber um OTP do Vinted pelo painel?

Sim. Entre na conta, recarregue a carteira, abra o OTP Gateway e escolha o Vinted e o país da conta. O preço é exibido antes de você confirmar. Copie o número no Vinted, e o código aparece na página da ativação assim que chega. É o mesmo pedido que uma chamada de API criaria, então os resultados das verificações manuais e automatizadas são comparáveis.

Por que um código do Vinted pode não chegar?

Cada ativação fica aberta por 20 minutos. Se nenhum SMS chegar nesse tempo, ou se você cancelar, o valor integral volta para a sua carteira automaticamente.

As causas comuns de um código ausente:

• Números virtuais recusados. O Vinted, como muitas plataformas, pode recusar um número virtual na verificação por telefone. Nenhuma rota muda isso, e é por isso que o reembolso existe.
• Entrega lenta. O tempo depende da rota, então deixe a janela correr antes de desistir.
• Estoque curto. Tente de novo um pouco mais tarde, ou com outro país que ainda corresponda ao seu teste.
• Tempestade de novas tentativas. Pedir de novo em loop apertado raramente ajuda; faça uma pausa e registre cada id de ativação.

Um número de longo prazo é alguma vez a melhor escolha para o trabalho com o Vinted?

Um número de uso único atende a um código. Se uma conta de teste precisa entrar de novo mais tarde, ou se uma equipe de operações precisa receber alertas da conta em uma linha estável, um Número Dedicado é a ferramenta melhor, mas ele só é vendido para os Estados Unidos e o Canadá, a partir de $1.95/month, com SMS de entrada no painel e no webhook number.sms_received. Como a maioria dos mercados do Vinted fica na Europa, isso só ajuda quando um número dos EUA ou do Canadá realmente combina com a conta. A comparação entre números temporários e dedicados cobre essa troca.

Como usamos os números do Vinted de forma responsável?

Siga os termos do Vinted. Mantenha uma conta por pessoa real ou empresa e use um número virtual para o Vinted apenas em contas e produtos que realmente sejam seus, como contas de teste da sua própria integração ou a loja da própria empresa. O OTP Route não serve para criar contas em escala nem para driblar decisões de uma plataforma, e a sua Política de Uso Aceitável se aplica a cada pedido. Vinted é marca registrada de seu titular, e o OTP Route não tem afiliação com ela.

Perguntas frequentes

Qual id de serviço o OTP Route usa para o Vinted?

Use vinted em GET /api/v1/prices e no corpo de POST /api/v1/activations.

Quanto custa receber um OTP do Vinted?

A partir de $0.20 por código; o preço exato depende do país e é retornado ao vivo pela API e exibido no painel.

Sou cobrado se o Vinted rejeitar o número?

Não. Se nenhum código chegar em 20 minutos ou se você cancelar, o valor integral é reembolsado na sua carteira.

De qual país deve vir o meu número de teste do Vinted?

Corresponda ao site de país da conta que você está testando, para que o número se encaixe no mercado a que o perfil pertence.

Posso testar minha integração com o Vinted sem gastar saldo da carteira?

Sim. Peça o modo sandbox em uma conta de desenvolvimento, e a API devolve números e códigos simulados para que você rode o fluxo de ponta a ponta.

Posso pagar pelos números de verificação do Vinted com cripto?

A carteira pré-paga em USD aceita pagamentos com cartão e stablecoins USDT/USDC, com uma fatura em PDF enviada por e-mail a cada recarga e sem mensalidade.

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.