Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.myproceeds.xyz/llms.txt

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

Proceeds doesn’t expose a traditional REST API for end users — the integration surface is the paywall URL itself. Each paywall generates URLs that follow the x402 and MPP standards.

Generated URLs

Replace {serviceId} and {slug} with the values from your dashboard.
POST https://myproceeds.xyz/api/x402/pay/{serviceId}/{slug}
POST https://myproceeds.xyz/api/mpp/pay/{serviceId}/{slug}

Behavior

StatusWhen
402 Payment RequiredThe request arrived without a valid payment payload. The body contains a challenge with the price, supported networks, and accepted standards.
2xxPayment was verified and the upstream response was proxied.
4xx from upstreamPayment was verified but the upstream rejected the request — check Events.
5xx from upstreamPayment was verified but the upstream errored — check Events.

Standards reference

x402

Open standard built on HTTP 402. Broadest client compatibility.

MPP

Machine Payments Protocol — for agents and machine-to-machine flows.

Circle Nanopayments

Gas-free USDC down to $0.000001 via batched settlement.

Concepts

Services, paywalls, transactions, and events.