Getnet DocsGetnet Docs

Verificar um Cartão

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Processe uma transação de pagamento com valor zero apenas para validar o cartão. Este guia orienta você em cada etapa do uso da Global API da Getnet para esse fluxo comum de e-commerce.

Requisitos

Antes de seguir os passos, você precisa:

  • Criar sua conta entrando em contato com a equipe de Suporte de Integração para obter suas credenciais de API client_id e client_secret.
  • Gerar seu token com suas credenciais utilizando o endpoint de Authentication.

A Getnet disponibiliza uma Postman Collection para ajudar você a reproduzir esses casos de uso localmente. Você também pode testar a API em sandbox utilizando a API Reference disponível na documentação.

Especificidades dos Casos de Uso

Ao integrar qualquer solução da Getnet, aplicam-se requisitos específicos de mercado. Certifique-se de revisar os recursos abaixo antes de ir para produção:

Você também pode usar cartões de teste para simular cenários específicos. Mais informações sobre requisitos específicos de cada país podem ser encontradas na seção Developer Resources da documentação da Getnet.

Step 1: Verificando um cartão

Um pagamento com valor zero começa com a autorização. Esta etapa valida o cliente e os dados do cartão. Utilize o endpoint de verificação de cartão para iniciar a transação.

A tabela abaixo lista os campos que você precisa enviar:

AtributoTipoDescriçãoExemplo
number_tokenStringNúmero do cartão tokenizado.dfe05208b105578c070f806c80abd3a
brandStringBandeira do cartão.Mastercard
cardholder_nameStringNome do portador impresso no cartão.JOAO DA SILVA
expiration_monthStringMês de expiração do cartão (dois dígitos).28
expiration_yearStringAno de expiração do cartão (dois dígitos).12
security_codeStringCódigo de segurança. CVV ou CVC.123

O bloco de código a seguir mostra um exemplo de requisição e resposta para autorizar um pagamento:

curl --request POST \
  --url https://api.pre.globalgetnet.com/dpm/cofre-gw-proxy/v1/cards/verification \
  --header 'authorization: Bearer ' \
  --header 'content-type: application/json' \
  --header 'x-seller-id: 54f88e68-7764-4e87-8830-756b1e2c02f8' \
  --header 'x-transaction-channel-entry: XX' \
  --data '{
  "number_token": "dfe05208b105578c070f806c80abd3a",
  "brand": "Mastercard",
  "cardholder_name": "JOAO DA SILVA",
  "expiration_month": "12",
  "expiration_year": "28",
  "security_code": "123"
}'

Exemplo de resposta:

{
  "status": "VERIFIED",
  "verification_id": "ae267804-503c-4163-b1b1-f5da5120b74e",
  "authorization_code": "6964722471672911",
  "transaction_id": "1002217281190421"
}

O sistema da Getnet envia automaticamente uma transação interna de valor zero juntamente com os dados do cartão, permitindo que o emissor valide a existência e elegibilidade do cartão. Após uma validação bem-sucedida, você pode criar pagamentos.

Esta é uma verificação sem transação financeira, na qual nenhum valor é creditado ao cartão.

Próximos Passos

Você pode explorar mais funcionalidades da Global API da Getnet: