GET /api/v1/accounts/onboarding/:sellerId

Retorna o status atualizado de um seller, consultando diretamente o gateway de pagamentos

Busca o status mais recente de um seller no gateway de pagamentos Zoop e atualiza o banco de dados. Caso a consulta ao gateway falhe, retorna os dados armazenados localmente como fallback. Quando o seller se torna active, a conta e a organização são habilitadas automaticamente para cobranças e saques.

​

Autenticação

Requer autenticação via Supabase JWT (usuário autenticado). O usuário deve pertencer à organização associada ao seller.

​

Parâmetros de Path

sellerId · string · required

ID do seller no gateway de pagamentos (retornado na criação do seller).

​

Resposta

sellerId · string

ID do seller no gateway.

accountId · string

ID da conta associada ao seller.

organizationId · string

ID da organização associada ao seller.

status · string

Status atual no gateway: pending, active, action_required, new.

zoopStatus · string

Status retornado pelo gateway Zoop.

polarStatus · string

Status mapeado para o padrão Chargefy.

type · string

Tipo do seller: individual ou business.

sellerType · string

Alias de type.

taxpayerId · string

CPF ou CNPJ do seller (sem formatação).

email · string

E-mail do seller.

phone · string

Telefone do seller.

mcc · string

Código de categoria do comerciante.

businessName · string

Razão social (presente apenas para sellers do tipo business).

statementDescriptor · string

Descritor que aparece na fatura do cartão.

metadata · object

Metadados adicionais associados ao seller.

createdAt · string

Data de criação (ISO 8601).

updatedAt · string

Data da última atualização (ISO 8601).

​

Exemplo

cURL

curl -X GET "https://api.chargefy.io/api/v1/accounts/onboarding/seller_xyz456" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"

​

Resposta de Exemplo

{
  "sellerId": "seller_xyz456",
  "accountId": "acc_abc123",
  "organizationId": "org_xyz456",
  "status": "active",
  "zoopStatus": "active",
  "polarStatus": "active",
  "type": "individual",
  "sellerType": "individual",
  "taxpayerId": "12345678901",
  "email": "[e-mail]",
  "phone": "11999998888",
  "mcc": "5999",
  "businessName": null,
  "statementDescriptor": "João Silva",
  "metadata": {
    "organization_id": "org_xyz456",
    "account_id": "acc_abc123"
  },
  "createdAt": "2026-03-01T10:00:00Z",
  "updatedAt": "2026-03-20T14:30:00Z"
}

​

Erros

Status	Descrição
403	Usuário não tem acesso à organização do seller
404	Seller não encontrado
500	Erro interno