Hosted checkout
Every invoice and deposit has a ready-made payment page. Send the customer the payment_url from the creating response; the address is already in place.
The page shows the token, network, address, QR code and payment status. You do not need to build a checkout yourself.
Send the payment link
Section titled “Send the payment link”Use payment_url exactly as returned. Do not build a URL from the issuance ID or assume a fixed format for public_id.
The customer must send the displayed token on the displayed network. Sending a different token or using a different network does not pay the invoice.
A payer who has an Invoise account can also pay from the Invoise wallet on the same page.
Set the shop’s name and logo
Section titled “Set the shop’s name and logo”Edit branding in the dashboard or through the API with an owner session or a shop key with write:
PATCH /api/v1/shops/{shop_id}/brandingAuthorization: Bearer <owner-session-token>Idempotency-Key: <saved-unique-key>Content-Type: application/json
{"name":"My shop"}Branding controls the displayed shop name and logo. If Invoise has allowed it for your merchant, {"hide_name":true} hides the merchant’s name on the payment page; otherwise the request returns 400 hide_name_not_allowed. Set a payment’s return_url, an https:// URL, when creating the invoice or deposit. Neither changes the payout recipient.
Confirm payment on your server
Section titled “Confirm payment on your server”The return link is for navigation. A customer opening it is not proof of payment.
Use Invoice and deposit status to read the status from your backend, or verify a signed webhook. Keep API keys on the server; never put them in the payment link or browser code.