Primeiros Passos
Autenticação
Token Authentication para todas as chamadas à Cakto Payments API.
Autenticação
Todas as chamadas à API usam Token Authentication (DRF Token):
Authorization: Token {seu_api_token}A Cakto fornece um único token opaco no onboarding — é uma string alfanumérica gerada pelo sistema (ex: 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b).
Formato do header
Authorization: Token {API_TOKEN}
Content-Type: application/jsonExemplos por linguagem
// Node.js (servidor — recomendado)
const headers = {
'Authorization': `Token ${process.env.CAKTO_API_TOKEN}`,
'Content-Type': 'application/json',
}function caktoHeaders(): HeadersInit {
return {
'Authorization': `Token ${process.env.CAKTO_API_TOKEN!}`,
'Content-Type': 'application/json',
}
}import os
def cakto_headers() -> dict:
return {
'Authorization': f'Token {os.environ["CAKTO_API_TOKEN"]}',
'Content-Type': 'application/json',
}curl -X POST https://api.cakto.com.br/api/checkout/ \
-H "Authorization: Token ${CAKTO_API_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ ... }'Endpoint público (sem autenticação)
O endpoint de token 3DS não exige autenticação:
GET {BASE_URL}/api/3ds/token/?provider=cieloVocê pode chamá-lo diretamente do browser sem o header Authorization.
Credenciais fornecidas pela Cakto
| Credencial | Descrição |
|---|---|
API_TOKEN | Token de API (formato: Token {chave}) |
MERCHANT_ID | ID numérico de merchant (campo user em todos os requests) |
NETHONE_SCRIPT_URL | URL do script de detecção de fraude |
Nunca exponha o token no bundle do cliente. Use variáveis de ambiente no servidor e um BFF (Backend for Frontend) para fazer as chamadas autenticadas. Ver Next.js BFF.