# Fluxis Payment Processor

Fluxis is a comprehensive payment processing platform that enables secure, efficient payment transactions using <a href="/docs/key-concepts/naspip/introduction" style={{color: '#00d086'}}>NASPIP tokens</a>. This documentation details its technical architecture, core features, and integration guidelines for developers and product owners.

## Get Familiar with Fluxis

<div style={{display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(300px, 1fr))', gap: '1.5rem', margin: '2rem 0'}}>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/introduction/getting-started")}
>
  <h3>🚀 Getting Started</h3>
  <p>Quick integration guide</p>
  <a href="/docs/introduction/getting-started">Start building with Fluxis</a>
</div>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/key-concepts/naspip/protocol-specification")}
>
  <h3>🏗️ Architecture</h3>
  <p>Understand technical design</p>
  <a href="/docs/key-concepts/naspip/protocol-specification">Explore NASPIP Protocol</a>
</div>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/applications/use-cases")}
>
  <h3>🌐 Supported Networks</h3>
  <p>Explore integrated networks</p>
  <a href="/docs/applications/use-cases">View supported blockchains</a>
</div>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/key-concepts/naspip/introduction")}
>
  <h3>💰 Payment Tokens</h3>
  <p>Explore supported currencies</p>
  <a href="/docs/key-concepts/naspip/introduction">Learn about NASPIP tokens</a>
</div>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/key-concepts/naspip/security-model")}
>
  <h3>🔐 Security</h3>
  <p>Verify Fluxis security</p>
  <a href="/docs/key-concepts/naspip/security-model">Security documentation</a>
</div>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/api")}
>
  <h3>📊 API Reference</h3>
  <p>Complete API documentation</p>
  <a href="/api">Explore API endpoints</a>
</div>

</div>

## How Fluxis Works

Fluxis simplifies payment processing through a three-step process:

### 1. Payment Request Creation

Merchants create payment requests with specific amounts, currencies, and recipient details. Fluxis generates secure NASPIP tokens containing encrypted payment instructions.

```bash
# 1) Exchange API key + secret for a Bearer token
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"}'

# 2) Create a payment request for a Point of Sale
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": "100.00",
    "unique_asset_id": "npolygon_t0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
    "reference_id": "order-12345"
  }'
```

### 2. Customer Payment

Customers receive payment instructions via QR codes, payment links, or NFC terminals. They use their preferred wallet to complete the payment according to the NASPIP token specifications.

::::info 
**NASPIP URL tokens**

When a NASPIP token embeds a `url` (static payment link), `POST /v1/naspip/read` automatically fetches the live payment instructions from that URL before returning the payload.
::::

### 3. Payment Settlement

Once payment is confirmed on the blockchain, Fluxis automatically settles funds with the merchant, handling all the complex verification and transfer processes.

## Supported Payment Types

<div style={{display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(280px, 1fr))', gap: '1.5rem', margin: '2rem 0'}}>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    textAlign: "center",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/applications/use-cases")}
>
  <h3>🪙 Cryptocurrency Payments</h3>
  <p>Multi-network stablecoins via Unique Asset IDs (UAI); on-chain settlement monitoring on Polygon, Base, Avalanche, and Arbitrum</p>
  <a href="/docs/applications/use-cases">Learn about crypto payments</a>
</div>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    textAlign: "center",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/key-concepts/uai")}
>
  <h3>⚡ Multi-network UAIs</h3>
  <p>Standardized asset IDs across networks (see UAI catalog)</p>
  <a href="/docs/key-concepts/uai">View supported assets</a>
</div>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "1.5rem",
    textAlign: "center",
    transition: "all 0.2s ease-in-out",
    cursor: "not-allowed",
    opacity: "0.7",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#19323a";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(25, 50, 58, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
>
  <h3>🏦 Traditional Payments</h3>
  <p>Credit cards, bank transfers, digital wallets</p>
  <span style={{ color: "#6b7280" }}>Coming soon</span>
</div>

</div>

## Our Products

<div style={{display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(300px, 1fr))', gap: '2rem', margin: '2rem 0'}}>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "2rem",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/developers/tutorials/api-integration-guide")}
>
  <h3>🔧 Fluxis API</h3>
  <p>
    REST API for POS management, payment requests, NASPIP tokens, webhooks, and
    transaction reconciliation.
  </p>
  <ul>
    <li>NASPIP token create/read (`POST /v1/naspip/create`, `POST /v1/naspip/read`)</li>
    <li>Point of Sale and payment requests (`/v1/pos/...`)</li>
    <li>Account webhooks and signature verification</li>
    <li>Transaction listing with pagination (`GET /v1/transactions`)</li>
    <li>Refunds for completed payment requests</li>
  </ul>
  <a href="/docs/developers/tutorials/api-integration-guide">API integration guide</a>
</div>

<div
  style={{
    border: "1px solid #e2e8f0",
    borderRadius: "8px",
    padding: "2rem",
    transition: "all 0.2s ease-in-out",
    cursor: "pointer",
  }}
  onMouseEnter={(e) => {
    e.currentTarget.style.borderColor = "#837ff9";
    e.currentTarget.style.boxShadow = "0 4px 12px rgba(131, 127, 249, 0.15)";
    e.currentTarget.style.transform = "translateY(-2px)";
  }}
  onMouseLeave={(e) => {
    e.currentTarget.style.borderColor = "#e2e8f0";
    e.currentTarget.style.boxShadow = "none";
    e.currentTarget.style.transform = "translateY(0)";
  }}
  onClick={() => (window.location.href = "/docs/key-concepts/naspip/introduction")}
>
  <h3>📋 NASPIP Protocol</h3>
  <p>Open-source protocol for secure, network-agnostic payment instructions.</p>
  <ul>
    <li>Cryptographically signed payment tokens</li>
    <li>Cross-network compatibility</li>
    <li>Tamper-proof payment instructions</li>
    <li>Standardized payment format</li>
    <li>Extensible architecture</li>
  </ul>
  <a href="/docs/key-concepts/naspip/introduction">Learn about NASPIP</a>
</div>

</div>

## Key Benefits

### 🚀 Easy Integration

Get started with just a few API calls. No complex blockchain infrastructure required.

### 🔒 Enterprise Security

Built-in security features including cryptographic key rotation, signed NASPIP tokens, and webhook signature verification.

### 🌍 Global Reach

Support for multiple blockchain networks via the UAI catalog, with expanding settlement coverage.

### ⚡ Real-time Processing

Instant payment validation and settlement with comprehensive webhook notifications.

### 📈 Scalable Infrastructure

Auto-scaling architecture that grows with your business needs.

### 💰 Cost Effective

Competitive pricing with transparent fee structure and no hidden costs.

## Getting Started

Ready to start accepting payments with Fluxis? Here's how:

1. **[Sign Up](https://fluxis.us/signup)** - Create your Fluxis account
2. **[Get API Keys](https://fluxis.us/dashboard)** - Generate your authentication credentials
3. **[Make Your First Request](/docs/introduction/getting-started)** - Create your first payment request
4. **[Explore the API](/api)** - Discover all available endpoints

## Why Choose Fluxis?

While you could implement payment processing yourself, Fluxis provides:

- **Faster Time to Market**: Launch in days, not months
- **Reduced Development Costs**: No need to build complex infrastructure
- **Enhanced Security**: Enterprise-grade security out of the box
- **Ongoing Support**: Expert assistance when you need it
- **Future-Proof**: Automatic updates and new feature rollouts

---

_Last updated on May 21, 2026_