@stripe402/client-axios

Axios interceptor that automatically handles stripe402 402 responses. When a paid endpoint returns 402, the interceptor calls your callback to get payment details, then retries the request transparently.

Install

npm install @stripe402/client-axios axios

Usage

import axios from 'axios'
import { createStripe402Axios } from '@stripe402/client-axios'

const client = createStripe402Axios(axios.create(), {
  onPaymentRequired: async (requirements) => {
    // requirements includes: amount, minTopUp, currency, publishableKey, description
    const pm = await stripe.createPaymentMethod(/* ... */)
    return { paymentMethodId: pm.id, topUpAmount: requirements.minTopUp }
  },
})

// Automatically handles 402 → payment → retry
const response = await client.get('https://api.example.com/api/weather')

After the first successful payment, the client stores the returned clientId and uses it for subsequent requests — no re-payment until credits run out.

Return null from onPaymentRequired to decline payment and let the 402 error propagate.