Tokenização de Cartão

{
  "number": "4000000000000010",
  "holderName": "JOAO M SILVA",
  "expirationMonth": "12",
  "expirationYear": "2028",
  "cvv": "123"
}

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZWxsZXIiOjEsImNhcmQiOnsib...kZCI6dHJ1ZX0sImlhdCI6MTY4NTM4MjAwMSwiZXhwIjoxNjg1MzgyMzAxfQ.aBcDeFgHiJkLmNoPqRsTuVwXyZ

POST

api

card-token

{
  "number": "4000000000000010",
  "holderName": "JOAO M SILVA",
  "expirationMonth": "12",
  "expirationYear": "2028",
  "cvv": "123"
}

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZWxsZXIiOjEsImNhcmQiOnsib...kZCI6dHJ1ZX0sImlhdCI6MTY4NTM4MjAwMSwiZXhwIjoxNjg1MzgyMzAxfQ.aBcDeFgHiJkLmNoPqRsTuVwXyZ

Tokenização de Cartão

Este endpoint permite que você tokenize dados de cartão de crédito de forma segura, convertendo informações sensíveis do cartão em um token que pode ser usado para transações sem armazenar os dados reais do cartão.

Autenticação

Este endpoint utiliza autenticação via query parameter:

https://api.hydrahub.com.br/api/v1/card-token?publicKey=pk_userKey

Parâmetros da Requisição

publicKey

string

required

Sua chave pública para tokenização

Body da Requisição

number

string

required

Número do cartão de crédito

holderName

string

required

Nome do titular como aparece no cartão

expirationMonth

string

required

Mês de expiração (formato: MM)

expirationYear

string

required

Ano de expiração (formato: AAAA)

cvv

string

required

Código de segurança do cartão

{
  "number": "4000000000000010",
  "holderName": "JOAO M SILVA",
  "expirationMonth": "12",
  "expirationYear": "2028",
  "cvv": "123"
}

Resposta

A resposta é o token do cartão em formato JWT:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZWxsZXIiOjEsImNhcmQiOnsib...kZCI6dHJ1ZX0sImlhdCI6MTY4NTM4MjAwMSwiZXhwIjoxNjg1MzgyMzAxfQ.aBcDeFgHiJkLmNoPqRsTuVwXyZ

Exemplo com cURL

curl --location 'https://api.hydrahub.com.br/api/v1/card-token?publicKey=pk_userKey' \
--header 'Content-Type: application/json' \
--data '{
    "number": "4000000000000010",
    "holderName": "JOAO M SILVA",
    "expirationMonth": "12",
    "expirationYear": "2028",
    "cvv": "123"
}'

Códigos de Resposta

200 - Token gerado com sucesso
401 - Erro de autenticação
400 - Dados inválidos

Segurança

Por razões de segurança, nunca armazenamos os dados completos do cartão em nossos servidores. O token gerado é único e só pode ser utilizado para criar uma transação com sua conta.

Validade do Token

O token gerado tem validade de 5 minutos. Após esse período, será necessário gerar um novo token para realizar uma transação.

Transações de Pagamento Transações com Cartão

Introdução

Status e Informações

Transações

Sellers

Tokenização de Cartão

Tokenização de Cartão

Autenticação

Parâmetros da Requisição

Body da Requisição

Resposta

Exemplo com cURL

Códigos de Resposta

Segurança

Validade do Token

​Tokenização de Cartão

​Autenticação

​Parâmetros da Requisição

​Body da Requisição

​Resposta

​Exemplo com cURL

​Códigos de Resposta

​Segurança

​Validade do Token

Tokenização de Cartão

Autenticação

Parâmetros da Requisição

Body da Requisição

Resposta

Exemplo com cURL

Códigos de Resposta

Segurança

Validade do Token