沙盒模式

沙盒模式是一个独立环境，支持除真实付款外所有实时环境的功能。您可以使用沙盒模式测试：

  • 支付小组件
  • 收款人帐户
  • 通过身份认证程序(KYC)和税务信息调查的表单
  • 与API的集成

支付小组件

要在沙盒模式下打开支付小组件：

  1. 获取令牌。在请求中传入Authorization:Basic <your_authorization_basic_key>参数，其中<your_authorization_basic_key>是按照Base64标准编码的平台ID：密钥对。要找到该测试数据：
    1. 在发布商帐户中打开您的项目，然后前往提现 > 设置部分。
    2. 在右上角下拉列表中选择沙盒。
    3. 前往设置 > 安全性部分。

获取令牌请求的示例：

Copy
Full screen
Small screen

    curl -X POST 'https://payouts-sandbox-api.xsolla.com/api/v1/merchants/customer/auth' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic <your_authorization_basic_key>' \
-d '{"email": "<your email>", "name": "<your name>"}'

    1. 通过链接https://payouts-sandbox-widget.xsolla.com/?token={token}打开沙盒模式，其中{token}是步骤1中收到的令牌。

    注：
    使用SDK打开小组件

    要在沙盒模式下打开支付小组件，请在打开小组件的脚本或npm-package的初始化代码中传入sandbox: true参数。

    打开支付小组件的脚本：

    Copy
    Full screen
    Small screen

      <script>
    var s = document.createElement('script');
    s.type = "text/javascript";
    s.async = true;
    s.src = "https://static.xsolla.com/payouts/v0/_bundles/santorelli.min.js";
    s.addEventListener('load', function () {
        const widget = new XPayoutsWidget.Widget({
                    token: '<auth token>',
                    theme: 'black',
                    size: 'fixed',
                    sandbox: true
                });

        widget.show('<container_id>');

        widget.addEventListener('load', () => {
            console.log('loaded');
        });
    }, false);
    var head = document.getElementsByTagName('head')[0];
    head.appendChild(s);
</script>

      打开支付小组件的初始化代码：

      Copy
      Full screen
      Small screen

        import {Widget} from '@xsolla/payouts-sdk';

const widget = new Widget({
    token: '<auth token>',
    theme: 'black',
    size: 'fixed',
    sandbox: true  
});

widget.show('<container_id>');

widget.addEventListener('load', () => {
    console.log('loaded');
});

        1. 在打开的小组件中，勾选阅读并同意许可协议的复选框。
        2. 在Verification选项卡中，使用测试数据填写字段：
          • 名字
          • 姓氏
          • 中间名（非必填）
          • 国家/地区
          • 国籍
        3. 如要测试失败场景，请勾选通过身份认证程序(KYC)时生成错误的复选框。
        4. 单击Send。

        1. 在Tax Interview选项卡中，选择要测试的场景：成功或错误。
        2. 使用测试数据进行支付。

        注：
        沙盒模式下的交易对生产环境没有任何影响。

        收款人帐户

        要在沙盒模式下开立收款人帐户：

        1. 在发布商帐户中打开您的项目，然后前往提现 > 设置部分。
        2. 在右上角的下拉列表中选择沙盒。

        1. 前往用户选项卡，然后邀请自己。
        2. 在邮箱收到的邮件中点击收款人帐户的链接。
        3. 在收款人帐户中，选择商户并使用测试数据进行支付。

        注：
        您也可以通过https://payouts-sandbox.xsolla.com/链接并完成身份认证程序前往沙盒收款人帐户。

        测试数据

        注意
        任何未包含在测试列表中的数据在沙盒模式下无效。

        测试银行卡

        卡号CVC到期日期描述
        4242424242424242任意3位数字未来任意日期成功付款
        4000000000000002任意3位数字未来任意日期支付失败

        测试交易

        IBAN其他字段描述
        FI211234569876543210任意数据成功提现
        AT483200000012345864任意数据提现失败

        测试邮箱地址

        邮箱地址其他字段描述
        success@xsolla.com任意数据成功提现
        failed@xsolla.com任意数据提现失败

        测试手机号

        手机号码其他字段描述
        +1 (555) 123-4567任意数据成功提现
        +1 (555) 987-6543任意数据提现失败
        本文对您的有帮助吗？
        谢谢！
        我们还有其他可改进之处吗？ 留言
        非常抱歉
        请说明为何本文没有帮助到您。 留言
        感谢您的反馈！
        我们会查看您的留言并运用它改进用户体验。
        为此页面评分
        为此页面评分
        我们还有其他可改进之处吗？

        不想回答

        感谢您的反馈！
        上次更新时间: 2023年10月10日

        发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。

        报告问题
        我们非常重视内容质量。您的反馈将帮助我们做得更好。
        请留下邮箱以便我们后续跟进
        感谢您的反馈！