Built for Developers

Integrate x402 payment routing into your stack. Simple SDKs, powerful APIs.

x402 Payment Flow

Request → Route → Settle. Simple flow, powerful capabilities.

1
Create Request
2
Route
3
Settle

Request sealed → Routed to pool → Settled with proof

Official SDKs

Node.js

v2.1.0
npm install @blackbox/payments
View Docs

Python

v1.8.2
pip install blackbox-payments
View Docs

Go

v1.5.1
go get github.com/blackbox/payments-go
View Docs

Middleware Examples

Get started with code samples in your preferred language

javascript
import { BlackboxClient } from '@blackbox/payments';

const client = new BlackboxClient({
  apiKey: process.env.BLACKBOX_API_KEY,
});

// Create a request
const request = await client.createRequest({
  amount: 1000,
  currency: 'USD',
  destination: 'pool_abc123',
  metadata: {
    orderId: 'order_123',
  },
});

// Handle webhooks
app.post('/webhooks/blackbox', async (req, res) => {
  const isValid = client.verifyWebhook(req.body, req.headers['x-blackbox-signature']);
  if (!isValid) return res.status(401).send('Invalid signature');
  
  const event = req.body;
  // Handle event...
  res.status(200).send('OK');
});

Integrations

Connect Blackbox with your favorite frameworks and tools

Ready to build?

Explore our complete documentation and API reference.

View Documentation