t54XRPL x402 Docsv2
Home

Core

  • Facilitator Overview
    • What Is x402
    • Why x402
    • Key Benefits
    • Payment Flow
    • Next Step
  • Quickstart Guide
    • Prerequisites
    • Environment Matrix
    • Role Selection
  • XRPL Exact Scheme
    • Overview
    • Network IDs
    • HTTP Headers
    • Payload Format
    • Asset Types
    • Requirement Fields
    • Invoice Binding
    • Verification Flow
    • Settlement Response
    • Error Codes
    • Security Notes

Verifiable Intent

  • Overview & Concept
    • What Is VI
    • The Three Layers
    • Who Holds Which Key
    • Why It Earns Risk Service
    • Chain Payload Shape
  • Agent Integration Guide
    • Prerequisites
    • 1 · Register
    • 2 · Enable VI
    • 3 · Issuer Secret
    • 4 · Configure SDK
    • 5 · Sign L1 → L3
    • 6 · Bundle & Submit
    • Run It
    • Troubleshooting

Merchant Guides

  • FastAPI Integration
    • Overview
    • Install Dependencies
    • Environment Setup
    • Create Server
    • Run Service
  • Express Integration
    • Overview
    • Install Dependencies
    • Environment Setup
    • Create Server
    • Run Service

Client Guides

  • Python Client
    • Overview
    • Install Dependencies
    • Environment Setup
    • Create Client
    • Run Client
  • TypeScript Client
    • Overview
    • Install Dependencies
    • Environment Setup
    • Create Client
    • Run Client

XRPL x402
Documentation

Everything you need to integrate facilitator-side settlement, merchant middleware, and paid clients in the XRPL exact scheme.

01

Facilitator Overview

Protocol context, trust model, and payment lifecycle from HTTP 402 challenge to settlement.

02

Quickstart Guide

Deploy a paid endpoint and test a paying client in minutes.

03

XRPL Exact Scheme

Canonical payload fields, headers, invoice binding rules, and supported assets.

04

Verifiable Intent

What VI is, the L1→L3 chain, and why attaching it earns the XRPL Facilitator risk service.

05

VI Agent Integration Guide

Six steps: register, enable VI, get your Issuer Secret, configure the SDK, sign L1→L3, and submit it with every payment.

06

Merchant FastAPI

Python middleware path for integrating x402 settlement on XRPL.

07

Merchant Express

Node.js middleware path for paid APIs using x402-xrpl package.

08

Python Client

Use x402-enabled requests session and XRPL signing for paid API calls.

09

TypeScript Client

Use x402Fetch and decode payment headers in Node.js 18+ or trusted JavaScript runtimes.

Contents

Core

  • Facilitator Overview
    • What Is x402
    • Why x402
    • Key Benefits
    • Payment Flow
    • Next Step
  • Quickstart Guide
    • Prerequisites
    • Environment Matrix
    • Role Selection
  • XRPL Exact Scheme
    • Overview
    • Network IDs
    • HTTP Headers
    • Payload Format
    • Asset Types
    • Requirement Fields
    • Invoice Binding
    • Verification Flow
    • Settlement Response
    • Error Codes
    • Security Notes

Verifiable Intent

  • Overview & Concept
    • What Is VI
    • The Three Layers
    • Who Holds Which Key
    • Why It Earns Risk Service
    • Chain Payload Shape
  • Agent Integration Guide
    • Prerequisites
    • 1 · Register
    • 2 · Enable VI
    • 3 · Issuer Secret
    • 4 · Configure SDK
    • 5 · Sign L1 → L3
    • 6 · Bundle & Submit
    • Run It
    • Troubleshooting

Merchant Guides

  • FastAPI Integration
    • Overview
    • Install Dependencies
    • Environment Setup
    • Create Server
    • Run Service
  • Express Integration
    • Overview
    • Install Dependencies
    • Environment Setup
    • Create Server
    • Run Service

Client Guides

  • Python Client
    • Overview
    • Install Dependencies
    • Environment Setup
    • Create Client
    • Run Client
  • TypeScript Client
    • Overview
    • Install Dependencies
    • Environment Setup
    • Create Client
    • Run Client