能力介绍
通用交易系统是平台提供的一套新的轻量级交易解决方案,开发者可以在此解决方案下,通过交易下单/履约/退款/结算等基础服务对接,完成交易闭环。另外,在这套方案里,核心以澄清「交易规则」为中心,以规则标签作为前端展示形式,同时在各交易环节对规则进行校验,从而明确用户可享受的交易权益,减少因理解不一致导致的交易纠纷,也极大提升双方的交易转化效率。
详细能力介绍请查看文档:通用交易系统能力介绍
使用场景
用户在小程序内的支付链路如下:
准入条件
支持行业如下,详细信息请见文档:小程序交易能力接入规范。
行业 | 行业类目 |
通信 |
|
咨询 |
|
工具 |
|
内容消费 |
|
接入流程
详细接入指引请查看文档:通用交易系统接入指引
根据所属行业,选择订单所属商品类型。涉及服务:tt.requestOrder
行业 | 行业类目 | 商品类型 | 商品类型枚举值 | 备注 |
通信 |
|
| 101 |
|
| 102 |
| ||
| 103 |
| ||
咨询 |
|
| 201 |
|
| 202 |
| ||
工具 |
|
| 301 |
|
内容消费 |
|
| 401 |
|
根据售卖商品,选择订单对应的标签组,一期主要以退款规则为主。涉及服务:tt.requestOrder
标签组id,即tag_group_id对应的枚举参见
行业 | 商品类型 | 规则组文案 | 规则说明 | 退款规则 |
通信 |
|
|
号码实名定制前可全额退款
号码制卡完成后如有特殊退款诉求可与卖家协商退款,号码一经激活将不再支持退款 |
|
|
|
定制类服务未受理制作前可全额退款
开始定制后如有特殊退款诉求可与卖家协商退款,定制完成交付后将不再支持退款 |
| |
|
定制类服务未受理制作前可全额退款
开始定制后不支持无理由退款 |
| ||
|
|
|
| |
咨询 |
|
|
服务开始前可全额退款
服务过程中如有特殊退款诉求可与卖家协商退款,服务完成后将不再支持退款 |
|
|
服务开始前可全额退款
服务开始后不支持退款 |
| ||
|
|
服务开始前可全额退款
服务过程中如有特殊退款诉求可与卖家协商退款,服务完成后将不再支持退款 |
| |
内容消费 |
|
|
|
|
工具 |
|
|
|
|
若售卖的是以下商品,根据以下指引选择接入履约同步服务,不在列表中的商品无需接入。涉及服务:tt.confirmFulfillment / 推送履约状态
调用时序可参考文档
商品类型的枚举值见上文
注:以下表格中,JSAPI即tt.confirmFulfillment,用于弹窗展示履约相关内容;OPENAPI即推送履约状态
商品类型 | 履约状态机 | 接入服务类型 | 弹窗确认节点 (即JSAPI的使用节点) | 履约确认弹窗文案 | 节点判定 |
号卡商品 |
|
| / | / |
|
定制服务 | / |
| |||
普通咨询 |
|
|
| 依据选择的标签组二选一:
服务开始后,本订单不再支持退款
服务开始后,本订单不再支持无理由退款,如有退款需求需与商家协商 |
|
代写文书 |
|
|
|
服务确认完成后,本订单不再支持退款 |
|
行业及对应商品类型的固定结算规则,可在账期到达后调用接口发起分账。涉及服务:发起分账
行业 | 商品类型 | 结算方式 | 结算节点 | 结算账期 |
通信 | 号卡商品/定制服务 | 履约后结算 | 履约完成 | 7天 |
虚拟充值 | 支付后结算 | 支付 | 7天 | |
咨询 | 普通咨询/预约咨询 | 履约后结算 | 履约完成 | 7天 |
代写文书 | 履约后结算 | 履约完成 | 7天 | |
工具 | 虚拟服务 | 支付后结算 | 支付 | 7天 |
内容消费 | 内容充值 | 支付后结算 | 支付 | 7天 |
接口列表
关键环节 | 接口类型 | 接口地址 | 接口描述 |
进件 | OPENAPI | 提交商户资料,开通商户号以收款或接收分账 | |
发起进件请求需要上传商户证件等图片,需要先调用图片上传接口获取image_id | |||
开发者/服务商可以通过接口主动查询进件结果 | |||
下单 | JSAPI | 提交平台下单 | |
根据返回单号,拉起收银台 | |||
OPENAPI | 可以查询所属行业及商品对应的交易标签 | ||
将用户支付成功的消息通知给开发者/服务商 | |||
开发者/服务商可以通过接口主动查询查询订单状态 | |||
履约 | JSAPI | 可通过该接口拉起平台统一服务确认弹窗 | |
OPENAPI | 开发者/服务商可以通过接口同步服务交付状态 | ||
退款 | OPENAPI | 提交平台退款 | |
通过该扩展点,告知开发者退款必要的信息 | |||
通过该接口同步商户的退款审核结果 | |||
开发者/服务商可以通过接口主动查询退款结果 | |||
将退款结果通知给开发者/服务商 | |||
结算及分账 | OPENAPI | 通过该接口发起此笔订单结算及分给其他分账方 | |
开发者/服务商可以通过接口主动查询分账结果 | |||
将分账结果通知给开发者/服务商 | |||
提现 | OPENAPI | 查询商户各渠道账户余额 | |
对可提现账户余额发起提现 | |||
开发者/服务商可以通过接口主动查询提现订单状态 |