1. Integration
Kobaru
  • Kobaru.io Gateway API
    • Introduction
      • What is Kobaru?
      • Quick start
      • How x402 works
    • Integration
      • Standard x402 SDK
      • Advanced SDK
      • Transparent proxy integration
      • Direct API integration
    • Core Concepts
      • Available Chains and Assets
      • Payment schemes
      • Security
      • Usage models
    • Guides
      • Pricing your API
      • Going to Production
      • Testing with devnet
      • Bazaar discovery
      • BITE encryption for SKALE
    • API Reference
      • Error Handling
      • Get Supported Payment Kinds
      • Verify Payment Authorization
      • Settle Payment
    • Discovery
      • List Discovery Resources
    • Transparent Proxy
      • Overview - Transparent Proxy
      • Upstream authentication
      • Troubleshooting
      • Constraints and security
      • Capabilities and routes
      • Domain verification
      • Service setup
    • Effortless MCP
      • Kobaru MCP Overview
      • Wallets
      • CLI reference
      • Setup Template
    • Schemas
      • SupportedResponse
      • ErrorResponse
      • UnauthorizedResponse
      • RateLimitResponse
      • VerifySuccessResponse
      • VerifyErrorResponse
      • SettleSuccessResponse
      • SettleErrorResponse
      • DiscoveryResourceItem
      • ListDiscoveryResourcesResponse
  1. Integration

Transparent proxy integration

Monetize your API in minutes without changing a single line of code. The transparent proxy sits between your customers and your backend, handling payments automatically at the network edge.

How it works#

The proxy intercepts requests, enforces payment, and forwards clean requests to your backend. Your API code never changes.

Why choose the transparent proxy#

Zero integration effort
No SDK installation or code changes required
Works with any language (Go, Python, Rust, Java, PHP, etc.)
Perfect for legacy APIs that can't be easily modified
Your backend receives standard HTTP requests
Edge performance
Runs on 100+ datacenters worldwide
Payment verification happens at the edge (sub-50ms)
Automatic geographic routing
Built-in DDoS protection
Automatic payment handling
Smart usage tracking (pay-per-request or pay-per-time)
Automatic refunds when your backend returns errors
Multi-network support (Solana, Base, SKALE)
No blockchain code in your application
Simple configuration
5-minute setup via Console
Uniform pricing across all endpoints
Optional path-specific pricing overrides
Live configuration updates (no deploys needed)

Comparison with other integration methods#

FeatureTransparent ProxyStandard SDKDirect API
Setup time5 minutes30 minutes2+ hours
Code changesNoneMiddleware integrationFull implementation
Language supportAnyNode.js, Go, PythonAny
Dynamic pricingPath-based onlyFull controlFull control
Request body limit64KBUnlimitedUnlimited
WebSocket supportNoYesYes
Best forQuick monetization, legacy APIsModern apps needing flexibilityCustom payment flows

When to use the transparent proxy#

Choose the transparent proxy when:
You want to monetize an existing API without code changes
You have a legacy system that's difficult to modify
Your backend is not in Node.js, Go, or Python (SDK languages)
Simple, uniform pricing works for your use case
You want the fastest path to accepting crypto payments
Consider alternatives when:
You need dynamic pricing based on request content → Use Standard SDK
Your request bodies exceed 64KB → Use Standard SDK
You need WebSocket support → Use Standard SDK
You want full control over payment flow → Use Direct API

Getting started#

Ready to set up your proxy? The full documentation covers everything you need:
→ Start with the Proxy Overview
The proxy documentation includes:
Domain verification - Prove you own your API's domain
Service setup - Create your proxy service and configure slugs
Upstream authentication - Secure your backend with API key injection
Capabilities and routes - Configure payment methods and pricing
Constraints and security - Understand limits and security restrictions
Troubleshooting - Common issues and solutions
Estimated setup time: 5 minutes

Quick reference#

SettingValue
Gateway URLhttps://access.kobaru.io/{your-slug}/*
Backend protocolHTTPS only
Request body limit64KB maximum
Upstream timeout50 seconds
Redirect handlingAll 3xx blocked (returns 502)
Payment networksSolana, Base, SKALE
Usage modelsPay-per-request, Pay-per-time
Modified at 2026-02-10 21:46:54
Previous
Advanced SDK
Next
Direct API integration
Built with