# ============================================================================ # 全球支付模块标准配置模板 (Universal Payment Config Template) v4.0 # ============================================================================ # 适用于: Python, Node.js, Go, Java, PHP 等任意后端语言 # 使用方法: 将此配置映射到你项目的环境变量 (.env, config.py, application.yml) # ============================================================================ # ---------------------------------------------------------------------------- # 1. 基础环境 (Environment) # ---------------------------------------------------------------------------- APP_ENV: "production" # development / staging / production APP_NAME: "MyApp" # 应用名称 (用于日志/标题) APP_URL: "https://your-site.com" # 你的网站域名 (用于回调地址生成) APP_CURRENCY: "CNY" # 默认货币: CNY, USD, EUR # ---------------------------------------------------------------------------- # 2. 数据库 (Database) - 存储订单和交易流水 # ---------------------------------------------------------------------------- DB_CONNECTION: "mysql" # mysql / postgres / mongodb / sqlite DB_HOST: "127.0.0.1" DB_PORT: "3306" DB_DATABASE: "payment_db" DB_USERNAME: "root" DB_PASSWORD: "your_password" # 自动创建的表: # - orders (订单表) # - pay_trades (交易流水表) # - cashflows (资金流水表) # ---------------------------------------------------------------------------- # 3. 支付宝 (Alipay) - 中国市场 # ---------------------------------------------------------------------------- ALIPAY_ENABLED: true ALIPAY_MODE: "production" # sandbox / production ALIPAY_APP_ID: "" # 开放平台应用 AppID ALIPAY_PID: "" # 商户 PID (合作伙伴ID) ALIPAY_SELLER_EMAIL: "" # 收款支付宝账号 ALIPAY_PRIVATE_KEY: "" # 商户私钥 (RSA2) ALIPAY_PUBLIC_KEY: "" # 支付宝公钥 ALIPAY_MD5_KEY: "" # MD5 密钥 (旧版接口) # 回调地址 (系统自动拼接 APP_URL) # 同步回调: ${APP_URL}/api/payment/return/alipay # 异步回调: ${APP_URL}/api/payment/notify/alipay # ---------------------------------------------------------------------------- # 4. 微信支付 (Wechat Pay) - 中国市场 # ---------------------------------------------------------------------------- WECHAT_ENABLED: true WECHAT_MODE: "production" # sandbox / production # 公众号/网站支付 WECHAT_APPID: "" # 公众号/网站 AppID WECHAT_APP_SECRET: "" # AppSecret # 服务号 (如果有独立服务号) WECHAT_SERVICE_APPID: "" # 服务号 AppID WECHAT_SERVICE_SECRET: "" # 服务号 AppSecret # 商户信息 WECHAT_MCH_ID: "" # 商户号 WECHAT_MCH_KEY: "" # 商户平台 API 密钥 (32位) WECHAT_MCH_KEY_V3: "" # APIv3 密钥 (如使用v3接口) # 证书路径 (相对于项目根目录) WECHAT_CERT_PATH: "./cert/wechat/apiclient_cert.pem" WECHAT_KEY_PATH: "./cert/wechat/apiclient_key.pem" WECHAT_CERT_SERIAL: "" # 证书序列号 (v3接口需要) # 小程序 (如果有) WECHAT_MINI_APPID: "" # 小程序 AppID WECHAT_MINI_SECRET: "" # 小程序 AppSecret # 回调地址 # 异步回调: ${APP_URL}/api/payment/notify/wechat # ---------------------------------------------------------------------------- # 5. PayPal - 全球市场 # ---------------------------------------------------------------------------- PAYPAL_ENABLED: true PAYPAL_MODE: "live" # sandbox / live PAYPAL_CLIENT_ID: "" # Client ID PAYPAL_CLIENT_SECRET: "" # Client Secret PAYPAL_WEBHOOK_ID: "" # Webhook ID (用于验证回调) # 回调地址: ${APP_URL}/api/payment/notify/paypal # ---------------------------------------------------------------------------- # 6. Stripe - 全球市场 # ---------------------------------------------------------------------------- STRIPE_ENABLED: true STRIPE_MODE: "live" # test / live STRIPE_PUBLIC_KEY: "" # pk_live_xxx 或 pk_test_xxx STRIPE_SECRET_KEY: "" # sk_live_xxx 或 sk_test_xxx STRIPE_WEBHOOK_SECRET: "" # whsec_xxx # 回调地址: ${APP_URL}/api/payment/notify/stripe # ---------------------------------------------------------------------------- # 7. USDT (加密货币) - Web3 / 抗审查支付 # ---------------------------------------------------------------------------- USDT_ENABLED: false USDT_GATEWAY_TYPE: "nowpayments" # nowpayments / native # 选项 A: NOWPayments (第三方托管) NOWPAYMENTS_API_KEY: "" NOWPAYMENTS_IPN_SECRET: "" # 选项 B: Native (原生 TRC20 监听) TRON_NODE_API: "https://api.trongrid.io" TRON_WALLET_ADDRESS: "" # 你的 USDT-TRC20 收款地址 TRON_API_KEY: "" # TronGrid API Key TRON_CHECK_INTERVAL: 60 # 轮询间隔 (秒) # ---------------------------------------------------------------------------- # 8. 高级配置 (Advanced) # ---------------------------------------------------------------------------- # 虚拟币/积分系统 COIN_ENABLED: false # 是否启用虚拟币抵扣 COIN_RATE: 100 # 1元 = 100虚拟币 # 订单配置 ORDER_EXPIRE_MINUTES: 30 # 订单过期时间 (分钟) TRADE_SN_PREFIX: "T" # 交易流水号前缀 # 日志配置 PAYMENT_LOG_LEVEL: "info" # debug / info / warning / error PAYMENT_LOG_PATH: "./logs/payment.log" # 安全配置 PAYMENT_IP_WHITELIST: "" # 回调IP白名单 (逗号分隔) PAYMENT_SIGN_TYPE: "RSA2" # 签名类型: RSA2, MD5