接入指引
收藏接入前准备
- 1.步骤1：完成交易能力的权限申请，路径：控制台-小程序-能力-解决方案，选择「交易类小程序通用」，依次开通各类能力权限（注：申请后自动审核通过）
- 2.步骤2：等待5分钟后在此路径下配置回调地址：控制台-小程序-开发-解决方案配置，然后回到上一级页面点击「发布上线」。
|
|
关键节点
关键节点 | 说明 |
商户进件 |
（注：之前已接入过担保支付或行业交易系统的开发者/服务商，无需再做进件） |
交易下单 |
|
交易履约 |
|
交易退款 |
|
交易结算与分账 |
|
退分账 |
|
提现 |
|
获取对账单 |
|
各环节说明
一、商户进件
若已接入过担保支付，或行业交易系统， 则可跳过此“进件”环节
如需要开发测试阶段与生产环境数据隔离，可以新增商户号，新商户号作为测试商户号，正式使用的商户号不会受到测试数据影响。
二、交易下单
2.1 开发步骤
2.2 收款模式(可选阅读)
- •选择一：默认收款模式
每个小程序开通的第一个商户号（即最后一位为 0 的商户号）为小程序的默认收款商户号，开发者在调用预下单接口时无需传入收款商户号，商户系统会根据小程序 appid 默认匹配尾号为 0 的商户号进行收款
- •选择二：多门店模式
随着小程序业务发展，默认收款模式无法满足部分小程序的需求，一个小程序下的不同商品可能需要收款到不同商户号中，于是衍生出多门店收款模式
如果 有多门店收款需求，请联系客服提供小程序 appid 添加多门店白名单。加入白名单后，开发者可以在下单环节在merchantUid字段将本单要使用的商户号传入，以实现不同商品/不同订单收款到不同商户号的诉求。如果小程序 appid 不在白名单内，则无法使用多门店模式
2.3 调用时序
- 1.开发者/服务商需先调用 tt.requestOrder，下单及获取拉起收银台的相关参数，可通过查询标签组信息服务，查询可传入的标签组ID（tag_group_id）
- 2.开发者/服务商调用 tt.getOrderPayment 拉起收银台，用户可在收银 台上选择支付方式并确认支付，收银台上展示的支付工具与商户开通的支付方式一致。
三、履约同步
3.1 背景说明
- 1.请先参考接入规范，确认所接的商品类型是否需要接入履约，如不需要可跳过此环节
- 2.通用交易系统梳理了不同行 业的各关键业务节点，将其映射为抽象的履约状态，同时规定了这些状态之间的流转规则
- 3.开发者需参考这套规则，使用通用交易系统提供的履约同步模式，将订单的履约状态同步给平台
（注意：平台会根据履约状态，判断订单退款时的可退金额，以及订单的可结算时间）
3.2 履约同步模式
- •模式一：tt.confirmFulfillment，拉起平台统一服务确认弹窗
作用：拉起平台提供的服务确认组件，引导用户确认关键服务交付节点（如'履约完成')，从而驱动平台订单的状态推进
- •模式二：通过履约同步openapi，由开发者同步
作用：将履约状态同步给平台，驱动平台订单的状态推进，达到关键节点（如’履约中‘）
3.3 调用时序
四、交易退款
4.1 退款入口
具体交互可参考此处
- •选择一：用户直接向开发者发起退款
用户在小程序内，向开发者直接发起退款
- •选择二：用户直接向平台发起退款
用户可以从小程序右上角「反馈」入口，选择进入「申请退款」页面（注：抖音APP版本>=27.0.0）。退款订单列表页将根据订单所属退款规则标签与订单履约状态，判断用户是否可发起此笔订单退款，及退款是否需要开发者发起审核
4.2 调用时序
场景1：用户提交申请，向开发者发起退款
注：由开发者向平台发起的退款，平台不判断订单履约状态及标签规则，均直接受理退款申请，且异步执行退款。
- •开发者需调用发起退款接口，该接口会同步响应退款申请的受理结果。
- •平台处理渠道退款结果后，返回最终退款结果。
场景2: 用户提交申请，由平台直接发起退款
- •用户在平台统一入口发起退款(入口见4.1描述)
- •平台收到退款申请后，根据订单的履约状态及标签规则，判定是否允许退款，若不允许退款则拒绝申请
- •退款申请受理后，平台将向开发者发起退款申请回调，开发者收到回调后，同步返回相关信息（若72小时后开发者仍未成功响应，系统会自动通过）
- •若此笔订单对应的规则为需要商家审核，开发者需要接入同步审核结果接口告知平台退款审核结果。平台接收到审核结果为审核通过后，开始执行退款操作，并通知最终的退款结果
- •若此笔订单对应的规则为无需审核，平台将直接执行退款，并通知最终的退款结果
五、交易结算及之后环节
开始开发
查看：API列表
