商家发起订单退款
基本信息
HTTP URL | ||||
HTTP Method | POST | |||
请求参数
Header:
参数名称 | 参数类型 | 必须参数 | 备注 |
» content-type | string | 必填 | application/json |
» access-token | string | 必填 | |
Body:
参数名称 | 参数类型 | 必须参数 | 备注 |
» account_id | string | 必填 | 账户id |
» order_id | string | 必填 | 抖音订单id |
» order_out_id | string | 选填 | 外部订单id |
» out_after_sale_id | string | 必填 | 三方售后单id |
» refund_list | list<trade/common/biz_common.RefundInfo> | 必填 | |
»» order_item_id | string | 必填 | 跟创单的item单id一致,主单itemId必填 配送费无需指定,抖音自行处理; 打包费id无需填入,只需要给到item_type=3 |
»» item_type | enum(trade/common/biz_common.RefundItemTypeEnum) | 必填 | 1=商品 2=配送费 3=打包费 |
» refund_reason | int | 必填 | 退款原因 // 联系不上用户 = 524 // 商品缺货/无货 = 715 // 商家已打样 = 405 // 商家订单太多忙不过来 = 162 // 超出配送范围 = 505 // 没有配送员接单 = 506 // 商家未接单取消 = 906 // 商品质量问题 = 1611 // 大小/尺寸/质量与商品描述不符 = 643 // 商品腐烂/变质 = 1614 // 包装/商品破损 = 515 // 商品过期 = 1615 // 商品化冻/融化 = 1616 // 与用户协商一致退款 = 1617 // 其他理由 = 999 |
» handle_time | int | 必填 | 时间戳,秒 |
» operator_id | string | 选填 | 操作人id |
» operator_name | string | 选填 | 操作人名称 |
» merchant_desc | string | 选填 | 商家备注 |
» after_sale_type | int | 必填 | 退货退款(1) 仅退款(3) 核销前退款,只能发起退货退款 |
» apply_source | int | 必填 | const ( // 商家核销前退款 ApplySourceEnum_MerchantBeforeFulfil ApplySourceEnum = 102 // 商家核销后退款 ApplySourceEnum_MerchantAfterFulfil ApplySourceEnum = 310 ) 注意用户发起,商户发起值不同 |
json示例
{ "order_id": "fnSzfoNz82", "order_out_id": "0BdwlE5DnP", "refund_reason": 76, "operator_id": 4389325350350326656, "operator_name": "NL5tvV0WGT", "merchant_desc": "j0LL06MoYS", "refund_list": [ { "order_item_id": "QeWiMXboU7", "item_type": 2 } ] }
返回参数
Body:
参数名称 | 参数类型 | 必须参数 | 备注 |
» Extra | object(common/openapi_common.ExtraBody) | 选填 | |
»» logid | string | 必填 | |
»» now | int | 必填 | |
»» error_code | int | 必填 | |
»» description | string | 必填 | |
»» sub_error_code | int | 必填 | |
»» sub_description | string | 必填 | |
» data | object(trade/biz_openapi/biz_openapi.DeliveryOrderApplyRefundResponseData) | 必填 | |
»» order_id | string | 必填 | |
»» after_sale_id | string | 必填 | |
»» success | bool | 必填 | |
json示例
{ "data": { "order_id": "1HqK6nfdOR", "success": false }, "Extra": { "logid": "tDvF6YRdJV", "now": 5109029405089483143, "error_code": 44789761, "description": "BaxIoupRPy", "sub_error_code": 985428888, "sub_description": "fOTuicmRht" } }
