Dados da conta

Identifica a conta dona da chave usada na requisição.

GET/v1/accountescopo: account:read
cURL
curl https://api.transakto.io/v1/account \
  -H "x-api-key: sk_live_..."
Resposta 200
{
  "id": "1c9d4f22-7a3e-4b58-8f10-2d6b9c0e3a41",
  "object": "account",
  "name": "Loja Exemplo",
  "legal_name": "Exemplo Comércio LTDA",
  "document": "12345678000195",
  "document_type": "CNPJ",
  "phone": "+5511900000000",
  "status": "active",
  "onboarding_status": "COMPLETED",
  "auto_payout_enabled": false,
  "created_at": "2026-01-14T10:22:00.000Z"
}

Campos

status
stringopcional
active ou inactive. Uma conta inativa não processa cobranças.
onboarding_status
stringopcional
Estágio do cadastro. Contas sem onboarding concluído têm restrições.
auto_payout_enabled
booleanoopcional
Se as transferências criadas pela API seguem direto para processamento ou entram na fila de aprovação manual.

Uso típico

Serve para validar credencial na configuração da integração: uma chamada barata que confirma que a chave é válida e mostra de qual conta ela é. Também é como o seu sistema descobre o modo de transferência sem perguntar ao usuário, lendo auto_payout_enabled.