Skip to main content
POST
/
billings
/
tokenize-card
curl -X POST 'https://api.goatpay.com.br/v1/billings/tokenize-card' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "customer": { "name": "João da Silva", "taxId": "12345678909", "email": "joao@exemplo.com" }, "creditCard": { "holderName": "João da Silva", "number": "5162306219378829", "expiryMonth": "12", "expiryYear": "2028", "ccv": "123" }, "creditCardHolderInfo": { "name": "João da Silva", "email": "joao@exemplo.com", "cpfCnpj": "12345678909", "postalCode": "01310100", "addressNumber": "100", "phone": "11999999999" }, "remoteIp": "203.0.113.10" }'

{
  "success": true,
  "message": "Cartão tokenizado com sucesso",
  "data": {
    "creditCardToken": "a75a1d98-c52d-4a6b-a413-71e00b193c99",
    "creditCardBrand": "MASTERCARD",
    "creditCardNumberLast4": "8829"
  },
  "requestId": "req_abc"
}

curl -X POST 'https://api.goatpay.com.br/v1/billings/tokenize-card' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "customer": { "name": "João da Silva", "taxId": "12345678909", "email": "joao@exemplo.com" }, "creditCard": { "holderName": "João da Silva", "number": "5162306219378829", "expiryMonth": "12", "expiryYear": "2028", "ccv": "123" }, "creditCardHolderInfo": { "name": "João da Silva", "email": "joao@exemplo.com", "cpfCnpj": "12345678909", "postalCode": "01310100", "addressNumber": "100", "phone": "11999999999" }, "remoteIp": "203.0.113.10" }'

{
  "success": true,
  "message": "Cartão tokenizado com sucesso",
  "data": {
    "creditCardToken": "a75a1d98-c52d-4a6b-a413-71e00b193c99",
    "creditCardBrand": "MASTERCARD",
    "creditCardNumberLast4": "8829"
  },
  "requestId": "req_abc"
}

​
Corpo da requisição

​
customer
object
required
Cliente (name, taxId, email, phone).
​
creditCard
object
required
holderName, number, expiryMonth, expiryYear, ccv.
​
creditCardHolderInfo
object
required
name, email, cpfCnpj, postalCode, addressNumber, phone.
​
remoteIp
string
IP do comprador.

Authorizations

​
X-API-Key
string
header
required

Chave gp_live_... criada em Integrações → Chaves de API no dashboard.

Body

application/json
​
customer
object
required
​
creditCard
object
required
​
creditCardHolderInfo
object
required
​
remoteIp
string

Response

Operação concluída.

​
success
boolean
required
Example:

true

​
message
string
required
Example:

"Operação concluída com sucesso"

​
data
object
required
​
requestId
string