发起退款
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.toutiao.com/api/apps/ecpay/v1/create_refund
接口说明
1.
2.
3.
4.
5.
6.
7.
基本信息
| 基本信息 | |
|---|---|
| 请求URL | 正式环境： https://developer.toutiao.com/api/apps/ecpay/v1/create_refund 沙盒环境： https://open-sandbox.douyin.com/api/apps/ecpay/v1/create_refund |
| 请求方式 | POST |
| 接口频次 | 50QPS(小程序app_id维度) |
错误码
| 错误码 err_no | 错误描述 err_tips | 排查建议 |
|---|---|---|
| 0 | success | 注：该响应代表退款业务受理成功，系统开始处理退款。最终退款结果以异步回调或查询接口为准。 |
| 1000 | 内部异常 | 当前请求的退款可能受理成功也可能失败。 1、请使用相同的参数再次重试调用，需要保证退款请求号和退款金额不能变更。如果前一次退款请求已经受理成功，接口会幂等返回受理成功；如果前一次退款请求没有成功，接口会重试执行退款操作； 2、或者通过退款查询接口查询退款执行结果 |
| 1001 | 业务繁忙，请稍后重试 | 该笔退款未受理，请降低频率后重试 |
| 1090 | 风控拦截 | 联系小程序平台处理 |
| 1093 | 系统异常，请稍微再试 | 请稍后原单号重试，同一笔交易的退款至少间隔3s后发起 |
| 2000 | 支付记录不存在 | 检查请求中的支付单号或商户支付单号是否正确，确认后重新发起 |
| 2004 | 当日金额或笔数超限，请明天再试 | 退款金额或笔数超限，请明天再试，详见退款常见问题 |
| 2008 | 签名校验异常，请使用正确的签名 | 请使用正确的签名重新请求，详见签名DEMO |
| 2010 | 参数错误 | 请检查参数后重试 |
| 2012 | 旧平台账户订单不支持分账后退款 | 建议联系买家进行线下退款处理 |
| 2013 | 服务商无对应小程序分账授权 | 联系小程序平台处理 |
| 2042 | 小程序appid无效，请检查app_id字段 | 检查app_id字段信息是否有误 |
| 2045 | 请求来源不合法 | 联系小程序平台处理 |
| 2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
| 2048 | 未查询到服务商与小程序的授权关系 | 检查服务商与小程序的授权关系 |
| 3000 | 业务异常 | 可通过查单接口确定退款状态和退款原因， 不能解决的联系小程序平台处理 |
| 3118 | 原支付单状态非法，不允许退款 | 查询支付是否为付成功状态 |
| 3141 | 分账后退款，请等待分账全部完成后再试 | 请等待分账全部完成后重试 |
| 4001 | 退款已失败 | 此笔退款 已失败，请换单号重试 |
| 4003 | 退款金额无效 | 请检查退款金额是否正确，请求的退款金额不能大于支付总金额 |
| 4004 | 退款金额超限 | 请确认退款金额后原单重试 |
| 4010 | 请求信息不一致 | 幂等校验失败，同一个退款多次请求必须为同一个支付单并且金额相等，请检查参数后重试 |
| 4011 | 已超过退款期限 | 退款时间超过一年，无法退款，详见退款常见问题 |
| 4039 | 退款次数超过限制 | 建议联系买家进行线下退款处理 |
| 4100 | 风控分账失败导致退款失败 | 联系小程序平台处理 |
| 4101 | 服务商与特约子商户关系上，该产品授权已被解除 | 联系小程序平台处理 |
| 4102 | 商户没有退款权限 | 联系小程序平台处理 |
| 4103 | 原支付交易被冻结 | 联系小程序平台处理 |
| 4104 | 商户担保产品权限已被冻结 | 联系小程序平台处理 |
| 4105 | 退款商家账户余额不足 | 现无充值入口，可等待商家现金户入账，换单号重试 |
| 4200 | 用户账户有异常行为，已被限制收款，本次交易无法完成 | 建议联系买家进行线下退款处理 也可联系用户在微信解除限制，换单号重试 |
| 4201 | 用户账户状态异常或注销，无法原路退款 | 建议联系买家进行线下退款处理 |
| 4202 | 用户账户状态异常无法退款 | 商户现金户余额不足无法原路退且用户账户状态异常无法实现退款，请等待商户现金户余额充足再次发起退款或联系买家进行线下退款处理 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/v1/create_refund' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id": "tt07e3715e98c9aac0",
"out_order_no": "7056505317450041644",
"out_refund_no": "401020220222383672284706009088",
"reason": "发错地址退款重新下单",
"refund_amount": 12800,
"sign": "d716027b7b5a91a3319a061d818cc9cc",
"cp_extra": "一些附加信息",
"notify_url": "https://douyin.com/callback"
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_tips": "string",
"refund_no": "string"
}请求参数
Header 参数
Content-Type
string
必需
Body 参数application/json
返回响应
修改于 2023-12-04 08:53:43