402.js

A tiny axios wrapper that adds HTTP 402 (Payment Required) handling via a pluggable callback.

Install

npm install 402.js
# or
pnpm add 402.js

If you're publishing this yourself, run npm publish inside this folder.

Usage

import { createClient } from "402.js";

const client = createClient({
  maxRetries: 1,
  onPaymentRequired: async ({ config, error, attempt }) => {
    // TODO: trigger your payment flow here (Stripe, Solana, Pump.fun, etc.)
    // Return true to retry the request after payment succeeds.
    console.log("402 received; attempt:", attempt);
    return false;
  }
});

const res = await client.get("https://api.example.com/protected");
console.log(res.data);

API

createClient(options)

• maxRetries (default 1): number of times to retry after your payment callback returns true.
• onPaymentRequired(ctx) => Promise<boolean>: called when a response is 402. Return true to retry once payment succeeds.
• axiosConfig: passed to axios.create().

Returns an object with { axios, get, post, put, patch, delete, request }.

License

MIT