Detalhe de um cliente
GET
/api/customers/{{customer_id}}
Autenticação
Bearer pela sua API Key real (vk_live_* produção, vk_test_* sandbox). Crie a chave em https://app.dotfy.com.br/dashboard/chaves-api. Sem o header → 401. Com chave inválida/revogada → 401. Com chave sem o escopo necessário → 403 insufficient_scope.customers:read. customer_id vem da listagem (base64url do payerTaxId).Requisição
Parâmetros Header
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '/api/customers/{{customer_id}}' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"customer": {
"name": "Maria Silva",
"taxId": "12345678901",
"totalSpent": 1250.5,
"transactions": 5,
"status": "active",
"firstTransaction": "2026-04-01T09:00:00.000Z",
"lastTransaction": "2026-05-05T14:30:00.000Z",
"avgTicket": 250.1
},
"charges": [
{
"id": "clcharge0001",
"correlationId": "dotfy-1714000000000-abc12345",
"value": 250.1,
"status": "COMPLETED",
"description": "Pedido #1234",
"paidAt": "2026-05-05T14:30:00.000Z",
"createdAt": "2026-05-05T14:00:00.000Z",
"acquirer": "TREEAL"
}
]
}Modificado em 2026-07-02 06:57:27