Oura402 API Documentation

Streamlined x402 payment integration with straightforward HTTP endpoints.

What is Oura402?

Oura402 simplifies x402 payment integration by handling all blockchain complexity, wallet management, and payment verification. Implement crypto payments with a single API call.

What is x402?

x402 is a payment standard that enables crypto payments over standard HTTP using the 402 Payment Required status code. Key features include:

• No wallet connection required - Users don't need to connect wallets or create accounts
• HTTP-based integration - Accept payments using standard API calls
• Blockchain abstraction - No blockchain knowledge required
• AI agent compatible - Designed for autonomous systems and machine-to-machine payments
• Flexible payment amounts - Support for micropayments to large transactions

Why Use Oura402?

• Quick Integration - Complete integration in minutes with straightforward endpoints
• Simple API - Clean, well-documented endpoints with predictable behavior
• Blockchain Abstraction - Focus on your application while we handle blockchain operations
• Real-time Updates - WebSocket support for instant payment notifications
• Platform Agnostic - Compatible with any language, framework, or platform
• High Reliability - 99.9% uptime SLA ensures continuous payment processing

Quick Start

Complete integration in three steps:

1. Get your API key

Sign up at oura402.dev to obtain your API key.

2. Accept a payment

curl -X POST https://api.oura402.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. Integration complete

Your application is now configured to accept x402 payments.

Documentation Structure

• Getting Started - Complete setup and integration guide
• API Reference - Comprehensive API documentation
  • Cloud API - Managed payment processing
  • Local Transaction API - Self-custodied transaction building
  • WebSocket API - Real-time payment events
• Authentication - API authentication guide
• Rate Limits - Rate limiting and quota information
• Error Handling - Error codes and resolution strategies
• Examples - Implementation 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: @Oura402
• Website: oura402.dev
• Email: support@oura402.dev