操作手册

业务说明

业务规则

商户贴息分期业务是C端用户在信用卡/花呗可用额度范围内满足其大额消费支出，用户自主选择采取3、6、12期分期消费本金还款的方式，相关分期手续费由商户承担。

操作流程概览

1 整体流程图

权责对象 流程 重点提示 相关文件
调用对象 协作对象 阶段 流程图
渠道商 产品负责人

准

备

阶

段

 图1   见《项目申请表附录二》
渠道商 运营    
渠道商 马凯 一个渠道商一套公私钥证书  
商户 支持群

企业入驻接口 或 个人入驻接口

业务开通接口

商户分期配置接口

 见 加验签demo见附录一
商户 支持群

花

呗

分

期

 图2

创建分期活动接口

上架分期活动接口

聚合正扫接口

交易查询接口

退款接口

  
商户 支持群

银

行

卡

分

期

 图3

分期支付签约接口

分期支付申请接口

分期支付确认接口

分期支付交易查询接口

退款接口

  

流程图

_images/process.png

2 商户入网

商户调用相应的入驻+业务开通接口；

3 花呗分期开通并激活

创建商户分期码：服务商在分期管理-分期码生成页面为商户生成分期码；

商户分期码激活：商户向分期码支付1元，完成激活。次日起方可进行分期交易。

第一步 商户入网

  • 1、商户进件接口
    • 企业用户调用[企业商户基本信息入驻/entMerReg]，个人商户调用[个人商户基本信息入驻 /indvMerReg]。
    • 参数说明
      1. 联系人信息按照协议上指定的人员信息填写。[联系人手机号contact_mobile_no]务必确认准确，此号码后续将会接收账户及密码短信。
      2. 参数[settle_config结算配置]用于配置商户自动结算。如不填写，将不开通自动结算功能，如需开通自动结算功能请务必填写该信息。
  • 2、申请单查询接口
    • 调用[申请单状态查询/queryApplyStatus]，使用商户进件接口返回的huifu_id和apply_no，查询商户入网的审核结果。

第二步 分期配置

  • 1、证照上传接口
    • 调用[商户图片上传接口/file/upload]上传商户相关证照，具体需要的证照信息可以参照[商户业务开通]接口参数要求。其中，接口返回参数[file_id]用于[商户业务开通]接口使用。
  • 2、商户业务开通接口
    • 调用[商户业务开通/regMerBusiInfo]接口，开通商户相关业务。后续还可重复调用此接口补开业务。
    • 参数说明
      1. 参数[支付宝配置对象 ali_conf_list]用于开通用户付息。
      2. 参数[花呗分期费率配置 hb_fq_fee_config]用于开通花呗分期商户贴息。
      3. 证照信息相关参数，需要先调用[商户图片上传/file/upload]接口，使用返回file_id来传值。
  • 3、商户分期配置接口
    • 调用[商户分期配置 /configFqMerFee]接口，管理商户分期配置。
    • 参数说明
      1. 花呗分期手续费填固定值或N
      2. 分期手续费配置不能低于底价费率
    • 相关接口
      1. 返回参数[申请单号 apply_no]，可以调用[申请单状态查询/queryApplyStatus]接口，查询商户分期配置结果。
      2. 调用[商户分期配置详情查询/queryFqMerFeeDetail]接口，可以查询商户分期配置信息。

第三步 花呗分期开通

  • 1、创建花呗分期贴息活动
    • 调用[创建花呗分期商家贴息方案/pcredit/createHbPcreditSolution]接口，给商户创建花呗分期商户贴息活动，同一个活动最多支持500个商户。
    • 参数说明
      1. 免息金额：系统最低支持100，即支付金额>100才可选择分期支付；
  • 2、上架花呗分期贴息活动
    • 调用[支付宝花呗分期贴息活动发布&下架接口/pcredit/modifySolutionStatus]接口，上架贴息活动。
    • 同一时间同一商家只能上架一个活动。
    • 相关接口
      1. 活动上架后，可以调用[更新花呗分期商家贴息方案/pcredit/modifyHbPcreditSolution]对活动时间进行更新。
      2. 调用[花呗活动详情查询 /pcredit/queryHbFqDetail]可以查询已经创建的活动详情。
      3. 已上架的活动，可以调用[支付宝花呗分期贴息活动发布&下架接口/pcredit/modifySolutionStatus]接口，进行下架处理。
  • 3、聚合正扫
    • 调用[聚合正扫/top/trans/pullPayInfo]接口，可以进行支付宝交易（包括非花呗类交易，花呗用户付息和花呗商户贴息交易）。该接口也支持微信和银联交易，如果商户开通了相应的业务，可以通过此接口进行交易。
    • 在对接此接口时，至少需要完成两种交易类型。第一种是普通支付宝交易（非花呗分期）用户激活花呗分期贴息功能。第二种是花呗分期商户贴息交易。
    • 参数说明
      1. 参数[分期贴息类型fq_mer_discount_flag]标识是否进行花呗分期贴息活动，商户贴息传1，非花呗分期商户贴息不传值。
      2. 花呗分期的[交易类型 trade_type]使用[支付宝JS-A_JSAPI]。
  • 4、生成分期码
    • 生成分期码有3种方式：
      1. 服务商可以自行包装分期码；
      2. 服务商可以在汇付的服务商控台给商户生成分期码，如下图所示。
      3. 商户可以在汇付的商户控台看到自己的分期码；
_images/console.png
  • 5、激活分期码
    • 商户使用支付宝扫花呗分期码，支付1元交易，完成该分期码激活。激活次日起该商户可以进行花呗分期收款。
  • 6、商户分期配置详情查询
    • 激活次日可以调用[商户分期配置详情查询/queryFqMerFeeDetail]接口，查询花呗分期激活状态情况
  • 7、退款
    • 调用[交易退款 /toprrc/refund]接口进行支付退款。

第四步 银行卡分期开通

  • 1、签约
    • 调用[分期支付签约 /top/bccredit/sign]接口完成银行卡签约。
  • 2、支付
      1. 申请：调用[两段式分期支付申请/top/bccredit/paymentApply] 接口申请支付。
      1. 确认：调用[两段式分期支付确认/top/bccredit/paymentConfirm]接口确认支付。
  • 3、退款
    • 调用[银行卡分期退款 /toprrc/bccredit/refund]接口进行银行卡分期支付退款。