信息同步(SPI)
接口说明(针对于预约单)
若存在以下几个非服务商发起的审核场景,抖音侧将会通过该接口进行同步审核结果,服务商系统需要感知这部分信息时可以接入该接口:
- 1.超时未收到服务商审核结果,抖音侧将自动执行退款
- 2.客服介入处理退款
- 3.来客审核流程触发退款
基本信息
HTTP URL | 需服务商提供 | |||
HTTP Method | POST | |||
请求参数
Body 请求
参数名称 | 参数类型 | 参数描 述 | 必需 | 备注 |
order_id | string | 抖音侧的订单号 | 是 | |
after_sale_id | string | 抖音侧售后单号,多张券属于同一售后单才会返回 | 否 | |
after_sale_type | int | 售后类型,枚举:1、退货退款,2、取消预约,3、仅退款 | 是 | |
notice_list | list(object) | 退款通知列表 | 是 | |
.certificate_id | string | 券id | 是 | |
.code | string | 三方码 | 是 | |
.total_count | int64 | 次卡商品总次数(仅次卡商品有) | 否 | |
.verify_count | int64 | 次卡商品已核销次数(仅次卡商品有) | 否 | |
.refund_count | int64 | 次卡商品退款次数(仅次卡商品有) | 否 | |
.origin_amount | int64 | 应退金额,应退金额=实退金额+退款违约补偿金额(仅次卡商品有) | 否 | |
.refund_amount | int64 | 实退金额(仅次卡商品有) | 否 | |
.deduct_fee_amount | int64 | 退款违约补偿金额(仅次卡商品有) | 否 | |
.sub_item_list | list(object) | 次卡商品次数信息列表(仅次卡商品有) | 否 | |
..sub_item_id | string | 次卡退款次序号(仅次卡商品有) | 否 | |
..origin_amount | int64 | 应退金额,应退金额=实退金额+退款违约补偿金额(仅次卡商品有) | 否 | |
..refund_amount | int64 | 实退金额,实退金额=营销实退金额 + 用户实退金额(仅次卡商品有) | 否 | |
..marketing_amount | int64 | 营销实退金额(仅次卡商品有) | 否 | |
..user_amount | int64 | 用户实退金额(含支付优惠退款)(仅次卡商品有) | 否 | |
..deduct_fee_amount | int64 | 退款违约补偿金额(仅次卡商品有) | 否 | |
.apply_time | int | 退款申请时间 | 是 | |
.audit_time | int | 退款审核时间 | 是 | |
.audit_result | int | 审核结果 1同意2拒绝 | 是 | |
.voucher | string | 景区多凭证,具体字段见三方码发放凭证响应参数中的vouchers数组中的结构体(单一结构,非list) | 否 | |
| | | | |
| | | | |
请求示例
POST接口附上请求体,GET接口请将请求参数拼接至请求链接后
{ "order_id": "12345678", "after_sale_id": "8762344" "notice_list": [ { "certificate_id": "987654321", "code": "abcd1234", "apply_time": 1632657476410, "audit_time": 1632657486410, "audit_result": 1, "voucher":"" } ] }
响应参数
参数名称 | 参数类型 | 参数描述 | 说明 |
data | struct | | |
.error_code | int64 | 错误码,0为成功 | |
.description | string | 错误码描述 | |
响应示例
正常示例
{ "data": { "error_code": 0, "description": "success" } }
