payment-gateway-setup

name	payment-gateway-setup
description	支付网关配置向导 - Stripe、PayPal、Shopify Payments等支付网关的配置指南
version	1.0.0
author	Shopilot
argument-hint	<gateway> <region> [currency]
disable-model-invocation	false
user-invocable	true

Payment Gateway Setup 💳

快速配置电商支付网关

专业的支付网关配置工具，提供Stripe、PayPal、Shopify Payments等主流支付平台的详细配置指南，支持多币种和防欺诈设置。

---

🎯 支持的支付网关

1. Stripe

优势:
✅ 开发者友好
✅ 费率透明
✅ 功能强大
✅ 全球支持
✅ 实时分析

适用:
├─ 国际市场
├─ 订阅业务
├─ 市场平台
└─ 复杂业务

2. PayPal

优势:
✅ 用户信任度高
✅ 全球普及
✅ 买家保护
✅ 快速结账
✅ 防欺诈

适用:
├─ 消费品零售
├─ 跨境电商
├─ 中小商家
└─ B2C业务

3. Shopify Payments

优势:
✅ 无缝集成
✅ 统一管理
✅ 自动对账
✅ 多币种
✅ 本地化

适用:
├─ Shopify商家
├─ 快速上线
├─ 简化运营
└─ 统一管理

4. 其他网关

区域网关:
├─ 支付宝 (中国)
├─ 微信支付 (中国)
├─ Adyen (全球)
├─ Braintree (全球)
└─ Klarna (欧洲)

---

📋 配置流程

Step 1: 账户设置

注册流程:
├─ 创建商户账户
├─ 完成身份验证
├─ 绑定银行账户
└─ 配置基本信息

Step 2: API集成

集成方式:
├─ 无代码/低代码
├─ 插件/扩展
├─ API集成
└─ SDK集成

Step 3: 支付配置

支付设置:
├─ 支付方式
├─ 币种设置
├─ 结账流程
└─ 回调配置

Step 4: 安全配置

安全措施:
├─ SSL证书
├─ 3D Secure
├─ PCI DSS
├─ 数据加密
└─ 风控规则

Step 5: 测试上线

测试验证:
├─ 沙盒测试
├─ 支付流程
├─ 退款测试
└─ Webhook测试

---

🔧 配置详解

Stripe 配置

1. 基础设置

账户设置:
  - 商户类型: Individual/Business
  - 业务类型: 电商/SaaS/市场
  - 结算周期: 2-7天
  - 保留期: 0-7天

费用结构:
  - 国内卡: 2.9% + ¥0.30
  - 国际卡: 3.9% + ¥0.30
  - 货币转换: 1%

2. API密钥

测试密钥:
├─ Publishable Key (pk_test_...)
└─ Secret Key (sk_test_...)

生产密钥:
├─ Publishable Key (pk_live_...)
└─ Secret Key (sk_live_...)

安全提示:
⚠️ 永远不要泄露Secret Key
⚠️ 使用环境变量存储
⚠️ 限制API密钥权限
⚠️ 定期轮换密钥

3. Webhook配置

事件类型:
  - payment_intent.succeeded
  - payment_intent.failed
  - charge.refunded
  - charge.dispute.created

端点配置:
  - URL: https://your-domain.com/webhooks/stripe
  - 验证: 使用签名验证
  - 重试: 配置重试策略
  - 超时: 设置合理超时

4. 防欺诈设置

Radar功能:
  - 欺诈评分: 自动评估
  - 规则引擎: 自定义规则
  - 3D Secure: 认证验证
  - 黑名单: 阻止风险用户

建议配置:
  - 低风险: 自动放行
  - 中风险: 3D验证
  - 高风险: 自动拒绝

PayPal 配置

1. 账户设置

账户类型:
  - Personal: 个人
  - Business: 商业 (推荐)
  - Enterprise: 企业

业务账户功能:
  ✅ 接受信用卡
  ✅ 自定义结账
  ✅ 批量操作
  ✅ 详细报告

2. API凭证

沙盒凭证:
├─ Client ID
└─ Secret

生产凭证:
├─ Client ID
└─ Secret

获取方式:
1. 登录 PayPal Developer
2. 创建应用
3. 生成凭证
4. 配置权限

3. 支付方式

PayPal按钮:
  - 标准结账
  - 快速结账
  - 订阅按钮
  - 捐赠按钮

其他方式:
  - PayPal Credit
  - Venmo (美国)
  - Pay in 4 (分期)
  - PayPal 卡

4. 防欺诈

FraudNet:
  - 实时监控
  - 机器学习
  - 风险评分
  - 自定义规则

Seller Protection:
  - 符合条件
  - 商品配送
  - 签名确认
  - 地址验证

Shopify Payments 配置

1. 激活设置

启用条件:
  ✅ Shopify店铺
  ✅ 支持的国家/地区
  ✅ 符合资格
  ✅ 完成验证

激活步骤:
  1. 设置 -> 支付
  2. 添加 Shopify Payments
  3. 完成信息填写
  4. 等待审核
  5. 开始收款

2. 币种设置

多币种:
  - 启用多币种
  - 设置汇率
  - 自动转换
  - 本地化支付

支持币种:
  - USD, EUR, GBP
  - CAD, AUD, JPY
  - CNY, HKD, SGD
  - 其他100+币种

3. 结账配置

结账流程:
  - 加速结账
  - 宾至如归
  - 本地化
  - 自动计算税费

加速结账:
  - Shop Pay
  - Apple Pay
  - Google Pay
  - PayPal

---

💰 费用对比

费用结构对比表

网关	国内卡	国际卡	货币转换	月费	结算周期
Stripe	2.9%+¥0.30	3.9%+¥0.30	1%	¥0	2-7天
PayPal	3.49%+¥0.49	4.49%+¥0.49	2.5-4%	¥0	1-2天
Shopify Payments	2.4-2.9%	同左	包含	¥0	2-5天
Adyen	1.5-3%	2.5-4%	1%	¥100+	2-3天

隐藏费用

注意费用:
├─ 退款手续费
├─ 争议费用
├─ 货币转换费
├─ 账户维护费
├─ 提现手续费
└─ 国际转账费

---

🚀 快速命令

Stripe配置

/payment-gateway-setup --gateway stripe --region US --currency USD

PayPal配置

/payment-gateway-setup --gateway paypal --region global --currency multi

Shopify Payments配置

/payment-gateway-setup --gateway shopify --region CN --currency CNY

多网关配置

/payment-gateway-setup --multi --gateways stripe,paypal --region global

---

💡 使用场景

场景 1: 新店配置

• 选择: 最佳支付网关
• 配置: 快速启用
• 测试: 确保正常

场景 2: 扩展国际

• 分析: 目标市场支付习惯
• 配置: 本地化支付方式
• 优化: 提升转化率

场景 3: 降低费用

• 分析: 当前费用结构
• 对比: 替代方案
• 切换: 更优网关

---

🛡️ 安全最佳实践

PCI DSS 合规

安全级别:
├─ SAQ A: 最简 (使用iframe)
├─ SAQ A-EP: 简化
├─ SAQ B: 中等
├─ SAQ C: 复杂
└─ SAQ D: 最复杂 (需要审核)

建议: 使用Stripe Elements减少合规负担

数据安全

保护措施:
✅ 永不存储完整卡号
✅ 使用Token化
✅ 强制HTTPS
✅ 实施CSP
✅ 定期审计

防欺诈

最佳实践:
✅ 启用3D Secure
✅ 配置风控规则
✅ 监控异常交易
✅ 验证高风险订单
✅ 保持更新

---

📊 成功指标

配置质量

• ✅ 支付成功率 >95%
• ✅ 支付响应时间 <3秒
• ✅ 退款处理时效 <48小时
• ✅ 争议处理率 <0.5%

转化率

• ✅ 放弃率 <70%
• ✅ 支付方式覆盖率 >90%
• ✅ 本地化支付可用

---

🔗 相关 Skills

• /checkout-optimizer - 优化结账流程
• /profit-calculator - 计算支付成本
• /shipping-config - 配送与支付集成

---

Accept payments with confidence! 💳

版本: 1.0.0 更新: 2026-04-12 作者: Shopilot Team