XRPL AI Infrastructure

Secure machine payments on the XRP Ledger.

The XRPL x402 Facilitator verifies and settles payer-signed presigned transactions, so your API can charge per request — no API keys, no custodial wallets, no payment glue.

No custodyInvoice bindingXRP · RLUSD · IOU
xrpl-facilitator-mainnet.t54.ai · x402 exact flow
01GET /premium/resourcebuyer requests a paid endpoint
02402 Payment Requiredserver returns requirements + invoiceId
03POST /verify → /settlefacilitator checks invariants, submits presigned blob
04200 OK · PAYMENT-RESPONSEresource released after validated settlement
Built onPowered by
Live endpoint

Point your middleware at the hosted facilitator

Use this hosted mainnet facilitator URL in server middleware. Buyer clients call your protected resource URL rather than the facilitator URL, and use XRPL RPC/WS plus a network filter.

Hosted mainnet
https://xrpl-facilitator-mainnet.t54.ai
XRPL_NETWORK=xrpl:0
Payer-signed XRPL Payment blobs
Invoice binding and replay protection
Settle XRP and IOU assets (RLUSD, USDC)
Integration flow

Drop-in setup for your x402 stack

The facilitator slots into existing x402 middleware. Your server keeps full control over pricing and release rules while payment verification is delegated.

Follow the Quickstart
01

Choose one environment

Keep the facilitator endpoint, XRPL network id, and RPC/WS endpoints from the same row.

XRPL_NETWORK=xrpl:0
02

Define payment terms

Set asset, destination, price, and invoice-level metadata in your resource server.

asset=XRP · price=1000 · payTo=r…
03

Serve paid resources

Middleware returns HTTP 402, then final content once verify + settle pass.

requirePayment({ path, … })
Core capabilities

Built for secure x402 settlement

Every payment request stays inside standard HTTP semantics while the facilitator handles verification, submission, and settlement status.

Presigned XRPL Payment

The payer signs a standard XRPL Payment transaction and sends it inside the x402 payload.

Invoice binding

Each transaction is tied to an invoiceId via Memos + InvoiceID hash to prevent replay.

Guardrails before submit

Rejects unsupported payment patterns and high-fee transactions before ledger submission.

Validated settlement

Optionally wait for a validated ledger result before releasing the paid resource.

No-custody model

The facilitator never signs payer transactions and never holds customer private keys.

Spec-compatible endpoints

Supports the /supported, /verify, /settle flow with x402-xrpl clients and middleware.

Optional risk extension · x402-secure

Risk-gated settlement, when you need it

When a buyer's agent brings Verifiable Intent, the hosted facilitator calls X402 Secure and Trustline before any money moves — returning allow, deny, or review, each with a replayable evidence trail.

Enhances, not replacesPlain XRPL x402 payments pass straight through. Risk is evaluated only when a buyer attaches x402Secure context.
Verifiable Intent L1–L3A Trustline-issued credential, an owner-signed delegation, and an agent-signed final action travel with the payment.
Allow · deny · reviewThe facilitator calls X402 Secure and Trustline before settling — and gates the transaction on the decision.
Optional by defaultEnforce per route or per tenant when a surface requires risk-checked settlement.
Integration paths

Wire it into either side of the payment

Sellers expose paid resources with deterministic pricing and settlement checks; buyers build autonomous calls that detect 402 challenges, sign payloads, and retry automatically.