景区退款审核
接口介绍
- •POST
- •抖音侧请求第三方申请退款,第三方同步或异步回调审核结果。
- •未预约的预售单退款不送审,直接通过【退款结果通知】进行通知。
- •团购订单部分退时只能按份数退款,不支持按游客维度退款。
- •对于未核销申请退款的订单,如果三方通过接口拒绝退款,订单会进入复审链路 ,此时商家可以到来客同意退款或者三方通过核销接口回传给抖音核销结果。否则,订单会在三方拒绝退款后超48小时自动同意退款。
基本信息
Scope | life.capacity.trip_order_after_sale_refund_apply | |||
权限要求 | 景区行业解决方案-景区退款审核 | |||
回调场景 | 景区申请退款 | |||
请求头
Key | 字段类型 | 示例 | 描述 |
Content-Type 必填 | String | application/json | - |
X-Bytedance-Logid 必填 | String | - | 请求LogId,用于排查问题 |
x-life-clientkey 必填 | String | - | 服务商应用的client_key |
x-life-sign 必填 | String | - |
请求参数
参数名称 | 参数类型 | 是否必填 | 是否加密 | 参数描述 |
order_id | string | 是 | 否 | 抖音订单ID, 如果是预约场景,对应预约订单ID |
order_out_id | string | 否 | 否 | 商户订单id |
biz_uniq_key | string | 是 | 否 | 业务唯一键,用于审核回调(可作幂等键) |
after_sale_type | int32 | 是 | 否 | 售后类型:1-退款;2-取消预约 |
apply_source | int64 | 否 | 否 | 申请退款类型 301 发码失败(发码失败拒绝退款需要返回补码信息) 302 过期自动退 |
apply_refund_time_unix | int64 | 是 | 否 | 申请时间戳,单位秒 |
refund_fee_amount | int64 | 是 | 否 | 退款手续费金额,单位分 |
vouchers | list<object> | 否 | 否 | 凭证列表(只有部分退/取消时,且非发码失败,才会给该字段,标识涉及取消或退款的凭证) |
-projects | list<object> | 否 | 否 | 可自定义的项目(例:景区项目索道A、索道B等) |
--project_id | string | 是 | 否 | 项目唯一标识,不能重复(核销时需要) |
响应字段
参 数名称 | 参数类型 | 是否必填 | 是否加密 | 参数描述 |
data | struct | 是 | 否 | |
- error_code | int | 是 | 否 | 错误码,合法范围为 [0,999999] 为0的场景下才会受理退款审核结果(result) |
- description | string | 是 | 否 | 错误信息 |
- audit_refund_result | int | 是 | 否 | 审核退款结果,当处理成功时必须返回,1 接受,2 拒绝 ,3 等待审核 |
- refund_fee_amount | int | 否 | 否 | 退款手续费金额,退款场景,审核退款结果为接受时必须返回,分;抖音侧如果校验此金额大于抖音侧计算的手续费金额则拒绝退款(团购场景需返回默认值0) |
-vouchers | list | 否 | 否 | 凭证列表(补码需要) |
--projects | list<object> | 否 | 否 | 可自定义的项目(例:景区项目索道A、索道B等) |
---project_id | string | 是 | 否 | 入园项目的唯一标识,同一个订单下不能重复(核销时需要) |
---name | string | 是 | 否 | 自定义的项目名称(例:景区XXXX索道) |
---id_cards | list<string> | 否 | 是 | 身份证号码,最多限100个 |
---qrcodes | list<string> | 否 | 否 | 二维码凭证,展示为二维码,每个URL长度不能超过512。 |
---urls | list<string> | 否 | 否 | url凭证 |
---certificate_nos | list<string> | 否 | 否 | 券号凭证,在C端展示为数字串,最多限100个 |
---credentials | list<object> | 否 | 否 | 证件列表 |
----credential_type | int | 是 | 否 | 凭证类型 1=身份证,2=港澳通行证,3=台湾通行证,4=回乡证,5=台胞证,6=护照,7=外籍护照,8=外国人永久居留证 |
----credential_no | string | 是 | 是 | 凭证号 |
响应示例
- •补码响应示例如下:
{ "data": { "error_code": 0, "description": "审核退款成功", "audit_refund_result": 2, "refund_fee_amount": 0, "vouchers": [ "projects": { "project_id": "proj_001", "name": "景区AAAA索道A", "qrcodes": [ "123123123" ], "certificate_nos": [ "CERT_001_2025" ], "credentials": [ { "credential_type": 1, "credential_no": "330106XXXXXXXXXXXX" } ] } ] } }
