# Primeiros passos com Fluxis API

O Fluxis é construído sobre o protocolo open source [NASPIP](https://github.com/fluxisus/naspip). A API hospedada cuida da assinatura, solicitações de pagamento POS, webhooks e conciliação para que você possa integrar sem executar sua própria infraestrutura NASPIP.

## Início rápido (≈5 minutos)

### 1. Obtenha credenciais

Seu representante Fluxis fornece uma **chave API** e um **segredo API** para staging (`https://api.stgfluxis.us`) ou produção (`https://api.fluxis.us`).

### 2. Autentique-se

```bash
curl -X POST https://api.fluxis.us/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_API_KEY","api_secret":"YOUR_API_SECRET"}'
```

Use o token Bearer retornado em todas as chamadas protegidas, junto com o header da sua chave API:

```
Authorization: Bearer <access_token>
x-fluxis-api-key: <your_api_key>
```

### 3. Descubra seu Point of Sale

```bash
curl "https://api.fluxis.us/v1/pos?page=1&page_size=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "x-fluxis-api-key: YOUR_API_KEY"
```

### 4. Crie uma solicitação de pagamento

```bash
curl -X POST "https://api.fluxis.us/v1/pos/YOUR_POS_ID/payment-request" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "x-fluxis-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "49.99",
    "unique_asset_id": "npolygon_t0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "reference_id": "order-001"
  }'
```

A resposta inclui um **token NASPIP** para exibir como código QR ou link de pagamento.

### 5. Receba atualizações de status

Registre um webhook de conta (`POST /v1/account/{accountID}/webhook`) e verifique as assinaturas — consulte [Webhooks](/pt/docs/developers/webhooks) e [Verificação de assinatura de webhooks](/pt/docs/developers/webhook-signature-verification).

### 6. Concilie (fallback)

Liste liquidações com paginação: `GET /v1/transactions?page=1&page_size=50`.

## Próximos passos

1. **[Guia de integração da API](/pt/docs/developers/tutorials/api-integration-guide)** — fluxo completo de ponta a ponta
2. **[Referência da API](/api)** — todos os endpoints
3. **[Unique Asset IDs](/pt/docs/key-concepts/uai)** — incluindo mapeamentos de USDC.e
4. **[Modelo de segurança NASPIP](/pt/docs/key-concepts/naspip/security-model)** — modelo de verificação de tokens
5. **[Onboarding de comerciantes](/pt/docs/merchant-integration/sign-up)** — Ready → Set → Go

---

Para acesso à produção e configuração de endereços de liquidação, entre em contato com [support@fluxis.us](mailto:support@fluxis.us).