DEVELOPERS

Accept USDC with Boss Pay.

Invoices, hosted checkout, a drop-in button and signed webhooks. Customers pay your own wallet directly — Boss never holds the funds.

Quick start

1 · Get keys

Open Boss Stash → Security → Business → Boss Pay for merchants. Payouts go to that wallet. You get a secret key (sk_live_…, server-side only) and a webhook secret (whsec_…).

2 · Create an invoice

Your server creates an invoice for an amount in USDC on Solana or Base, and sends the customer to checkout.

3 · Get paid

We watch the chain and call your webhook when the invoice is paid. Fee: 1% of each payment, no monthly fee.

API

Create an invoice

POST /merchant/invoices
curl -X POST https://api.bossstash.com/merchant/invoices \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"amount":"25.00","asset":"usdc-sol","orderId":"1042",
       "memo":"Order 1042","redirectUrl":"https://shop.example/thanks",
       "expiresInMin":60}'
Response (abridged)
{
  "id": "inv_...",
  "status": "open",
  "amount": "25.00",
  "merchantReceives": "25.00",
  "customerPays": "25.25",
  "checkoutUrl": "https://api.bossstash.com/checkout/inv_...",
  "bossPayUri": "bosspay:...",      // Boss Stash QR
  "walletUri": "solana:..."          // Solana Pay / EIP-681 for any wallet
}

Send the customer to checkoutUrl, show bossPayUri as a QR code for Boss Stash, or use walletUri for any Solana Pay / EIP-681 wallet.

Drop-in button

HTML
<script src="https://api.bossstash.com/widget.js" data-invoice="inv_..."></script>
<script>
  document.addEventListener('bosspay:paid', (e) => {
    // show your thank-you state; confirm on your server via the webhook
  });
</script>

Webhooks

We POST to your webhook URL with Boss-Signature: t=<unix>,v1=<hex>, where v1 = HMAC-SHA256(whsec, "<t>.<raw body>"). Events: invoice.paid and invoice.expired. We retry until your endpoint returns 2xx. Reject signatures older than 10 minutes.

Verify a webhook (Node.js)
import crypto from 'node:crypto';

// header: Boss-Signature: t=<unix>,v1=<hex>
export function verify(rawBody, header, whsec) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const age = Math.floor(Date.now() / 1000) - Number(parts.t);
  if (!(age >= 0 && age < 600)) return false;            // older than 10 min
  const expected = crypto.createHmac('sha256', whsec)
    .update(`${parts.t}.${rawBody}`).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 ?? ''));
}

How payments are matched

Solana

Each invoice has a unique reference key attached to the transfer (Solana Pay standard).

Base

Each open invoice gets a unique amount (a few millionths of a dollar added). Customers must send the exact amount shown.

Plugins and tools

WooCommerce

Install the Boss Pay plugin, paste your keys, and orders are marked paid from the signed webhook. USD-priced stores.

Merchant dashboard

api.bossstash.com/merchant — volume, open and paid invoices, create invoices, CSV export.

Shopify

Use a manual “Pay with USDC” method plus an order webhook that creates a Boss Pay invoice, until Shopify payments-partner approval.

Wallet SDK

@boss/wallet-core is the engine behind Boss Stash, available to licensed partners: BIP39 phrases, Bitcoin, Ethereum, Base and Solana, a PIN-encrypted vault, balances, signing, bridging and Boss Pay requests. Commercial use requires a signed licence — contact partners@bossstash.com.

TypeScript
import { createMnemonic, deriveKeys, fetchBalances } from '@boss/wallet-core';

const phrase = createMnemonic(12);
const keys = deriveKeys(phrase, 'mainnet');
const { balances } = await fetchBalances(keys, 'mainnet');

Security

Report vulnerabilities to security@bossstash.com — see our security policy and bug bounty. Never put a secret key in client-side code.