Quick Start

Documentation Index

Fetch the complete documentation index at: https://developers.fd.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​

Prerequisites

• A District Pass account
• A server-side application (Node.js, Python, or Java)
• A wallet address to receive settlement funds

​

Step 1: Get Your API Credentials

1. Log in to the Prism Console with your District Pass
2. Create a new Project or use the default Project
3. Navigate to Project Identify Tokens and generate a token
4. Copy your Project Identify Token — you’ll need it for the SDK configuration

​

Step 2: Install the SDK

pip install finance-district

<dependency>
  <groupId>xyz.financedistrict</groupId>
  <artifactId>prism-sdk</artifactId>
  <version>LATEST</version>
</dependency>

​

Step 3: Add Payment Middleware

import express from "express";
import { prismPaymentMiddleware } from "@1stdigital/prism-express";

const app = express();

app.use(
  prismPaymentMiddleware(
    {
      identifyToken: process.env.PRISM_IDENTIFY_TOKEN,
      baseUrl: "https://prism-gw.fd.xyz",
    },
    {
      "/api/premium": {
        price: "$0.01",
        description: "Premium API access",
      },
    }
  )
);

app.get("/api/premium", (req, res) => {
  res.json({
    message: "Premium content",
    payer: req.payer,  // wallet address that paid
  });
});

app.listen(3000, () => console.log("Server running on port 3000"));

from fastapi import FastAPI, Depends
from finance_district import require_payment, PaymentVerified

app = FastAPI()

@app.get("/api/premium")
async def premium_content(
    payment: PaymentVerified = Depends(require_payment(0.01, "USD"))
):
    return {"content": "Premium data", "payer": payment.payer}

from flask import Flask, jsonify
from finance_district import require_payment

app = Flask(__name__)

@app.route("/api/premium")
@require_payment(amount=0.01, currency="USD")
def premium_content():
    return jsonify({"content": "Premium data"})

​

Step 4: Test the Integration

curl http://localhost:3000/api/premium

{
  "x402Version": 2,
  "error": "Payment required to access this resource",
  "resource": {
    "url": "https://api.example.com/api/premium",
    "description": "Premium API access",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:84532",
      "amount": "10000",
      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "payTo": "0xYourWallet...",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ],
  "extensions": null
}

​

Step 5: Go Live

1. Switch to mainnet in your Prism Console Project settings
2. Generate a mainnet Project Identify Token
3. Update your wallet address to your production wallet
4. Monitor transactions in the Prism Console

​

What’s Next?