更新时间：2025-07-17 14:38:58集成工具收藏订阅更新我的文档设置返回文档完成 后，商家/服务商可根据本文指引快速接入 芝麻先享-商家标准版（固定金额模式）。说明：●芝麻先享 仅支持自研商家/服务商通过 自研应用 或 第三方应用 代调用方式，调用 api 接入。●芝麻先享 暂不支持沙箱调试。完整接入 芝麻先享商家标准版 需要同时接入 支付宝app支付 与 商家扣款 两个产品。产品接入核心模块订阅消息设置接收消息的应用网关地址商家/服务商 开通服务、信用下单、扣款、结束服务等场景的信用单状态消息，支付宝会通过 from 蚂蚁消息服务 向商家自研应用或第三方应用设置的 应用网关 地址，post 方式推送异步通知消息。若商家/服务商 网络环境比较复杂，如：通过统一网关间连互联网，推荐使用网络兼容性更好的标准 http(s) 协议进行对接。订阅消息接口商家/服务商 需根据 订阅消息 指引，为接入芝麻先享的 自研应用 或 第三方应用 订阅如下消息接口。注意：仅完成订阅后才会收到支付宝发送的对应异步通知消息。第二步：验签商家/服务商可使用支付宝 sdk 可根据 数据验签 指引，使用应用密钥信息验证异步通知消息来源是否为支付宝。第三步：反馈消息接收结果收到异步通知完成验签后，商家/服务商 需返回 success 这 7 个字符给支付宝，表示消息获取成功，支付宝就会停止发送异步通知。如果返回 fail 或其它值，表示消息获取失败，支付宝会根据 投递重试策略 重新发送消息到应用网关地址。响应值描述是否重试fail消息获取失败重试success消息获取成功不重试消息接口英文名作用消息通知类接口，订阅方式订阅方式可查看 from 蚂蚁消息。通过此接口获取用户先享服务开通状态变更通知。例如：新开通，用户主动解除等。消息通知类接口，订阅方式订阅方式可查看 from 蚂蚁消息。通过此接口获取信用订单的状态变动通知。接口调用时序图开通芝麻先享业务规则1用户在同一商家的同一个信用服务 id 下，只需要开通一次，即可使用芝麻先享服务。若是服务商代商家实现开通服务，则在同一授权商家下，只需要开通一次。2用户开通芝麻先享服务需要达到芝麻分准入条件以及满足风控评估要求，具体以与支付宝工作人员约定的芝麻分为准。流程说明生成签约字符串商家可调用 生成签约字符串 signstr（也就是示例代码中的orderstr），用于 app/h5/小程序 方式唤起开通服务。示例代码重要入参说明参数名称参数说明out_agreement_no商户外部协议号在商户系统中确保唯一。zm_service_id芝麻信用服务 id芝麻先享当前处于邀约制开放阶段，请联系芝麻运营获取芝麻信用服务 id。芝麻信用服务 id 共有 28 位数，需审核通过后才可使用。return_back_link服务开通后，跳转到商户 app 或者小程序页面。cancel_back_link用户中途退出开通服务时的跳转地址。product_code产品码固定为 credit_pay_after_use。服务开通方式一：app/h5如果安装了支付宝，根据 signstr，构造 schemeurl。注意：appid=20000067 用于唤起支付宝，请固定保持不变，直接跳转这个 schemeurl。构造规则如果没有安装支付宝，根据上文中得到的 schemeurl，去构造 landingurl。直接跳转这个 landingurl，这个时候会先到一个中间 landing页面引导用户下载支付宝。构造规则方式二：小程序第一步：创建小程序要在小程序内使用小程序芝麻后付插件，首先请完成 开发者入驻 并 创建小程序。第二步：订购插件完成创建小程序应用后，使用小程序所属的主体支付宝账号，在 pc 端 详情页点击 立即获取，完成插件订购。第三步：修改小程序参数插件 appid：2021002151672975（固定不变）。app.json 插件配置小程序页面 。axml 示例.js 示例重要入参说明属性类型必填描述typestring是服务类型，芝麻先享为 pay_after。sign_strstring是上文生成签约服务字符串 signstr。zm_service_idstring是芝麻先享当前处于邀约制开放阶段，请联系芝麻运营获取芝麻信用服务 id。芝麻信用服务 id 共有 28 位数，需审核通过后才可使用。success() => void否调用成功回调，指的是成功拉起页面。fail(error) => void否调用失败回调。complete() => void否调用完毕。错误结构属性类型描述errorstring错误码errormessagestring错误描述信息错误码错误码描述凯发app官方网站的解决方案2000参数错误阅读产品接入文档，校对参数。3000服务不存在传入的type，服务类型不存在。阅读产品接入文档，校对 type 参数。服务开通消息通知当用户点击开通服务后，支付宝将通过 发送开通服务/授权协议号以及开通/授权状态等信息给商家。商家也可以使用 查询 agreement_status=valid 表示服务开通成功。消息示例注意：消息处理可参考本文订阅消息段落。信用开通并下单未开通芝麻先享服务的用户，在商家平台购买商品或消费时，可通过本链路引导用户开通芝麻先享服务同时下单，此时用户同时开通了服务并且完成了该笔交易的信用下单。业务规则1开通并下单时，服务开通及信用下单同步成功或失败。2若因用户信用评估不通过导致无法完成开通并下单，支付宝会自动转入普通支付流程，用户可按订单金额直接完成付款。流程说明信用开通并下单 商家通过 使用 sdkexecute 方法，response.getbody()取到签名参数 orderstr，然后使用小程序唤起支付的 my.tradepay 方法唤起支付宝客户端进行信用开通并下单。(一) 方式一：app/h5●商户 app 可查看 ：(二) 方式二：小程序●使用 sdkexecute 方法，通过 response.getbody()，获取到签名参数，用于支付接口的 orderstr。●然后使用小程序唤起支付接口 my.tradepay 完成小程序信用下单：示例代码重要入参说明名称是否必传描述out_trade_no是订单号需保持唯一total_amount是由商户根据自身业务评估金额subject是商品订单名product_code是先用后付开通并下单使用：quick_msecurity_payextend_params是业务扩展参数--outagreementno是外部协议号，商家自定义，保障用户纬度唯一--credittradescene是芝麻服务固定为 ：credit_pay--serviceid是芝麻服务id，由芝麻分配--credittradeextinfo否联合风控时透传，非必要示例："credittradeextinfo":"{\"merchantcategorycode\":\"food\",\"shippingaddress\":\"浙江省西湖区西溪路xxx号\"}"小程序示例开通并下单服务消息通知当用户点击开通并下单服务后，支付宝将通过 发送开通服务/授权协议号以及开通/授权状态等信息给商家/服务商。商家/服务商也可以使用 。同时支付宝也通过 发送信用服务单号 credit_biz_order_id 等信息给商家/服务商，支付宝同步返回结果里，credit_pay_mode='creditadvancev2' 表明信用下单成功。消息示例服务开通消息示例信用订单消息示例用户在商家选择芝麻先享下单后，服务完结后，商家平台基于信用下单金额主动调 向用户发起扣款。扣款成功之后服务信用单状态自动由服务使用中变为已守约。信用下单业务规则用户开通服务后在商家平台购买商品或消费，使用芝麻先享下单，商家可以直接调用 下单生成信用服务从而进行后续免密支付。此时用户会在支付宝 app 的 芝麻信用 界面下方的 守约记录 页看到一条 服务使用中 记录。 说明：若用户存在未履约等行为会导致用户信用风险提升，风险用户不支持继续使用芝麻先享下单，信用恢复后可正常使用。流程说明信用下单（已开通下单）1已开通芝麻先享用户在商家客户端商品页面进行商品购买。2商家客户端请求商家服务端下单服务，商家服务端调用支付宝信用下单接口 进行信用下单。3下单完成后，支付宝侧会同步返回信用下单的结果。同时也会通过接口 发送异步通知。支付宝同步返回结果里，credit_pay_mode='creditadvancev2' 表明信用下单成功。4商家还可以主动查询，调用 ，查询结果里credit_pay_mode='creditadvancev2' 表明信用下单成功，此时交易单状态trade_status还是wait_buyer_pay，当发起扣款，扣款成功后交易状态变为trade_success。重要入参说明名称是否必传本次传参说明描述out_trade_no是商家订单号订单号需保持唯一subject是商品订单名商品订单名total_amount是需要信用下单的订单金额由商户根据自身业务评估金额product_code是产品码信用下单固定使用：general_withholdingauth_code是芝麻先享协议号开通异步通知或信用服务订单查询接口中返回的：credit_agreement_idextend_params是-业务扩展参数--credittradescene是信用交易场景芝麻服务固定为 ：credit_pay--credittradeextinfo否芝麻扩展参数额外扩展参数，非必要示例格式："credittradeextinfo":"{\"merchantcategorycode\":\"food\",\"shippingaddress\":\"浙江省西湖区西溪路5xx号\"}"扣款业务规则1若在固定扣款周期内，商家平台扣款成功，用户信用服务订单状态变更为已守约，并积累用户信用记录。2若在固定扣款周期内，商家平台扣款失败的话，需要商家或支付宝轮询向用户自有账户持续扣款。3 信用服务订单在扣款时的扣款金额等于信用下单时的金额，一个信用服务订单仅支持一次扣款，且退款后不支持再次扣款。4若用户账户持续未扣款/追缴扣款成功，7 天后用户信用服务订单将进入逾期状态，直到扣款成功后进入守约状态。5扣款成功的订单才会生成业务账单用于商家对账、以及下一步的结算、分账等操作。商家可以调 （查询对账单下载地址）接口下载对账单。6商家扣款阶段，芝麻先享具备智能代扣服务，商家发起一次扣款，支付宝将自动智能对用户扣款，协助商家提高回款效率。在集成流程上，商家发起扣款调用 时，需要传递参数 is_async_pay = true。不会同步返回支付结果，商家需监听 。流程说明发起扣款1、用户在商家客户端操作确认收货，商家服务端调用支付宝订单扣款接口，支付宝接口名 。2、支付宝收到扣款请求，处理扣款。支付宝会同步返回本次扣款结果，如果扣款成功将由 通知商户。并且在扣款请求时如果传入参数is_async_pay = true，则后续轮询扣款成功也将通过 通知商户。3、对于扣款结果，商家还可以主动查询，调用支付宝查询接口 ，交易状态 trade_status = 'trade_success' 就说明扣款成功，'wait_buyer_pay' 说明扣款还没成功。重要入参说明名称是否必填描述out_request_no是外部请求号。商家自定义，在商家系统内确保唯一。trade_no否支付宝交易号，商家调信用下单时产生。fulfillment_amount是信用服务订单本次扣款金额，目前只支持全额扣款，即必须与信用服务订单金额一致。单位为元，精确到小数点后两位。order_pay_mode是芝麻先享场景必须上送：credit_fulfillment_zmis_async_pay是传 true 时，支付宝会在后台定时轮询扣款，无需商家重复发起，且芝麻先享产品支持智能扣款能力，显著提高商家回款效率。但不会同步返回支付结果，商家需监听扣款异步通知，详见下方异步通知参数。扣款异步通知支付宝会根据 或 中传入的异步通知地址 notify_url，通过 post 请求的形式将支付结果作为参数通知到商家系统，具体可参考：，当面付异步通知。结束信用服务订单若用户需要取消订单，则该信用服务订单不需要进行扣款，则需要商家主动调 将信用服务订单取消。业务规则1若信用下单后，正常通过扣款接口完成扣款，会自动结束信用服务订单，不需要单独调用结束服务。2若买家发起取消服务/订单的行为时，商家必须调用结束接口将信用服务订单完结，否则用户在芝麻的信用服务订单会一直处于服务使用中的状态。a用户取消服务时，未通过其余渠道支付款项，商家将该信用订单推到「取消」状态；b用户取消服务时，若已通过其余渠道支付款项，商家将该信用订单推到「已守约」状态。3结束后的信用服务订单，无法再发起扣款。流程说明结束信用服务订单代码示例重要入参说明关键字段描述备注out_request_no商户外部请求号商户系统内，确保唯一。credit_biz_order_id信用服务订单号信用下单时产生的芝麻开通协议号。is_fulfilled是否履约标识字符串类型，用户此订单是否守约，默认值为false。true ：用户在芝麻信用-守约记录中，该笔订单是已守约状态。false ：用户在芝麻信用-守约记录中，该笔订单是已取消状态。服务信用单状态变更通知结束信用单，支付宝侧会通过接口 发送异步通知。支付宝同步返回结果里，order_status='trade_closed' 表明服务信用单已结束。消息示例注意：消息处理可参考本文 订阅消息 段落。
