Skip to content

Payment channel integration

Payment channel integration refers to the architectural and operational process of connecting an aggregate payment system (聚合支付系统) to specific upstream providers.^[600-developer-principle-aggregate-payment-system.md] It involves consolidating various payment methods—such as Alipay, WeChat Pay, and credit cards—into a single unified interface to streamline transaction processing for merchants.

Core Components

Aggregate payment system

The central component of this integration is the Aggregate payment system, which acts as an intermediary layer.^[600-developer-principle-aggregate-payment-system.md] Its primary functions include: * Unified Interface: Providing a single API or dashboard for merchants to manage different payment sources. * Routing: Directing payment requests to the correct underlying channel (e.g., a specific bank or digital wallet). * Consolidation: Merging transaction data and settlement reports from multiple channels into one cohesive view.

Payment Channels

Integration typically involves connecting to multiple downstream entities.^[600-developer-principle-aggregate-payment-system.md] Common channels include: * Third-party Wallets: Platforms like Alipay and WeChat Pay. * Bank Gateways: Direct connections to banking networks for card processing. * Alternative Methods: "Zero-manual" callback systems or specific merchant supplier mechanisms, such as those provided for WeChat's small and micro merchants.^[600-developer-principle-aggregate-payment-system.md]

Implementation and Architecture

Domain Modeling

Effective integration requires a robust domain model to handle the complexity of different protocols.^[600-developer-principle-aggregate-payment-system.md] Developers must define clear entities for orders, payments, and refunds to ensure that the system can accurately map internal states to the external requirements of each payment channel.

Microservices architecture

The implementation often leverages microservices to decouple the core payment logic from the specific integration details of each channel.^[600-developer-principle-aggregate-payment-system.md] This architectural style allows for: * Scalability: Handling high volumes of transactions without bottlenecks. * Flexibility: Easily adding or removing support for a specific payment channel without disrupting the entire system.

Development Resources

Several open-source projects and frameworks exist to facilitate the development and understanding of these systems.^[600-developer-principle-aggregate-payment-system.md] Notable examples include: * xxpay: An open-source project providing the source code for an Aggregate payment system.^[600-developer-principle-aggregate-payment-system.md] * Tpay: A system designed for automatic payment callbacks, utilizing tools like Xposed frameworks to intercept and relay payment confirmations.^[600-developer-principle-aggregate-payment-system.md] * Xpay & Youpay: Alternative projects demonstrating different approaches to payment aggregation and automated callbacks.^[600-developer-principle-aggregate-payment-system.md]

Sources

^[600-developer-principle-aggregate-payment-system.md]