Checkout Experience

What your customers see at each step of the payment flow.

Two Display Modes

SatsRail checkout pages adapt their layout based on your merchant's checkout mode setting. Each mode is designed for its context:

Embedded Mode

Opens in an overlay on the merchant's page

Compact, space-efficient layout. No popup blockers. Works on desktop and mobile.

New Tab Mode

Opens in a full browser tab

Two-column layout with product info on the left and payment details on the right.

Set the checkout mode in your Merchant Settings or override it per embed button with the data-mode attribute.

Embedded Mode

Compact checkout embedded in an overlay iframe on the merchant's page.

1
Customer Info
Embedded - Collect customer info

Collects email, name, phone, or address based on merchant settings.

2
Payment Method
Embedded - Select payment method

Lightning for instant settlement.

3
QR Code
Embedded - QR code payment

Scan the QR code with any Lightning or Bitcoin wallet. Real-time status via WebSocket.

Confirmed
Embedded - Payment confirmed

Payment received. Customer is auto-redirected to your success URL.

New Tab Mode

Spacious two-column layout for the full browser experience.

1
Customer Info
New Tab - Collect customer info

Amount displayed on the left, form fields on the right.

2
Payment Method
New Tab - Select payment method

Price on the left, payment method options on the right.

3
QR Code
New Tab - QR code payment

Amount and invoice details on the left, large QR code on the right.

Confirmed
New Tab - Payment confirmed

Wider confirmation card with order details and email receipt notice.

Steps Are Adaptive

Not every checkout has all four steps. The flow adapts automatically:

Step When It Appears When It's Skipped
1. Customer Info Merchant has customer fields configured (email, name, phone, address) No customer fields configured, or info pre-filled via API
2. Payment Method Lightning payment method is enabled Only one payment method enabled, or pre-selected via API
3. QR Code Always Never skipped
4. Confirmation Always Never skipped

Try it yourself

See the checkout in action on our demo site, or integrate it into your own.