Skip to main content
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 -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": "[email protected]",
  "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

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