# Payment Gateway Setup

> 支付网关配置向导 - Stripe、PayPal、Shopify Payments等支付网关的配置指南

- Skill: `huifer/payment-gateway-setup` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add huifer/payment-gateway-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/huifer/payment-gateway-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: huifer (https://skillmd.com/u/huifer)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/huifer/payment-gateway-setup

---


# 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. 基础设置
```yaml
账户设置:
  - 商户类型: 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配置
```yaml
事件类型:
  - payment_intent.succeeded
  - payment_intent.failed
  - charge.refunded
  - charge.dispute.created

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

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

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

### PayPal 配置

#### 1. 账户设置
```yaml
账户类型:
  - Personal: 个人
  - Business: 商业 (推荐)
  - Enterprise: 企业

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

#### 2. API凭证
```
沙盒凭证:
├─ Client ID
└─ Secret

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

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

#### 3. 支付方式
```yaml
PayPal按钮:
  - 标准结账
  - 快速结账
  - 订阅按钮
  - 捐赠按钮

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

#### 4. 防欺诈
```yaml
FraudNet:
  - 实时监控
  - 机器学习
  - 风险评分
  - 自定义规则

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

### Shopify Payments 配置

#### 1. 激活设置
```yaml
启用条件:
  ✅ Shopify店铺
  ✅ 支持的国家/地区
  ✅ 符合资格
  ✅ 完成验证

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

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

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

#### 3. 结账配置
```yaml
结账流程:
  - 加速结账
  - 宾至如归
  - 本地化
  - 自动计算税费

加速结账:
  - 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配置
```bash
/payment-gateway-setup --gateway stripe --region US --currency USD
```

### PayPal配置
```bash
/payment-gateway-setup --gateway paypal --region global --currency multi
```

### Shopify Payments配置
```bash
/payment-gateway-setup --gateway shopify --region CN --currency CNY
```

### 多网关配置
```bash
/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