Create a payment

There are two ways to charge: an invoice fixes the asset up front; an order lets the customer pick at checkout.

Invoice — asset chosen by you

POST https://api.payzuno.io/v1/invoices
Authorization: Bearer ak_live_…
Idempotency-Key: order_8412

{ "price_usd": "100.00", "asset_id": "USDC" }

Order — currency chosen by the customer

Create an order with just the price; the hosted checkout shows the customer the assets you have enabled and mints a payment when they choose one.

POST https://api.payzuno.io/v1/invoice
{ "price_amount": "100.00", "price_currency": "USD" }

The order response carries an invoice_url (also mirrored as checkout_url) — the hosted page to send the customer to.

Idempotency

Always send an Idempotency-Key. Replaying the same key returns the original resource, so a retry never creates a duplicate. Poll payment status for updates.