服务商代商家开通业务 -凯发app官方网站

更新时间：2024-12-17 15:56:51

文档更新记录 >

订阅更新

我的文档

设置

本文主要帮助服务商提升代商家开通业务效率，目前仅支持

安心付周期卡直连版

。

为了帮助开发者更清晰地了解开通

安心付周期卡直连版

的过程，我们提供以下详细说明。

安心付直连周期卡

包含以下六项业务功能：

●

芝麻信用服务开通

●

服务商

代运营授权

●

服务商代调用授权

●

安心付协议

●

安心付业务开通

●

服务商分佣设置

通过本文您将能够顺利开通并启用上述所有业务功能。

接入流程

流程简介：

①

服务商和商家准备业务开通必须的支付宝商家账号、商家资料或特殊行业资质。

②

服务商系统发起业务开通请求，核心接口有：准入预校验、发起业务开通、开通进度主动查询等接口。

③

业务单据流转阶段主要是支付宝内部系统和业务流程阶段，其中核心流程节点有：参数预校验、发起业务开通(创单)、支付宝审核、商家确认、单据完结；其中商家统一确认内容为

开通意愿、代开发授权、产品及代运营、分佣规则

。

④

商家在收到待办消息(或反扫服务商的待办确认小程序二维码)，可进行业务开通内容查看以及确认或拒绝，商户在完成确认后系统流程会继续推进到完结态。

⑤

完结态会有消息触达通知，服务商系统消费后可进行后置动作推进或完结处理。

系统交互时序：

系统时序补充说明：如需要获取开发授权token请参考

授权通知说明

，图片上传请参考

ant.merchant.expand.indirect.image.upload(图片上传)

。

业务开通服务管理

第一步: 准入预校验

与

的区别是本接口仅执行绝大部分校验逻辑，不会实际执行业务申请的提交。

也会执行全部的校验逻辑的，所以是否接入本接口，可结合具体的服务商侧交互设计而定。

注意事项：

鉴于本套业务开通接口流程整体较为复杂，且参数组合验证时可能出现多种异常情况，为确保服务商和商户的良好用户体验，我们采用了参数基础校验及业务参数检查的前置处理模式。同时考虑到

本身幂等性控制和审核流程较长的特点，特此提供

。此接口旨在提前识别并解决可能的问题，从而优化整体流程效率和客户体验。

第二步: 发起业务开通

有关

的特殊情况，我们提供如下说明，以便于服务商开发人员更清晰理解：

网络抖动与超时处理注意事项

在设计产品流程时，服务商需考虑网关可能出现的网络抖动或超时问题。这类问题可能导致“系统已成功处理请求，但服务商未收到确认”的情况。为应对这种情况，我们建议服务商在产品设计中引入以下策略：

●

重试机制：在检测到请求未确认的情况下，可以再次发起调用进行重试并以支付宝返回幂等的单号

关联上

，这有助于提高系统的可靠性。

●

幂等性设计：务必确保每次调用都伴随一个唯一的幂等键（支付宝侧返回的业务主单号），这样即使重复调用也不会导致重复处理，确保数据一致性。

通过以上建议，服务商可以有效地降低网络不稳定带来的潜在影响，提高整体服务的健壮性和用户体验。

幂等性控制

是一个具备幂等性的接口。支付宝系统会根据以下三个参数作为幂等控制的依据：

服务商小程序、商户登录号 merchant_logon_id、业务场景码 scene_biz_code

。这三个参数共同生成一个唯一的业务开通单号。该单号的生命周期从创建时开始，以达到最终状态（成功完结或失败完结）为结束。在这个期间，所有发起的业务开通请求都会保持返回同一业务开通单号，从而确保幂等性。

注意

：一旦业务开通请求被提交并进入受理阶段，用户将无法再次提交相同请求。请确保在发起新业务开通时，以上三个参数的组合是唯一且有效的，以避免不必要的重复提交。这种幂等性控制机制的设计，旨在避免由于重复请求导致的系统资源浪费，并确保业务流程的准确性和稳定性。

第三步: 开通进度查询

服务商可通过

查询开通情况。主要用于业务申请单流转状态查询，可以结合消息通知异步接口协同使用。

核心状态：

待确认(wait_to_confirm), 接口会额外返回待办小程序商家确认页链接，服务商可生成二维码提供商家反扫工具。

成功完结(success)，意味着业务单据开通完成，服务商可进行业务开通结果表达或推进后续流程。

失败完结(fail)，服务商可获取失败原因(fail_reasons)反馈错误原因来提示引导后续行动点或凯发app官方网站的解决方案。

第四步: 商家确认

业务开通待办确认页提供统一服务，结合业务&行业模式，提供开户、授权、签约、业务开通等多渠道的信息确认能力(移动端商家助手)，商户只需一次确认处理。

移动端

操作入口

：支付宝app >

支付宝商家助手

小程序 >

消息中心

我的待办

。

pc端（敬请期待）

产品功能研发中，敬请期待！

第五步: 监听消息通知

服务商可通过

获取

服务商代商户业务开通消息通知。

状态机

支付宝系统的业务单据流转状态如下：

状态详细说明：

状态码	状态名称	说明
wait_to_audit	待审核	发起创单成功后，创单接口返回该状。如果创单失败，创建接口返回有两种情况： 1.申请单为空，且状态为空。 2.申请单不为空，且状态为失败完结（fail）。
wait_to_confirm	待确认	支付宝系统对提交的资料/资质审核完成后，主单状态会推进到该状态确认中（wait_to_confirm）。
confirming	确认中	该状态在主单流转过程中可跳过（非必须），考虑到商户在待办项确认页面点击确认后系统间调度处理需要时间而设计的中间过渡状态： 1.如果支付宝系统内部调度处理较快，则会跳过该状态，并推进到下一个状态。 2.如果支付宝系统内部调度处理较慢，则会返回该状态，这种情况下通常需要约1~2分钟调度处理并推进到下一个状态。
success	成功完结	申请单成功完结，由于是终态后续单据状态不再跃迁。
fail	失败完结	申请单失败完结，由于是终态后续单据状态不再跃迁。

相关问题