paidbeam

Charge for the call.
Keep the result.

Price an API request in USDG on Robinhood Chain. Deliver after settlement and let buyers recover the same response if the connection drops.

  • x402
  • Robinhood Chain
  • Paxos USDG
  • TypeScript

Build on either side.

Charge for an endpoint with merchant middleware, or pay for a request with the buyer client. Both use x402 and USDG on Robinhood Chain.

Merchant middleware

Set an exact USDG price for a read-only endpoint. Release the response after the payment service confirms settlement.

Merchant integration

Buyer client

Check the merchant and set a spending cap before signing. Save the purchase so your app can recover the result later.

Buyer integration
paidbeam@0.2.0-rc.1
import { protect, PaymentServiceClient } from 'paidbeam/merchant';

const client = new PaymentServiceClient(serviceUrl, merchantKey);

export const GET = protect({
  client,
  endpointId: 'transaction-report',
  publicOrigin: 'https://api.example.com',
}, async request => {
  const report = await generateReport(request);
  return Response.json(report);
});

Register the endpoint and price with your operator. Keep the merchant credential on your server.

Follow a paid request.

See what happens between the first HTTP 402 and the saved response. Hover to pause or select a stage.

Simulation

The API quotes an exact price for this request.

GET /api/transaction-report?hash=0x…
HTTP 402 Payment Required · 1.00 USDGSIGN authorization for 1.00 USDG
SAVE purchase before submissionVERIFY USDG settlement on chain 4663
CONFIRMED merchant received 1.00 USDGHTTP 200 OK
result: { "status": "success", … }RECOVER original purchase → same JSON
additional charge: 0 USDG

One call. One report.

Look up a Robinhood Chain transaction and get its receipt status, network fees, and decoded ERC-20 transfers.

GET /api/transaction-report

Input
Transaction hash
Output
Cached JSON report
Example price
1.00 USDG / request

Public API access is pending.

Retry delivery with the same purchase

If the connection drops after checkout, the saved purchase can retrieve the same report without a second signature or charge.

Read the recovery guide
Buy a transaction report

Before your first request.

Where does the payment go?

USDG moves directly from the buyer's wallet to the merchant's configured receiving wallet on Robinhood Chain. The service verifies settlement before releasing the paid response.

What happens if the connection drops?

The buyer SDK saves a purchase record before submitting authorization. Use that same record to recover the response. Recovery creates no new payable order and requests no second signature. Keep the record private: it contains payment authorization and access credentials.

What can I use the first version for?

Exact-price, read-only GET endpoints returning bounded JSON or text. The current SDK supports ordinary externally owned Robinhood Chain wallets. Contract wallets, subscriptions, streaming responses and variable charges are outside this version.

Can I start integrating today?

Yes. Install the Robinhood SDK from npm and follow the integration guide. The current release is 0.2.0-rc.1. A Paidbeam operator must register the merchant and endpoint and provide the service URL and merchant credential. Public API access is not open yet.

Make your next request payable.

Connect your existing API to USDG payments with the Paidbeam SDK.