COMPLETE PUBLICATION-READY PILLAR SECTION Building a Scalable Expansion Strategy for Payments The real test of an international payment architecture is not how it handles the first foreign market. It is what happens when the merchant reaches market #10. Consider two hypothetical merchants. Merchant A enters each country successfully, but every launch produces another branch in the architecture: new PSP integration → new checkout logic → new payment statuses → new token handling → new reports → new reconciliation rules → new operational runbook. Merchant B still has real market-entry work to do. It may need another provider, another local payment method, another currency, different authentication, new routing logic or local settlement configuration. But those differences are introduced inside a payment system whose core concepts remain stable. Merchant B configures: provider → payment methods → currency → authentication → routing → local checkout → settlement → risk rules. The two merchants can support exactly the same number of countries. Their marginal complexity is different. That is the architectural objective for international expansion: Convert as much new-market work as possible from new engineering architecture into controlled market configuration. This does not mean making every market identical. It means standardizing the parts where standardization creates leverage and localizing the parts where variation actually matters. Market expansion should become more configurable over time
A scalable international payment stack should become better at absorbing differences. That idea is already visible inside current PSP products themselves. Stripe's dynamic payment-method tooling, for example, allows many payment-method choices and display rules to be changed through configuration rather than hard-coded individually into each transaction flow. Adyen's Management API similarly lets eligible integrations request, enable, disable and update payment-method settings, including relevant country and currency attributes. These are provider-specific implementations, but they illustrate a broader architectural principle: some market differences can be represented as configuration rather than new integration logic. For the merchant's own architecture, the same principle can apply at a higher level. Instead of asking: “What do we need to build for Brazil?” then later: “What do we need to build for Japan?” then: “What do we need to build for market #10?” ask: “Which parameters describe a market, and which new capabilities genuinely require code?” A mature market configuration might include: * provider and acquirer; * enabled payment methods; * presentment and settlement currencies; * authentication behavior; * payment-method ordering; * local checkout fields; * routing policies; * risk settings; * merchant entity; * settlement configuration; and * operational ownership. That does not make market entry effortless.
It makes the difference between countries explicit rather than scattering it across application code. For the implementation patterns behind that model, route readers to how to build a multi-country payment stack and how to launch payments without rebuilding your stack. What belongs in the global payment core? The global core should contain capabilities whose meaning should remain stable even when the provider or market changes. A useful model is: Payment intent The merchant should have an internal concept representing what it is trying to accomplish commercially: charge this customer this amount for this order rather than allowing the entire order model to depend directly on a particular PSP object. That does not mean hiding every provider feature behind a lowest-common-denominator API. It means maintaining a merchant-owned business concept above the provider implementation. Merchant-facing payment API Checkout, subscriptions, order management and other internal systems should ideally communicate with a stable merchant-controlled payment interface rather than integrating independently with every new provider. A provider adapter can then translate that interface into the relevant PSP request. The boundary should be designed carefully: excessive abstraction can conceal useful PSP-specific functionality. The purpose is not to pretend providers are identical. It is to prevent every upstream merchant system from becoming provider-specific. Canonical payment states
Payment providers do not necessarily describe payment lifecycles in the same vocabulary. Stripe's current PaymentIntent lifecycle includes statuses such as requires_payment_method, requires_action, processing and succeeded. Adyen's current online-payment result codes instead include states such as Received, Pending, Authorised, Cancelled and Refused, and Adyen notes that the immediate result can later change and recommends using subsequent payment events rather than relying solely on that first result for order-state updates. That creates an architectural problem for a merchant using several providers. If every internal system learns each provider's vocabulary, provider logic spreads through: * checkout; * order management; * fulfilment; * customer support; * finance; * fraud tooling; * analytics; and * incident management. A more scalable design is to create a merchant-owned canonical state model and map provider states into it. For example: initiated customer_action_required processing authorized captured/paid failed cancelled refunded The exact merchant taxonomy should match the business and payment methods involved; the list above is conceptual rather than an industry standard. The important property is ownership: Provider-specific state → merchant normalization layer → stable internal state Adding another provider then requires a new mapping rather than teaching the whole organization another state machine. Token strategy
A scalable architecture should also decide deliberately where reusable payment credentials live and how dependent they are on a particular provider. This is where token portability needs to be distinguished from ordinary tokenization. Tokenization replaces sensitive payment credentials with a token so applications do not need to handle the original card data directly in ordinary payment operations. But a token issued by one provider is not automatically usable with another provider. Current provider documentation makes that distinction concrete. Stripe supports secure exports of eligible stored card data to another PCI DSS Level 1-compliant processor, but states that some credentials—such as those saved through Link—are not transferable through that export, and other Stripe objects such as payment history and subscriptions are not part of the payment-data export. Adyen separately offers a Forward capability that can send certain stored card details or network tokens from its vault to an eligible PCI-compliant third party. That is a specific portability mechanism layered on top of tokenization; it is not evidence that every Adyen token or every provider token is inherently portable. The architectural question is therefore not merely: “Do we tokenize cards?” It is: “If our acquiring or PSP strategy changes, what happens to our reusable payment credentials?” That belongs in the deeper Payment Token Portability article. Canonical data model
Provider IDs, payment methods, currencies, fees, disputes, refunds, settlement fields and timestamps can arrive in different schemas. The merchant should decide which concepts are part of its own durable payment data model. Useful merchant-owned identifiers can include: * payment ID; * order ID; * customer ID; * provider; * provider payment reference; * merchant entity; * market; * payment method; * presentment amount/currency; * settlement amount/currency; * internal payment state; * provider state; * authentication outcome; * refund/dispute references; and * relevant timestamps. Provider-specific fields do not need to disappear. Preserve them where they carry useful detail. The objective is to avoid making provider schemas the only source of truth for how the merchant understands its payment operation. Reporting taxonomy Provider dashboards are useful operational tools. They should not automatically become the global merchant reporting model. Stripe, for example, currently exposes balance transactions, payout reconciliation and its own reporting categories in its financial reporting model. Adyen's Settlement Details report uses a different settlement schema with fields such as merchant account, PSP reference, payment method and transaction-level settlement information.
The inference for a multi-provider merchant is straightforward: if Finance wants one consistent view across providers, it generally needs a merchant-owned reporting taxonomy that maps provider reports into comparable internal concepts. For example: gross payment refund chargeback processing fee FX effect other adjustment net settlement The exact taxonomy depends on the merchant's accounting and payment architecture. What matters is that adding another PSP does not force executive reporting to be redesigned around that PSP's dashboard vocabulary. That deeper problem belongs in Global Payment Data Standardization and Global Payment Reporting. Observability When a payment fails in market #10, Operations should be able to trace it without knowing the implementation history of that market. A merchant-controlled observability layer can preserve: merchant payment ID → provider → provider reference → route selected → attempts → state transitions → latency/errors → final outcome Provider webhooks remain important inputs. The scalable step is correlating them with merchant-owned identifiers and operational events rather than making the PSP dashboard the only place an incident can be investigated. Operational controls The global core should also define controls such as: * who can enable a provider; * who changes routing rules; * how configuration is tested; * how payment-method launches are approved; * how incidents are escalated; * how reconciliation exceptions are owned; * how configuration changes are logged; and
* how rollback works. The point is not centralization for its own sake. It is making market configuration governable. What should remain local? If everything is standardized, the merchant eventually recreates its home-market assumptions everywhere. That defeats the purpose. Market configuration should preserve differences that matter to customers, providers, acquirers, Finance, Compliance or Risk. Those can include: Provider and acquiring route Different markets may justify different acquiring or provider arrangements. The global architecture should therefore be capable of representing provider choice without treating the provider itself as the global architecture. Payment methods A method that matters in one market may be irrelevant or unavailable in another. Payment-method eligibility and configuration are genuinely market/provider dependent. Current Adyen and Stripe tooling both expose payment-method settings as configurable dimensions rather than one immutable global list. The detailed method-selection question belongs in the pillar's Local Payment Behaviour content and country payment guides. Currency Display, presentment and settlement choices can vary by market without requiring the global order or reporting architecture to change. That distinction is handled in Currencies and Settlement. Authentication Authentication requirements and provider flows can vary by payment method, geography and transaction context.
Keep those differences at the payment capability layer rather than spreading market-specific assumptions throughout unrelated merchant systems. Checkout fields and method ordering Language, field formats, currency, payment-method ordering and other customer-facing elements may need local configuration. The detailed design belongs in Checkout Localization. Routing Routing policy is configuration about where a payment attempt should go. It is not synonymous with having many providers. A merchant can have three PSPs and no meaningful routing architecture if each market is permanently hard-wired to one of them. Conversely, a merchant can have a relatively small provider portfolio and still make explicit routing decisions based on factors such as market, currency, payment method, merchant entity or operational state. The deeper implementation belongs in Routing Payments by Country and Routing Payments by Currency. Settlement Entity, bank-account and settlement configurations can vary without changing the merchant's core concept of a payment. That separation matters because Treasury architecture should not have to redefine checkout architecture every time settlement changes. Risk configuration A merchant can maintain common risk data and operational principles while allowing market-specific rules, models or thresholds where justified by local payment behavior and fraud patterns. The pillar's Fraud Differences by Market section should own the reasons for that localization.
One architecture can still use multiple providers A common mistake is to treat these two goals as interchangeable: one global architecture and one global PSP They are not. A single provider can reduce some integration and operational work when it satisfies the merchant's market, method, acquiring and feature requirements. But a one-provider strategy does not by itself create: * a merchant-owned state model; * portable payment data; * canonical reporting; * portable credentials; * standardized observability; or * disciplined market configuration. Likewise, adding a second provider does not automatically create architectural chaos. Complexity grows when provider-specific assumptions leak into every merchant system. The architecture question should therefore come before the provider-count question: Can the merchant introduce or replace a payment provider without redesigning every upstream and downstream system? That does not mean switching providers should be trivial. Payment providers have genuinely different capabilities, API models, payment methods and operational requirements. A useful architecture preserves those differences at explicit boundaries instead of pretending they do not exist. For provider portfolio strategy, route readers to one global PSP versus multiple local PSPs, global PSP versus regional PSP, and multi-PSP strategy for global merchants. PSP count is not a useful proxy for operational complexity Imagine two merchants. Merchant X has two PSPs, but:
* both send data into the same payment model; * states are normalized; * provider references are searchable through one operations tool; * reconciliation maps to a standard finance model; * routing configuration has defined ownership; * payment credentials have a deliberate migration strategy. Merchant Y has one PSP, but: * each country has separate code; * teams use different account structures; * reporting conventions differ market by market; * payment-method logic is embedded throughout checkout; * local operations have created separate reconciliation spreadsheets; * no common identifiers connect customer support to settlement. Merchant Y may have fewer providers and more operational complexity. The useful metric is therefore not: Number of PSPs It is closer to: How much incremental technology and operating work does another provider, payment method or market create? Routing is not the same thing as provider proliferation The distinction matters as merchants add providers. Provider proliferation means the merchant has accumulated more PSPs or acquirers. Routing architecture means the merchant has an explicit decision layer determining which eligible route should handle a particular payment attempt. A route could depend on dimensions such as: * market; * payment method; * currency; * merchant entity; * transaction type; * provider availability; or * other merchant-approved criteria.
Not every merchant needs sophisticated dynamic routing, and routing should not be added merely because it sounds architecturally mature. First identify the business decision. Then decide whether it requires configuration, static mapping, rules, orchestration or another implementation. That distinction prevents payment orchestration from becoming a solution in search of a problem. The deeper architectural choices belong in payment orchestration for international expansion. Token portability is different from tokenization This distinction deserves architectural attention before the merchant builds recurring payment volume around a provider. Tokenization asks: Can we avoid using raw reusable card credentials in ordinary application flows? Token portability asks: What happens to our stored-payment capability if another eligible processor needs to handle those customers later? Current Stripe and Adyen documentation demonstrates why that second question must be asked explicitly. Stripe can securely export eligible stored card data to another qualifying processor, but some credentials and non-card account objects are excluded. Adyen can forward certain stored card details and network tokens to eligible third parties under its documented Forward capability. So “we use tokens” is not sufficient architecture documentation. The merchant should know: Who issued the token? Where is the underlying credential stored? Can the token itself be used elsewhere? Can the underlying credential be migrated?
What PCI/security process applies? What payment or wallet credentials are excluded? What happens to recurring agreements, mandates or historical references? Those answers can materially affect how easily the provider layer can change later. Reporting should survive a provider change The Finance team should not need a new definition of “net payments” every time Payments adds an acquirer. Provider reporting systems naturally reflect their own account and settlement models. Stripe's financial reporting is built around concepts such as balance transactions, reporting categories and payout reconciliation; Adyen's settlement reporting uses its own transaction and settlement fields and references. A scalable merchant architecture therefore benefits from a translation layer: Provider reports → provider-specific ingestion → merchant canonical transaction model → finance/reconciliation taxonomy → global reporting This is an architectural recommendation inferred from the differing provider schemas, not a requirement imposed by either provider. The goal is not to discard source-provider data. Retain the original references so Finance can reconcile back to each PSP. But executive and operating metrics should not become impossible to compare because the definition changes with the provider. Operations need the same abstraction as engineering Architecture fails to scale if engineering normalizes providers but Operations still runs each country as a separate payment company.
For market #10, ask whether the operating model can already answer: * Who owns a provider incident? * Where does customer support find the provider reference? * How is a payment reprocessed or investigated? * Where do Finance teams find settlement information? * What happens when a new payment method stays pending? * Who owns routing changes? * How are provider outages escalated? * How are reconciliation exceptions tracked? * Which configuration is market-specific? * Which configuration change requires approval? A scalable international payments strategy therefore needs both: technical abstraction and operational standardization The deeper design belongs in Global Payment Operations Model and, where organizational ownership differs materially, Centralized vs Decentralized Payment Operations. The Global Core / Market Configuration Model The architecture can be summarized in two layers. Global core Keep these stable where practical: Payment intent A merchant-owned representation of the commercial payment objective. API/interface The stable boundary used by merchant applications. Canonical payment states A common merchant vocabulary into which provider states are mapped. Token strategy Rules for storage, security, recurring use and portability. Data model Consistent identifiers and payment concepts. Reporting taxonomy Merchant-owned financial and operational categories. Observability A way to trace transactions across providers and markets. Operational controls
Ownership, deployment, escalation and change-management rules. Market configuration Make these configurable where relevant: PSP / acquirer Which eligible provider or acquiring route is used. Payment methods Which methods are enabled for the market and use case. Currency Display, presentment, settlement and other relevant currency choices. Local checkout Fields, method ordering and relevant localized payment behavior. Authentication Market/provider/payment-method-specific authentication behavior. Routing How eligible payment attempts are assigned. Settlement Merchant entity, currency and destination configuration where applicable. Risk settings Market-specific settings justified by payment and fraud behavior. The principle is not: global = good; local = bad. It is: Standardize where commonality creates leverage. Configure where local variation creates enough value—or is sufficiently necessary—to justify the complexity. How to decide whether something belongs in core or configuration For each payment capability, ask four questions. 1. Does its business meaning change by provider? If not, it is a strong candidate for the global core. An internal order or payment identifier should not acquire a new meaning because another PSP is introduced. 2. Does its optimal value vary by market? If yes, it is likely configuration. Payment-method availability and ordering are obvious examples. 3. Would hard-coding the difference force unrelated systems to understand the provider?
If yes, move the difference toward an adapter or configuration boundary. 4. Does abstraction erase material provider capability? If yes, preserve an explicit extension mechanism. The goal is not to produce a lowest-common-denominator payment API that prevents teams from using valuable local or provider features. A good global core creates stability without banning useful specialization. Measure the complexity of market N+1 International-payment architecture should be measured by the cost of change, not by an architecture diagram. A useful internal concept is: Marginal Market Complexity For each new market, record how much incremental work was required across: Capability Configuration only Adapter/change New architecture Provider/acquirer
Payment methods
Currency
Authentication
Checkout
Token/payment credentials
Payment-state mapping
Reporting
Reconciliation
Settlement
Operations
Then track whether the mix changes as the merchant expands. The target is not: 100% configuration. Some markets introduce genuinely new payment methods, regulatory structures, providers or customer flows that require engineering. The healthier objective is: The proportion of expansion work requiring a new foundational architecture should fall as the merchant's international platform matures. A practical N+1 test Before approving the architecture for another market, ask: Provider Can we add this provider through an existing adapter boundary, or must upstream systems integrate directly? Payment methods Can the new methods be represented through the existing payment interface and state model? Tokens Can recurring credentials be used, migrated or routed according to the intended provider strategy? States Can every meaningful provider state be mapped without breaking the canonical lifecycle? Checkout Can local differences be configured without creating another checkout codebase? Data Will transactions still land in the same internal payment model? Reporting Can Finance reconcile the provider without inventing another permanent reporting process? Operations Will Support, Payments and Finance investigate incidents through the same operating model? Settlement Can the market's settlement configuration be represented without changing unrelated payment logic? Exit If the provider strategy changes later, what data, credentials and business processes are difficult to move? The last question is deliberately included.
Architecture should be evaluated not only for how quickly a provider can be added, but also for how deeply the merchant becomes dependent on its proprietary objects. One global PSP versus multiple PSPs is a second-order decision The merchant still needs a provider strategy. But that decision should be made after the architecture questions are clear. Ask: * Which markets must be supported? * Which local payment methods matter? * Which acquiring relationships are required? * Which currencies and settlement configurations are needed? * Which provider-specific features create meaningful value? * What resilience does the business require? * What operational cost does another provider create? * How portable are credentials and payment data? * How much routing flexibility is actually useful? Those answers can support a one-PSP model, a global-plus-local model, multiple regional providers or another configuration. There is no provider-count formula for global scalability. The architectural objective is more durable: Do not let today's PSP portfolio become tomorrow's payment architecture. The strategic endpoint: build less of the same problem By market #10, the merchant should still expect work. Customer behavior changes. Payment methods change. Acquiring changes. Currencies and settlement change. Regulation changes. Risk behavior changes. Checkout requirements change. The scalable payment organization is not the one that eliminates these differences.
It is the one that has decided where those differences are allowed to live. The target architecture is: Global core → stable merchant payment concepts plus Market configuration → deliberate local differences so that market N+1 increasingly means: configure provider configure methods configure currency configure routing configure checkout configure settlement and risk rather than: build another payment system. That is the difference between expanding a payment stack and repeatedly replacing it.
PILLAR SECTION END
Pillar Section 9 — Building a Scalable Expansion Strategy for Payments A. Brief interpretation — editorial, not part of the pillar section Section-owned question: How can a merchant add country N+1 without building another bespoke payment stack? Merchant problem: International expansion works market by market, but every launch adds another PSP integration, token store, payment-state model, report, reconciliation process and operating procedure until the payment organization stops scaling. Editorial position: Standardize capabilities that create global leverage; leave market-specific capabilities configurable where local differences materially affect customer access, economics, compliance, risk or operational performance. Key distinction: One PSP is not the same thing as one scalable architecture. Likewise, multiple PSPs do not automatically mean an unmanageable architecture. Evidence anchor: Contrast two hypothetical merchants entering market #10. Merchant A builds another payment stack. Merchant B configures a new market inside a stable core. Primary merchant decision: Which payment capabilities should remain globally standardized, and which should be configurable by market or provider?
B. C. ORIGINAL SECTION ASSET — GLOBAL CORE / MARKET CONFIGURATION MODEL Global Core / Market Configuration Model GLOBAL CORE — standardize for leverage Capability What should remain stable Why Payment intent Merchant's definition of what is being paid Keeps commercial logic independent of PSP objects API/interface Merchant-controlled payment boundary Limits provider logic spreading across applications Canonical states Internal payment lifecycle Makes provider events comparable Token strategy Credential-storage and portability principles Prevents token architecture being accidental Data model IDs, amounts, currencies, references, timestamps Makes payments comparable across markets Reporting taxonomy Common financial/operational categories Enables global Finance and analytics Observability End-to-end traceability Enables cross-provider incident diagnosis Operational controls Ownership, escalation and change process Prevents every market developing its own operating model MARKET CONFIGURATION — preserve useful variation Capability Typical configurable dimensions Decision owner(s) PSP/acquirer Provider, acquiring route, merchant account Payments Payment methods Enabled methods and relevant eligibility Payments/Product Currency Presentment, settlement and other currency choices Payments/Finance Checkout Local fields, method order, language-related configuration Product Authentication Relevant provider/market/payment-method behavior Payments/Risk Routing Country, currency, method, provider eligibility Payments Settlement
Entity, currency, account configuration Finance/Treasury Risk Market-specific controls and models Fraud/Risk Architecture boundary GLOBAL MERCHANT SYSTEMS Commerce / subscriptions / orders / customer service / finance ↓ Merchant payment interface ↓ Canonical state + data + token + reporting layer ↓ Market configuration ↓ Provider A | Provider B | Provider C ↓ Acquirers / payment methods / local rails Goal Reduce the marginal complexity of market N+1 without eliminating useful local variation.
N+1 Architecture Scorecard Use four classifications for each new-market requirement: C — Configure Existing capability; only market/provider configuration changes. A — Adapt Existing architecture; provider adapter or mapping needs work. E — Extend New reusable capability must be added to the global core. B — Bespoke Market-specific implementation that is not currently reusable. Track: Configuration Ratio Number of C requirements ÷ Total assessed market requirements and: Foundational Change Ratio Number of E + B requirements ÷ Total assessed requirements These are merchant-defined operating metrics, not industry benchmarks. The goal is directional: over successive launches, more repeatable market work should move toward configuration while genuine new capabilities are added deliberately to the reusable core.
D. INTERNAL-LINK PLAN — not part of pillar prose Priority Recommended anchor text Destination Purpose Link type 1 payment infrastructure for global expansion Payment Infrastructure for Global Expansion Broader architecture context supporting the section Strategic article 2 how to build a multi-country payment stack How to Build a Multi-Country Payment Stack Detailed technical implementation of the core/configuration model Specialist architecture page 3 one global PSP versus multiple local PSPs One Global PSP vs Multiple Local PSPs Provider-portfolio decision after architectural requirements are defined Strategic article 4 multi-PSP strategy for global merchants Multi-PSP Strategy for Global Merchants Deeper provider-portfolio and operating-model analysis Specialist strategy page 5 payment orchestration for international expansion Payment Orchestration for International Expansion Explain when a dedicated orchestration layer is warranted Specialist architecture page 6 Payment Token Portability Payment Token Portability Owns migration, vault portability and credential dependency Technical deep link 7 Global Payment Reporting Global Payment Reporting Owns canonical reporting across provider schemas Technical deep link 8 Global Payment Operations Model Global Payment Operations Model Owns operational standardization and cross-market ownership Technical deep link Secondary links to distribute only where relevant Global PSP versus regional PSP Use in the provider-strategy paragraph rather than alongside every PSP link.
Routing Payments by Country / Routing Payments by Currency Use adjacent to the routing discussion. Global Payment Data Standardization Use in the canonical-data/reporting section. Centralized vs Decentralized Payment Operations Use only where operating-model ownership is discussed. How to Launch Payments Without Rebuilding Your Stack Use near the opening or final “build versus configure” synthesis. Reciprocal link recommendation The following supporting pages should link back to this pillar using natural anchor variants such as: * international payment expansion; * scalable global payments expansion; * payment challenges when entering new markets; * international payment infrastructure; * expanding payments into new countries. Avoid using the identical anchor on every page.
E. SEO SUPPORT — not part of pillar prose Suggested H2: Building a Scalable Expansion Strategy for Payments Suggested H3s: * Market expansion should become more configurable over time * What belongs in the global payment core? * What should remain local? * One architecture can still use multiple providers * Measure the complexity of market N+1 Secondary semantic terms: * international payment architecture * scalable payment infrastructure * global payment stack * multi-country payment architecture * PSP abstraction * payment provider integration * payment routing * canonical payment states * payment data model * token portability * payment token migration * multi-PSP * global payment reporting * payment reconciliation * payment observability * market configuration * payment orchestration * global payment operations * marginal market complexity Featured-snippet opportunity How do you build a scalable international payment architecture? A scalable international payment architecture keeps reusable capabilities—such as payment intents, internal APIs, payment states, token strategy, data models, reporting and observability—in a stable global core. Market-specific differences such as providers, payment methods, currencies, authentication, routing, settlement and risk settings remain configurable. The objective is to make each additional market require more configuration and less foundational rebuilding. Supporting visual Global Core / Market Configuration Model Visually show: Merchant commerce systems ↓ Global core
Payment intent API Canonical states Token strategy Data model Reporting Observability Operational controls ↓ Market configuration PSP/acquirer Methods Currency Authentication Routing Local checkout Settlement Risk ↓ Market 1 | Market 2 | Market 3 | Market N+1 A side arrow should show: More mature architecture → lower marginal N+1 complexity Recommended alt text “Global Core and Market Configuration payment architecture showing standardized APIs, payment states, token strategy, data, reporting and observability connected to configurable PSPs, payment methods, currencies, routing, checkout, settlement and risk by international market.”
F. EVIDENCE AND VERIFICATION PLAN — not part of pillar prose Primary sources used Stripe — PaymentIntent lifecycle Current first-party documentation demonstrating Stripe's own payment-state model, including states such as requires_payment_method, requires_action, processing and succeeded. Editorial use: Evidence that provider-specific payment-state vocabularies exist and therefore need deliberate mapping in a multi-provider merchant architecture. Adyen — Payment result codes Current first-party documentation describing Adyen result codes such as Received, Pending, Authorised, Cancelled and Refused. Adyen also warns that an immediate result code can later change and directs merchants toward subsequent payment-status events for system updates. Editorial use: Comparison with Stripe supporting the need for a merchant-owned canonical state model. Important qualification: The article's proposed canonical states are an architectural recommendation, not a standard supplied by Stripe, Adyen or a payment network. Stripe — Dynamic payment methods Current first-party documentation showing that eligible payment-method availability and presentation can be managed through configuration rather than being individually hard-coded into every payment request. Editorial use: Provider-specific evidence illustrating the wider build-versus-configure principle. Adyen — Manage payment methods with API
Current first-party documentation showing API-based requesting, enabling, disabling and updating of payment-method configuration, including country and currency settings where supported. Editorial use: Additional primary evidence that market-specific payment capabilities can be exposed as configuration. Stripe — Payment data export Current first-party documentation states that Stripe can securely transfer eligible customer card data to another PCI DSS Level 1-compliant payment processor. It also documents exclusions: Link credentials are not transferable through this process, and payment history, subscriptions and certain other objects are not part of the exported payment credentials. Editorial use: Strong evidence for distinguishing tokenization/storage from credential portability. Adyen — Forward payment details Current first-party documentation states that eligible stored card details and network tokens can be forwarded from Adyen to a PCI-compliant third party under its Forward capability. Editorial use: Additional evidence that cross-provider credential use requires an explicit portability mechanism. Stripe — Reporting and reconciliation Current Stripe documentation describes its balance-transaction, payout and reporting-category model and supports financial-report retrieval through its reporting architecture. Adyen — Settlement Details report
Current Adyen documentation describes its own transaction-level settlement-report structure, including PSP references, merchant-account information and payment-method fields. Editorial use: Together, Stripe and Adyen demonstrate that providers expose different financial-reporting structures. The recommendation to map them into a merchant canonical reporting taxonomy is an architectural inference based on that difference.
Claims requiring current verification Before publication, recheck any claims concerning: * current provider payment-state names; * payment-method configuration capabilities; * API configuration availability; * provider-country eligibility; * routing features; * network-token support; * credential export/import capability; * card-data migration restrictions; * PCI requirements for migrations; * PSP token portability; * reporting APIs; * settlement-report schemas; * orchestration capabilities; and
Most of the section's architecture recommendations are intentionally provider-neutral and do not depend on volatile performance claims. No approval-rate uplift, cost reduction, resilience percentage, engineering saving or universal “best” PSP count is asserted. Regional/country claims needing research This section intentionally does not specify: * which provider is optimal in a named market; * which local payment methods are required; * whether local acquiring is available; * whether a local entity is required; * specific authentication rules; * particular routing priorities; or * country-specific settlement structures. Those decisions belong to the relevant market, acquiring, compliance and country-guide content.
* global payment API abstraction; * provider orchestration capability; * multi-acquirer routing; * automatic routing logic; * token vault; * token portability; * network-token functionality; * data migration process; * canonical reporting; * reconciliation product; * observability tooling; * country-based routing; * currency-based routing; * fallback provider capability; * multi-PSP management function; * centralized payment-method configuration; or * merchant operational workflow.
G. HUMAN REVIEW RECOMMENDATION — not part of pillar prose Primary technical reviewer: Payment architect or senior payments engineer with experience operating multi-country, multi-provider payment infrastructure. Payments strategy reviewer: Head of Payments or international payments strategist who can validate the global-standardization versus local-configuration boundary. Operations reviewer: Payment operations lead with experience in incidents, provider transitions, reconciliation and market launches. Finance/reconciliation reviewer: Finance or payment-reconciliation specialist for the reporting-standardization sections. Token/security reviewer: Payments security or PCI specialist should review any detailed claims about credential storage, token portability, PAN migration or network tokens. Product reviewer: Checkout/product leader to ensure market configuration does not imply that every local customer difference should be engineered independently. Recommended first-hand contribution: A useful attributed contribution would compare the actual engineering and operational work needed for an early international market with a later market after a reusable architecture was established. Any real metric should define what counted as configuration, adapter work and foundational engineering.
Not sure which payment solution fits?
Use the merchant matching prototype to understand the types of providers to evaluate.
Explore matching ↗