更新时间：2024-10-22 11:00:20集成工具收藏订阅更新我的文档设置返回文档本文为商家提供花呗分期接入指引。商家在满足 花呗分期产品介绍-准入条件 的前提下，才能够使用花呗分期进行收款，准入后有以下两种可选方式：●支付宝标准收银台展示花呗分期渠道（仅用户承担手续费），无需额外开通花呗分期，仅需设置传入请求参数 enable_pay_channels，详情可查看 接口说明。●花呗分期单通道（可选用户或商家承担手续费），需要开通并开发相应接口来实现，详情查看 接口说明。商家无需开通即可实现用户付费情况下使用花呗分期；如开通花呗分期，并按照下文的介绍进行开发并接入，可选择商家付费及用户付费两种模式。说明：直连商户最低起分金额 1 元，间连商户最低起分金额 100 元。商家在接入花呗分期时如有问题，请拨打商家服务电话：4007585858。注意：本接入指引适用于在开放平台创建应用的商家或服务商（直连商家），通过银联、网联渠道接入支付宝收单能力的商家或者服务商（间连商家）请查看 。1 接入流程1.1 签署支付宝收单商家收银台需接入支付宝，支持支付宝收款；商家需签署支付宝收单协议中的当面付、app 支付、电脑网站支付、手机网站支付。商家登录 后在 凯发k8官方网娱乐官方的产品中心 页签署收单协议，如下图所示：以上产品的接入指南请查看：●当面付接入指南●app支付接入指南●电脑网站支付接入指南●手机网站支付接入指南●小程序jsapi支付接入指南1.2 支付宝账号花呗准入商家的支付宝账号需完成花呗准入，即商家支持用户以花呗、花呗分期向该商家账号付款。商家在满足花呗准入条件后，就可以顺利 。商家点击页面下方的 立即接入 后（如下图所示），系统将检查支付宝账号是否准入；如果暂时不准入，商家可以先将支付宝交易额做到一定规模后再来检查。1.3 签署花呗分期手续费协议在接入花呗后，商家还需签署该协议，才能接通花呗分期单通道和具备贴息能力。说明：签署该协议，不意味着立刻产生分期费用。只有在商家签署了该协议、设置了分期免息商品、完成了分期免息交易后，才会产生分期手续费。1.4 商家接入花呗分期单通道花呗分期单通道模式，是指商家在自己的收银台将花呗分期资金渠道与支付宝并列，支持用户选择花呗分期的某期数购买，并将分期方案带至支付宝收银台。目前手机网站支付、手机 app 支付、电脑网站支付产品支持花呗分期单通道。商家在接入单通道过程中需要开通花呗分期，接口与常规支付宝收单接口保持一致，只需在传参时按照格式传入花呗分期相关参数（如 hb_fq_param 和 extend_params 等）即可。 在接入过程中遇到的花呗分期参数问题可以查看 接口说明；前端效果可查看 应用案例-app端分期、应用案例-pc网站分期。2 支付接入说明●订单结算页和商品详情页（可选）增加花呗分期渠道展示（支付宝提供 logo 矢量图，前往 花呗分期付款界面规范-设计资源下载，下载花呗品牌资源），将标准收银台的支付宝支付和花呗分期渠道的支付宝支付并列展示。详情可查看 应用案例。○如果用户在商家订单结算页选择非分期支付宝支付，则跳转至标准收银台（不包含花呗分期渠道）。○如果用户选择了花呗分期渠道，则跳转至花呗分期收银台（若由于额度不足或不准入等原因无法使用花呗分期，可在支付宝域内直接选择其它凯发k8官方网娱乐官方的支付方式）。●选择花呗分期支付时，带上花呗分期的期数和承担手续费比例，请求相应渠道的收单接口（详情可查看 接口说明）。○参数 hb_fq_num 指定可选期数，包括3/6/12期的，还款期数越长手续费越高（注意：该期数是在开通时约定好的，不可指定未约定的期数，否则调接口时报错）。○参数 hb_fq_seller_percent 指定手续费承担方式，手续费可以由用户全承担（该值为 0），也可以商家全承担（该值为 100），但不可以共同承担，即不可取 0 和 100 外的其它值。●每期支付费用＝手续费和费用的总和/分期数，详情可查看 花呗分期产品介绍-买家分期费用计算规则。●如果需要修改分期参数，请务必使用新的外部订单号。若在同一个交易中，第一次请求参数分 n 期，且用户已经进入支付宝收银台生成交易后，用相同的订单号再次请求参数分 m 期。则跳转到花呗分期收银台后还是显示 n 期，金额也是 n 期的金额，继续支付会报错。●测试时注意使用的买家账号需要在支付宝客户端内开通 花呗 支付，否则测试会报错。●如果是虚拟商品交易，为防止用户使用花呗分期套现，需要禁止使用花呗分期。如果商家在虚拟商品交易中使用花呗分期支付，一经发现关闭花呗分期权限。禁用花呗分期方法：○传入参数 goods_type=0，表示虚拟交易，花呗和花呗分期将不会出现在支付宝收银台供用户选择。○在交易中通过传参禁用花呗分期渠道，具体方法：在收单接口中传入参数 disable_pay_channels=pcreditpayinstallment，花呗和花呗分期将不会出现在支付宝收银台供用户选择。○如果是实物交易，请传 goods_type=1。花呗分期虚实分离适用的 3 个产品：pc 即时到账（电脑网站支付）新老接口、手机 app 支付新老接口、手机网站支付新老接口。●如果是用户在支付宝收银台选择花呗分期，花呗分期手续费 100% 由用户承担，如下图所示：3 退款说明●商家退款后，款项原路退回到花呗账号。退款周期在开通时约定，默认 3 个月。●花呗分期的退款方法和普通支付宝支付相同，详情可查看收单产品（电脑网站支付、app支付、手机网站支付、当面付）接口文档中的退款接口。●发生退款时，资金由商家收款账号退至花呗分期账号，花呗根据用户还款情况，将退款金额做提前还款处理。●分期手续费退费规则：○商家承担手续费，自交易发生后 15 天内发生退款花呗全额退手续费，15天后不退手续费。○用户已经支付的手续费一概不退，未支付的手续费，如果已经出了账单则不能减免，未出账单的，根据退款金额按比例减免。●用户发起退款，相应的退款资金进入花呗分期放款账号，然后冲抵用户该笔交易的账单。冲抵顺序：先冲抵用户已经出账的账单，出账账单冲抵完成后再从该笔交易的最后一期账单向前冲抵，如仍有多余金额则进入用户支付宝余额。4 对账说明可登录移动端支付宝企业版后台下载对账单，花呗分期与普通支付宝收单交易在同一张对账单中。5 安全说明支付宝不允许花呗套现，如发现套现行为，参与套现的用户的花呗及花呗分期支付渠道将做关闭处理。同时，支付宝针对套现行为，为平台类商家花呗防套现给出以下建议：5.1 接入 riskgo 服务花呗安全团队将通过 riskgo 渠道向平台商家输出疑似套现订单信息；平台商需对交易进行拦截，风险店铺进行处罚关闭，并反馈处理结果。详情可查看 。5.2 提前对平台商品类型做好虚实分离实物商品和虚拟商品使用不同的支付宝账号进行收款，或者通过商品名称进行虚拟和实物标注，助于反套现策略防控，降低正常交易打扰情况。5.2.1 虚实分离的实现方式在接口请求参数中传入 goods_type 参数，参数值为 0 代表虚拟类商品，支付宝会禁用花呗渠道；参数值为1代表实物类商品，支付宝会打开花呗渠道。虚实分离的产品支持情况，以及参数的具体使用方法，可查看各产品的请求参数列表。
