沙盒环境
收藏
我的收藏

简介

抖音沙盒测试环境是抖音开放平台为第三方开发者提供的官方沙盒环境。开发者可以在该沙盒环境中创建沙盒应用，配合开发者的测试服务端和抖音沙盒环境服务端进行测试。但沙盒中创建的应用只能给开发者小范围测试使用，无法面向普通抖音用户进行发布和分发。

特别的，抖音沙盒环境为开发者提供了一套沙盒担保支付能力，是一个与生产环境完全隔离的联调测试环境。沙盒环境会忽略商户进件流程中的资质门槛和审核过程，开发者创建沙盒应用后即可在沙盒页面中快速完成进件，进而对接支付/退款/分账等接口进行开发联调，从而提高整体交付效率。

使用沙盒环境请使用沙盒客户端，沙盒客户端创建详见沙盒环境使用指南。

沙盒环境与生产环境通过域名区分。

沙盒环境下产生的支付/退款/分账等数据，均无实际资金流，用户无需真实付款，商户也不会有资金入账。

沙盒环境下产生的数据，是与生产环境完全隔离的，即沙盒环境与生产环境下两个相同的单号实际上并不是同一笔交易，切不可把沙盒数据与线上数据混淆。

沙盒环境产生的交易数据仅保留 14 天，每周六 4:00 抖音沙盒环境将对创建时间超过 14 天的数据进行清理。

沙盒环境仅作为方便开发者联调测试的环境，并非与生产环境的逻辑完全一致，接口返回的信息和生产环境实际返回可能不一致，所有场景的接口响应请均以生产环境为准。开发者在沙盒环境中调试完毕后仍需通过生产环境进行验收。

沙盒环境的域名为 https://open-sandbox.douyin.com，开发者要使用沙盒环境，可以将对应的请求接口域名换成沙盒环境域名接口。

下面以支付下单接口为例，将请求生产环境域名https://developer.toutiao.com 替换为https://open-sandbox.douyin.com 即可请求到担保支付的沙盒环境，按照沙盒环境使用指南进行相应的接口测试开发。

环境	请求URL
生产环境	https://developer.toutiao.com/api/apps/ecpay/v1/create_order
沙盒环境	https://open-sandbox.douyin.com/api/apps/ecpay/v1/create_order

接口类型	接口文档
支付	预下单接口支付结果查询支付结果回调
退款	发起退款退款结果查询退款结果回调
结算及分账	发起结算及分账结算及分账结果查询结算及分账结果回调
退分账	发起退分账查询分账回退结果

功能	是否支持	与生产环境的主要差异
页面进件	支持	1.进件请从沙盒入口 https://developer.open-douyin.com/sandbox 进行进件 2.开发者无需等待审核流程 3.无需正式的资质材料及等待审核过程
接口进件	不支持	-
支付	支持	1.用户无需真实付款，不会发生真实资金流 2.收银台支持选择支付结果, 如超时、成功 3.支付成功回调只通知一次, 商户处理失败也不会重试
退款	支持	1.退款成功用户也无资金入账，不会发生真实资金流 2.退款回调只通知一次, 商户处理失败也不会重试
分账	支持	1.分账成功商户也无资金入账，不会发生真实资金流 2.分账回调只通知一次, 商户处理失败也不会重试
退分账	支持	退分账成功商户也无资金入账，不会发生真实资金流
提现	不支持	-
商户余额查询	不支持	-

为方便开始开发者模拟异常情况，验证对接口响应错误码的处理，担保支付沙盒环境提供了一个解决方案。开发者调用接口时通过 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