---
title: "POST /cards/verify"
method: POST
path: "/cards/verify"
tags: ["Cards"]
---

# POST /cards/verify

`POST /cards/verify`

Validação de um novo cartão.<br><br> A autenticação no endpoint é feita da seguinte forma:
  * **Bearer Token Authorization**: Token JWT.

## Headers

- `Host` string, required

## Request body

- PostCardsVerifyRequest
  - `type` 'credit' | 'debit' | 'voucher', required — Tipo de cartão está sendo utilizado na cobrança.
  - `local_datetime` string, yyyy-MM-ddTHH:mm:ss, required — Data e hora da operação utilizando o fuso horário do local do dispositivo no formato ISO8601.
  - `initiator_id` string, required — Identificador externo (cliente) que pode ser utilizado em reversões e consultas.
  - `reference_id` string — Identificador externo, geralmente relacionado a um pedido ou outra referência do cliente, apenas em fluxos informacionais.
  - `statement_descriptor` string — Informação adicional apresentada na filipeta para o comprador final. Em geral o nome fantasia do cliente.
  - `merchant_category_code` string — Código de categoria do lojista ou sublojista relacionado à cobrança.
  - `card` object, required
    - `entry_mode` 'magstripe' | 'emv' | 'emv_contacless' | 'contactless' | 'qr_code' | 'manual' | 'credentials_on_file' — Método pelo qual foi realizada a leitura dos dados do cartão: * `magstripe`: Leitura da tarja magnética. * `emv`: Leitura por inserção de ICC, sendo os dados no padrão EMV. * `emv_contactless`: Leitura por aproximação, sendo os dados no padrão EMV. * `contactless`: Leitura por aproximação com tecnologia NFC ou bluetooth, por exemplo, em padrões não EMV. * `qr_code`: Leitura por código QR exibido em um terminal de pagamento.. * `manual`: Dados inseridos manualmente através de uma plataforma de pagamento. * `credentials_on_file`: Dados armazenados previamente.
    - `number` string, int32, required — Número do cartão (PAN) sendo utilizado na cobrança.
    - `expiration_date` string, YYMM, required — Data de expiração do cartão utilizando o formato ano e mês "YYMM".
    - `holder_name` string — Nome do portador do cartão.
    - `cvv` string, int32 — Código de segurança do cartão.
    - `fallback` boolean — Indicação se está sendo utilizado o entry_mode de fallback.
    - `brand` 'visa' | 'mastercard' | 'amex' | 'hipercard' | 'elo' | 'jcb' | 'aura' | 'dinners' — Bandeira do cartão.

## Response `200`

OK

- PostCardsVerifyResponse
  - `id` string, required — Identificador único da validação.
  - `initiator_id` string, required — Identificador externo (cliente) que pode ser utilizado em reversões e consultas.
  - `reference_id` string — Identificador externo, geralmente relacionado a um pedido ou outra referência do cliente, apenas em fluxos informacionais.
  - `status` 'authorized' | 'declined', required — Status atual da validação
  - `result` 'success' | 'failed', required — Resultado da operação de validação
  - `created_at` string, yyyy-MM-ddTHH:mm:ssZ, required — Data e hora da criação da validação no formato ISO8601.
  - `transaction_id` string, required — Identificador da transação emitido pelo provedor (Adquirente).
  - `operation_id` string — Identificador da operação gerado pela adquirente.
  - `authorization_code` string — Código de autorização.
  - `acquirer_message` string — Mensagem de resultado da operação retornada pela adquirente.
  - `acquirer_return_code` string, required — Código de resultado da operação retornado pela adquirente.
  - `card` object, required
    - `brand` string, required — Bandeira do cartão
    - `payment_account_reference` string — Referência exclusiva ao cartão, usada por comerciantes e adquirentes para vincular transações tokenizadas e não tokenizadas associadas ao mesmo cartão subjacente (PAR).

## Other responses

- `400` — BadRequest
- `401` — Não autorizado

---

[API](https://skmtc.dev/stone/apis/payments-processing-acquiring-paymentcardapi.md) · [All operations](https://skmtc.dev/stone/apis/payments-processing-acquiring-paymentcardapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stone/payments-processing-acquiring-paymentcardapi/revisions/29bc4962fa98/schema)