企业官网建设流程全解析

Dujiao-Next 是一款开源数字商品电商平台，内置多支付渠道配置能力。本教程带你从零完成支付宝、微信支付、Stripe、PayPal 及 USDT 等加密渠道的完整设置，覆盖参数填写、回调地址、手续费与金额限制等关键配置项，让新手也能快速开通收款。

一、Dujiao-Next 支持的支付渠道一览

Dujiao-Next 的支付模块采用统一网关适配器架构（源码位于 internal/modules/payment/），每个渠道都是一个独立适配器，按「提供方 + 渠道类型」路由。目前已内置的渠道如下：

网关注册逻辑集中在 internal/app/container/bootstrap.go，渠道常量定义在 internal/constants/constants.go。

💡选型建议：国内用户为主选支付宝/微信；出海站点优先 Stripe + PayPal；面向海外或加密货币用户则配置 BEpusdt、EPusdt 等 USDT 渠道。

二、进入后台：找到支付渠道管理入口

登录 Dujiao-Next 管理后台后，在「支付渠道」页面集中管理所有渠道。对应前端页面为 PaymentChannels.vue，新建/编辑弹窗为 PaymentChannelModal.vue。

点击「新增渠道」后，表单分为两大部分：

1. 基础信息：渠道名称、图标、提供方类型、渠道类型、交互方式
2. 渠道参数：根据所选提供方自动切换为对应的参数表单（支付宝表单、微信表单、Stripe 表单等），无需手写 JSON

三、通用参数详解：手续费、金额限制与可用人群

所有渠道共享一组通用设置，建议创建渠道时一并规划好：

• 手续费比例fee_rate/固定手续费fixed_fee：透传支付渠道成本，用于内部结算
• 最小/最大金额min_amount/max_amount：0表示不限
• 超出区间隐藏hide_amount_out_range：开启后，订单金额不在 [min, max] 内时该渠道自动不展示
• 付款类型payment_types：order（商品订单）或wallet（钱包充值）
• 付款角色payment_roles：guest（游客）或member（会员）
• 会员等级member_levels：限制仅指定等级会员可见
• 排序sort_order/启用开关is_active：控制收银台展示顺序与启停

这些字段定义在渠道领域模型 channel.go，保存前会经过 admin_channel_handler.go 的完整性校验。

⚠️重要：所有敏感参数（私钥、API Secret 等）保存后在列表和详情中以••••••••掩码显示，防止明文泄露。掩码规则见 admin_channel_handler.go。

四、支付宝渠道设置（官方直连）

选择提供方official+ 渠道alipay，交互方式支持qr（扫码）、wap（手机网站）、page（电脑网站）三种模式。

需填写的核心参数：

📌notify_url必须是可被支付宝服务器访问的公网 HTTPS 地址，且域名要与商城实际部署域名一致，否则回调会失败。

五、微信支付渠道设置

选择提供方official+ 渠道wechat，支持qr（扫码）与redirect（H5 跳转）两种交互方式。

核心参数：

💡 后台内置了公钥验证测试按钮，可在保存前直接校验微信支付公钥配置是否正确，避免上线后才发现验签失败。该诊断能力由 GatewaySecurityTester 接口提供，测试结果只包含可公开的校验事实，不回传私钥或请求体。

六、Stripe 与 PayPal 国际支付配置

Stripe（信用卡）：交互方式固定为redirect。核心参数为secret_key、publishable_key、webhook_secret、success_url、cancel_url，以及payment_method_types（默认card，可追加link等）。

PayPal：交互方式固定为redirect。核心参数为client_id、client_secret、base_url（沙箱默认https://api-m.sandbox.paypal.com，上线后改为生产地址）、return_url、cancel_url、webhook_id。

🌍 出海站点建议：先以 PayPal 沙箱base_url联调，再切换生产地址；Stripe 务必在 Dashboard 中配置 Webhook 事件payment_intent.succeeded并回填webhook_secret。

七、USDT 加密货币渠道配置

Dujiao-Next 对加密货币收款做了深度支持，主流方案为BEpusdt与EPusdt：

BEpusdt（推荐）：选择提供方bepusdt，渠道类型可选usdt-trc20（USDT-TRC20）、usdc-trc20、trx。参数包括gateway_url、auth_token、order_mode（transaction交易模式 /cashier收银台模式）、trade_type（默认usdt.trc20）、fiat（法币，默认CNY）。

EPusdt：参数包括gateway_url、pid（商户号）、secret_key、token（默认usdt）、network（默认tron）、currency（默认cny）。

其他可选加密渠道：

• OkPay：merchant_id+merchant_token+ 回调地址，支持 USDT / TRX
• DujiaoPay：api_key_id+api_secret+webhook_secret，token_id由管理员手动填写（如tron-usdt），上游新增链或代币无需改代码
• TokenPay：gateway_url+notify_secret，默认币种USDT

⚠️ 加密货币渠道的回调地址必须可被公链支付服务商访问；使用云服务器托管时，请先确认防火墙已放行 443 端口。

八、回调地址与验签：支付成功的关键

所有渠道的异步回调统一由 internal/modules/payment/transport/http/callback/ 下的回调处理器接收，标准回调路径形如：

https://api.你的域名.com/api/v1/payments/callback

回调处理流程：网关适配器验签 → 解析订单号与金额 → 幂等更新支付状态 → 驱动订单流转。验签逻辑由各适配器实现（如微信适配器见 wechatpay.go，Stripe 适配器见 stripe.go）。

新手常见坑位：

1. 回调地址用了内网地址—— 支付服务商无法回传，订单永远停在"待支付"
2. notify_url与return_url混淆—— 前者给服务器，后者给用户浏览器
3. 忘记配置 Webhook Secret（Stripe / DujiaoPay）—— 回调无法验签被拒绝
4. 金额限制卡单—— 订单金额低于min_amount且未开启"超出区间隐藏"，用户看不到该渠道

九、上线前检查清单 ✅

配置完成后，按以下清单逐项确认：

• 所有notify_url为公网可访问的 HTTPS 地址
• 敏感参数已保存且列表显示为掩码
• 手续费与金额区间符合实际成本
• payment_types已按业务勾选（订单 / 钱包充值）
• 交互方式与终端匹配（PC 站选qr/page，H5 选wap/redirect）
• 沙箱渠道（如 PayPal sandbox）联调通过后切换生产地址
• 渠道按sort_order排序，收银台展示符合预期

🎉 完成以上配置后，用户在收银台即可看到你启用的全部支付方式，支付成功后系统会自动更新订单状态并发出通知。

总结

Dujiao-Next 通过统一的支付网关适配器架构，让支付宝、微信、Stripe、PayPal、USDT 等十余种渠道共用一套配置界面与回调机制，无需二次开发即可按需组合。本文覆盖的渠道参数、通用限制项与回调排坑要点，配合管理后台的可视化表单，足以支撑国内、出海与加密货币三类站点的收款需求。

延伸阅读：渠道领域模型 channel.go、网关契约 gateway.go、后台渠道表单 PaymentChannelModal.vue。