POST AI agent ready /v1/validate/credit-card

API de validação de cartão de crédito - Luhn Check e detecção de marca

Envie um número de cartão de crédito e informe se ele passou na soma de verificação Luhn, qual rede de cartões o emitiu (Visa, Mastercard, Amex, Discover, JCB, Diners Club, UnionPay) e se é um cartão de crédito ou débito. O número é validado no servidor e nunca é armazenado ou registrado.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/validate/credit-card \
  -H "Content-Type: application/json" \
  -d '{"number":"4111111111111111"}'

When to use this API

Valide os números do cartão na finalização da compra antes de cobrar

Execute uma verificação rápida de Luhn no número do cartão antes de enviá-lo ao seu processador de pagamentos. Isso detecta erros de digitação e números falsos antes que cheguem ao Stripe ou Adyen, reduzindo as taxas de transação recusadas.

Mostre o ícone correto da marca do cartão em seu formulário de pagamento

Detecte se o usuário digitou um número Visa, Mastercard ou Amex enquanto digita e exibe o logotipo correspondente. Reduz a confusão do usuário e cria confiança durante a finalização da compra.

Sinalize números de cartões suspeitos em filas de análise de fraude

Valide em lote números de cartão armazenados em seu sistema de risco. As cartas que falharem na verificação de Luhn são garantidamente inválidas; sinalize-os automaticamente para que os analistas se concentrem nos casos ambíguos.

Frequently asked questions

Esta API armazena ou registra os números dos cartões que envio?

Não. O número do cartão é validado na memória do servidor e descartado imediatamente após o envio da resposta. Nada é gravado no disco ou em qualquer banco de dados.

Esta API pode verificar se um cartão está ativo e tem fundos?

Não. Este endpoint executa apenas uma soma de verificação Luhn e detecção de marca. Confirma que o número é estruturalmente válido, não que o cartão esteja ativo ou com fundos. Para verificação ao vivo, você precisa de um processador de pagamentos como o Stripe.

Quais marcas de cartão são suportadas?

Visa, Mastercard, American Express, Discover, JCB, Diners Club e UnionPay. Se o número passar na verificação de Luhn, mas não corresponder a um intervalo de BIN conhecido, o campo de marca retornará "Desconhecido".

O número precisa ser formatado de uma maneira específica?

Não. Espaços, traços e pontos são removidos automaticamente antes da validação. Você pode enviar "4111 1111 1111 1111" ou "4111-1111-1111-1111" e ambos funcionam.

O algoritmo de Luhn é suficiente para prevenir fraudes?

A verificação de Luhn filtra números aleatórios e digitados incorretamente. É uma primeira camada de validação, não uma ferramenta de prevenção de fraudes. Combine-o com a detecção de fraude integrada do seu processador de pagamentos para obter cobertura total.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.