Skip to main content
POST
/
v1
/
card-token
Tokenizar cartão
curl --request POST \
  --url https://api.ephra.io/v1/card-token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "4111111111111111",
  "holderName": "MARIA SILVA",
  "expirationMonth": "07",
  "expirationYear": "28",
  "cvv": "123"
}
'
{
  "success": true,
  "token": "tok_abc123..."
}
Tokeniza os dados sensíveis do cartão e devolve um token opaco. Use esse token no campo card.cardToken ao criar a cobrança — número e CVV nunca trafegam na rota de cobrança.
Esta é a única rota que recebe número e CVV do cartão. Chame-a a partir do seu back-end, sobre HTTPS.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
number
string
required

Número do cartão (validado por Luhn)

Example:

"4111111111111111"

​
holderName
string
required
Example:

"MARIA SILVA"

​
expirationMonth
string
required

Mês 01-12

Example:

"07"

​
expirationYear
string
required

2 ou 4 dígitos

Example:

"28"

​
cvv
string
required

3 ou 4 dígitos

Example:

"123"

Response

Token gerado

​
success
boolean
Example:

true

​
token
string
Example:

"tok_abc123..."