Why Offer BNPL?
Higher AOV
Customers spend more when they can spread payments over time. Average order value increases 20-50%.
Better Conversion
Removing payment friction at checkout. Conversion rates improve 10-30% for high-ticket items.
Zero Risk
BNPL providers handle credit risk and collections. You receive full payment upfront.
Supported Providers
Klarna
| Feature | Details |
|---|---|
| Availability | US + 19 European countries |
| Currencies | USD, EUR, GBP, DKK, NOK, SEK, CZK, RON, PLN, CHF |
| Minimum | $50.01 (or equivalent) |
| Subscriptions | No |
- Pay in 4 — Split into 4 interest-free payments
- Pay in 30 days — Full payment due in 30 days
- Financing — Longer-term installment plans
Afterpay (Clearpay)
| Feature | Details |
|---|---|
| Availability | US, UK |
| Currencies | USD, GBP |
| Minimum | $50.01 (or equivalent) |
| Subscriptions | No |
- Pay in 4 — 4 interest-free payments every 2 weeks
In the UK, Afterpay operates as “Clearpay” but uses the same API type (
afterpay_clearpay).Billie
| Feature | Details |
|---|---|
| Availability | Global |
| Currencies | GBP |
| Minimum | None |
| Subscriptions | No |
- Invoice Payment — Pay within agreed payment terms
- Flexible Terms — Business-friendly payment schedules
Configuration
API Method Types
| Type | Provider |
|---|---|
klarna | Klarna |
afterpay_clearpay | Afterpay / Clearpay |
billie | Billie (B2B) |
Example
Minimum Transaction Amount
Both Klarna and Afterpay require a minimum of $50.01 USD (or equivalent in supported currencies). Transactions below this threshold:- BNPL options won’t appear at checkout
- No error is thrown — options simply don’t show
- Card payments remain available
allowed_payment_method_types for products under $50.
How Installments Work
Key points:- You receive the full payment upfront from the BNPL provider
- The BNPL provider handles credit risk and collections
- Customer pays the provider directly over 4 installments (typically)
- No chargebacks from installment failures — that’s the provider’s risk
Testing
Klarna Test Data
Use these details in test mode:| Field | Approved | Denied |
|---|---|---|
| Date of Birth | 07-10-1970 | 07-10-1970 |
| First Name | Test | Test |
| Last Name | Person-us | Person-us |
| [email protected] | [email protected] | |
| Street | Amsterdam Ave | Amsterdam Ave |
| House Number | 509 | 509 |
| City | New York | New York |
| State | New York | New York |
| Postal Code | 10024-3941 | 10024-3941 |
| Phone | +13106683312 | +13106354386 |
Transaction must be at least $50 for Klarna to appear as an option.
Afterpay Testing
1
Select Afterpay
Choose Afterpay in checkout and click Pay.
2
Successful payment
Use any valid email and shipping address.
3
Failed authentication
To test failure: close the Afterpay modal on the redirect page. Payment status transitions to
requires_payment_method.Best Practices
Target high-ticket items
Target high-ticket items
BNPL works best for products 1000. The value proposition of “pay over time” is most compelling in this range.
Show installment amounts
Show installment amounts
“4 payments of 100 with Klarna”. Display the per-payment amount when possible.
Don't force BNPL for low-value products
Don't force BNPL for low-value products
Under 100, most customers prefer cards. Focus BNPL promotion on higher-ticket items.
Collect billing address
Collect billing address
BNPL providers require billing information for credit checks. Ensure your checkout collects full address details.
Set clear expectations
Set clear expectations
Customers should understand they’re entering a credit agreement with Klarna/Afterpay, not with you.
Limitations
No Subscriptions
BNPL payment methods do not support recurring payments. For subscription products, use cards or other recurring-compatible methods.Credit-Based Approval
BNPL providers perform instant credit checks. Not all customers will be approved. Approval rates vary by:- Customer credit history with the provider
- Transaction amount
- Customer location
Currency Restrictions
| Provider | Currencies |
|---|---|
| Klarna | USD, EUR, GBP, DKK, NOK, SEK, CZK, RON, PLN, CHF |
| Afterpay | USD, GBP |
Troubleshooting
BNPL not appearing at checkout
BNPL not appearing at checkout
Check:
- Transaction amount at least $50.01?
- Customer location in supported country?
- Currency supported by BNPL provider?
- BNPL method included in
allowed_payment_method_types?
Customer denied by BNPL provider
Customer denied by BNPL provider
Causes:
- Insufficient credit history with provider
- Too many active installment plans
- Failed identity verification
Payment stuck in pending
Payment stuck in pending
Cause: Customer didn’t complete authentication flow with BNPL provider.Solution: Payment will timeout and fail. Customer can retry or use a different method.