通知退款结果(SPI)
收藏
我的收藏接口说明
抖音侧完成退款后,通知第三方实际退款结果。
通知类型的接口 请勿返回业务类型的错误(譬如订单不存在)
基本信息
Scope | life.capacity.trip_order_after_sale_refund_notify | |||
权限要求 | 景区行业解决方案-景区退款结果通知 | |||
回调场景 | 抖音侧通知第三方景区退款结果 |
请求头
- •Content-Type:
application/json
- •X-Bytedance-Logid: 请求 logid, 用于问题排查用
- •x-life-clientkey: 服务商应用的 client_key
- •X-life-sign: 请求签名,签名规则
请求参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
order_id | string | 是 | 抖音侧订单 ID | 100001 |
order_out_id | string | 否 | 第三方订单 ID | 200001 |
biz_uniq_key | string | 是 | 业务唯一键,用于审核回调 | 123456 |
refund_amount | int | 是 | 实际退款金额,分 | 2340 |
refund_time_unix | int | 是 | 退款时间戳,秒 | 1678859904 |
refund_scene | int64 | 否 | 退款场景
| |
refund_count | int64 | 否 | 退款份数 | |
vouchers | list | 否 | 退款订单对应的凭证列表 | |
- entrance | struct | 是 | 景区的入园项目(若入园凭证是单独的凭证,则使用此字段用来传入园凭证。若不是单独的凭证,可使用自定义项目的字段传入) | |
--project_id | string | 是 | 入园项目的唯一标识,与projects中不能重复 | |
-projects | list<object> | 否 | 可自定义的项目(例:景区项目索道A、索道B等) | |
--project_id | string | 是 | 项目唯一标识 | |
请求示例
响应参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
data | struct | 是 | | |
- error_code | int | 是 | 错误码,合法范围为 [0,999999] | 0 |
- description | string | 是 | 错误信息 | |
响应示例
{ "data": { "error_code": 0, "description": "", } }
错误码
error_code | description | 备注 |
0 | | 成功 |
100 | ... | 抖音侧需要重试,其他错误码抖音不重试 |