> ## 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.

# POST /api/v1/accounts/onboarding/sync-status

> Sincroniza o status de todos os sellers pendentes das organizações do usuário com o gateway de pagamentos

Consulta o gateway de pagamentos e atualiza no banco de dados o status de todos os sellers em estado pendente (`pending`, `new`, `action_required`) associados às organizações do usuário autenticado. Deve ser chamado após o login para manter os dados de status sempre atualizados.

## Autenticação

Requer autenticação via **Supabase JWT** (usuário autenticado).

## Corpo da Requisição

Nenhum parâmetro necessário no corpo. A API identifica as organizações a partir do usuário autenticado.

## Resposta

**updated** `integer`

Número de sellers que tiveram o status atualizado.

**sellers** `array`

Lista de sellers cujo status foi alterado.

**Propriedades de cada item**

**seller\_id** `string`

ID do seller no gateway

**old\_status** `string`

Status anterior

**new\_status** `string`

Novo status após sincronização

## Exemplo

```bash cURL theme={null}
curl -X POST "https://api.chargefy.io/api/v1/accounts/onboarding/sync-status" \
  -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 result = await chargefy.accounts.onboarding.syncStatus();
console.log(`${result.updated} seller(s) atualizados`);
```

## Resposta de Exemplo

```json theme={null}
{
  "updated": 1,
  "sellers": [
    {
      "seller_id": "seller_xyz456",
      "old_status": "pending",
      "new_status": "active"
    }
  ]
}
```

### Quando não há sellers para atualizar

```json theme={null}
{
  "updated": 0,
  "sellers": []
}
```

## Erros

| Status | Descrição |
| - | - |
| `401` | Token ausente ou inválido |
| `500` | Falha na comunicação com o banco de dados ou gateway |


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