Skip to main content
x402 Facilitator

The Payment Layer
for AI Agents

Nevermined's x402 Facilitator coordinates authorization, metering, and settlement for AI agents — across fiat, crypto, credits, and smart accounts.

Unified x402 payment handshake
Usage-driven, programmable settlement
Built for agent-to-agent and AP2 workflows
View DocsContact the Team
x402-flow.ts
TypeScript
1import { Payments } from '@nevermined-io/payments'
2
3// Initialize the payments client
4const payments = Payments.getInstance({
5nvmApiKey: process.env.NVM_API_KEY,
6environment: 'production'
7})
8
9// Verify x402 token with facilitator
10const result = await payments.facilitator
11.verifyPermissions({
12x402AccessToken,
13maxAmount: BigInt(credits)
14})
15
→Payment verified, settlement ready
Connectedfacilitator.nevermined.app
nvm:erc4337
Capabilities

Everything You Need to Monetize AI

Fiat + Crypto Payments

Cards, wallets, stablecoins, and credits. One integration handles all payment rails.

Flexible Pricing Models

Pay-as-you-go, credit plans, time-limited access. Configure what works for your use case.

Dynamic Pricing Logic

Fixed rates, cost-plus margins, or real-time dynamic pricing. You control the economics.

Enterprise Ready

SOC-2, ISO 27001, PCI SAQ-A, GDPR. Audit-ready flows with complete transaction trails.

Smart Accounts

ERC-4337 smart accounts with session keys. Smart contract settlement without key custody.

Easy Integration

Agent + client libraries with drop-in request protection. Minimal code surface.

nevermined/x402-facilitator/quickstart

Integration Guide

Add payment protection to your AI agent in three steps. Full TypeScript support with automatic type inference.

1

Install the SDK

terminal
$npm install@nevermined-io/payments
2

Initialize the client

payments.ts
import { Payments } from '@nevermined-io/payments'
// Initialize with your API key
const payments = Payments.getInstance({
nvmApiKey: process.env.NVM_API_KEY,
environment: 'production'
})
3

Protect your endpoint

route.ts
// Verify x402 payment in your API route
const result = await payments.facilitator
.verifyPermissions({
x402AccessToken,
maxAmount: BigInt(credits)
})
✓Payment verified, proceed with request

Quick Links

Full Documentation
API Reference
GitHub Repository

SDK Features

  • Full TypeScript support
  • Works with Next.js, Express, Fastify
  • Automatic retry & error handling
  • Zero dependencies
npmv2.4.1
Stable

Enterprise Ready

Audit-ready compliance for regulated industries

SOC-2
ISO 27001
PCI SAQ-A
GDPR
The Coordination Layer

Not an Agent. The Infrastructure.

Without the Facilitator

  • Agents must handle auth, pricing, metering, and settlement themselves
  • Tight coupling to specific payment rails and blockchain infrastructure
  • No auditability or coordination across multi-agent workflows
  • Each integration requires custom payment logic

With the Nevermined Facilitator

  • Coordinates authorize → meter → redeem → settle in one flow
  • Enforces pricing, entitlements, and settlement logic transparently
  • Rail-neutral: fiat, crypto, or credits — same integration
  • Complete audit trail for every transaction and agent interaction
api/v1/facilitator

API Reference

RESTful endpoints for the x402 Facilitator service

View Full Docs
Base URLhttps://facilitator.nevermined.app
POST/authorize

Create and validate authorization for payment-gated requests

GET/challenge

Construct x402 payment challenge (402 response payload)

POST/verify

Verify payment proof and entitlement for a request

POST/meter

Submit and resolve metering signals for usage tracking

POST/settle

Execute or confirm atomic settlement on-chain

GET/entitlements

Resolve credit and time-plan entitlements

All systems operational
TLS 1.3
<50ms p99
OpenAPI spec available
pricing/commercial

Simple, Aligned Pricing

1–2%per tx
No minimums
No lock-in
Success-based
Talk to Sales
Get started

Ready to monetize your AI?

Add the Nevermined Facilitator to your agent and start processing payments today.
View DocumentationContact the Team