Yuzu402 API Documentation

The simplest way to accept x402 payments. If you can make an HTTP request, you can integrate Yuzu402.

What is Yuzu402?

Yuzu402 makes it dead simple to accept x402 payments. We handle all the blockchain complexity, wallet management, and payment verification so you don't have to. Just one API call and you're accepting crypto payments.

What is x402?

x402 is a payment standard that lets you accept crypto payments over regular HTTP using the 402 Payment Required status code. Think of it like this:

• No wallet setup - Your users don't need to connect wallets or sign up for accounts
• Just HTTP requests - Accept payments the same way you make any API call
• Crypto without the headache - No blockchain knowledge required
• Works with AI agents - Perfect for autonomous systems and machine-to-machine payments
• Any amount - From tiny micropayments to large transactions

Why Use Yuzu402?

• 5 Minute Integration - Seriously. Copy our code, paste it, and start accepting payments
• One Simple API - No complicated flows, just straightforward endpoints
• No Crypto Expertise Needed - We handle the blockchain stuff so you don't have to learn it
• Real-time Updates - WebSocket support to know when you get paid instantly
• Works Everywhere - Any language, any framework, any platform
• Reliable - 99.9% uptime means your payments never stop

Quick Start

Literally three steps. That's it.

1. Get your API key

Sign up at yuzu402.dev - takes 30 seconds.

2. Accept a payment

curl -X POST https://api.yuzu402.dev/v1/payments/verify \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "payment_proof": "...",
    "amount": 1000000,
    "recipient": "YOUR_WALLET_ADDRESS"
  }'

3. You're done

That's it. You're now accepting x402 payments. Told you it was simple.

Documentation Structure

• Getting Started - Set up your API key and integrate x402
• API Reference - Complete API documentation
  • Payment Verification API - Verify x402 payments
  • Payment Settlement API - Settle verified payments
  • WebSocket API - Real-time payment events
• Authentication - API authentication guide
• Rate Limits - Understanding rate limits and quotas
• Error Handling - Common errors and solutions
• Examples - Code examples in multiple languages

x402 Resources

• x402 Protocol: x402.org
• x402 Documentation: x402.gitbook.io
• x402 on Twitter: @x402protocol

Support

• Documentation Issues: GitHub Issues
• Twitter: @yuzu402dotdev
• Website: yuzu402.dev
• Email: support@yuzu402.dev