Integration Guides

import { PaymentClient, createSigner } from '@billmyagent/payments-core';
// Server / agentconst signer = await createSigner('base', process.env.PRIVATE_KEY);const client = new PaymentClient({ signer });

const res = await client.http.get('https://api.example.com/paid-resource');
console.log(res.data, 'paid:', Boolean(res.headers['x-payment-response']));

const client = new PaymentClient({ apiKey: 'your-api-key', authToken: jwt });
await client.getPayoutSettings();await client.updatePayoutSettings({ base_address: '0x…' });await client.listPayments();

import { PaymentButton, PaymentClient, createSigner } from '@billmyagent/payments-react';
// In a browser, build the signer from the user's wallet (e.g. window.ethereum).const client = new PaymentClient({ signer: await createSigner('base', PRIVATE_KEY) });
function App() {  return (    <PaymentButton      client={client}      url="https://api.example.com/premium-article"      onSuccess={(data) => console.log('unlocked', data)}      onError={(error) => console.error('payment failed', error)}    >      Read article    </PaymentButton>  );}

import { usePayment } from '@billmyagent/payments-react';
function PremiumContent({ client }) {  const { pay, data, loading, error, paid } = usePayment(client);
  return (    <div>      <button onClick={() => pay('https://api.example.com/premium')} disabled={loading}>        {loading ? 'Loading…' : 'Load premium'}      </button>      {error && <p>Error: {error.message}</p>}      {data && <p>Loaded{paid ? ' (paid)' : ''}</p>}    </div>  );}

<template>  <PaymentButton    :client="client"    url="https://api.example.com/premium-article"    label="Read article"    :onSuccess="handleSuccess"    :onError="handleError"  /></template>
<script setup>import { PaymentButton, PaymentClient, createSigner } from '@billmyagent/payments-vue';
const client = new PaymentClient({ signer: await createSigner('base', PRIVATE_KEY) });
const handleSuccess = (data) => console.log('unlocked', data);const handleError = (error) => console.error('payment failed', error);</script>

const client = new PaymentClient({  signer: await createSigner('base', process.env.PRIVATE_KEY),});
// When the API returns 402, client.http automatically:// 1. reads the x402 payment requirements (the `accepts` challenge)// 2. signs an EIP-3009 transferWithAuthorization with your wallet// 3. retries the request with the X-PAYMENT header// 4. the facilitator settles it on-chain
const res = await client.http.get('https://api.example.com/premium');if (res.headers['x-payment-response']) {  console.log('paid and unlocked:', res.data);}

import express from 'express';import { paymentMiddleware } from 'x402-express';
const app = express();
// PAY_TO is your payout wallet (the same address you set in Payouts).app.use(  paymentMiddleware(process.env.PAY_TO, {    'GET /premium': { price: '$0.01', network: 'base' },  }));
app.get('/premium', (_req, res) => res.json({ unlocked: true }));app.listen(4021);

// middleware.tsimport { paymentMiddleware } from 'x402-next';
export const middleware = paymentMiddleware(process.env.PAY_TO, {  '/premium': { price: '$0.01', network: 'base' },});
export const config = { matcher: ['/premium/:path*'] };

import { PaymentClient } from '@billmyagent/payments-core';
const client = new PaymentClient({ apiKey: process.env.BILLMYAGENT_API_KEY });
const intent = await client.createPaymentIntent({  amount: '25.00',       // decimal string, [0.01, 1000000]  network: 'base',       // 'base' | 'base-sepolia' | 'polygon'  currency: 'USDC',      // optional, defaults to USDC  description: 'Pro plan — March',  expires_in_seconds: 604800, // optional; default 7 days, max 30 days});
// Share this hosted link with your buyer:console.log(intent.checkout_url); // or client.getCheckoutUrl(intent.id)

async function waitForSettlement(id) {  for (;;) {    const intent = await client.getPaymentIntent(id);    if (intent.status === 'settled') return intent; // funds are in your payout wallet    if (intent.status === 'expired' || intent.status === 'canceled') {      throw new Error(`intent ${intent.status}`);    }    await new Promise((r) => setTimeout(r, 5000));  }}

import timefrom billmyagent import PaymentClient
client = PaymentClient(api_key=os.environ['BILLMYAGENT_API_KEY'])
intent = client.create_payment_intent(    amount='25.00', network='base', description='Pro plan — March')print(intent['checkout_url'])  # or client.checkout_url(intent['id'])
while True:    current = client.get_payment_intent(intent['id'])    if current['status'] == 'settled':        break    if current['status'] in ('expired', 'canceled'):        raise RuntimeError(current['status'])    time.sleep(5)