蚂蚁沙箱环境(Beta)是协助开发者进行接口功能开发及主要功能联调的辅助环境。沙箱环境模拟了开放平台部分产品的主要功能和主要逻辑(当前沙箱支持产品请参考“沙箱支持产品列表”)。
在开发者应用上线审核前,开发者可以根据自身需求,先在沙箱环境中了解、组合和调试各种开放接口,进行开发调通工作,从而帮助开发者在应用上线审核完成后,能更快速、更顺利的进行线上调试和验收工作。
如何使用和配置沙箱环境请参考《沙箱环境使用说明》。
注意:
点击“开放平台-开发者中心-沙箱环境”。进入沙箱环境页面,系统已经自动为你创建一个应用,在基础信息中可以看到应用信息。
1. 生成并上传RSA2(SHA256)的应用公钥,详见生成RSA密钥;配置RSA2(SHA256)的应用公钥后,不需要配置RSA(SHA1)密钥,RSA和RSA2签名算法区别可以参考此处;
2. 编写代码时,请将
a.请求网关修改为:https://openapi.alipaydev.com/gateway.do
b.appid切换为沙箱的appid
c.签名方式使用RSA2
d.应用私钥使用第1步生成的RSA2(SHA256)的私钥(请根据开发语言进行选择原始或pkcs8格式)
e.支付宝公钥切换为第1步配置后应用公钥后,点击查看支付宝公钥看到的公钥
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipaydev.com/gateway.do","2016072200101XXXX","请复制第1步中生成的密钥中的商户应用私钥","json","utf-8","沙箱环境RSA2支付宝公钥","RSA2");
选看部分作为进阶使用,非必填项;
1. 第三方应用授权:
授权url中的redirect_uri必须与此值相同。
2. 获取用户信息:
授权url中的redirect_uri的域名必须与此值相同。(例如:授权回调地址配置:https://auth.example.com/authCallBack 高亮部分需和授权url相同)
在”功能信息”列表中,罗列沙箱支持的功能,当前沙箱功能接口无需申请开通,开发者可以根据自身需求选择了解和调试。
为了方便开发者使用,蚂蚁沙箱环境设置了独立于线上环境的配置,并提供了辅助开发者体验开放接口的配套测试账号和工具:
具体如何调用开放接口,请参考各开放产品的快速接入或技术接入文档章节,其中会说明沙箱使用的特别说明,开发者可以根据产品文档进行各接口的开发,按照接口文档说明和沙箱使用说明填入正确的参数,完成沙箱功能的调用。
在沙箱环境完成功能调试后,必须将支付宝网关、appid、应用私钥、支付宝公钥修改成正式环境的配置,并在蚂蚁正式环境进行完整的功能验收测试。
错误码 |
错误描述 |
排查方案 |
invalid-signature |
无效签名 |
签名校验失败。 详细可以使用自助排查 |
ACQ.PAYMENT_AUTH_CODE_INVALID |
支付失败,获取顾客账户信息失败,请顾客刷新付款码后重新收款,如再次收款失败,请联系管理员处理。SOUNDWAVE_PARSER_FAIL |
1、沙箱环境需要使用沙箱钱包的付款码进行调试,获取方式在开发者中心左侧,点击沙箱环境- 沙箱工具; 2、如果已使用沙箱钱包仍然报此错误,可以尝试将钱包卸载后重新安装; |
missing-signature |
缺少签名参数 |
1、 检查请求时是否加上sign字段; 2、 使用非java版本sdk开发时,请检查是否为代码中因私钥格式错误导致未签名就提交; |
missing-signature-config |
验签出错 未配置对应签名算法的公钥或者证书 |
1、 检查是否在沙箱环境上传应用公钥; 2、 签名方式和实际配置的应用公钥是否匹配,即推荐使用的是上传RSA2(SHA256)密钥,并且签名时需要使用RSA2进行签名; |
如排查后仍有问题,可点击屏幕右侧的”有技术问题点我”进行咨询;
开放能力 | 开放产品 | 描述 |
---|---|---|
支付能力 |
当面付 |
查看产品接入说明 |
手机网站支付 |
查看产品接入说明 | |
App支付 |
查看产品接入说明 | |
电脑网站支付 |
查看产品接入说明 | |
资金能力 |
单笔转账到支付宝账户 |
查看产品接入说明 |
口碑开店能力 |
口碑开店 |
查看产品接入说明 |
店铺数据 |
查看产品接入说明 | |
商家详情页广告 |
查看产品接入说明 | |
支付宝卡券 |
支付宝卡券 |
查看产品接入说明 |
会员营销 |
营销活动 |
查看产品接入说明 |
会员分层 |
查看产品接入说明 | |
经营报表 |
查看产品接入说明 | |
自定义报表 |
查看产品接入说明 | |
会员能力 |
获取会员信息 |
查看产品接入说明 |
行业能力 |
地铁线上购票 |
查看产品接入说明 |
生活缴费 |
查看产品接入说明 | |
安全能力 |
“蚁盾”风险评估 |
查看产品接入说明 |
基础能力 |
图片资料上传 |
查看产品接入说明 |
第三方应用授权 |
查看产品接入说明 | |
凤蝶(快速搭建H5页面) |
查看产品接入说明 | |
信用能力 |
芝麻认证 |
查看产品接入说明 |
欺诈信息验证 |
查看产品接入说明 | |
芝麻信用评分(普惠版) |
查看产品接入说明 | |
行业关注名单(普惠版) |
查看产品接入说明 |