文档中心 > 开放平台

沙箱环境使用说明

更新时间:2017/03/28 访问次数:110026

蚂蚁沙箱环境(Beta)是协助开发者进行接口功能开发及主要功能联调的辅助环境。沙箱环境模拟了开放平台部分产品的主要功能和主要逻辑(当前沙箱支持产品请参考“沙箱支持产品列表”)。
在开发者应用上线审核前,开发者可以根据自身需求,先在沙箱环境中了解、组合和调试各种开放接口,进行开发调通工作,从而帮助开发者在应用上线审核完成后,能更快速、更顺利的进行线上调试和验收工作。
如何使用和配置沙箱环境请参考《沙箱环境使用说明》。

注意:

  • 由于沙箱为模拟环境,在沙箱完成接口开发及主要功能调试后,请务必在蚂蚁正式环境进行完整的功能验收测试。所有返回码及业务逻辑以正式环境为准。
  • 为保证沙箱稳定,沙箱环境测试数据会进行定期数据清理。Beta测试阶段每日的21:00至次日的9:00为维护时间。在此时间内沙箱环境部分功能可能会不可用,敬请谅解。
  • 请勿在沙箱进行压力测试,以免触发相应的限流措施,导致无法正常使用沙箱环境。
  • 沙箱支持的各个开放产品,沙箱使用的特别说明请参考各产品的快速接入文档或技术接入文档章节。

如何使用沙箱环境

第一步:配置沙箱应用环境

点击“开放平台-开发者中心-沙箱环境”。进入沙箱环境页面,系统已经自动为你创建一个应用,在基础信息中可以看到应用信息。

      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步配置后应用公钥后,点击查看支付宝公钥看到的公钥

TIPS:下列以JAVA语言示例展示,其他语言请参考各自SDK。
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相同)

  • RSA(SHA1)密钥:目前推荐使用RSA2(SHA256)密钥,请参考第1步进行配置;
  • AES密钥:目前不再使用;

 

TIPS: 调试过程中需要钱包端支持的功能,请使用沙箱提供的Android支付宝钱包沙箱版,例如当面付的条码获取、芝麻信用的认证;获取方式在开发者中心左侧,点击沙箱环境- 沙箱工具;

 

在”功能信息”列表中,罗列沙箱支持的功能,当前沙箱功能接口无需申请开通,开发者可以根据自身需求选择了解和调试。

第二步:了解并调用接口

为了方便开发者使用,蚂蚁沙箱环境设置了独立于线上环境的配置,并提供了辅助开发者体验开放接口的配套测试账号和工具:

  • 蚂蚁沙箱网关地址为:https://openapi.alipaydev.com/gateway.do
  • 沙箱环境应用为上述沙箱环境为开发者自动创建的应用,对应的APPID可以在页面上找到
  • 沙箱平台提供了商家和买家的测试账号;点击沙箱环境-测试账号;开发者可使用商家账号进行应用授权、使用买家账号进行付款等操作;

具体如何调用开放接口,请参考各开放产品的快速接入或技术接入文档章节,其中会说明沙箱使用的特别说明,开发者可以根据产品文档进行各接口的开发,按照接口文档说明和沙箱使用说明填入正确的参数,完成沙箱功能的调用。

第三步:线上验收

在沙箱环境完成功能调试后,必须将支付宝网关、appid、应用私钥、支付宝公钥修改成正式环境的配置,并在蚂蚁正式环境进行完整的功能验收测试。

 

沙箱调试常见错误 

错误码

错误描述

排查方案

invalid-signature

无效签名

签名校验失败。
1>.检查网关地址是生产环境还是沙箱环境,必须使用与之匹配的app_id与私钥。
2>.检查编码类型是否正确。
3>.检查私钥与开放平台上传的应用公钥是否匹配。
4>.检查签名类型(sign_type)设置是否正确。如果不传入sign_type参数,默认RSA类型。
5>.检查生成的待签名串是否符合要求:
      a)去掉值为空的参数。
      b)所有参数是否按照字母升序排序。
6>.检查签名之后是否对所有参数值做了url encode操作才发起请求。

详细可以使用自助排查

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页面)

查看产品接入说明

信用能力

芝麻认证

查看产品接入说明

欺诈信息验证

查看产品接入说明

芝麻信用评分(普惠版)

查看产品接入说明

行业关注名单(普惠版)

查看产品接入说明

FAQ

关于此文档暂时还没有FAQ
返回
顶部
onlineServer