退款结果通知
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/v2/result_callback
使用限制
接口说明
| 名称 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| app_id | string | 是 | 小程序 id | ttcfdbb0e33350 |
| status | string | 是 | 退款状态枚举值：SUCCESS：退款成功FAIL：退款失败 | SUCCESS |
| order_id | string | 是 | 抖音开平侧订单号 | motb7057980663048 |
| refund_id | string | 是 | 抖音开平侧退款单号 | motb7014925531429 |
| refund_item_detail | Json Object | 是 | 退款商品单信息 | |
| out_refund_no | string | 是 | 开发者自定义的退款单号（可能为空) | 530402398023 |
| cp_extra | string | 是 | 退款时开发者传入字段 | test |
| refund_total_amount | int64 | 是 | 退款金额，单位分 | 9900 |
| is_all_settled | bool | 是 | 是否为分账后退款 | FALSE |
| event_time | int64 | 是 | 退款时间戳，单位为毫秒 | 1643189272388 |
| message | string | 否 | 结果描述信息，如失败原因 | 余额不足 |
| refund_type | int64 | 否 | 退款来源类型，枚举值： 1: 用户发起 2：开发者发起 4：抖音客服退款 | 1 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/v2/result_callback?timestamp=1345678901234&nonce=iuy987q4htafreqw' \
--header 'Content-Type: application/json' \
--data-raw '{
"version": "3.0", //本次固定为3.0, 通过版本信息识别，用不同的结构体去解析上述关键参数
"msg": "{\"app_id\":\"ttcfdbb96650e33350\",\"status\":\"SUCCESS\",\"order_id\":\"motb7057980663048\",\"cp_extra\":\"\",\"message\":\"\",\"event_time\":1643185934447,\"refund_id\":\"motb7014925531429\",\"out_refund_no\":\"530402398023\",\"refund_total_amount\":1,\"is_all_settled\":false,\"refund_item_detail\":{\"item_order_quantity\":1,\"item_order_detail\":[{\"refund_amount\":1,\"item_order_id\":\"motb75515980663048\"}]}}",
"type": "refund"
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_tips": "success"
}请求参数
Query 参数
timestamp
string
必需
示例值:
1345678901234
nonce
string
必需
示例值:
iuy987q4htafreqw
Header 参数
Content-Type
string
必需
示例值:
application/json
Body 参数application/json