接入指引

​接入前准备​

1.​步骤1：完成交易能力的权限申请，路径：控制台-小程序-能力-解决方案，选择「交易类小程序通用」，依次开通各类能力权限（注：申请后自动审核通过）​

2.​步骤2：等待5分钟后在此路径下配置回调地址：控制台-小程序-开发-解决方案配置，然后回到上一级页面点击「发布上线」。​

​关键节点​

​各环节说明​

​一、商户进件 ​

​先参照：担保支付|企业版 接入指引_小程序_抖音开放平台，进件环节流程一致，api以此文档下api为准​

​二、交易下单​

​2.1 开发步骤​

​2.2 收款模式(可选阅读)​

•​选择一：默认收款模式 ​

•​选择二：多门店模式 ​

​2.3 调用时序​

1.​开发者/服务商需先调用 tt.requestOrder，下单及获取拉起收银台的相关参数，可通过查询标签组信息服务，查询可传入的标签组ID（tag_group_id）​

2.​开发者/服务商调用 tt.getOrderPayment 拉起收银台，用户可在收银台上选择支付方式并确认支付，收银台上展示的支付工具与商户开通的支付方式一致。 ​

3.​用户支付后，平台会通过支付结果回调告知开发者/服务商支付结果，但回调可能存在延迟或丢失。该笔交易付款是否成功，建议开发者/服务商的服务端以主动查询订单信息为准。​

​三、履约同步​

​3.1 背景说明​

1.​请先参考接入规范，确认所接的商品类型是否需要接入履约，如不需要可跳过此环节​

2.​通用交易系统梳理了不同行业的各关键业务节点，将其映射为抽象的履约状态，同时规定了这些状态之间的流转规则​

3.​开发者需参考这套规则，使用通用交易系统提供的履约同步模式，将订单的履约状态同步给平台​

​3.2 履约同步模式​

•​模式一：tt.confirmFulfillment，拉起平台统一服务确认弹窗​

•​模式二：通过履约同步openapi，由开发者同步​

​3.3 调用时序​

​四、交易退款​

​4.1 退款入口​

​具体交互可参考此处​

•​选择一：用户直接向开发者发起退款​

•​选择二：用户直接向平台发起退款​

​4.2 调用时序​

​注：由开发者向平台发起的退款，平台不判断订单履约状态及标签规则，均直接受理退款申请，且异步执行退款。​

•​开发者需调用发起退款接口，该接口会同步响应退款申请的受理结果。​

•​平台处理渠道退款结果后，返回最终退款结果。​

•​用户在平台统一入口发起退款(入口见4.1描述)​

•​平台收到退款申请后，根据订单的履约状态及标签规则，判定是否允许退款，若不允许退款则拒绝申请​

•​退款申请受理后，平台将向开发者发起退款申请回调，开发者收到回调后，同步返回相关信息（若72小时后开发者仍未成功响应，系统会自动通过）​

•​若此笔订单对应的规则为需要商家审核，开发者需要接入同步审核结果接口告知平台退款审核结果。平台接收到审核结果为审核通过后，开始执行退款操作，并通知最终的退款结果​

•​若此笔订单对应的规则为无需审核，平台将直接执行退款，并通知最终的退款结果​

​五、交易结算及之后环节​

​先参照：担保支付|企业版 接入指引_小程序_抖音开放平台​

​开始开发​

​查看：API列表​