Skip to main content
POST
Tokenizar cartao
Tokenizes a credit card using the merchant’s active acquirer, without storing PAN/CVV in Safefy’s database. The returned token can be used in POST /v1/transactions via the cardToken field.

Request

POST /v1/card-tokenize

Parameters

Responses

200 — Success

400 — Invalid data

401 — Invalid JWT token

422 — Acquirer doesn’t support tokenization

Authorizations

Authorization
string
header
required

Token JWT obtido via /v1/auth/token

Body

application/json
cardNumber
string
required

Numero do cartao (13-19 digitos)

Example:

"4111111111111111"

cardHolderName
string
required

Nome impresso no cartao

Example:

"JOAO SILVA"

cardExpirationMonth
string
required

Mes de expiracao (1-12)

Example:

"12"

cardExpirationYear
string
required

Ano de expiracao (4 digitos)

Example:

"2028"

cardCvv
string
required

Codigo de seguranca (3-4 digitos)

Example:

"123"

Response

Cartao tokenizado com sucesso

data
object
message
string | null
error
object | null