# Primeros pasos con Fluxis API

Fluxis está construido sobre el protocolo de código abierto [NASPIP](https://github.com/fluxisus/naspip). La API alojada gestiona el firmado, las solicitudes de pago POS, los webhooks y la conciliación para que puedas integrarte sin ejecutar tu propia infraestructura NASPIP.

## Inicio rápido (≈5 minutos)

### 1. Obtén credenciales

Tu representante de Fluxis te proporciona una **clave API** y un **secreto API** para staging (`https://api.stgfluxis.us`) o producción (`https://api.fluxis.us`).

### 2. Autentícate

```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"}'
```

Usa el token Bearer devuelto en todas las llamadas protegidas, junto con el header de tu clave API:

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

### 3. Descubre tu 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. Crea una solicitud de pago

```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"
  }'
```

La respuesta incluye un **token NASPIP** para mostrar como código QR o enlace de pago.

### 5. Recibe actualizaciones de estado

Registra un webhook de cuenta (`POST /v1/account/{accountID}/webhook`) y verifica las firmas — consulta [Webhooks](/es/docs/developers/webhooks) y [Verificación de firmas de webhooks](/es/docs/developers/webhook-signature-verification).

### 6. Concilia (respaldo)

Lista las liquidaciones con paginación: `GET /v1/transactions?page=1&page_size=50`.

## Próximos pasos

1. **[Guía de integración de la API](/es/docs/developers/tutorials/api-integration-guide)** — flujo completo de extremo a extremo
2. **[Referencia de la API](/api)** — todos los endpoints
3. **[Unique Asset IDs](/es/docs/key-concepts/uai)** — incluidos los mapeos de USDC.e
4. **[Modelo de seguridad NASPIP](/es/docs/key-concepts/naspip/security-model)** — modelo de verificación de tokens
5. **[Onboarding de comercios](/es/docs/merchant-integration/sign-up)** — Ready → Set → Go

---

Para acceso a producción y configuración de direcciones de liquidación, contacta con [support@fluxis.us](mailto:support@fluxis.us).