Hosted checkout (self-hosted integration)

The classic server-driven flow: your backend creates a payment intent with your API key, then redirects the customer to the hosted checkout page.

Flow

Create the intent

const res = await fetch('https://api.puffinmoney.com/v1/gateway/api/payment-intents', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.PUFFIN_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    amount: '99.00',
    token: 'USDC_BASE',
    chain: 'BASE',
    successUrl: 'https://yourstore.com/orders/123/thanks',
    metadata: { orderId: '123' },
  }),
});
const { intent, checkoutUrl } = await res.json();

Poll or verify

GET /v1/gateway/api/payment-intents/:id   # X-API-Key

Statuses: PENDING → CONFIRMED | EXPIRED | CANCELLED. Always treat the webhook (or this GET) as the source of truth — never the browser.

Supported assets

All stablecoins on all networks Puffin supports: Solana, Ethereum, Base, Polygon, BSC, Arbitrum, Optimism, XDC — GET /v1/wallets/supported lists the current matrix.

Getting started

Ways to accept payments

Wallet-as-a-Service

Going further

Hosted checkout (self-hosted integration)

Flow

Create the intent

Poll or verify

Supported assets

​Flow

​Create the intent

​Poll or verify

​Supported assets

Flow

Create the intent

Poll or verify

Supported assets