Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.renvoy.ai/llms.txt

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

Renvoy gives you a hosted facilitator endpoint so you can add pay-per-request USDC payments to any API — no infrastructure to run, no keys to manage, no gas to fund. Set a price on your endpoint. We handle the on-chain settlement.

What is x402?

Understand the protocol

Getting Started

Try it right now (no signup)

Server Integration

Add payments to my API

Client Integration

Pay for an x402 API

Agent Self-Provisioning

Provision an endpoint programmatically

Plans & Pricing

Compare plans

API Reference

See all endpoints

​
How it works

Client                     Your Server                  Renvoy
  |                            |                            |
  |-- GET /data -------------->|                            |
  |<-- 402 + payment details --|                            |
  |                            |                            |
  |-- GET /data + X-PAYMENT -->|                            |
  |                            |-- POST /settle ----------->|
  |                            |<-- { success, tx } --------|
  |<-- 200 + data -------------|                            |
1

Client requests a protected endpoint

2

Server responds 402 Payment Required with price and payment address

3

Client signs a USDC transfer and retries with the X-PAYMENT header

4

Server forwards the payment to Renvoy, which settles it on-chain

5

Server returns the data

The @x402/express middleware and @x402/fetch client handle steps 2-4 automatically.
New here? Start with Getting Started — you’ll have a working payment flow in under 2 minutes.