Validar Cartão (Zero Auth)

POST/api/v1/bank/wallet/zeroauth/Bearer Token

Autenticação

Requer Bearer token. Veja Autenticação.

Campos da requisição

Campo	Tipo	Obrigatório	Descrição
wallet_uuid	string (UUID)	Sim	Contexto da carteira para roteamento
holder_name	string	Sim	Nome do portador do cartão
card_number	string	Sim	Número da conta primária
expiry_month	string	Sim	Mês com dois dígitos (01–12)
expiry_year	string	Sim	Ano com quatro dígitos
cvv	string	Sim	Código de segurança (3–4 dígitos)
brand	string	Sim	Visa, Mastercard, AmericanExpress, Discover, DinersClub, JCB

Exemplo de requisição

cURL

curl -sS -X POST 'https://core-manager.a55.tech/api/v1/bank/wallet/zeroauth/' \
  -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "wallet_uuid": "1f937eb2-cf2c-421c-aa24-3f26519f42fa",
    "holder_name": "Jane Doe",
    "card_number": "4111111111111111",
    "expiry_month": "12",
    "expiry_year": "2030",
    "cvv": "123",
    "brand": "Visa"
  }'

Python

import os, requests

r = requests.post(
    "https://core-manager.a55.tech/api/v1/bank/wallet/zeroauth/",
    headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"},
    json={
        "wallet_uuid": "1f937eb2-cf2c-421c-aa24-3f26519f42fa",
        "holder_name": "Jane Doe",
        "card_number": "4111111111111111",
        "expiry_month": "12",
        "expiry_year": "2030",
        "cvv": "123",
        "brand": "Visa",
    },
    timeout=30,
)
data = r.json()
if data["is_valid"]:
    print("Card valid — proceed to tokenization")
else:
    print(f"Card rejected: code {data['code']}")

Exemplos de resposta

Cartão válido

{
  "internal_uuid": "d96561ac-4331-4553-921c-d1b01c63521d",
  "is_valid": true,
  "code": "00"
}

Cartão inválido

{
  "internal_uuid": "d96561ac-4331-4553-921c-d1b01c63521d",
  "is_valid": false,
  "code": "57"
}

Restrito

{
  "internal_uuid": "d96561ac-4331-4553-921c-d1b01c63521d",
  "is_valid": false,
  "code": "389"
}

Códigos de resposta

Código	Significado	Ação
00	Aprovado / cartão válido	Prossiga com tokenização ou cobrança
05	Não autorizado	Peça ao portador que contate o banco
14	Número de cartão inválido	Verifique a validação Luhn
54	Cartão expirado	Solicite um cartão válido
57	Transação não permitida	Tente outro cartão
62	Cartão restrito	Cartão bloqueado pelo emissor
63	Violação de segurança	Incompatibilidade de CVV
N7	Falha no CVV	Redigite o CVV
91	Emissor indisponível	Tente novamente depois
96	Mau funcionamento do sistema	Tente novamente ou contate o suporte
389	Restrição de cadastro	Cartão restrito
500	Requisição inválida	Corrija o corpo da requisição

Observações

• internal_uuid referencia a tentativa de verificação para tickets de suporte
• A A55 protege PAN e CVV com criptografia de ponta a ponta; prefira tokens para produção
• Combine com tokenização de cartão para armazenar apenas cartões validados