在沙盒模式下测试PayPal

沙盒模式是一个独立环境，支持除真实付款和拒绝支付外实时环境的所有功能。获得令牌后，您可以通过发送“mode”:“sandbox”来进入沙盒模式。

要打开支付UI，请使用以下链接并在其中指定获得的令牌：https://sandbox-secure.xsolla.com/paystation4/?token={token}。

在沙盒模式下，您可以测试以下面向PayPal的支付UI交互场景：

• 进行测试性支付
• 退款
• 部分退款
• 拒付
• 保存帐户
• 删除保存的帐户
• 通过已保存的帐户扣款
• 获取已保存帐户的列表

创建测试用PayPal帐户

要测试支付过程，您需要为PayPal沙盒模式创建一个帐户：

1. 打开PayPal开发者网站。
2. 登录您的帐户或新建帐户。
3. 前往Sandbox accounts选项卡。
4. 在Sandbox test accounts页面上单击Create account。
5. 选择Personal (Buyer Account)帐户类型并选择国家/地区。
6. 单击Create。

创建的帐户在沙盒帐户列表中显示。

您也可以使用现有沙盒帐户的信息：

测试单次购买

进行测试性支付

1. 在沙盒模式下打开支付UI。
2. 选择PayPal支付方式。
3. 在Mock Response Code字段中，输入0或将该字段留空。
4. 在邮政编码字段中，任意输入5个数字。

5. 点击支付。您将跳转到一个PayPal帐户登录窗口。
6. 输入沙盒帐户的信息：输入Email ID作为邮箱地址，输入System Generated Password作为密码。要找到该信息：
   1. 在PayPal开发者网站上登录您的帐户。
   2. 前往Sandbox accounts选项卡。
   3. 在Sandbox test accounts页面上选择一个沙盒帐户。
   4. 单击•••，然后选择View/Edit account。您将在随后打开的模态窗口中看到该信息。
7. 完成测试支付。

支付完成后交易ID在页面上显示：

成功完成测试支付后，您的PayPal帐户将保存在支付方式列表中。

要查看沙盒模式下所作交易的详细信息，包括费用等：

1. 打开您的发布商帐户。
2. 前往会计 > 交易登记表。
3. 勾选显示测试交易复选框。

此外，您还可以在发布商帐户的支持 > 交易搜索部分查看交易的详细信息及申请退款。

退款

1. 配置退款Webhook。
2. 进行成功的测试支付。
3. 调用请求退款API方法。

随后会有一个关于退款的通知发送到指定的Webhook URL。

部分退款

1. 配置部分退款Webhook。
2. 进行成功的测试支付。
3. 调用请求部分退款API方法。

随后会有一个关于部分退款的通知发送到指定的Webhook URL。

拒付

我们为沙盒模式开发了一个独立的API调用来测试该场景，无需任何银行方的参与。

要测试拒付：

1. 配置退款Webhook。
2. 进行成功的测试支付。
3. 调用请求拒付API方法。

您将收到一个包含以下代码的退款Webhook：

测试保存的帐户

保存帐户

您可以在以下场景下测试在支付UI中保存帐户：

• 进行测试支付时保存
• 在用户帐户中保存

进行测试支付时保存帐户

1. 配置添加支付帐户Webhook。
2. 在沙盒模式下打开支付UI。
3. 选择PayPal作为支付方式。
4. 在Mock Response Code字段中，输入0或将该字段留空。
5. 在邮政编码字段中，任意输入5个数字。
6. 勾选不再询问复选框。
7. 单击支付。您将跳转到一个PayPa帐户l登录窗口。
8. 输入您的沙盒帐户的信息。
9. 完成测试支付。

随后一个关于添加了新帐户的通知将发送到指定的Webhook URL。

保存的帐户在保存的支付方式部分显示。

在支付UI中保存帐户

1. 配置添加支付帐户Webhook。
2. 在沙盒模式下打开支付UI。
3. 前往已保存。
4. 单击铅笔图标并选择添加新方式。
5. 选择PayPal。
6. 在Mock Response Code字段中，输入0或将该字段留空。
7. 在邮政编码字段中，任意输入5个数字。
8. 单击保存。您将跳转到一个PayPal帐户登录窗口。
9. 要完成设置，请输入您的沙盒帐户的信息。
10. 单击Save and Continue。

随后一个关于添加了新帐户的通知将发送到指定的Webhook URL。

保存的帐户在保存的支付方式部分显示。

删除已保存的支付帐户

您可以测试删除保存的帐户：

• 通过API
• 通过支付UI

通过API删除保存的帐户

1. 配置删除支付帐户Webhook。
2. 调用删除已保存的支付帐户API方法。

随后一个关于删除帐户的通知将发送到指定的Webhook URL。

在支付UI中删除保存的帐户

1. 配置删除支付帐户Webhook。
2. 在沙盒模式下打开支付UI。
3. 前往已保存。
4. 单击铅笔图标。
5. 单击编辑方式。
6. 选择帐户，然后点击回收站图标。

随后一个关于删除帐户的通知将发送到指定的Webhook URL。

通过已保存帐户的余额扣款

您可以测试用保存的帐户进行支付：

• 通过API
• 通过支付UI

通过API对已保存帐户的余额扣款

1. 配置支付Webhook。
2. 在沙盒模式下保存帐户。
3. 调用通过已保存的帐户收费API方法。

随后一个关于成功支付的通知将发送到指定的Webhook URL。

在支付UI中对已保存帐户的余额扣款

1. 配置支付Webhook。
2. 在沙盒模式下保存帐户。
3. 在沙盒模式下打开支付UI。
4. 点击已保存支付帐户列表中的帐户。
5. 点击支付。

随后一个关于成功支付的通知将发送到指定的Webhook URL。

获取保存的帐户列表

1. 在沙盒模式下保存帐户。
2. 调用获取保存的帐户API方法。

您将在响应中得到有掩码的数据。

生成错误

1. 在沙盒模式下打开支付UI。
2. 选择PayPal支付方式。
3. 在Mock Response Code字段中，从列表中输入一个要测试的错误代码，或将该字段留空。
4. 在邮政编码字段，任意输入5个数字。
5. 单击支付。您将跳转到您的PayPal帐户来完成支付。

错误消息将显示在支付UI上。

错误代码：

上次更新时间: 2024年9月12日