> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Validação de Cartões
Uma transação de validação de cartões, também conhecida como zero dollar ou zero dólar, é uma funcionalidade usada para verificar se o cartão de crédito é válido sem gerar cobranças ao portador do cartão.
Para usar essa funcionalidade você precisa informar o número do cartão, do nome impresso no cartão, o CVV e a data de expiração.
## Validar um cartão via zero dollar
A funcionalidade de zero dollar funciona no momento de salvar um cartão de crédito.
Abaixo detalhamos o passo a passo:
### Passo 1 - Criar um merchant
Crie um merchant com pelo menos 1 provedor com suporte a validação de zero dollar.
Esse passo é importante porque o merchant criado será usado no passo 3
(validar e salvar o cartão)
```bash theme={null}
curl --location 'https://sandbox-api.malga.io/v1/merchants' \
--header 'x-api-key: ' \
--header 'x-client-id: ' \
--header 'Content-Type: application/json' \
--data '{
"name": "zero dollar validator",
"mcc": "4040",
"providers": [{
"priority": 1,
"name": "SANDBOX",
"credentials": {
"type": "SANDBOX",
"apiKey": "123"
}
}]
}'
```
Resultado:
```bash theme={null}
{
"id": "3fb1884c-f442-4044-be6f-5afe2e0629b5",
"name": "zero dollar validator",
"mcc": "4040",
"clientId": "e234eeb3-483d-4df2-87eb-1e2be5cdaccd",
"status": false,
"createdAt": "2023-05-30T13:16:06.979Z",
"updatedAt": "2023-05-30T13:16:06.979Z",
"providers": [
{
"id": "ead031bb-cd67-40e7-a5b2-aa3e5b08f934",
"name": "SANDBOX",
"priority": 1,
"credentials": {
"type": "SANDBOX",
"apiKey": "******"
},
"options": null,
"createdAt": "2023-05-30T13:16:06.979Z",
"updatedAt": "2023-05-30T13:16:06.979Z"
}
]
}
```
Nesse exemplo acima criamos um merchant usando nosso adapter de sandbox.
É importante dizer que nosso adapter sandbox não faz uma verificação real do
cartão. Usamos mocks para emular cenários.
### Passo 2 - Tokenização
Agora precisamos tokenizar os dados do cartão para trafegar os dados de forma segura.
```bash theme={null}
curl --location 'https://api.malga.io/v1/tokens' \
--header 'x-client-id: ' \
--header 'x-api-key: ' \
--header 'Content-Type: application/json' \
--data '{
"cardHolderName": "JOAO DA SILVA",
"cardNumber": "4929564637987814",
"cardCvv": "320",
"cardExpirationDate": "12/2026"
}'
```
Resultado:
```bash theme={null}
{
"tokenId": "d3202b89-1ccd-4dea-95f2-05b3561bc055"
}
```
Se você estiver usando um merchant com nosso provedor SANDBOX de testes, você pode variar o CVV para testar um cenário de cartão válido e outro de cartão inválido.
Para testar um cenário válido basta que o CVV termine com 0 (zero), por exemplo, 320.
Para testar um cenário que o cartão não é válido basta que o CVV não termine com 0 (zero), por exemplo, 321
Se tiver dúvidas sobre tokenização de cartão [clicando aqui](/documentations/tokenization/intro) você acessa nossa documentação sobre esse assunto.
### Passo 3 - Validar e salvar o cartão
O processo de verificação do cartão ocorre no momento que o cartão será salvo no cofre (vault) de cartões.
Para validar o cartão usando zero dollar precisamos informar 3 propriedades no payload:
* **merchantId:** Merchant contendo pelo menos 1 provedor com validação de zero dollar.
* **tokenId:** Token que contém os dados do cartão
* **cvvCheck:** `true` ou `false` para indicar o desejo de verificar ou não o cartão via zero dollar. Importante dizer que se você optar por não verificar o cartão, o mesmo será criado com status `pending`, permitindo que você tente validar esse cartão via uma transação.
```bash theme={null}
curl --location 'https://api.malga.io/v1/cards' \
--header 'x-client-id: ' \
--header 'x-api-key: ' \
--header 'Content-Type: application/json' \
--data '{
"merchantId": "",
"tokenId": "",
"cvvCheck": true
}'
```
Resultado:
```bash theme={null}
{
"id": "59085c6d-4d21-4fc0-a6da-dda38b51c2aa",
"status": "active",
"statusReason": null,
"createdAt": "2023-05-30T16:18:11.045Z",
"clientId": "e234eeb3-483d-4df2-87eb-1e2be5cdaccd",
"brand": "Visa",
"cardHolderName": "JOAO DA SILVA",
"cvvChecked": true,
"fingerprint": "p5hgkYxaw5EXgim3GbJ7KzDUhdtxo1O2+qkLFj/Qyoo=",
"first6digits": "492956",
"last4digits": "7814",
"expirationMonth": "12",
"expirationYear": "2026",
"transactionRequests": [
{
"id": "edd0d86a-76d0-4c2c-b924-1528510a5a32",
"createdAt": "2023-09-25T18:09:59.001Z",
"providerId": "5ce68ed3-2213-423b-8eaf-9d8c4b40df2b",
"providerType": "SANDBOX",
"requestStatus": "success",
"requestType": "zero_dollar",
"responseTs": "32ms"
}
]
}
```
## Provedores com suporte a zero dollar
| Provedor | Detalhes |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sandbox | Somente para testes. Use para emular comportamentos de cartão válido / inválido |
| Cielo | Suporta somente bandeiras Visa, Master e Elo |
| PagSeguro | [https://dev.pagbank.uol.com.br/docs/validando-um-cart%C3%A3o](https://dev.pagbank.uol.com.br/docs/validando-um-cart%C3%A3o) |
| Klap | [https://api.pasarela.multicaja.cl/docs/apitarjetas#operation/Demorado%20(Modelo%20PSP)](https://api.pasarela.multicaja.cl/docs/apitarjetas#operation/Demorado%20\(Modelo%20PSP\)) |
| Getnet Sep | [https://devportalgetnet.sensedia-eng.com/pt/products/online-payments/regional-api?doc=api-ref-card-verification](https://devportalgetnet.sensedia-eng.com/pt/products/online-payments/regional-api?doc=api-ref-card-verification) |