Skip to main content

​
Prerequisites

Before continuing, make sure you have:
  • A Corbits account with a funded wallet
  • At least one active proxy configured in the Control Plane
If you haven’t done this yet, follow the Sign-Up guide first.

​
Find your proxy URL

Every proxy you create gets a unique public URL in this format: 
https://{proxyname}.{orgname}.api.corbits.dev
To find your proxy’s URL, open the Control Plane, navigate to Proxies, and copy the URL from your proxy’s detail view. You’ll use this URL for all requests.

​
Make a test request

Send a plain request to your proxy without any payment headers. A 402 Payment Required response is the expected result — it confirms your proxy is live and payment-gating is active. 
curl -i https://{proxyname}.{orgname}.api.corbits.dev/your-endpoint
The response will look something like this: 
HTTP/2 402
x-payment-required: true
x-payment-network: solana
x-payment-asset: USDC
x-payment-amount: 10000
x-payment-recipient: <your-wallet-address>
x-payment-facilitator: https://facilitator.corbits.dev
A 402 is not an error. It means your proxy is working correctly. The response headers describe exactly what payment is required before the request will be fulfilled.

​
Make a paid request

To complete a paid request, you need a payment-capable client that can read the 402 headers, submit the payment to the Corbits facilitator, and retry the request with a signed payment receipt. The Faremeter Rides SDK is the recommended client for making x402 payments. It handles the full payment flow automatically — your code just makes a normal HTTP call. Once the payment is processed, the proxy forwards your request to the backend and returns the actual response.

​
Check the Dashboard

After a successful paid request, open the Control Plane and go to Dashboard. You should see:
  • The call recorded in the Calls count
  • The payment amount reflected in Total Earned or This Month
If the numbers don’t update immediately, wait a few seconds and refresh — payments settle on-chain before appearing in the dashboard.

​
Next steps

Dashboard

Monitor your proxy’s revenue and call volume

Endpoints

Customize per-route pricing on your proxy

Discovery

Get listed so callers can find and pay for your API