Start here

How do you want to integrate?

Pick a path. Hosted checkout is the recommended start because your server only creates a session and verifies payment.

Hosted checkout

Most websites

Create a session, redirect, verify on the server.

Direct API

Backends and platforms

Create invoices yourself. No BOSPay UI.

Custom checkout

Full UI control

QR, address, expiry, and status from invoice fields.

First payment in five minutes

Create a sandbox key. Format: bospay_sandbox_… — keep it on the server.
Register a Sepolia destination for the asset you will accept.
POST /checkout-sessions with fiatAmount, then redirect to embedUrl.
Pay the quoted sandbox amount.
Verify invoice.paid with the raw-body HMAC, then GET the invoice before fulfilling.