> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/accounts/onboarding/seller_xyz456" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

const seller = await chargefy.accounts.onboarding.get('seller_xyz456');
console.log('Status:', seller.status);
```

## Resposta de Exemplo

```json theme={null}
{
  "sellerId": "seller_xyz456",
  "accountId": "acc_abc123",
  "organizationId": "org_xyz456",
  "status": "active",
  "zoopStatus": "active",
  "polarStatus": "active",
  "type": "individual",
  "sellerType": "individual",
  "taxpayerId": "12345678901",
  "email": "joao@exemplo.com",
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.