日历品行业交易订单退款结果通知(SPI)
抖音侧主要用作通知,返回结果不会影响最终退款结果,非超时情况下,不要返回业务错误和系统错误
接口说明
订单退款时,抖音侧通知三方系统退款结果。当订单退款时,如果订单中没有第三方订单号,则无需通知三方系统
请求头
- •Content-Type:
application/json
- •X-Bytedance-Logid: 请求 logid, 用于问题排查用
- •x-life-clientkey: 服务商应用的 client_key
- •X-life-sign: 请求签名,签名规则
请求体
接口入参 | | |||||
一级参数 | 二级参数 | 三级参数 | 名称 | 是否必填 | 参数类型 | 备注 |
» order_id | | | 抖音侧订单号 | 是 | string | |
» order_out_id | | | 第三方订单 ID | 是 | string | |
» pay_amount | | | 订单实付金额 | 是 | int | 订单实际付款总金额;针对补差价订单,实付金额取值补差子单的金额 |
» refund_amount | | | 退款金额 | 是 | int | 实际退款金额,精确分 |
» refund_time_unix | | | 退款时间 | 是 | int | 时间戳,精确到时分秒 |
» refund_type | | | 退款类型 | 是 | int | 枚举值:1、订单退款,2、补差价退款 |
请求示例
{ "order_id": "1003213027769622814", "order_out_id": "654321", "pay_amount": 2, "refund_amount": 2, "refund_time_unix":1688464299, "refund_type":1 }
响应参数
接口出参 | | ||||
一级参数 | 二级参数 | 参数名称 | 是否必填 | 参数类型 | 备注 |
» data | | | 是 | struct | |
| »» error_code | 错误编码 | 是 | int | |
| »» description | 描述信息 | 否 | string | 描述信息 |
响应示例
{ "data":{ "error_code": 0, "description": "success" } }