---
title: "Tokenizar cartao"
method: POST
path: "/v1/card-tokenize"
tags: ["Transacoes"]
---

# Tokenizar cartao

`POST /v1/card-tokenize`

## Request body

- CardTokenizeRequest
  - `cardNumber` string, required — Numero do cartao (13-19 digitos)
  - `cardHolderName` string, required — Nome impresso no cartao
  - `cardExpirationMonth` string, required — Mes de expiracao (1-12)
  - `cardExpirationYear` string, required — Ano de expiracao (4 digitos)
  - `cardCvv` string, required — Codigo de seguranca (3-4 digitos)

## Response `200`

Cartao tokenizado com sucesso

- CardTokenizeResponse
  - `data` CardTokenizeData
    - `cardToken` string — Token do cartao (prefixo ct_). Valido por tempo limitado.
    - `last4` string — Ultimos 4 digitos do cartao
    - `brand` string — Bandeira do cartao
  - `message` string, nullable
  - `error` ApiErrorResponse, nullable
    - `message` string — Mensagem de erro
    - `code` string — Codigo do erro

## Other responses

- `400` — Dados invalidos
- `401` — Token JWT invalido
- `422` — Adquirente nao suporta tokenizacao

---

[API](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway.md) · [All operations](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safefy-pay/safefy-pix-gateway/revisions/c4fd84385e23/schema)