Skip to main content
POST
/
api
/
v1
/
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.