Skip to content
UnizPay UnizPay Docs

Hosted payment page

The hosted payment page is the fastest integration: you create a payment on your server and redirect the payer to its checkout_url.

  1. Create the payment on your server with POST /v1/payments. Set success_url (and optionally cancel_url) to bring the payer back to your site.

  2. Redirect the payer to checkout_url, for example https://pay.unizpay.com/pay_01K…#cs_….

  3. The payer pays. The page lists the tokens and networks you accept, shows the deposit address, amount and QR code, and updates as the payment is detected, confirmed and settled.

  4. The payer returns to your success_url from the page once the payment is complete, or to cancel_url if they leave.

  5. Fulfil on the webhook, not on the redirect: a payer can close the tab before returning. Wait for payment.settled (see Webhooks).

What the payer sees

Section titled “What the payer sees”
  • Your profile name and the payment’s description.
  • The methods you accept. Choose them in the dashboard under Settings → Payment defaults → Accepted tokens.
  • The amount to send. For stablecoins it equals the price. For other tokens (for example POL or WETH) it is a price quote locked for 15 minutes; after that the page asks for a fresh quote.
  • A processing fee line when the payer pays the fees (fee_payer: "payer"); see Fees.

Expiry

Section titled “Expiry”

The payer can start paying until expires_at (default 60 minutes for API payments; set expires_in per payment, from 5 minutes to 7 days). An address that was issued before then stays valid for its whole window: 60 minutes for stablecoins, 15 minutes for other tokens.