开发指南创建应用

开发者使用支付宝账号登录开放平台(需实名认证的支付宝账号),进入开发者中心。

Image 1.png

选择应用类型

开发者在创建应用前,需要先选择应用类型。目前开放平台支持两种应用类型:

  • 第三方应用:适用于服务商(ISV),为商户开发应用,拓展商户使用,详见供他人使用
  • 自用型应用:使用开放的功能,为自己或自己公司开发应用,详见自己使用。自研型应用分为网页/移动应用,小程序和生活号应用。

开发者根据自己业务需求选择应用类型,企业或开发者个人自研发请选择网页移动应用,小程序或者生活号,推荐使用小程序。
为企业或商户代开发,请选择第三方应用,第三方应用上线后获取商户授权。

以下步骤以创建“网页/移动应用”为例,其他类型的应用创建请参考创建生活号创建小程序

开始创建

开发者在选择并点击需要创建的应用类型后进入创建应用界面,此处以点击“网页&移动应用”为例。开发者根据自身业务需求,选择接入的能力类型,如下图所示:
image 3.png

注意
创建应用时的应用状态为“开发中”,无法在线上正式调用接口。如您已经了解应用的基本功能,可点击此处跳过此步骤。
您在点击完成创建步骤后,开放平台会为您的应用生成应用唯一标识(APPID),详情见下文的查看 APPID;因此状态为“开发中”的应用也拥有 APPID。

填写基础信息

应用基础信息在开发应用过程中可以无需审核随时完善。

需要完善的内容 作用
应用名称 应用名称和应用图标会在授权、分享的场景中露
出,请准确填写相关信息。
应用图标 代表应用的应用图标,不可上传黄赌毒图片,符合蚂蚁开放审核标准

注意:
应用名称和应用图标会在应用申请上线时进行审核,所以在配置时,建议先了解相关审核规则

添加应用功能

开发者在开发过程中,可以添加自己需要的功能到“功能列表”。不同的功能会有不同的使用条件,如果某个功能的使用条件为签约,则使用者在使用此功能前,需要签约对应的产品。具体签约方式,可参考“如何使用应用”。

此处请注意开发者和使用者的区别:

  • 开发者:应用(功能或者服务)的开发人员(或者企业);
  • 使用者:购买和使用应用(功能或者服务)的人员(或者企业)。

当开发者自己使用自己开发的应用时,开发者和使用者的两个身份是重合的。

配置应用环境

开发者所需配置内容请参考:

字段名称 字段描述
应用网关
(对应下图1)
选填字段,用于接收支付宝异步通知,例如口碑开店中,需要配置此网关来接收开发者门店被动通知;开发者视实际需要填写。
授权回调地址
(对应下图2)
第三方授权或用户信息授权后回调地址。授权链接中配置的 redirect_uri 的值必须与此值保持一致(如:https://www.alipay.com)。

注意
当填入该地址时,系统会自动进行安全检测,详情请参考安全检测
RSA(SHA256)密钥
(对应下图3)
开发者要保证接口中使用的私钥与此处的公钥匹配,否则无法调用接口。可参考密钥的生成与配置,且接口参数 sign_type=RSA2。
RSA(SHA1)密钥
(对应下图4)
同上,且接口参数 sign_type=RSA。

界面请参考:
111.png

如何生成与配置密钥详见签名专区

注意

  • 开发者必须填写“接口加密方式”(加密方式只需填写一个),才可以提交审核。
  • 密钥和应用(APPID)一一对应,即开发者需要为名下的每个应用分别设置密钥,且不同应用的密钥不能混用。

接入沙箱环境

开发中的应用无法调用线上正式环境的接口,蚂蚁提供了沙箱环境帮助开发者进行开发调通工作,沙箱环境自动为开发者分配沙箱应用,不依赖线上环境的应用创建。
点击“开放平台-开发中心-研发服务-沙箱环境”。进入沙箱环境页面,系统已经自动为你创建一个应用。与线上流程一致,只要配置了沙箱应用的密钥即可开始开发。

应用申请上线

应用开发完成后,请开发者自行进行验收并完成安全性检查(安全性检查可参考《开放平台第三方应用安全开发指南》),验收检查完成后,可“提交审核”。应用上线成功后,状态变为已上线,该状态下的应用能够调用生产环境的接口。
开发者点击“提交审核”后,预计会有1个工作日的审核时间,请耐心等待。如需第一时间收到通知,请使用支付宝客户端扫码,进入移动开放平台随时接收审核结果。

Image 7.png

应用上线后可新增功能、删除功能,操作后实时生效。删除功能时请谨慎操作,如果线上已经有用户使用此功能,删除功能后会导致无法使用。

查看 APPID

在完成创建应用的步骤后,开放平台会为您的应用生成应用唯一标识(APPID),通过 APPID 才能调用开放产品的接口能力。开发者可以通过进入“开发中心”-“开发者概览”查看该账号下所有的应用的 APPID,如下图所示:

110.png

协作费相关说明

协作协议可在应用申请上线时以及应用上线后申请。

应用申请上线时

如下图所示,如果开发者选择的功能可签署协作协议,例如“当面付”,就可以在应用申请上线时确认签署协作协议。查看如何获得协作费
65bd397f8583d5f02dfabbab405d92df.png

注意
由于部分协作协议之间会有互斥关系,在签约协作协议的时候,会同时作废掉之前签约的互斥协议。而作废协议会导致协作费费率等的变化,因此当页面提示有作废的协议时,请谨慎选择。
 

应用上线后申请

应用上线后再添加的功能中,如果可签署协作协议,页面上会看到相关提示:

签约协作协议后,点击“运营中心”- “服务商代运营”进入服务商中心,选择左侧菜单的“协作协议信息”页面可查看协议信息:

image.png

历史应用补充签约协作协议

如果开发者的应用在2016年7月28日前已经上线,且未在上线时签约协作费协议,此时如想获得协作费,需要创建一个新的应用,并选择可获得协作费的功能,如当面付等产品(获得协作费的条件可参考协作费公告)。这样在应用申请上线时就会出现确认协作协议的页面,此时只要勾选该协议,并提交应用上线审核即可,提交后,即可在“账户及密钥管理”页面查看协作协议是否生效。协议生效后,账号下的所有应用在满足协作费条件的情况下,就能获得协作费。

协作费计算方式 :开发者可在“规则中心-公告区”查看协作费计算方式。

onlineServer