接入PayPal全球支付平台*，为新功能做好准备。

升级步骤

第1步：确认您当前的集成版本

• 如果您正在使用JavaScript SDK按钮和REST API，那么一切已就绪。只需确保您的结账流程基于我们的Orders v2 API即可。

  

• 如果您使用的是较早版本的PayPal解决方案，则需要升级。以下传统解决方案需要更新到PayPal全球支付平台*。

  • WPS网站支付标准版
  • NVP/SOAP快速结账
  • Orders/Payments v1 API

第2步：决定方案，选择PayPal全球支付平台*的标准方案或高级方案

查看标准方案与高级方案的比较，选择适合您业务需求的方案。

标准方案

包含PayPal，PayPal Pay Later先买后付，信用卡借记卡支付

高级方案

包含PayPal，PayPal Pay Later先买后付，信用卡借记卡，Apple Pay** 和Google Pay 等支付方式

第3步：设置您的沙箱环境

• 获取您的API密钥

• 登录开发者面板创建REST API应用并获取您的client ID和access token。

• 设置您的沙箱环境账户

• 获取您用于网页和手机应用测试的企业账户或个人账户沙箱环境凭证。

第4步：设置付款按钮

如果您已经使用PayPal很长时间，您可能仍在使用"静态"图形PayPal按钮，比如可点击的GIF图片。为了获取PayPal全球支付平台*的所有功能，首先需要将静态按钮升级为JavaScript SDK按钮。JavaScript SDK能确保您的集成始终保持最新的按钮样式以及付款功能。

• 升级静态按钮

• 将您的按钮升级到JavaScript SDK按钮。

• 自定义按钮

• 参阅JavaScript SDK参考文档配置按钮的外观和体验。

• 设置数据属性

• 参阅JavaScript SDK参考文档，指定您所需的必要数据参数。这些参数必须包含intent、commit、amount、currency、购物描述和唯一订单号，并且必须与您的服务器端的处理保持一致。

第5步：设置服务器端的处理

使用Orders v2 API对订单进行创建、更新、获取、授权与付款操作。使用Payments v2 API进行付款之后的其它操作。

• 设置付款

• 使用Orders v2 API设置基本交易并完成付款。

• 映射您的参数

• 检查您当前的集成参数是否支持在Orders v2 API上作为调用参数，然后将需要升级的集成转换为Orders v2对应的参数。

• 优化您的体验

• 参阅Orders v2 API参考文档配置您的集成详细信息。

第6步：自定义您的集成

通过PayPal全球支付平台*，您可以尽享全方位功能。

• PayPal Pay Later先买后付

• 在您的结账集成中添加PayPal Pay Later先买后付按钮和相关提示信息。

• 备选付款方式

• 允许客户使用银行账户、数字钱包和其它备选付款方式付款。

• PayPal订阅收费

• 创建PayPal订阅收费，定期向客户收费。

• Apple Pay**/Google Pay

• 接受手机支付和数字钱包，如Apple Pay**和Google Pay。

• 保存付款方式

• 保存付款方式，让付款人无需在未来交易中重复输入信息。

第7步：测试并上线

• 代码编写完成后，您就可以测试并上线您的集成了。

• 测试

• 在PayPal沙箱环境中测试您的集成。

• 上线

• 使用您的生产环境client ID更新代码，开始处理实际交易。在集成上线时，记得将凭证和API地址从沙箱环境切换到生产环境。

参考和链接

API 参考

• REST API 和 HATEOAS

• Orders v2 API 参考

• Payments v2 API 参考

• REST API 返回值

• REST API 支持的国家和货币

集成资源

• 使用我们的在线文档直接集成 PayPal 全球支付平台*，或按照说明使用我们的电商建站平台之一进行设置。

• 使用 Postman 探索 PayPal 的 REST API，无需开发者账户。

• 使用Server SDK帮助您集成。

常见问题

从哪里开始？

首先按照沙箱测试指南设置您的沙箱环境。

什么是client ID？

如果您之前的集成是通过NVP/SOAP实现的，那么您在开发过程中可能没有接触过client ID。client ID是使用PayPal JavaScript SDK执行API调用时所需的唯一凭证。

如何获取client ID？

登录developer.paypal.com，创建REST应用并点击查看client ID和Secret。

如何上线？

要将您的集成转移到生产环境，请参考此指南。

NVP/SOAP和REST API集成有什么区别？

以下是NVP/SOAP和REST API的一些主要区别。

• • API凭证 - REST API使用的凭证类型与NVP或SOAP不同。您需要使用这些凭证获取OAuth 2.0访问令牌，然后将其提供给REST API。

  • API终端 - 在NVP和SOAP中，所有请求都使用HTTP POST方法访问同一接口地址。而REST使用更广泛的HTTP方法（GET、POST、PUT、PATCH和DELETE），并根据所访问的API或资源使用特定的接口地址。HTTP头部有时用于提供额外信息。此外，HTTP响应代码用于表明调用是否成功。

  • 参数/字段名称 - Orders v2 API的结构以及参数可能与您之前的集成不同。PayPal正在开发工具，帮助您将NVP/SOAP参数映射到Orders v2。