Local Payment Method Integration Options: Direct, PSP, Hosted, or Orchestrated? Imagine three international merchants adding the same local bank-payment method. The first signs the relevant agreements, receives method-specific credentials, integrates the payment API, builds its own payment-state handling, implements refunds and maps the method into its reconciliation system. The second adds the method to an existing PSP integration. Its checkout remains merchant-controlled, but the merchant sends the transaction to the PSP through an API and receives a normalized payment result. The third enables the method on a hosted payment page. Its application creates an order and hands the customer to a payment experience operated largely by its provider. To the customer, all three merchants may appear to offer the same payment method. The merchants do not own the same payment architecture. One owns a method-specific integration. One owns a provider integration. One delegates much of the payment surface as well. Add a fourth merchant using a payments orchestration layer across several providers and the customer-facing similarity hides an even bigger architectural difference. This is the problem with asking whether a merchant should integrate a local payment method “directly or through a PSP.” It sounds like one choice. It is actually several. The real decision is which payment layers the merchant wants to own A payment method is not fully described by its button.
Underneath that button are several control boundaries. 1. Commercial relationship Who has the contract that allows the merchant to accept the method? It might be: * the merchant directly; * an acquirer; * a payment service provider; * a collecting provider; * another licensed payment intermediary; * or a commerce platform acting within its permitted payment architecture. That relationship can determine eligibility, pricing, settlement, reserves, underwriting and support. 2. Technical connectivity Whose system speaks to the payment method? The merchant may integrate a method-specific API itself. A PSP may expose the method through its API. A gateway may provide technical connectivity while another party remains responsible for acquiring or settlement. An orchestration layer may connect the merchant to several providers, each of which connects onward to different methods. 3. Checkout presentation Who renders the payment experience? The merchant may control its own payment-method selector and call APIs behind it. A provider may supply JavaScript or an SDK. The customer may be redirected to the method operator or bank. Or the entire payment-selection experience may be rendered through hosted checkout. 4. Payment-state ownership Who decides how dozens of method-specific states become merchant order states such as: * pending; * authenticated; * authorized; * confirmed; * failed; * expired; * cancelled; * refunded? This can become more strategically important than the initial API call.
A local payment method that confirms asynchronously or requires the customer to return from an external application needs different state handling from an immediately confirmed transaction. 5. Operational ownership Who owns: * refunds; * payment investigations; * reporting; * reconciliation; * settlement visibility; * credential rotation; * certificate management; * API migrations; * incident escalation; * and method-specific support? The architecture decision is therefore not simply: Direct or indirect? It is: Which of these layers creates enough strategic value for the merchant to own itself? Direct integration: maximum method ownership, maximum method-specific responsibility A direct integration means the merchant establishes a technical relationship close to the payment method or relevant processing/acquiring participant rather than consuming the method solely through a broader merchant PSP abstraction. It can give the merchant substantial control over: * API behavior; * payment-method features; * customer experience; * payment-state logic; * method-specific metadata; * refund execution; * reporting; * and potentially the commercial relationship. But the word direct needs discipline. Direct integration does not necessarily mean direct acquiring These are different architectural concepts. A merchant can integrate directly with a payment interface while another institution remains responsible for processing, acquiring or settlement.
Apple Pay provides a useful technical illustration outside the local-method category. Apple's current documentation says Apple Pay payment data can be decrypted by the merchant itself or delegated to a PSP. The choice of who decrypts the wallet payload is therefore separable from the rest of the payment-processing relationship. The same conceptual rule matters for local payment methods: Owning a technical endpoint does not automatically mean owning every financial relationship behind it. For each direct integration, ask separately: * Who contracts with the method? * Who provides merchant credentials? * Who performs regulated payment services? * Who receives or controls settlement? * Who determines merchant eligibility? * Who owns customer funds at each stage? What the merchant gains from direct integration The strongest case for going direct is usually capability depth. The merchant may gain faster or earlier access to method-specific functionality, more complete data, greater checkout flexibility, a direct escalation path and fewer limitations introduced by a provider's normalized abstraction. That can matter when a particular method is strategically important enough to justify treating it almost like its own payment product. A very large merchant may also have economics that justify a separate commercial relationship. And direct connectivity can reduce dependency on one general-purpose PSP. But reducing provider dependency does not eliminate dependency.
It replaces some provider dependency with payment-method dependency. The merchant now owns the consequences when that method changes. What the merchant must maintain A production integration does not stop costing engineering time when it launches. The merchant may need to own: * method-specific API code; * sandbox and production configuration; * secrets and credentials; * certificates where relevant; * SDK upgrades; * API-version migrations; * redirect/deep-link logic; * webhook or callback handling; * idempotency; * retries; * state transitions; * refund logic; * reconciliation mappings; * monitoring; * alerting; * runbooks; * incident escalation; * reporting changes; * and regression testing. Multiply that by ten, twenty or fifty local methods and “more direct control” can become a permanent engineering organization. That is the central cost direct-integration comparisons often omit. The cost is not the first integration. It is the portfolio of integrations after five years of change. PSP integration: delegate method connectivity without necessarily delegating checkout A PSP model usually gives the merchant access to one or more payment methods through a provider's broader integration and commercial environment. But even “PSP” is not precise enough to tell a merchant exactly what is delegated.
Current iDEAL | Wero documentation demonstrates why. It distinguishes a technical PSP, which provides technical integration while the merchant retains its agreement with an iDEAL acquirer, from a collecting PSP, where the merchant contracts with the collecting PSP and that provider also collects and subsequently transfers the merchant's iDEAL funds. That is the evidence anchor for this entire architecture question: Two merchants can accept the same payment method through something both sides call a PSP while having materially different contracts, settlement flows and operational dependencies. What a PSP can abstract Depending on the provider and method, a PSP may centralize: * merchant onboarding; * method connectivity; * APIs; * payment-state normalization; * credentials; * checkout components; * refunds; * reporting; * settlement; * reconciliation; * and support. This can dramatically reduce the amount of method-specific code a merchant maintains. Instead of building ten integrations, a merchant may expose one internal payment interface: create_payment() and allow the provider to translate that instruction into the method-specific transaction. Likewise, the merchant can attempt to normalize responses into its own internal states rather than exposing every method's vocabulary to order-management systems. That abstraction is valuable. It is also a dependency. The abstraction tax A provider abstraction may expose fewer capabilities than the underlying method offers.
For example, the method operator may support: * richer customer data; * a particular recurring model; * partial refunds; * specialized payment-status queries; * QR presentation options; * app-specific flows; * detailed error information; * or a new feature not yet implemented by the PSP. The correct question is not whether PSP integration has “fewer features.” It is: Does the provider expose the features this merchant actually needs? If yes, unused method-specific capability has little strategic value. If no, abstraction begins to constrain the merchant. PSP versus gateway: define the role before comparing the label “Payment gateway” and “payment service provider” are used inconsistently across the industry. For architectural purposes, it is more useful to define the roles functionally. In this article: Gateway means primarily a technical connectivity layer that passes payment instructions between the merchant and one or more downstream payment participants. PSP means a broader provider relationship that may combine technical connectivity with merchant onboarding, payment-method access, processing, reporting, settlement or other payment services. A company can perform both roles. A merchant can also have one party providing gateway connectivity and another holding the commercial or acquiring relationship. That is why vendor-category comparisons frequently mislead architecture teams. Do not ask: “Is this company a gateway or PSP?” Ask: * Who holds the merchant agreement?
* Who has the method credentials? * Who sends the transaction downstream? * Who owns the payment state? * Who receives the funds? * Who settles the merchant? * Who executes refunds? * Who provides transaction-level reporting? * Who handles the incident? Those answers define the architecture. The label does not. Hosted checkout: a checkout decision, not an acquiring model Hosted checkout belongs on a different architectural axis. A merchant using hosted checkout delegates substantial parts of the payment user interface to a provider. The merchant may still be using a PSP, aggregator or other commercial model underneath it.
This illustrates the important distinction: Hosted checkout describes where the payment interaction is rendered. It does not by itself tell you who ultimately owns every processing or settlement relationship. Why merchants choose hosted checkout The strongest advantage is usually reduced frontend and method-specific checkout work. A provider can handle differences such as: * input fields; * method eligibility; * payment-method UI; * redirects; * logos; * method-specific instructions; * return URLs; * and parts of the customer payment flow. This can make hosted checkout especially useful when speed to market matters more than absolute control over each payment interaction. It can also reduce the surface on which sensitive card data is handled. For card environments specifically, PCI SSC distinguishes implementations where payment-page components originate from validated third-party providers and sets particular SAQ eligibility requirements for redirects and embedded payment forms. Exact PCI scope still depends on the implementation and must be assessed rather than inferred from the phrase “hosted checkout.” That compliance example should not be generalized to every non-card local method. It demonstrates a broader architectural principle: Where the payment interface originates changes what the merchant must secure and operate. What hosted checkout gives up Delegating UI may limit: * layout; * payment-method sequencing; * component behavior; * analytics granularity; * design-system consistency;
* experimentation; * accessibility implementation; * return-flow handling; * and the speed with which the merchant can exploit provider-specific features. For many merchants, those limitations are entirely acceptable. For merchants treating checkout as a core product surface, they may not be. API, SDK and redirect are not competing commercial models A common architecture diagram places these options side by side: * Direct * PSP * API * Hosted * Redirect That mixes different layers. API describes a machine interface. SDK describes packaged integration software. Redirect describes customer navigation. Hosted checkout describes who renders the payment surface. PSP describes a provider relationship. Direct describes the degree to which the merchant connects to the method or relevant participant without an intermediate merchant-level abstraction. A merchant can therefore have: * a direct API integration; * a PSP API integration; * a PSP SDK; * a PSP-hosted redirect; * a direct method redirect; * or an orchestration API that ultimately invokes several different provider integrations. W3C's Payment Request architecture demonstrates the same separation at a standards level: the API can initiate a payment request while the details of fulfilling a given payment method are handled by a payment handler. The interface through which payment is requested is not the full implementation of the underlying payment method.
This distinction prevents architecture meetings from comparing things that are not actually alternatives. Aggregation versus orchestration These terms are also used inconsistently, so merchants should define the capability they mean. For this article: Payment-method aggregation Aggregation means a provider gives the merchant access to multiple payment methods behind a common commercial and/or technical relationship. The provider is reducing the number of separate method relationships the merchant must build. The primary value is consolidation. Payment orchestration Orchestration means a layer helps the merchant control payment execution across multiple providers, processors or routes. The primary value is optionality and control across providers. An orchestration layer may abstract: * provider selection; * routing; * failover; * method availability; * shared payment states; * provider credentials; * analytics; * and integration endpoints. Aggregation and orchestration can coexist. An orchestrator can route to an aggregator. An aggregator can expose local methods from multiple downstream relationships. A merchant can also maintain direct integrations for a few strategically important methods while routing everything else through PSPs connected to an orchestration layer. The hidden price of abstraction Every abstraction creates a translation layer. A method has its native object model. A PSP converts that model into the PSP's API. An orchestrator may convert the PSP's API into another normalized model.
The merchant then maps the orchestrator's model into its own internal payment object. That can be excellent architecture if the normalized model captures everything the merchant needs. But whenever a feature does not fit the abstraction, the architecture starts leaking method- or provider-specific behavior upward. Examples might include: * a special refund state; * unusual expiry behavior; * method-specific customer instructions; * a recurring mandate; * asynchronous confirmation; * unique dispute evidence; * or a provider-only field the merchant needs for reconciliation. This gives orchestration teams a useful design rule: Normalize what is genuinely common. Preserve extensions for what is economically important and method-specific. Over-normalization can destroy useful capability. Under-normalization recreates dozens of separate integrations inside the orchestration layer. Plugin and commerce-platform integration Not every merchant controls a custom payments stack. Merchants operating on commerce platforms may gain local payment methods through: * payment apps; * plugins; * platform extensions; * platform-native payment providers; * or offsite payment integrations. Shopify's current payments-extension documentation, for example, supports payment applications that can process through platform-defined payment flows, including offsite payment experiences where customers are redirected to an app-hosted payment page.
This model can produce the fastest path to payment-method access for merchants whose storefront already lives inside that ecosystem. But the platform becomes another control boundary. The merchant's practical feature set now depends on: payment method → payment provider/application → commerce platform → merchant configuration The merchant may have less influence over: * checkout rendering; * payment-state vocabulary; * method eligibility; * extension capabilities; * upgrade schedules; * analytics; * or the migration path away from the platform. For smaller merchants, that tradeoff can be rational. For businesses building a long-lived independent payments platform, platform dependency may become strategically expensive. The Local Payment Method Integration Decision Matrix There is no universally superior integration model. The following matrix describes typical architectural tendencies, not guaranteed product capabilities. The exact method, provider, country, entity and contract must be verified. Dimension Direct method PSP API Technical gateway Hosted checkout Orchestration / multi-provider abstraction Plugin / platform Initial time to launch Usually slower Medium–fast Medium Usually fastest Slower initial platform build Fast where supported Method-specific control High Medium–high High downstream visibility possible Low–medium Configurable but abstraction-dependent Platform-dependent Feature depth Potentially highest Depends on provider coverage Depends on downstream relationship Often standardized
Depends on adapter depth Often constrained Checkout control High High with merchant-built UI High Lower High if merchant owns frontend Platform-defined Data access Potentially rich Provider-normalized Often technical/raw Provider-defined Potentially centralized Platform/provider-defined Credential control Merchant may own more credentials Often PSP-managed Can remain merchant/downstream-owned Usually provider-managed Split across orchestration/providers Platform/provider-managed Refund control Method-specific Provider API Depends on downstream Usually provider workflow/API Centralized if normalized correctly Platform/provider-defined Reporting Separate method reporting Consolidated provider reporting Often fragmented Consolidated provider view Cross-provider potential Platform-centric Settlement visibility Potentially direct but model-specific PSP-defined Depends on commercial counterparty PSP/provider-defined Must reconcile several providers Platform/provider-defined Maintenance burden High per method Lower per method Medium–high Lower High platform-level, lower marginal method cost if abstraction works Lower merchant engineering burden Provider dependency Lower PSP dependency; high method dependency High PSP dependency Dependency on gateway + downstream High hosted-provider dependency Designed to reduce single-provider dependency High platform dependency Portability Method code is merchant-owned but method-specific Migration requires provider adapter replacement Depends on downstream architecture Usually lower
Potentially high if abstraction is merchant-controlled Usually lower Total cost profile High fixed engineering/ops; potentially favorable economics at scale Provider fees + lower engineering overhead Technical + downstream commercial costs Provider fees + low frontend cost Platform cost + engineering + multiple provider costs Platform/payment-provider economics The most important row is not time to launch. It is the combination of: feature depth + maintenance + portability + provider dependency + total operating cost. Architecture lasts much longer than implementation. Control-boundary map Before selecting a model, fill in this table for the actual proposed integration. Responsibility Merchant PSP/gateway Method operator Acquirer/bank Orchestration/platform Merchant contract
Method eligibility
API credentials
Checkout UI
Customer redirect/deep link
Payment-state translation
Refund initiation
Refund processing
Dispute handling
Merchant reporting
Settlement
Reconciliation identifiers
Technical incident
Commercial escalation
If the architecture team cannot fill this out confidently, it does not yet understand the integration it is proposing. Merchant archetype 1: the international merchant entering new markets quickly This merchant needs ten locally relevant methods across several markets but has a small payments engineering team. Its strongest objective is not method-level optimization. It is getting eligible customers into working payment flows without creating ten bespoke systems. A PSP API or hosted model will often deserve investigation first. The threshold for direct integration should be high. Direct integration becomes interesting only when a method becomes commercially important enough that the PSP's missing functionality, economics, reliability or data creates measurable opportunity cost. Merchant archetype 2: the large digital merchant with a mature payments platform This merchant already has: * a payment abstraction layer; * internal payment states; * provider routing; * reconciliation systems; * payment analytics; * and a dedicated payment engineering organization. For this merchant, direct integrations can make considerably more sense. The marginal cost of another connector may be lower because much of the underlying architecture already exists. Even here, direct should not be the default. The merchant should ask: What does direct access give us that our existing providers cannot? If the answer is merely “more control,” quantify the control. Does it mean: * lower cost? * improved completion?
* faster feature access? * unique recurring capability? * better data? * lower incident rate? * faster market expansion? * provider bargaining leverage? If none can be measured, the merchant may simply be buying additional maintenance. Merchant archetype 3: the multi-PSP merchant This merchant intentionally works with several providers for: * geographic coverage; * redundancy; * specialized local methods; * commercial leverage; * or payment-performance reasons. An orchestration layer can create value because the problem is no longer simply “connect method X.” It becomes: How do we prevent every provider relationship from becoming an independent payment architecture? The orchestration layer should centralize genuinely common behavior while allowing method- and provider-specific capability where it has economic value. A poorly designed orchestration layer merely relocates complexity. A good one changes the marginal cost of adding the next provider or method. Merchant archetype 4: the platform merchant A merchant running entirely through a commerce platform may rationally choose a platform payment app or plugin even if an API integration would theoretically provide greater flexibility. The strategic constraint is different. Building a bespoke payment system outside the platform may cost more than the additional control is worth. The relevant comparison is not: plugin versus perfect custom architecture. It is: plugin versus the architecture this merchant can realistically operate.
Merchant archetype 5: the method for which one feature changes everything Sometimes a merchant can use a payment method through its existing PSP but cannot access the one capability that matters. Examples include a requirement for: * recurring collection; * partial capture; * specialized refunds; * richer transaction status; * a native mobile flow; * particular settlement; * or deeper customer/payment metadata. This is where direct integration deserves serious consideration. The merchant should calculate the value of that missing capability. If it materially changes customer access, payment completion, unit economics or operations, then the direct relationship may be justified. If it merely adds technical elegance, probably not. When is direct integration actually justified? A useful decision rule is: Direct-integration value **Incremental commercial value * avoided provider cost * strategically valuable data/capability * provider optionality** minus **build cost * ongoing engineering * payment operations * certification/security work * reconciliation complexity * incident burden * API migration cost * opportunity cost** Direct makes sense when that result remains strongly positive over the life of the integration. The mistake is comparing: direct API transaction fee with PSP transaction fee and treating the difference as savings. That ignores much of the actual cost. Measure the integration architecture itself Most payment analytics focus on customer performance.
Architecture teams should measure their own system too. Integration effort per method Engineering and technical-operations effort required from approved project start through production readiness. Do not confuse this with activation lead time controlled by underwriting or external approvals. Time to add the next method This may be the most revealing architecture metric. The first integration can be expensive in any model. The question is whether method number 12 is substantially easier than method number 2. Provider-specific code Track how much production logic depends on a particular: * provider; * method; * SDK; * payment-state model; * or callback format. Rising provider-specific code is an early sign that an abstraction layer may not be doing its job. Payment incident burden Measure: * incidents by method; * incidents by provider; * engineering hours; * payment-operations hours; * customer-support impact; * mean time to detect; * mean time to restore. A “cheap” direct integration can become expensive if it repeatedly consumes senior engineering time. Refund-support effort Track: payment/refund support contacts attributable to method ÷ completed payments using the method A method that processes successfully but generates difficult refund cases still has architecture cost. Reconciliation exception rate Transactions requiring manual reconciliation ÷ completed transactions through the integration This often reveals architecture problems that checkout conversion cannot. Total method cost Include:
* processing/provider cost; * engineering amortization; * operational support; * reconciliation; * incident handling; * refund cost; * infrastructure; * and relevant compliance/security cost. For commercial comparison, a useful denominator is: total relevant payment and operating cost ÷ completed paid orders Transaction price alone is not architecture economics. Integration is not activation A final distinction prevents significant project-planning errors. A merchant can finish code and still be unable to accept the payment method. Production access may still depend on: * KYB/KYC; * merchant underwriting; * method approval; * merchant category; * contracting; * settlement configuration; * credentials; * certification; * entity eligibility; * local bank requirements where applicable; * or production enablement. Likewise, a provider can list a method that the merchant cannot yet activate. This article concerns how the method is technically and architecturally accessed. The separate operational process of turning that integration into a live, approved payment method belongs in How to Add Local Payment Methods and Why Payment-Method Activation Takes So Long.
For an international merchant, the architectural benefit of this kind of provider model can be reducing the number of local-payment connections the merchant must maintain independently. But the same decision rules still apply. For each required method, the merchant should verify: * whether the method is available to its legal entity;
* what remains merchant-controlled; * whether checkout is hosted, embedded, redirected or API-driven; * which method-specific capabilities are exposed; * how payment states are reported; * how refunds work; * how settlement is reported; * whether recurring behavior is supported where needed; * and what portability looks like if the merchant later changes architecture. The value of a payment provider is not that architectural complexity disappears. It is that the provider can own portions of that complexity more efficiently than the merchant would own them separately. Architecture FAQ Is direct integration always better than using a PSP? No. Direct integration generally increases method-specific ownership. Whether that is better depends on whether additional capability, economics, data or control justify the build and long-term maintenance burden. Does using a PSP mean giving up control of checkout? No. A merchant can use a PSP commercially and technically while still rendering its own checkout and calling the provider through an API. Hosted checkout is a separate architectural choice. Is hosted checkout the same as using a PSP? No. Hosted checkout describes the payment presentation layer. The provider hosting it may also be a PSP or other payment intermediary, but those are separate characteristics. Is an API integration always more “direct” than a redirect?
No. Both direct method operators and PSPs can expose APIs, redirects or SDKs. API versus redirect describes how software and customers interact with the payment flow, not necessarily who owns the payment relationship. Is a gateway the same as a PSP? Not necessarily. Industry terminology varies. A technical gateway may primarily connect systems while the merchant has separate acquiring or payment-method contracts. A PSP may combine connectivity with merchant onboarding, payment access, settlement and other services. Merchants should compare actual responsibilities rather than labels. Is aggregation the same as orchestration? Not in this framework. Aggregation consolidates access to multiple payment methods. Orchestration controls execution across multiple providers or routes. A merchant can use both simultaneously. Does an orchestration layer eliminate provider-specific integration work? It can reduce it, but only if the abstraction captures the capabilities the merchant requires. Method- or provider-specific extensions are still necessary when important functionality cannot be normalized. When should a merchant build a direct local-payment integration? When the method is commercially important and direct ownership provides measurable functionality, economics, data, performance, reliability or strategic optionality that materially exceeds its lifecycle cost. Final recommendation Do not choose a local payment integration architecture by asking which option offers the most control.
Control has a cost. Choose it by asking: Which capabilities does the merchant need to own? If method-specific functionality differentiates the business, direct integration can be rational. If the method is important but technically ordinary for the merchant, a PSP API can preserve substantial checkout control while avoiding a separate method integration. If speed and operational simplicity dominate, hosted checkout may be the better architecture. If the merchant operates across providers and markets at sufficient scale, orchestration may reduce the marginal cost of that complexity. And if the business already lives inside a commerce platform, a platform-native integration can be strategically superior to a technically purer architecture that the merchant does not need to own. The customer may see the same local payment method in every case. What changes is everything underneath it: Who contracts. Who connects. Who renders. Who holds credentials. Who translates payment state. Who refunds. Who reports. Who settles. Who fixes it at 3 a.m. And who has to replace it when the architecture changes. That is the integration decision. Direct integration is not the most powerful architecture by default. The most powerful architecture is the one that preserves the control the merchant genuinely needs while delegating the complexity that does not differentiate the business.
This article provides general information and does not constitute legal, regulatory, tax, financial, security, or compliance advice. Merchants should verify applicable requirements with qualified advisers and the relevant payment providers, payment-method operators, acquirers, banks, platforms and authorities.
I’ve treated the uploaded brief as the controlling document. This piece owns the technical access-model decision: once a merchant has decided that a local method matters, what should it own itself, what should it delegate, and what architectural dependencies does each choice create? The strongest editorial idea is that “direct,” “PSP,” “hosted,” “API,” “redirect,” and “orchestrated” do not all describe the same layer of the stack. A merchant can, for example, use a PSP commercially while still controlling its own checkout through an API; or use a hosted checkout while the provider also acts as the commercial counterparty. That separation should make this article more technically useful than a standard pros-and-cons comparison. Editorial interpretation Field Decision Customer-access problem The merchant has identified a payment method customers need, but that method still cannot be used until the merchant chooses a viable technical and commercial path to production. Payment-method decision owned Whether to access a local method directly, through a PSP/gateway, through hosted checkout, through an aggregation/orchestration layer, or through a platform/plugin model. Customer who cannot adequately pay A target customer whose relevant local method has been selected strategically but is not actually available through the merchant's production architecture. Capability that changes this
A production integration that connects the checkout, payment state, commercial relationship, refunds, reporting and settlement processes to the method. Unique evidence anchor The same payment method can sit behind different merchant relationships. Current iDEAL | Wero documentation, for example, distinguishes technical PSPs—where the merchant still has an acquirer agreement—from collecting PSPs that provide connectivity and become the merchant's method contract counterparty. Editorial position Direct integration is justified only when the incremental control, economics, data or feature access is worth owning the method-specific lifecycle for years. Assumption challenged “Direct integration is always the most powerful architecture.” Most important distinction Technical connectivity ≠ commercial relationship ≠ checkout presentation ≠ acquiring/settlement. Format Architecture comparison + decision matrix. Merchant decision Decide which control boundaries must remain merchant-owned and delegate everything else unless direct ownership creates durable incremental value. Structural rationale Rather than present four integration types as mutually exclusive boxes, the article first separates the architecture into layers: Commercial access — who contracts and settles Connectivity — whose API/infrastructure reaches the method Checkout surface — merchant UI, SDK, hosted page, redirect or platform checkout Payment-state ownership — who normalizes confirmation, failure and asynchronous events
Operations — refunds, reconciliation, reporting and incidents That makes several otherwise confusing distinctions much easier to explain. Proposed architecture 1. Same payment method, different merchant architectures 2. The five layers merchants are actually choosing 3. Direct integration 4. PSP and gateway access 5. Hosted checkout 6. API, SDK and redirect are interaction patterns—not provider models 7. Aggregation versus orchestration 8. Plugin and commerce-platform access 9. Control and dependency tradeoffs 10. Local Payment Method Integration Decision Matrix 11. Merchant archetypes 12. When direct integration is justified 13. Measuring architecture, not just launch speed 14. Final recommendation Original practical asset The primary asset should be the Local Payment Method Integration Decision Matrix in the article. For a more visual version, I would pair it with a second, simpler architecture diagram: CUSTOMER CHECKOUT ↓ Presentation layer Merchant UI | Provider SDK | Hosted page | Platform checkout ↓ Merchant payment layer Merchant API | PSP API | Gateway | Orchestration ↓ Commercial/access layer Direct contract | Acquirer | Collecting PSP | Aggregator ↓ Payment method / operator ↓ Underlying payment infrastructure ↓ Settlement / reconciliation Across the side, show five control questions: Who contracts? → Who holds credentials? → Who owns payment state? → Who refunds? → Who settles?
The visual makes the article's most important idea immediately obvious: “Hosted,” “API,” “PSP,” and “direct” describe different layers and can coexist. Suggested image alt text: “Local payment method integration architecture comparing merchant checkout, hosted payment pages, PSP APIs, gateways, orchestration, payment operators and settlement relationships.” SEO package Element Recommendation SEO title Local Payment Method Integration Options: Direct vs PSP vs Hosted H1 Local Payment Method Integration Options: Direct, PSP, Hosted, or Orchestrated? Meta description Compare direct, PSP, gateway, hosted checkout, orchestration and platform integrations for local payment methods, including control, data, maintenance and portability. URL slug /local-payment-methods/integration-options Primary keyword local payment method integration options Secondary keywords integrate local payment methods; direct payment method integration; PSP local payment methods; hosted checkout payment methods; payment method API integration; payment orchestration local methods; payment gateway local methods; APM integration options Related entities PSP, payment gateway, acquiring, hosted checkout, payment API, SDK, redirect, payment orchestration, payment aggregation, merchant credentials, settlement Article excerpt
Two merchants can accept the same local payment method while owning completely different contracts, checkout systems, payment states and operational responsibilities. The right integration model depends on how much method-specific capability the merchant genuinely needs to own. Suggested structured data Article, BreadcrumbList; FAQPage only if the FAQ remains visible and current search-engine requirements support its use Primary merchant metric Lifecycle integration cost per useful production method Secondary architecture metric Time and engineering effort required to add the next payment method Internal links Use How to Add Local Payment Methods when moving from architecture choice into the end-to-end launch process. Use International Payment Architecture for deeper discussion of provider abstraction, internal payment models, global reporting and long-term architecture. Use Global PSP vs Regional PSP when the choice is not merely direct versus provider but which type of provider supplies the strongest local method access. Use Multi-PSP Strategy from the orchestration section for routing, redundancy and provider diversification. I would also link Why Payment-Method Activation Takes So Long from the “integration is not activation” section. That prevents this article from duplicating underwriting, KYB and approval content. Authoritative source recommendations
The evidence stack is unusually strong because the architecture can be demonstrated using first-party technical sources rather than competitor commentary. iDEAL | Wero / Currence is the strongest source for proving that technical connectivity, commercial counterparty and settlement model can differ even for the same customer-facing payment method. Its documentation explicitly distinguishes technical PSP and collecting PSP models. Apple Developer documentation is useful only for the narrow architectural distinction between technical integration responsibilities and downstream payment processing: Apple explicitly documents that Apple Pay payment-data decryption can be handled either by the merchant or by its PSP. W3C Payment Request / Payment Handler specifications provide a neutral technical reference showing why a payment invocation API and the implementation that fulfills the payment are distinct layers. PCI Security Standards Council should support only the specific card-security discussion around hosted/embedded payment pages. It should not be generalized into a claim that hosted local-payment methods automatically reduce all security or compliance obligations. Shopify developer documentation is a useful first-party platform example showing how payments extensions can expose platform-defined and offsite payment experiences.
Human contribution
Recommended reviewers: * Senior payment engineer * Payment architecture lead * Payment product manager * Payment operations/reconciliation specialist
That would give the article genuine practitioner authority without requiring promotional claims. Publication fact-check matrix Integration-model facts Before using any branded method as an example, verify the actual contractual and technical route. Do not infer that a direct API means a direct merchant contract, that a PSP controls settlement, or that a gateway does not touch funds. Country-specific facts This article does not require country rankings. If editors add country examples, verify the relevant method's current merchant access model in that jurisdiction. Customer-access facts The integration model itself does not prove customer demand. The method should already have passed the selection case covered elsewhere in the cluster. Conversion/incrementality facts Do not claim direct, hosted, PSP or orchestrated integrations inherently convert better. Checkout implementation, device flow and method availability can affect completion, but architecture must be measured on comparable customer cohorts before making causal claims. Technical integration facts For every method/provider combination verify: * API version * required SDK * redirect/app-switch behavior * payment-state model * webhook/callback model * idempotency requirements * credentials/certificates * refund APIs * status-query capabilities * sandbox behavior * deprecations and migration requirements Activation facts Keep technical integration separate from: * KYB/KYC * underwriting * method approval * commercial contracting * entity eligibility
* production credentials * certification * settlement configuration * go-live approval Refund and recurring facts Never infer these from the integration model. A PSP API may expose a capability that another PSP does not. Direct access may expose functionality unavailable through an aggregator. Verify the exact method, provider, country and merchant contract. Regulatory/security facts Do not describe “direct” as automatically less compliant or “hosted” as automatically compliant. The merchant's responsibilities depend on the payment mechanism, data flows, jurisdiction, provider role and implementation. Amber-flag claims The following should require additional evidence if editors want to introduce them: * Direct integrations always cost less at scale. * PSP integrations launch faster in every case. * Hosted checkout lowers conversion. * API checkout converts better than redirects. * Orchestration improves authorization or completion rates. * Direct connections expose all method functionality. * PSPs always control settlement. * Gateways never handle funds. * Orchestration removes vendor lock-in. * One API means one commercial contract. * Hosted checkout removes PCI responsibility.
* Direct integration guarantees better data. Each can be true in a particular architecture. None should become a universal claim.
2. Whether the Widget API and Checkout API terminology in public documentation matches current commercial/product naming. 3. Which local methods can be deep-linked or displayed individually. 4. Which methods require method-specific merchant approval. 5. Which payment states are normalized across methods. 6. Which capabilities remain method specific. 7. Current refund handling. 8. Current recurring support by method. 9. Current reporting and reconciliation capabilities. 10. Settlement visibility and payout structure.
13. Current integration migration/versioning policy.
Provider/method verification record For every architecture evaluated, create one row containing: Method → market → merchant entity → commercial counterparty → technical connector → checkout owner → credentials owner → payment-state owner → refund interface → dispute owner → reporting source → settlement party → recurring capability → production approval owner → incident escalation path → last verified date That record is arguably more useful to an architecture team than a generic vendor comparison. Cluster sameness-audit fields Field This article Title Local Payment Method Integration Options: Direct, PSP, Hosted, or Orchestrated? First-two-sentence device Three merchants expose the same method but own different systems Opening device Customer-facing sameness versus merchant architectural difference Customer-access problem Relevant method identified but not yet reachable through production architecture Primary method/category Integration models Primary market Global Primary industry Advanced multi-market merchants Primary format Architecture comparison + decision matrix Evidence anchor Same payment method can have different technical, contractual and settlement relationships Editorial position Direct ownership must earn its lifecycle cost Merchant decision Decide which control boundaries deserve merchant ownership Original framework Local Payment Method Integration Decision Matrix + control-boundary map Primary metric Lifecycle integration cost / time to add next method Conclusion
Preserve differentiating control; delegate non-differentiating complexity CTA direction Map responsibilities before choosing the integration model FAQ Architecture-decision terminology Distinctive visual Layered customer → checkout → integration → commercial access → method → settlement map This should be strongly differentiated from How to Add Local Payment Methods: that article owns the launch process. It also avoids taking over Why Payment-Method Activation Takes So Long, because KYB, underwriting and approvals appear only to establish the critical boundary that integration and activation are different workstreams.
Not sure which payment solution fits?
Use the merchant matching prototype to understand the types of providers to evaluate.
Explore matching ↗