更新时间：2025-03-06 16:39:09文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档1 花呗分期接入当面付支持 花呗分期 的付款方式，商家在满足 花呗准入 的前提下，才能够使用花呗分期进行收款，准入后有标准收银台与单通道两种模式可选。详情可查看 花呗分期支付接入说明。要在当面付功能中使用花呗分期的付款方式，商家只需要在对应的接口中传入对应的参数即可。 1.1 花呗分期接口列表接口英文名接口中文名alipay.trade.pay统一收单交易支付接口1.2 标准收银台模式支付宝标准收银台展示花呗分期渠道（仅支持用户承担手续费），无需额外开通花呗分期，且无需进行额外的花呗分期参数的透传开发工作，可以直接在支付宝标准收银台中展示出花呗分期渠道。1.2.1 准入条件商家要接入花呗标准收银台模式，必须满足以下几个条件：●公司已接入收单产品 当面付（具体接口见上方说明），并产生一定的交易额。●此产品无需技术开发。●公司运营稳定并具备一定的用户群，具体考核将结合公司运营时长、交易额、规模、用户数来做出综合判定。1.3 单通道模式商家可以根据需要，将花呗分期资金渠道前置或者与其它付款方式并列，实现花呗分期单通道模式。该方式需额外开通 ，且如果当前花呗分期渠道无法支付成功，则可以继续使用其它支付渠道进行付款。商家需要将花呗分期参数传入到 extend_params 中，格式如下：91"extend_params" :{ "hb_fq_num" : "3" , "hb_fq_seller_percent" : "100" }1.3.1 参数说明●hb_fq_num：花呗分期数，仅支持传入 3、6、12，其它期数暂不支持，传入会报错。●hb_fq_seller_percent：卖家承担收费比例，商家承担手续费传入 100，用户承担手续费传入 0，仅支持传入 100、0 两种，其它比例暂不支持，传入会报错。 1.3.2 准入条件商家要接入花呗标准收银台模式，必须满足以下几个条件：●商家已接入收单产品 当面付（具体接口见上方说明），并产生一定的交易额。●商家需签约花呗分期协议。●此产品需要技术开发，需商家进行技术开发或由服务商协助完成。●商家运营稳定并具备一定的用户群，具体考核将结合商家运营时长、交易额、规模、用户数来做出综合判定。2 优惠金额2.1 限制订单参与优惠的金额 商家在支付宝已配置优惠活动或优惠券，如需要限制订单参与优惠的金额，可使用以下参数控制，支持交易支付接口和交易预下单接口。参数名参数说明discountable_amount可优惠金额。其中如果需要不可优惠金额，可通过订单总额 total_amount 减去可优惠金额 discountable_amount 自动获取。2.2 获取优惠情况下的各级金额此外，在支付接口和查询接口返回的支付结果中，可根据以下参数获取有优惠情况下的支付宝计算好的各级金额。参数名参数说明total_amount订单总金额。与请求中的订单金额一致。receipt_amount实收金额。商家实际入账的金额（扣手续费之前）。buyer_pay_amount用户实付金额。建议打印在小票上避免退款时出现纠纷。invoice_amount开票金额。快速告知商家应该给用户开多少钱发票。2.2.1 各级金额关系receipt_amount = total_amount - 商家出资的优惠金额。buyer_pay_amount = receipt_amount - 支付宝出资的优惠金额。invoice_amount = total_amount - 不需要参与开票的金额（如平台优惠、商家优惠等）。2.3 案例分析某餐厅在支付宝后台配置了商家出资的 9 折活动，酒水不享受折扣，同时叠加支付宝出资的立减 5 元活动。某用户总共消费 100 元，其中酒水 20 元，则商家系统在请求支付时，需传入 discountable_amount = 80。由于用户又使用了自己账号等值 2 元的集分宝支付，计算规则如下：●商家实收金额： (100-20)*0.9 20 = 92 元；●用户实付金额：92 - 5 = 87 元；●开票金额：87 - 2 = 85 元。 3 指定收款支付宝账号 对于部分大型集团型或加盟型商家，若有 一个开通账号 多个收款账号 的需求，通过交易支付接口 alipay.trade.pay 中的参数 seller_id 来指定收款账号。 默认情况下，当面付只允许收款至开通账号。如果使用指定收款账号的功能，需要使用商家开通账号登录 配置收款账号列表，详情可点击查看 （目前暂只支持配置同主体账户）。 注意：seller_id 传入的是收款账号的 user_id（支付宝内部 id，2088 开头的 16 位数字），而不是登录 id（邮箱或手机号）。商家可通过静默模式的用户信息授权流程获得支付宝账号的 user_id（需使用该账号登录），详情可点击查看 获取会员信息 。4 商品信息同步 商家/isv 在调用支付接口时，可传入用户实际购买的商品信息，达到两个效果：1如果商家在支付宝创建了单品优惠活动，则支付时必须传入商品信息，当传入的商品信息与单品活动中的配置的商品匹配上时，支付宝就会自动根据活动的优惠规则减免付款金额。 注意：商品信息通过付款码支付的交易支付接口 alipay.trade.pay 中 goods_detail 参数传入，此参数为数据集，包含几个子参数，以 json 列表的形式支持同时传入多个商品。子参数名称子参数说明goods_id商家自定义的商品编号，需要与单品活动中配置的商品编号一致。请在商家维度保持商品编号唯一，并与商品名称保持一对一关系。goods_name商家自定义的商品名称，请不要传入如外卖商品/打折商品等无实际意义的商品名称。如果有商品有多个规格，可在商品名称中包含，如海飞丝（350ml）。注意编码格式与调用接口指定的编码一致。quantity本次交易购买的商品数量。price商品单价。单位元，商品优惠前的价格。商品单价 x 数量的累加金额＝订单总金额（不做强行校验，但可能影响单品相关返佣）更多信息以及完整的请求报文示例，可查看 。注意：请传入的商品信息遵守以上规范，商品信息的不规范可能影响与单品相关的返佣和单品运营活动。5 多门店应用使用 alipay.trade.pay（统一收单交易支付接口）时，需注意以下参数的取值：●store_id：门店编号，商户自己定义的门店号。为商户通过 蚂蚁门店管理 产品接口创建门店配置的 store_id（门店编号） 或在 创建支付宝门店的 门店编号，则需要与开店时传入的 store_id（或配置的外部门店号）保持一致，与 alipay_store_id 至少上传一个。 注意：该参数仅支持字母、数字和英文符号，不支持中文。6 小票打印6.1 门店收银系统打印收银小票规范6.1.1 必须包含内容●商户订单号或支付宝交易号，最好增加条形码展示。●支付宝支付标识。●日期和时间。6.1.2 建议包含内容●商家实收金额，返回参数中的 receipt_amount。●开票金额，返回参数中的 invoice_amount。●用户支付宝账号，返回参数中的 buyer_logon_id，已脱敏。6.2 小票示例7 返佣服务商帮助商家接入支付产品时候可以获取交易的返佣。1服务商登录服务商平台（）,在业务中心-协作费业务内签约《当面付协作费政策》。2 服务商只需在支付 api 的 sys_service_provider_id 中传入返佣服务商 的 pid ，商家即可获取返佣。pid 获取：签约《当面付协作费政策》的服务商主账户登录服务商平台 > 凯发k8官方网娱乐官方的合作伙伴管理 > pid。注意：sys_service_provider_id 要求服务商上传自己的支付宝 pid；如果服务商存在多个支付宝 pid，要确保上传的 pid 是已经在服务商平台签署过返佣协议的那个，若错误上传了未签署返佣协议的 pid 一样无法计算返佣；请务必注意，服务商不要漏传 system_service_provider_id，或是错误上传交易商户的 pid。因服务商交易上传参数错误导致无法计算返佣，是不允许服务商申诉的。示例代码（在业务扩展参数 extend_params 中上传 sys_service_provider_id）以 alipay.trade.pay 为例3为了确保得到返佣，需要返佣的服务商请确保传入正确的返佣参数。传入返佣参数后，服务商需根据 结算和发票管理 指引查看、获取返佣。注意：建议服务商接入的所有订单都加入 sys_service_provider_id 参数并确保参数的准确性，否则无法获得返佣。
