# Verificar um Cartão

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](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/authentication).

> A Getnet disponibiliza uma [Postman Collection](/en/global-api/sep-api/first-steps-api/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:

* [Códigos de moeda](https://docs.globalgetnet.com/en/articles?article=currency-codes)
* [Tipos de documento](https://docs.globalgetnet.com/en/articles?article=document-types)
* [Impostos e regulamentações locais](https://docs.globalgetnet.com/en/articles?article=taxes-and-regulations)

Você também pode usar [cartões de teste](https://docs.globalgetnet.com/en/articles?article=test-cards) 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](https://docs.globalgetnet.com/en/articles?article=currency-codes) 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](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/cards/post/dpm/cofre-gw-proxy/v1/cards/verification) para iniciar a transação.

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

| Atributo          | Tipo   | Descrição                                | Exemplo                           |
| ------------------ | ------ | ------------------------------------------ | --------------------------------- |
| `number_token`     | String | Número do cartão tokenizado.               | `dfe05208b105578c070f806c80abd3a` |
| `brand`            | String | Bandeira do cartão.                        | `Mastercard`                      |
| `cardholder_name`  | String | Nome do portador impresso no cartão.       | `JOAO DA SILVA`                   |
| `expiration_month` | String | Mês de expiração do cartão (dois dígitos). | `28`                              |
| `expiration_year`  | String | Ano de expiração do cartão (dois dígitos). | `12`                              |
| `security_code`    | String | Có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:

```json
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:

```json
{
  "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.

<Callout type="warning">

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

</Callout>

### Próximos Passos

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

* Saiba como criar um [Single-Step Payment](/pt/global-api/sep-api/payment-guides-api/card-payments/single-step-payment).
* Saiba como criar um [Create a Pre-authorized Card Payment](/pt/global-api/sep-api/payment-guides-api/card-payments/pre-auth-payment).
* Saiba como criar um Create a Tokenized Payment