沙盒环境
收藏我的收藏
收藏简介
抖音沙盒测试环境是抖音开放平台为第三方开发者提供的官方沙盒环境。开发者可以在该沙盒环境中创建沙盒应用，配合开发者的测试服务端和抖音沙盒环境服务端进行测试。但沙盒中创建的应用只能给开发者小范围测试使用，无法面向普通抖音用户进行发布和分发。
特别的，抖音沙盒环境为开发者提供了一套沙盒担保支付能力，是一个与生产环境完全隔离的联调测试环境。沙盒环境会忽略商户进件流程中的资质门槛和审核过程，开发者创建沙盒应用后即可在沙盒页面中快速完成进件，进而对接支付/退款/分账等接口进行开发联调，从而提高整体交付效率。
注意事项
- 1.使用沙盒环境请使用沙盒客户端，沙盒客 户端创建详见沙盒环境使用指南。
- 2.沙盒环境与生产环境通过域名区分。
- 3.沙盒环境下产生的支付/退款/分账等数据，均无实际资金流，用户无需真实付款，商户也不会有资金入账。
- 4.沙盒环境下产生的数据，是与生产环境完全隔离的，即沙盒环境与生产环境下两个相同的单号实际上并不是同一笔交易，切不可把沙盒数据与线上数据混淆。
- 5.沙盒环境产生的交易数据仅保留 14 天，每周六 4:00 抖音沙盒环境将对创建时间超过 14 天的数据进行清理。
- 6.沙盒环境仅作为方便开发者联调测试的环境，并非与生产环境的逻辑完全一致，接口返回的信息和生产环境实际返回可能不一致，所有场景的接口响应请均以生产环境为准。开发者在沙盒环境中调试完毕后仍需通过 生产环境进行验收。
使用指南
下面以支付下单接口为例，将请求生产环境域名https://developer.toutiao.com 替换为https://open-sandbox.douyin.com 即可请求到担保支付的沙盒环境，按照沙盒环境使用指南进行相应的接口测试开发。
功能范围
支持的接口
支持的功能
功能 | 是否支持 | 与生产环境的主要差异 |
页面进件 | 支持 |
|
接口进件 | 不支持 | - |
支付 | 支持 |
|
退款 | 支持 |
|
分账 | 支持 |
|
退分账 | 支持 | 退分账成功商户也无资金入账，不会发生真实资金流 |
提现 | 不支持 | - |
商户余额查询 | 不支持 | - |
异常测试
为方便开始开发者模拟异常情况，验证对接口响应错误码的处理，担保支付沙盒环境提供了一个解决方案。开发者调用接口时通过 Http Header 中添加异常头 Aweme-Negative-Test: {用例名} 指定异常用例集，沙盒环境会识别用例名返回相应的异常错误码。
目前仅支持下表的异常用例集，若 Aweme-Negative-Test 中的用例名不在用例集内，会返回给开发者用例集无法识别的错误码 1007。
功能 | 支持异常用例集 | 具体含义 | 返回错误码 |
支付下单 | MA_PAY_ALREADYSUCCESS | 交易已被支付 | 5001 |
MA_PAY_ALREADYCLOSE | 交易已经关闭 | 5002 | |
MA_PAY_BAN | 支付封禁 | 5004 | |
MA_PAY_PARAMINCONSISTENT | 交易信息被篡改 | 5005 | |
退款发起 | MA_REFUND_NOAUTH | 商户没有退款权限 | 4102 |
分账发起 | MA_SETTLE_AMOUNTINVALID | 当前已分账金额或分账前已退款金额已超限，无法再次发起全新的分账请求 | 6000 |
退分账发起 | MA_RETURN_AMOUNTINVALID | 回退次数超过限制 | 4401 |
- | - | 不支持该用例集,请使用有效用例集 | 1007 |
