更新时间：2025-07-17 14:40:43集成工具收藏订阅更新我的文档设置返回文档完成 后，商家/服务商可根据本文指引快速接入 芝麻免押。说明：●芝麻免押 仅支持自研商家/服务商通过 自研应用 或 第三方应用 代调用方式，调用 api 接入。●芝麻免押 提供 ，以实现更快接入。●芝麻免押 暂不支持沙箱调试。●芝麻免押 开发完成后需要根据 完成验收。完整接口时序图芝麻免押研发接入共分为两大流程，以用户向商家确认免押订单为关键节点，分为：创建免押订单流程 和 创建免押订单后流程。●创建免押订单流程，共有 3 个关键环节，请商家关注各个接口的出入参以及链路的完整性，确保当前订单正常创建。●在创建免押订单后流程，代表已经完成了订单的创建，商家可以对订单进行 9 项接口操作，包括查询、取消、完结，以及对这个订单进行多次扣款、查询扣款、取消扣款、申请退款、退款查询、同步服务订单信息等操作，请商家根据业务需求，按文档指引进行接入。创建免押订单流程创建免押订单商家可调用 创建冻结订单，获取 orderstr 用于拉起芝麻免押确认页面。注意：1、在验收完成前，属于灰度阶段，仅对加白账号免押，测试前请先对测试账号加白，链接：。2、选择 信用凯发app官方网站的解决方案 > 点击 继续编辑 > 选择第三步技术对接&验收 > 扫码添加，生成二维码在支付宝上登录测试账号，扫码后确认即可加白进行测试。跳转确认订单页支付宝根据用户不同的使用场景（ 小程序、app 、h5 ）分别提供了对应跳转确认订单页的方法，请根据场景进行选择。小程序商家在小程序内调用 my.tradepay 接口，传入获取的加签字符串唤起预授权冻结流程。示例代码appandroid 示例代码入参说明：●paytask 对象主要为商家提供订单支付、查询功能，及获取当前开发包版本号。●获取 paytask 支付对象调用支付（支付行为需要在独立的非 ui 线程中执行）。出参获取：ios 示例代码详情可查看 ios集成方案。h5示例代码使用介绍可直接传入一个字符串作为 option.orderstr 参数。option 参数说明：名称类型必填描述tradenostring否交易号，多个交易号请用英文分号(;)分隔。partneridstring否商户 id。biztypestring否交易类型，默认为 trade。bizsubtypestring否交易子类型。bizcontextstring否支付额外的参数，格式为 json 字符串。orderstrstring否完整的支付参数拼接成的字符串，从服务端获取。callback 参数说明名称类型描述resultcodestring支付结果状态码，详情可查看下表。resultcode 支付状态码说明：resultcode描述9000订单支付成功。8000正在处理中。4000订单支付失败。6001用户中途取消。6002网络连接出错。99用户点击忘记密码导致快捷界面退出（only ios）。确认订单回调通知当用户确认订单时，支付宝会把相关信息通过 传入的 notify_url 主动以 post 的方式推送给商家。注意：接收程序执行完后必须打印输出 success。如果商家反馈给支付宝的字符不是 success 这 7 个字符，服务器会不断重发通知，直到超过 24 小时 22 分钟。创建免押订单后流程查询免押订单商家可以通过 查询单笔订单的详细信息，细分到每一次操作，如冻结、解冻。取消免押订单商家由于业务系统处理超时需要终止后续业务处理或者授权结果未知时可调用 取消免押订单。注意：●请先调用 接口查询，没有明确的返回结果再调用此接口。订单状态为 init（初始化）、authorized（已创建）时也可以取消订单（此时一般为用户取消服务时使用）。●取消订单后仍有冻结金额时，请做好完结订单，避免影响用户信用额度，造成不必要的客诉。扣款操作发起扣款当商家获得用户授权完成 创建订单 操作后，用户服务结束后/服务进行中（一般为多次扣款模式，如租物场景中对用户每个月扣除一次租金）如果业务场景需要用户进行支付，则需要调用 完成扣款操作。注意：对于未消费的免押订单（免押订单创建成功，但未进行扣款），请使用定时任务做好完结免押订单或取消免押订单，避免影响用户信用额度，造成不必要的客诉。参数说明●auth_confirm_mode：○取值选择 complete ，扣到用户钱时会同步关闭订单。○取值选择 not_complete，扣到用户钱时不同步关闭订单（一般用于多次扣款的场景）。查询扣款若商家在调用接口时传入了 notify_url 字段，扣款完成后，支付宝会把相关信息以异步回调的方式推送给商家 ，商家需要处理接收。注意：●接收程序执行完后必须打印输出 success。如果商家反馈给支付宝的字符不是 success 这 7 个字符，服务器会不断重发通知，直到超过 24 小时 22 分钟。●商家并未收到支付宝发送的扣款完成通知时，商家可以通过主动调用 来查询扣款结果。取消扣款当发起扣款后，商家发现扣款金额有误/更换订单金额/通过其他渠道完成扣款需要取消扣款时，商家可调用 取消扣款。注意：●此时需要订单为 待支付 状态。●如用户通过其他方式完成支付，也需要取消扣款（此时需要订单为 待支付 状态）。退款申请退款交易发生后的一段时间内，由于业务原因（如金额错误、用户退款或者对账不平等）需要全额或部分退款时，商家可调用 将对应订单支付款退还给买家。支付宝将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家账号上。退款查询商家可调用 查询对应退款请求的退款情况。 同步服务订单信息订单状态发生变更时，商家可调用 同步订单状态到支付宝客户端，向用户展示订单变化完结免押订单完结订单由于用户取消订单/商家按照业务逻辑进行扣款后仍有冻结金额时，商家可通过 将授权资金进行解冻，支付宝将在收到解冻请求并验证成功后，会解冻冻结的用户信用资产/实际资产。异步通知若商家在调用接口时传入了 notify_url 字段，订单完结后，支付宝会把相关信息以异步回调的方式推送给商家 ，商家需要处理接收。注意：接收程序执行完后必须打印输出 success。如果商家反馈给支付宝的字符不是 success 这 7 个字符，服务器会不断重发通知，直到超过 24 小时 22 分钟。对账商家可调用 传入指定日期，获得该日期账单文件的下载链接。注意：下载链接有效时长仅 30 秒，在得到链接后系统需要立刻下载账单文件。
