Copy page

Introducción

Primeros pasos con Fluxis API

Fluxis está construido sobre el protocolo de código abierto 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

Code
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:

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

3. Descubre tu Point of Sale

Code
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

Code
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 y Verificación de firmas de webhooks.

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 — flujo completo de extremo a extremo
2. Referencia de la API — todos los endpoints
3. Unique Asset IDs — incluidos los mapeos de USDC.e
4. Modelo de seguridad NASPIP — modelo de verificación de tokens
5. Onboarding de comercios — Ready → Set → Go

---

Para acceso a producción y configuración de direcciones de liquidación, contacta con [email protected].