E-commerce
July 1, 2026
"What is iDEAL, how do I pay?" "Bancontact is not working, I don't understand." "Which local method should I use in Brazil?" Three tickets where a poorly explained local payment method blocks international checkout conversion.
The e-commerce local payment methods support covers iDEAL, Bancontact, Sofort, BLIK, Pix, and checkout flows by market. Distinct from unavailable methods (#517) and country restrictions (#759): here, it's about pedagogy on how to use each local method by market.
This guide #783 covers policy LOCPAY-SUP, flows LP-1 to LP-8, and matrix LOCPAY-MAP. Paired with future customer service bot LOCPAY (#784).
Summary
Why do local payment methods generate tickets?
The international customer sees iDEAL or Bancontact at checkout but does not understand the local banking process. The agent mentions a global card, ignores the local method guide, or confuses a missing method with an unknown method. Without a SOP, support routes to country restriction (#759) or payment declined instead of explaining how to pay locally.
Five typical frictions for local methods
Unknown customer method: iDEAL BLIK Pix not understood map
Unclear checkout steps: bank redirection app map
Market method choice: which option for country X map
Card vs local comparison: advantages and delays map
Local process failure: bank app timeout map
Shopify Payments and Stripe enable local methods by market (Shopify, payment methods 2026). Without LOCPAY-MAP, agents improvise the iDEAL Bancontact guide.
LOCPAY #783 vs CNTRYPAY #759, PAYUNAV #517, international #100 and bot #784
Six contents, six distinct local payment paths.
Quick Matrix
#783 LOCPAY: guide on how to use iDEAL Bancontact BLIK Pix by market
CNTRYPAY #759 : country restriction blocked method distinct local education
PAYUNAV #517 : unavailable means cart distinct device market guide
Declined payment : distinct bank decline unknown method
International #100 : distinct general cross-border guide local checkout
#784 LOCPAYbot : bot offer tier 1 local method
#783 = how to use iDEAL. #759 = iDEAL absent due to country restriction alternative.
Which locpay_* typologies should be classified?
Eight local payment method ticket scenarios.
Eight locpay typologies
locpay_ideal_explain: what is iDEAL how to pay NL map
locpay_bancontact_explain: Bancontact guide BE map
locpay_sofort_explain: Sofort Klarna DE map
locpay_blik_explain: BLIK code PL map
locpay_pix_explain: Pix QR code BR map
locpay_method_selection: which method market X map
locpay_checkout_steps: checkout steps local method map
locpay_local_failed: failed flow bank app map
Tags: locpay, local_payment, checkout_international. METHOD-GUIDE-CITE: ideal_guide_copy bancontact_guide_copy map only.
How should the LOCPAY-MAP matrix be structured?
The LOCPAY-MAP matrix documents local payment methods guide by market for agents and future bot #784.
LOCPAY-MAP Columns
locpay_program_id : local payment method program identifier map
market_country_code : NL BE DE PL BR etc. market country code map
local_methods_list_copy : available methods market order map
ideal_guide_copy : iDEAL bank redirection steps map
bancontact_guide_copy : Bancontact card app map
sofort_guide_copy : Sofort instant bank transfer map
blik_guide_copy : BLIK 6-digit code map
pix_guide_copy : Pix QR copy paste map
checkout_steps_copy : generic checkout journey market map
method_comparison_copy : local vs card vs PayPal map
local_failed_troubleshoot_copy : bank app timeout retry map
bot_intent_map : bot_locpay_* #784 mapping
Sync helpdesk macros, local_payment market tags and METHOD-GUIDE-CITE agent training before MARKET-CITE.
LOCPAY-SUP policy in six rules
Six rules support local payment methods.
LOCPAY-MAP-GROUNDED: local method guide from map only
METHOD-GUIDE-CITE: ideal_guide_copy bancontact_guide_copy etc. cite map
MARKET-CITE: market_country_code local_methods_list_copy cite map
CHECKOUT-GUIDE-CITE: checkout_steps_copy cite map verbatim
CNTRYPAY759-REROUTE: blocked method absent → #759 distinct country restriction guide
PAYUNAV517-REROUTE: unavailable cart device → #517 distinct market
Flow LOCPAY LP-1 to LP-8
Flow agent eight steps local payment methods.
LP-1 Intake: locpay_* intent + market_country method_question cart_url device
LP-2 LOCPAY-MAP: methods ideal bancontact sofort blik pix checkout comparison failed
LP-3 Market lookup: shipping_country market verify MARKET-CITE
LP-4 Classify: ideal bancontact sofort blik pix selection steps failed
LP-5 Triage: METHOD-GUIDE MARKET CHECKOUT CNTRYPAY759 PAYUNAV517 DECLINED
LP-6 Respond: macro LOCPAY grounded method guide checkout_steps_copy
LP-7 Guide: cart link checkout_steps_copy local method
LP-8 Close: tag locpay_resolved method_guide_cited checkout_completed Y/N
SLA: locpay_ideal_explain answered with METHOD-GUIDE-CITE ideal_guide_copy and CHECKOUT-GUIDE-CITE in one interaction.
Essential LOCPAY macros
Four macro agents for local payment methods.
LOCPAY-IDEAL-01
"iDEAL Netherlands: [ideal_guide_copy map.] [checkout_steps_copy map.] METHOD-GUIDE-CITE CHECKOUT-GUIDE-CITE."
LOCPAY-BANCONTACT-01
"Bancontact Belgium: [bancontact_guide_copy map.] [checkout_steps_copy map.] METHOD-GUIDE-CITE."
LOCPAY-SELECT-01
"Payment [market_country_code map]: [local_methods_list_copy map.] Recommended: [method_comparison_copy map.] MARKET-CITE."
LOCPAY-FAILED-01
"Local flow failure: [local_failed_troubleshoot_copy map.] [checkout_steps_copy retry map.]"
Edge cases: country restriction, unavailable, bank decline, and Markets
Five cases outside the standard local average macro.
iDEAL missing from checkout: CNTRYPAY759-REROUTE #759 country restriction distinct guide to use
Greyed out method in cart: PAYUNAV517-REROUTE #517 device threshold distinct market
Card declined after attempt: declined payment distinct unknown method
Shopify Markets configuration: Markets ops distinct client guide
BLIK Pix timeout: local_failed_troubleshoot_copy banking app retry map
Visible method = METHOD-GUIDE-CITE. Missing method = CNTRYPAY759-REROUTE.
Essential locpay KPIs
Five LOCPAY management metrics.
locpay_method_guide_cite_rate: METHOD-GUIDE-CITE / total locpay explain selection
locpay_checkout_complete_rate: completed order post-guide / total locpay
locpay_cntrypay_misroute_rate: restriction tickets despite guide / total locpay
locpay_market_cite_rate: MARKET-CITE / total locpay method_selection
locpay_csat: CSAT local payment segment post-guide map
Target: locpay_method_guide_cite_rate 100% and locpay_checkout_complete_rate increasing post LOCPAY-MAP.
LOCPAY anti-patterns
Five common mistakes when supporting local payment methods.
Offering card only : METHOD-GUIDE-CITE local_methods_list_copy map first
Agent-invented guide : ideal_guide_copy bancontact_guide_copy map only
Confusing absent and unknown : CNTRYPAY759-REROUTE absent distinct explain visible
Ignoring customer market : MARKET-CITE market_country_code before diagnosis
Route PAYUNAV #517 : PAYUNAV517-REROUTE market guide distinct basket threshold
LOCPAY with Qstomy
Qstomy on Shopify: detect locpay intent, LOCPAY-MAP RAG grounded, market classify, METHOD-GUIDE-CITE guardrail, handoff #784 bot tier 1 or ops Markets escalate.
Pipeline: #784 bot propose local method tier 1 → #783 agents ops Markets escalate payment config.
Explore AI support and request a demo.
Checklist, FAQ and going further
LOCPAY Checklist (8 steps)
LOCPAY-MAP v1 : NL BE DE PL BR methods ideal bancontact sofort blik pix checkout failed
Policy LOCPAY-SUP : 6 rules METHOD-GUIDE MARKET CHECKOUT CNTRYPAY759 PAYUNAV517
8 locpay_* typologies : tags helpdesk local_payment checkout_international
4 LOCPAY-* macros : IDEAL BANCONTACT SELECT FAILED
Markets payment sync : local_methods_list by Shopify market test
30-min agent training : METHOD-GUIDE-CITE before CNTRYPAY759-REROUTE
Checkout guide screenshots : ideal_guide bancontact_guide visuals help center
Dashboard KPI : locpay_* section 9 method_guide_cite checkout_complete misroute
FAQ
Difference CNTRYPAY #759 ?
#759 = blocked method land restriction. #783 = visible method how to use it.
How does iDEAL work ?
LOCPAY-IDEAL-01 ideal_guide_copy checkout_steps_copy map.
iDEAL missing checkout ?
CNTRYPAY759-REROUTE land restriction distinct guide to use.
Relation #784 bot ?
#784 = bot suggest local method tier 1. #783 = agents ops Markets escalate.
Going further
This week : index LOCPAY-MAP ideal_guide bancontact_guide by market, sync tags local_payment market, test macro LOCPAY-IDEAL-01 customer scenario FR order NL.
Enzo
July 1, 2026
