文档中心 > 商家经营工具-开发指引

电子凭证ISV侧对接流程&方案

更新时间:2024/07/31 访问次数:22911

开篇纵览整体的接入及个角色对应环节

码商接入平台及完整文档内容可一键直达码商接入平台全盘了解:点击查看


1. 电子凭证能力对接前置准备条件

各个角色的定义如下。

1)码商的定义及门槛条件

首先需要根据入驻条件指引对照明确下自己是否具备成为码商的前置条件:

成为码商条件:点击查看

成为码商需要准备的硬性材料:点击查看

2)发起码商入驻申请

在明确具备申请条件后如果需要开始申请,请先和行业小二以及淘宝电子凭证商务人员进行商务洽谈, 加入淘宝O2O码商群(群号:1442236451)按群公告要求提问,或者咨询旺旺:电子凭证答疑君。 洽谈成功后,符合入驻条件的码商发起入驻申请:

第一步邮件提交信息:点击查看

第二步:待第一步邮件初审通过之后,在系统上发起在线申请入驻,线上操作指引:点击查看

2. 如何成为开放平台开发者

在完成码商的申请并审批通过后,在正式进行开发对接工作前,我们需要码商注册入驻开放平台。

1)为什么要入驻开放平台


开放平台是基于淘宝各类电子商务业务的开放平台,提供外部合作伙伴参与服务淘宝用户的各类数据、API等信息。码商系统与淘宝的发码、核销、冲正等交互流程正是通过淘宝开放平台来承载的,因此所有入驻电子凭证的码商均需要入驻到淘宝开放平台,以获得API的调用权限等功能。

2)如何入驻开放平台

在入驻开放平台之前,请确保已经完成了码商的申请,并且平台小二已经审批通过。

开始码商入驻开放平台,其中包含两个核心步骤,首先注册成为开发者,然后针对凭证业务创建对应的应用。

3)实操关键点及重点信息内容

申请应用时请务必使用入驻的码商账号登录,应用标签选择"电子凭证码商", 创建成功会进入应用证书页面,如果之前已经创建过这种类型的应用,直接打开应用证书页面, 请特别留意应用证书页面App Key和App Secret这两个参数,在开发过程中会频繁使用到。应用安全等级建议设置为2或3级, 0级可能会影响SessionKey的有效时间。注意:登录开放平台创建应用的账号必须和入驻成码商的账号一致

请参考此链接完成注册和应用创建:点击查看

4)扩展信息

开放平台简介:点击查看

开放平台新手创建指南:点击查看

开放平台应用管理说明:点击查看

3. 码商在开放平台进行业务开发指南

在前置完成码商身份申请、开放平台身份注册、应用创建三个核心流程后,我们将进入应用开发实施阶段。

1)开放平台API的整体情况及技术指引

码商在开放平台实现功能是基于开放平台(TOP)的API,API是基于HTTP协议来调用的,开发者(ISV)可以直接使用TOP提供的官方SDK(支持多种语言,包含了请求的封装,签名加密,响应解释,性能优化等)来调用,也可以根据TOP的协议来封装HTTP请求进行调用。在正式开始实施前请开发者先整体的了解技术框架,调用方法的详细内容:点击查看

2)电子凭证核心API、业务核心运行流程

在完成上述技术背景信息后,我们整体来串联下电子凭证能力的业务核心流程,帮助大家建立整体的实施逻辑。

码商开发所涉及的功能API列表,请根据文档了解每个API的大体作用及参数内容,构建初步感觉:点击查看

参考如下链接文档了解从:下单发出请求-》接收生成码-》发码-》异常重发-》失败处理-》核销前置校验-》核销执行-》撤销冲正 这个主干流程的运行说明,详细了解整个电子凭证业务系统执行的核心流程—点击查看

3)API接口实施流程图【仅供参考,具体对接逻辑开发者需考虑完整逻辑】

图上M1接口表示码商系统需要提供一个接口用来接收发码、重新发码等通知请求。 码商可以通过电子凭证码商 管理后台自主修改接口地址,特别注意不是在开放平台应用中修改回调地址。

如下流程主要是概略表示码商和淘宝系统之间的逻辑交互,码商和商家之间的系统交互以及逻辑非平台层面控制,在此不表请码商和商家之间做好内部界定。


发码流程

涉及API:M1码商自定义接收消息接口、

taobao.eticket.merchant.ma.send(码商发码成功回调接口)、

taobao.eticket.merchant.ma.failsend(码商发码失败回调接口)。

重新发码流程

涉及API:M1码商自定义接收消息接口、

taobao.eticket.merchant.ma.resend(电子凭证重发回调接口)、

taobao.eticket.merchant.ma.failsend(码商发码失败回调接口)。

退款关闭订单处理

核销&核销失败冲正流程

涉及API:taobao.eticket.merchant.ma.available(电子凭证核销前校验接口)、taobao.eticket.merchant.ma.consume(电子凭证核销接口)、

taobao.eticket.merchant.ma.reverse(电子凭证冲正接口)。

撤销核销冲正流程

taobao.eticket.merchant.ma.reverse(电子凭证冲正接口)。

4)系统联调环节

整体如何进行联调调试扫盲看这里:点击查看

系统联调包括两部分:功能调试和流程调试。功能调试流程允许对单个项目进行联调测试,可以边开发边测试。有关码商系统自测的详细操作引导信息,请参见联调工具中的功能调试:点击查看

流程调试是指正式的流程测试,按照顺序对指定的测试项目进行测试,请确保在自测通过后进行,具体操作流程参见联调工具中的流程调试:点击查看

5)系统上线

在系统完成联调成功后,小二会根据3.4说明的这两个联调项目的调试报告审核您的上线资格。符合资格方可上线

在功能调试以及流程调试通过后,码商可以根据自身情况进一步测试或者申请上线。

4. 常见问题及支持帮助

1)代表性问题

2)更多开发对接过程常见问题FAQ列表

详情请查看

3)人工咨询帮助

与开放平台应用操作相关的问题,通过开放平台支持中心提交处理:点击提交

问题提交标题请选择注明:"电子凭证业务"。

如果还不能解决,加入淘宝O2O码商群(群号:1442236451)按群公告要求提问。


FAQ

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