E-commerce
July 1, 2026
“PayPal is not showing up at checkout, why?” “Klarna is missing even though my cart is €120.” “Apple Pay is greyed out on mobile, how do I pay?” Three tickets where an unavailable payment method without a playbook generates checkout abandonment, bug accusations, and lost hot sales.
The unavailable e-commerce payment support covers missing methods based on country, cart, currency, or product, grounded alternatives, and BNPL threshold explanations. Distinct from declined payment (blocked card): here, the method is not offered at checkout.
This guide #517 covers policy PAYUNAV-SUP, flows PU-1 to PU-8, and the PAYUNAV-MAP matrix. Completes declined payment. Future customer service pair bot PAYUNAV (#518).
Summary
Why do unavailable payment methods generate tickets?
The customer arrives at the checkout and does not see the expected method: PayPal, Klarna, Apple Pay, bank transfer, or COD. They conclude it is a site bug or country discrimination.
Five typical points of friction
Missing method: PayPal invisible depending on the Shopify market
BNPL threshold: Klarna hidden for cart totals below the minimum
Product restriction: gift card blocks certain payment methods
Country currency: local method missing for BE market vs FR
Device browser: Apple Pay Safari only, absent on Chrome Android
Baymard points out that the visibility and clarity of payment options directly impact checkout abandonment (Baymard, payment step 2026). Without a SOP, the agent might promise Klarna outside of its eligibility mapping.
Convert over 2,000 customers on average per month with Qstomy.
The world’s 1st Shopify AI dedicated to customer conversion
Empowering 200+ e-commerce merchants
PAYUNAV #517 vs payment declined, COD #469 and international
Four pieces of content, four payment friction layers.
Quick Matrix
#517 PAYUNAV: missing checkout method for cart country
Payment declined: card attempted and blocked by bank
#469 COD: cash on delivery zone conditions
International: cross-border support guide
Payment declined = card attempted, failed. #517 = method never displayed or greyed out at checkout.
Which pay_unav_* typologies should be classified?
Eight unavailable payment ticket scenarios.
Eight pay_unav typologies
pay_unav_method_missing: PayPal Klarna missing from checkout
pay_unav_country_block: method unavailable in shipping country
pay_unav_cart_min: BNPL minimum cart threshold not met
pay_unav_cart_max: method limit exceeded for large cart
pay_unav_product_restrict: SKU category blocks method
pay_unav_currency_market: market currency incompatible with method
pay_unav_device_browser: Apple Pay wallet device gate
pay_unav_alternative_ask: which method to use instead
Tags: pay_unav, checkout. Lookup market + cart total + line items before alternative macro.
How should the PAYUNAV-MAP matrix be structured?
The PAYUNAV-MAP matrix documents method eligibility per market shopping cart product for agents and future bot #518.
PAYUNAV-MAP Columns
payment_method: paypal klarna apple_pay shop_pay cod wire
market_country: FR BE DE US shipping country
cart_min_eur: minimum threshold BNPL display
cart_max_eur: maximum limit method
product_block_sku_tags: gift_card subscription digital block
unavailable_reason_code: country min max product device
alternative_methods: ordered fallback grounded list
policy_url: payment help page #539 future
checkout_visibility: shown hidden greyed device_rule
PAYUNAV-SUP Policy in Six Rules
Six rules for unavailable payment support.
PAYUNAV-MAP-GROUNDED: alternatives from map only
NO-METHOD-PROMISE: never promise method outside eligibility
CHECKOUT-CONTEXT: market cart SKU device before response
ALTERNATIVE-ORDERED: cite alternative_methods map order
DECLINED-REROUTE: declined card → declined payment playbook
POLICY-URL-CITE: policy_url if customer contests absence
Flow PAYUNAV PU-1 to PU-8
Flow agent eight steps payment unavailable.
PU-1 Intake: pay_unav_* intent + checkout context
PU-2 Context lookup: market country cart total SKUs device
PU-3 PAYUNAV-MAP: method row unavailable_reason
PU-4 Classify: missing min max product device alternative
PU-5 Respond: macro PAYUNAV grounded alternatives
PU-6 Guide checkout: cart link alternative method
PU-7 Escalate ops: if map error Shopify payment config
PU-8 Close: tag pay_unav_resolved method_cited
SLA: pay_unav_alternative_ask answered in one interaction with alternative_methods cited.
Essential PAYUNAV macros
Four macro agents.
PAYUNAV-MISSING-01
"[payment_method] unavailable: [unavailable_reason_code map]. Alternatives: [alternative_methods]. Details: [policy_url]."
PAYUNAV-MIN-01
"Klarna displayed from [cart_min_eur] €. Your cart: [cart_total] €. Alternatives: card Shop Pay PayPal."
PAYUNAV-DEVICE-01
"Apple Pay available on Safari iOS/macOS with a Wallet card. On [device]: alternatives [alternative_methods]. See the checkout widget."
PAYUNAV-PRODUCT-01
"Gift card in cart: [payment
Edge cases: B2B, wire transfer, and mixed cart with mixed items
Four cases outside the standard macro.
B2B Transfer: manual transfer if cart > map threshold
Zone COD: #469 COD absent postal code outside zone
Card declined after: reroute declined payment if customer attempted card
VPN Market mismatch: shipping country vs IP explain market rules
Each payment provider requires a PAYUNAV-MAP line if cart_min or market_country differs.
Essential unpaid KPI
Five PAYUNAV steering metrics.
pay_unav_ticket_rate: tickets / checkout payment step sessions
pay_unav_recovery_rate: % of customers guided toward a purchase alternative
pay_unav_top_method: most requested missing method
pay_unav_top_reason: dominant unavailable_reason_code
pay_unav_sla_met: % alternative response < 5 min chat
Target: pay_unav_recovery_rate > 25% if PAYUNAV-MISSING-01 and direct cart link alternative.
PAYUNAV Anti-patterns
Five common mistakes.
Promising Klarna out of threshold: NO-METHOD-PROMISE
Invented alternative: PAYUNAV-MAP-GROUNDED
Confusing declined card: DECLINED-REROUTE distinct
Ignoring Apple Pay device: CHECKOUT-CONTEXT device
Blaming customer country: POLICY-URL-CITE explain map
PAYUNAV with Qstomy
Qstomy on Shopify checkout: detect pay_unav intent, PAYUNAV-MAP lookup cart context, alternative_methods widget, payment step proactive chip, handoff #518 bot tier 1 alternative quote.
Pipeline: #517 agents alternative ops → #518 bot checkout save conversion tier 1.
Explore AI support and request a demo.
Checklist, FAQ and going further
PAYUNAV Checklist (8 steps)
PAYUNAV-MAP v1: methods market min max product device
PAYUNAV-SUP Policy: 6 ops rules + agents
8 typologies pay_unav_*: helpdesk checkout tags
4 PAYUNAV-* macros: MISSING MIN DEVICE PRODUCT
Shopify payment settings audit: sync map vs admin config
Checkout payment FAQ snippet: top 3 missing methods
Training declined vs unav 20 min: DECLINED-REROUTE
Dashboard KPI: pay_unav_* section 9
FAQ
Difference declined payment?
Declined = card attempted failed. #517 = method not displayed checkout.
PayPal missing France?
Check PAYUNAV-MAP market + Shopify Payments config.
Bot #518 enough?
Tier 1 alternative quote. Config ops error → agents #517.
Klarna cart threshold?
PAYUNAV-MIN-01 cart_min_eur map row.
Going further
p: COD (#469)
This week: document PAYUNAV-MAP by market, test PAYUNAV-MIN-01 on cart below Klarna threshold, measure pay_unav_top_method missing.
Enzo
July 1, 2026
