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.
data-mode
attribute.
Embedded Mode
Compact checkout embedded in an overlay iframe on the merchant's page.
Customer Info
Collects email, name, phone, or address based on merchant settings.
Payment Method
Lightning for instant settlement.
QR Code
Scan the QR code with any Lightning or Bitcoin wallet. Real-time status via WebSocket.
Confirmed
Payment received. Customer is auto-redirected to your success URL.
New Tab Mode
Spacious two-column layout for the full browser experience.
Customer Info
Amount displayed on the left, form fields on the right.
Payment Method
Price on the left, payment method options on the right.
QR Code
Amount and invoice details on the left, large QR code on the right.
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.