Copy page

Introdução

Primeiros passos com Fluxis API

O Fluxis é construído sobre o protocolo open source 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

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

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

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

3. Descubra seu 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. Crie uma solicitação de pagamento

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

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 e Verificação de assinatura de webhooks.

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 — fluxo completo de ponta a ponta
2. Referência da API — todos os endpoints
3. Unique Asset IDs — incluindo mapeamentos de USDC.e
4. Modelo de segurança NASPIP — modelo de verificação de tokens
5. Onboarding de comerciantes — Ready → Set → Go

---

Para acesso à produção e configuração de endereços de liquidação, entre em contato com [email protected].