佛系程序员_ 正式环境的 PayPal 必须勾选的完整清单

学习笔记

网站开发

发布日期: 2026-03-27 17:48:30

喜欢量: 9 个

阅读次数: 54

# PayPal 开发者后台创建 App 时相关设置一份**简洁、完整、...

# PayPal 开发者后台创建 App 时相关设置

一份**简洁、完整、你照着勾选就能用**的最终版说明。
在 PayPal 开发者后台创建 App 时**按下面勾选**，然后把 **Live Client ID** 复制保存即可，后续开发人员不再需要动同事的账号。

---

## 一、创建 App 时必须勾选的完整清单（APP + 网站通用）
同事在 https://developer.paypal.com/ 登录 → My Apps & Credentials → Live → Create App

按模块**只勾这些**，其他全部不勾：

### 1. Add-on services
- ✅ Customer disputes
（处理退款、争议，必须开）

### 2. Manage
- ✅ Transaction search
（查交易记录，必须开）

### 3. PayPal SDKs
- ✅ JavaScript SDK v6
（你的 App 目前用网页支付，必须开）
- ✅ Mobile SDKs
（App 原生支付用，必须开）

### 4. Payment methods
- ✅ Expanded checkout
（3D Secure、信用卡支付，合规必须开）
- ✅ Advanced Credit and Debit Card Payments
（可选但建议开，支付体验更好）

可按需勾选（有需要再开）：
- Apple Pay
- Google Pay

### 5. Payment capabilities
- ✅ Payment links and buttons
（支付按钮能力，必须开）

按需勾选（你业务需要再开）：
- Save payment methods
- Subscriptions（订阅）
- Invoicing（发票）
- Payouts（打款给别人）

---

## 二、创建完成后，你只需要同事给你这 2 个东西
1. **Live Client ID**
2. **Live Secret / Secret Key**

拿到后你直接替换掉之前 Sandbox 的配置即可。

---

## 三、你这边开发要改的关键点（极简版）
1. 把环境从 `sandbox` 改为 `live`
2. 替换 Client ID 为正式环境
3. 支付接口域名从：
   `api-m.sandbox.paypal.com`
   改为：
   `api-m.paypal.com`
4. 继续用你现在的 JS SDK 方式支付，**仍然可以跳网页支付**，完全能用
5. 若以后想优化成不跳网页，再集成 Mobile SDK 即可，不影响现在上线

---

## 四、一句话总结（可直接发给客户）
> 创建 Live App，勾选：Customer disputes、Transaction search、JavaScript SDK v6、Mobile SDKs、Expanded checkout、Advanced Credit and Debit Card Payments、Payment links and buttons。其他不用勾。把 Live Client ID 和 Live Secret 发我即可。

---

# APP里可以用PayPal支付吗？

**APP里完全可以用PayPal支付，而且有比“跳Web页”更好的原生方案**。你现在跳Web页是因为用了网页版JS SDK，换成**PayPal Mobile SDK（原生）** 或**App Switch（应用内跳转PayPal App）** 就能实现更流畅的体验。下面给你完整方案、后台勾选配置、实现路径。

---

### 一、先明确：APP用PayPal的3种主流方案（按体验排序）
#### 1. 最佳方案：PayPal Mobile SDK（原生，无WebView）
- 体验：**纯原生界面**，在App内完成支付，不跳外部浏览器/WebView，体验最好。
- 支持：iOS/Android，支持PayPal账户、信用卡、Apple Pay/Google Pay等。
- 缺点：需要集成原生SDK，开发量比WebView大，需PayPal审核。

#### 2. 次优方案：App Switch（应用内跳转PayPal App）
- 体验：点击PayPal按钮，**直接唤起手机上的PayPal App**（已安装时），用生物识别（Face ID/指纹）快速支付，支付完切回你的App；未安装PayPal App时，自动降级到安全浏览器（SFSafariViewController/Custom Tabs）。
- 支持：iOS/Android，基于JS SDK v6开启，**开发成本低、体验接近原生**。

#### 3. 现有方案：WebView/浏览器跳转（不推荐）
- 体验：跳转到网页支付页，加载慢、易被拦截、用户易流失，**正式环境不推荐**。
- 原因：你现在用的是网页版JS SDK，在App里用WebView加载，所以会跳Web页。

---

### 二、PayPal开发者后台：APP场景必须勾选的选项
你之前是网站配置，现在做APP，**必须在后台开启Mobile SDK相关权限**，否则原生SDK无法调用。

#### 1. 核心必勾（创建App时）
- **PayPal SDKs → Mobile SDKs（必勾）**：开启原生移动支付能力，iOS/Android通用。
- **Payment methods → Expanded checkout（必勾）**：支持3D Secure、信用卡直付，合规必备。
- **Payment capabilities → Payment links and buttons（必勾）**：生成支付按钮，基础能力。
- **Manage → Transaction search（必勾）**：交易查询、对账。
- **Add-on services → Customer disputes（必勾）**：售后争议处理。

#### 2. 推荐勾选（提升体验）
- **Payment methods → Advanced Credit and Debit Card Payments（推荐）**：自定义信用卡输入框，提升转化。
- **Payment methods → Apple Pay / Google Pay（按需）**：支持对应钱包支付。
- **Payment capabilities → Save payment methods（按需）**：保存支付方式，一键复购。
- **Add-on services → Log in with PayPal（按需）**：用PayPal账号登录App。

#### 3. 不勾/暂不勾
- **JavaScript SDK v6**：仅网站用，APP原生开发不依赖（App Switch除外）。
- **IC++ with Gross Settlement**：特殊费率，普通商户不用。

---

### 三、从“跳Web页”升级到原生/App Switch的实现路径
#### 方案A：快速升级 → App Switch（基于现有JS SDK，1-2天搞定）
适合不想大改代码、快速优化体验的场景。
1. 后台已勾：**Mobile SDKs、Expanded checkout**。
2. 前端（App内）：
   - 用**PayPal JS SDK v6**，开启`enableFunding: ['paypal']` + `appSwitch: true`。
   - 用`SFSafariViewController`（iOS）或`Custom Tabs`（Android）加载PayPal按钮，**不要用普通WebView**。
   - 配置`return_url`和`cancel_url`，支付后切回你的App。
3. 效果：用户点击PayPal → 唤起PayPal App（已安装）→ 生物识别支付 → 切回你的App；未安装则走安全浏览器，**不再是简陋WebView**。

#### 方案B：原生集成 → PayPal Mobile SDK（最佳体验，需原生开发）
适合纯原生App（iOS Swift/Android Kotlin）或Flutter/React Native跨端。
1. 后台：已勾**Mobile SDKs**，获取**Live Client ID**。
2. 集成SDK：
   - **iOS**：CocoaPods引入`PayPalCheckout` SDK。
   - **Android**：Gradle引入`com.paypal.android:paypal-checkout`。
   - **Flutter**：用`paypal_native_checkout`插件（无WebView）。
3. 开发流程：
   - 初始化SDK，传入`Client ID`和环境（Live）。
   - 创建订单（后端生成`Order ID`，传给前端）。
   - 调用SDK支付方法，弹出原生PayPal支付界面。
   - 监听支付结果（成功/失败），后端验证订单。
4. 优势：**完全原生、无跳转、加载快、转化率高**，符合App Store/Google Play审核要求。

---

### 四、关键注意事项（上线必看）
1. **环境切换**：Sandbox测试没问题后，**必须替换为Live Client ID/Secret**，API地址从`sandbox`改为`api-m.paypal.com`。
2. **审核要求**：
   - 原生SDK集成后，PayPal会审核你的App（Live环境2-10个工作日）。
   - 确保App内支付流程清晰、无诱导、符合PayPal商户协议。
3. **Webhook配置**：后台配置Webhook，监听`PAYMENT.CAPTURE.COMPLETED`等事件，**后端必须验证支付结果**，防止前端伪造成功回调。
4. **合规**：开启`Expanded checkout`支持3D Secure，符合欧盟SCA等支付合规要求。

---

### 五、快速决策建议
- 想**最快优化体验、少改代码**：选**App Switch**（基于JS SDK，开启App Switch）。
- 想**最佳原生体验、长期迭代**：选**PayPal Mobile SDK**（原生集成）。
- 放弃**普通WebView跳转**，体验差、易被风控拦截。

需要我给你一份**App Switch（JS SDK）的最小可运行代码示例**（含iOS/Android配置、return_url处理），你直接复制就能用吗？

我把**创建名为 yijing 的正式PayPal应用**的完整流程、勾选项、取凭证，一次性给你，同事照着做即可。

---

## 一、准备工作（同事操作）
1. 用国内注册的PayPal商户账号，在**国内常用设备、常用网络**登录
2. 访问：https://developer.paypal.com/
3. 登录后进入 **Dashboard → My Apps & Credentials**
4. 切换到 **Live（正式环境）**（不要选Sandbox）

---

## 二、创建应用（名称：yijing）
1. 右上角点 **Create App**
2. 填写：
   - **App Name**：`yijing`
   - **App Type**：选 **Merchant（商家）**（你是收款方）
   - 关联账号：默认即可（你的PayPal商户账号）
3. 点 **Create App** → 应用创建成功

---

## 三、必须勾选的权限（只勾这些，其他不勾）
进入 yijing 应用详情页，往下拉到 **Add App Capabilities**，按模块勾选：

### 1. Add-on services
- ✅ **Customer disputes**（处理争议/退款，必开）

### 2. Manage
- ✅ **Transaction search**（查询交易，必开）

### 3. PayPal SDKs
- ✅ **JavaScript SDK v6**（网页/APP内嵌网页支付，必开）
- ✅ **Mobile SDKs**（APP原生支付，必开）

### 4. Payment methods
- ✅ **Expanded checkout**（3D Secure、信用卡，合规必开）
- ✅ **Advanced Credit and Debit Card Payments**（自定义卡字段，建议开）
- 按需勾选：Apple Pay、Google Pay（有需要再开）

### 5. Payment capabilities
- ✅ **Payment links and buttons**（支付按钮，必开）
- 按需勾选：Save payment methods、Subscriptions、Invoicing、Payouts（业务需要再开）

勾选完，拉到最底部点 **Save**。

---

## 四、获取正式凭证（发给你）
在应用详情页顶部 **API Credentials** 区域，复制这两个：
1. **Live Client ID**
2. **Live Secret**（点 **Show** 查看，妥善保管）

---

## 五、一句话发给同事（可直接复制）
> 登录PayPal开发者后台（Live环境），创建名为 yijing 的Merchant应用，勾选：Customer disputes、Transaction search、JavaScript SDK v6、Mobile SDKs、Expanded checkout、Advanced Credit and Debit Card Payments、Payment links and buttons。保存后把 Live Client ID 和 Live Secret 发我。

---

## 六、你这边开发配置（极简）
1. 环境从 `sandbox` 改为 `live`
2. 替换 Client ID 为正式的 `yijing` 应用 Client ID
3. API 域名从 `api-m.sandbox.paypal.com` 改为 `api-m.paypal.com`
4. 继续用 JS SDK 跳转网页支付，完全可用

需要我给你一段**正式环境可直接使用的PayPal JS SDK支付代码**，你只需替换Client ID就能上线吗？

yyii

https://amtb.info/show/MzE5

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !