Velstore支付网关设计深度解析动态配置下集成PayPal与Stripe的完整方案【免费下载链接】velstoreFree and open-source multi-vendor Laravel eCommerce solution that is fully customizable and ready to use.项目地址: https://gitcode.com/gh_mirrors/ve/velstoreVelstore 是一款免费开源、可完全定制的多商户 Laravel 电商平台其支付网关Payment Gateway设计最大的亮点在于PayPal 与 Stripe 的密钥、沙箱/生产环境切换、启用状态全部由数据库动态驱动无需改代码即可在后台管理面板完成配置。本文将从架构到落地带你完整看懂这套动态支付配置方案。为什么要把支付配置放进数据库传统 Laravel 项目的支付密钥通常写在.env文件里每换一个环境都要改代码、重新部署。Velstore 反其道而行后台即配置中心管理员在管理面板直接填写网关密钥并保存立即生效环境隔离同一套密钥支持sandbox沙箱和live生产双环境切换环境不切换代码安全存储敏感密钥在入库前自动加密开放扩展新增一个支付渠道只需增加一个服务类 一行映射无需改动核心逻辑这套思路让 Velstore 的支付模块对新手非常友好也便于运维管理。数据层设计两张表撑起整个支付配置体系整个网关体系的骨架由两张数据表构成对应迁移文件位于database/migrations/2025_09_01_041746_create_payment_gateways_table.php和database/migrations/2025_09_01_041758_create_payment_gateway_configs_table.phppayment_gateways 网关注册表记录每个支付渠道的身份name显示名称、code唯一标识如paypal、stripe、is_active启用开关。可以理解为一张支付方式清单。payment_gateway_configs 配置中心真正存放密钥的表核心字段字段说明key_name配置项名称如client_id、secret_keykey_value配置值支持加密存储is_encrypted是否加密密钥类字段建议开启environment所属环境sandbox或live对应模型PaymentGateway和PaymentGatewayConfig分别位于app/Models/PaymentGateway.php与app/Models/PaymentGatewayConfig.php。PaymentManager动态工厂的巧妙设计核心调度类位于app/Services/PaymentGateway/PaymentManager.php它是整个支付体系的总入口根据网关code在数据库中查找记录并校验is_active状态——被禁用的网关直接抛出异常从源头拦截无效调用通过一张映射表将code翻译成对应的服务类paypal→ PayPalServicestripe→ StripeService携带环境参数实例化服务并返回前台发起 Stripe 支付时只需一行代码即可动态获取服务实例随后创建支付意图并返回前端所需的公钥与clientSecret见app/Http/Controllers/Store/PaymentGateway/StripeController.php对应路由routes/store.php中的stripe.checkout.process。这种工厂模式让调用方完全不知道背后是哪个具体网关为后续扩展埋下伏笔。Stripe 集成从数据库密钥到支付意图Stripe 服务类位于app/Services/PaymentGateway/StripeService.php工作流程非常简洁构造时从数据库取出该网关的secret和public配置按环境区分用密钥初始化官方StripeClient密钥缺失时立即抛出明确异常createPaymentIntent()创建支付意图getPublicKey()向前端暴露公钥供 JavaScript 侧发起扣款这种后端建意图、前端收密钥的分工正是 Stripe 推荐的 Payment Intents 标准流程。PayPal 集成OAuth 令牌与下单-收款两段式流程PayPal 服务类位于app/Services/PaymentGateway/PayPalService.php未依赖任何第三方 SDK而是直接用 Laravel HTTP 客户端调用 REST API依赖更轻动态环境寻址根据环境自动切换 API 地址——沙箱走api-m.sandbox.paypal.com生产走api-m.paypal.com令牌获取getAccessToken()用client_id/secret以 Basic Auth 换取 OAuth 访问令牌创建订单createOrder()以CAPTURE意图创建订单并自动回填paypal.success与paypal.cancel两个回调路由定义在routes/web.php完成收款captureOrder()在用户支付完成后对订单执行捕获密钥安全入库即加密PaymentGatewayConfig模型通过 Eloquent 修改器实现了透明加密当is_encrypted为真且值非空时写入数据库前自动调用 Laravel 的Crypt::encryptString()加密。数据库里看到的是一串密文应用读取时再自动还原全程对业务代码无感。种子数据database/seeders/PaymentGatewaySeeder.php默认写入沙箱占位密钥PaymentGatewayConfigSeeder.php还支持从.env读取真实密钥回填兼顾了开箱即用与生产安全。payments 表交易状态的全生命周期追踪迁移文件database/migrations/2025_09_01_043405_create_payments_table.php定义了交易流水表与订单、用户、网关三表关联并包含状态机pending→processing→completed/failed/refunded五种状态transaction_id记录第三方平台的交易号便于对账response / meta 两个 JSON 字段完整保存网关原始响应与附加上下文出问题时可直接回溯无需翻日志如何扩展第三个支付网关得益于动态工厂设计接入新渠道源码中已预留 Razorpay 注释位只需三步在app/Services/PaymentGateway/下新建服务类在PaymentManager的映射表中加一行注册在数据库的payment_gateways中新增一条记录并在后台填入密钥零侵入核心代码这是这套动态配置设计最实用的回报。小结Velstore 的支付网关用两张配置表 一个工厂 一组服务类的组合实现了密钥后台化、环境双轨化、扩展插件化。对刚接触 Laravel 支付开发的新手而言这套 PayPal 与 Stripe 的集成方案既是一套可运行的生产级实现也是一份结构清晰的架构学习范本。【免费下载链接】velstoreFree and open-source multi-vendor Laravel eCommerce solution that is fully customizable and ready to use.项目地址: https://gitcode.com/gh_mirrors/ve/velstore创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考