Final invoices

A final invoice is the payable object. It is created only after wallet approval for the AI-assistant flow, or through a verified merchant account/API key flow. Final invoices have payUrl, x402Url, and statusUrl.

With the platform action key, this endpoint returns public-safe invoice status for a final invoice. With a merchant API key, it returns the merchant-owned invoice shape from the developer API.

{
  "invoiceId": "inv_abc123",
  "status": "OPEN",
  "payUrl": "https://sollection.xyz/pay/pay_abc123",
  "x402Url": "https://sollection.xyz/api/x402/pay/pay_abc123",
  "statusUrl": "https://sollection.xyz/invoice/inv_abc123/status",
  "amount": "250",
  "tokenSymbol": "USDC",
  "tokenName": "USD Coin",
  "tokenMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "tokenDecimals": 6,
  "cluster": "mainnet-beta"
}

Invoice lifecycle statuses in the database are DRAFT, OPEN, PAID, and CANCELLED.

Creating final invoices directly

A verified merchant account or API key can create a final invoice directly, without the wallet-approval intent flow. Beyond items, add chargesfor costs that aren't a line item — a rush fee, a processing fee, a discount as a negative amount. Charges add to the invoice total the same way items do.

{
  "recipientId": "rcp_abc123",
  "payerEmail": "client@example.com",
  "token": "USDC",
  "items": [
    { "label": "Landing page website", "amount": "200.00", "qty": 1 }
  ],
  "charges": [
    { "label": "Rush fee", "amount": "25.00" }
  ],
  "dueDate": "2026-07-20"
}