# Verify a Card

Process a zero amount payment transaction just for validating the card. This guide walks you through every step of using the Getnet Global API for this common e-commerce flow.

## Requirements

Before following the steps, you need to:

* Create your account by contacting the Integration Support team to get your API credentials `client_id` and `client_secret`.
* Generate your token with your credentials using the [Authentication endpoint](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/authentication).

> Getnet provides a [Postman Collection](/en/global-api/sep-api/first-steps-api/postman-collection) to help you to replicate these use cases locally. You can also test the API in **sandbox** using the API Reference available in the documentation.

## Use Cases Specifics

When integrating any Getnet solution, market-specific requirements apply. Be sure to review the resources below before you go live:

* [Currency codes](https://docs.globalgetnet.com/en/articles?article=currency-codes)
* [Document types](https://docs.globalgetnet.com/en/articles?article=document-types)
* [Local taxes and regulations](https://docs.globalgetnet.com/en/articles?article=taxes-and-regulations)

You can also use [test cards](https://docs.globalgetnet.com/en/articles?article=test-cards) to simulate specific scenarios. More information about specific requirements for each country can be found in the [Developer Resources section](https://docs.globalgetnet.com/en/articles?article=currency-codes) of the Getnet documentation.

### Step 1: Verifing a card

A zero amount payment starts with authorization. This step validates the customer and card's details. Use the [Card verification endpoint](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/cards/post/dpm/cofre-gw-proxy/v1/cards/verification) to initiate the transaction.

The table below lists the fields you need to send:

| Attribute          | Type   | Description                       | Example                           |
| ------------------ | ------ | --------------------------------- | --------------------------------- |
| `number_token`     | String | Tokenized card number.            | `dfe05208b105578c070f806c80abd3a` |
| `brand`            | String | Card Brand.                       | `Mastercard`                      |
| `cardholder_name`  | String | Buyer's name printed on the card. | `JOAO DA SILVA`                   |
| `expiration_month` | String | Two-digit card expiration month.  | `28`                              |
| `expiration_year`  | String | Two-digit card expiration year.   | `12`                              |
| `security_code`    | String | Security code. CVV or CVC.        | `123`                             |

The following code block shows an example of a request and response to authorize a payment:

```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"
}'
```

Example of response:

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

The Getnet system automatically sends an internal zero-amount transaction along with the card details, allowing the issuer to validate the card’s existence and eligibility.
After a successful validation, you can create the payments.

<Callout type="warning">

This is a verification with no financial transaction, in which no amount is credited to the card.

</Callout>

### Next Steps

You can explore more features of the Getnet Global API:

* Learn how to create a [Single-Step Payment](/en/global-api/sep-api/payment-guides-api/card-payments/single-step-payment).
* Learn how to create a [Create a Pre-authorized Card Payment](/en/global-api/sep-api/payment-guides-api/card-payments/pre-auth-payment).
* Learn how to create a Create a Tokenized Payment