Identificar Conta (whoami)

Valida uma credencial e devolve a identidade da conta por trás dela, se ela já está apta a
transacionar e quais métodos e recursos estão disponíveis. Use no seu processo de integração para
confirmar que as chaves estão corretas antes de tentar a primeira cobrança.

GET https://api.legacyecombrasil.com/whoami

📘

Este endpoint nunca retorna 403 por causa do estado da conta

Se a credencial for válida, a resposta é sempre 200 — mesmo com o KYC pendente ou a conta
bloqueada. O motivo vem nos campos canTransact e reason. O 401 fica reservado para
credencial inválida, revogada ou inexistente.

Formas de autenticar

Diferente dos demais endpoints, o /whoami também aceita apenas a Public Key. O que você envia
determina o escopo da resposta (campo scope).

❗

A Secret Key continua sendo proibida no browser

No escopo company a restrição de sempre vale: requisições com Origin ou Referer são
rejeitadas com 403 Forbidden. O escopo public aceita chamadas do browser — a pk_live_* foi
feita para ficar exposta. Consulte o guia de Autenticação.

Exemplo de requisição

GET /whoami
Host: api.legacyecombrasil.com
Authorization: Basic base64(pk_live_xxxx:sk_live_yyyy)

Validando apenas a Public Key, direto do browser:

GET /whoami
Host: api.legacyecombrasil.com
x-public-key: pk_live_xxxx

Resposta 200 OK

Exemplo no escopo company, que traz o payload completo:

{
  "scope": "company",
  "companyId": "3f9a1c2e-7b41-4d88-9c05-1e2f3a4b5c6d",
  "companyName": "Alpha Comércio LTDA",
  "tradeName": "Alpha",
  "document": "**.***.***/0001-99",
  "kycStatus": "approved",
  "blocked": false,
  "canTransact": true,
  "reason": null,
  "paymentMethods": ["pix", "credit_card", "boleto"],
  "capabilities": {
    "tokenization": {
      "enabled": true,
      "mode": "backend",
      "cardOnFile": true,
      "cvvRequired": false
    },
    "threeDS": { "enabled": true, "flow": "pre-order" },
    "antifraud": { "enabled": true }
  }
}

Conta ainda em análise, no escopo public — repare que o status é 200, não 403:

{
  "scope": "public",
  "companyId": "3f9a1c2e-7b41-4d88-9c05-1e2f3a4b5c6d",
  "companyName": "Alpha Comércio LTDA",
  "kycStatus": "pending",
  "blocked": false,
  "canTransact": false,
  "reason": "KYC_NOT_APPROVED",
  "paymentMethods": ["pix"],
  "capabilities": {
    "tokenization": { "enabled": false },
    "threeDS": { "enabled": false },
    "antifraud": { "enabled": false }
  }
}

Campos da resposta

reason

capabilities

Reflete o que a conta consegue fazer no checkout. Um método ou recurso indisponível chega como
{ "enabled": false }.

📘

paymentMethods já considera tudo

A lista sai filtrada pelo que está de fato operante para a sua conta. Se credit_card não
aparecer mesmo com o KYC aprovado, pode faltar a habilitação de cartão — consulte o guia de
Autenticação e fale com o suporte.

Erros