发起退分账
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.toutiao.com/api/apps/ecpay/v1/create_return
接口说明
1.
2.
3.
4.
5.
错误码
| 错误码err_no | 描述 | 排查建议 |
|---|---|---|
| 0 | success | |
| 1000 | 系统错误 | 当前请求的退款可能成功也可能失败。1、请使用相同的参数再次重试调用，需要保证退款请求号和退款金额不能变更。如果前一次退款请求已经处理成功，接口会幂等返回成功；如果前一次退款请求没有成功，接口会重试执行退款操作；2、或者通过退款查询接口查询退款执行结果 |
| 2008 | 验签异常 | 请检查参数，详见签名DEMO |
| 2020 | 非法app_id | 请检查参数后再发起重试 |
| 2101 | 平台分账单号与商户原分账单号不能同时为空 | 请检查参数后，原单号重试 |
| 2102 | 退分账单号位数必须在0到64之间 | 请检查参数，原单号重试 |
| 2103 | 回退金额必须大于0 | 请检查参数，原单号重试 |
| 2104 | 回退描述长度必须在0到100之间 | 请检查参数，原单号重试 |
| 2105 | 回退出资方商户号不能为空 | 请检查参数，原单号重试 |
| 2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
| 3000 | 系统内部错误 | 可通过查单接口确定回退状态和失败原因，不能解决的联系小程序平台处理 |
| 4010 | 请求信息不一致，相同ma_app_id和out_return_no的多次请求为幂等请求，幂等请求需要保证多次参数的一致性 | 请检查参数后重试 |
| 4401 | 回退次数超过限制微信对同一个分账接收方最多能发起20次分账回退请求 | 建议联系分账方或者合作方进行线下处理 |
| 4402 | 未找到相应分账单 | 检查请求中的分账单号或商户分账单号是否正确，确认后重新发起 |
| 4403 | 分账状态非法，原分账单未到终态，不允许回退 | 查询分账是否为成功状态 |
| 4404 | 回退金额大于分账金额 | 请检查回退金额 是否正确，请求的回退金额不能大于分账总金额 |
| 4405 | 退分账出资方不正确，为无效商户号 | 请检查回退商户号字段，回退商户号需要为原发起结算及分账单的接收方商户号 |
| 4406 | 请求回退金额超出可回退金额 | 请确认回退金额后原单重试 |
| 4407 | 退分账接收方账户状态异常 | 联系小程序平台处理 |
| 4409 | 订单已超过回退期限，微信180天支付宝12个月 | 建议联系分账方或者合作方进行线下处理 |
| 4410 | 退分账接收方账户不存在 | 联系小程序平台处理 |
请求参数
Header 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/v1/create_return' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id": "tt07e3715e98c9aac0",
"out_settle_no": "sd_T220416122114165008287419707173",
"settle_no": "N7067781639492913452",
"out_return_no": "out_return_7067781639492913452",
"merchant_uid": "M7067781639492913452",
"return_amount": 30,
"return_desc": "分账回退demo",
"cp_extra": "2856",
"sign": "d98e6af1c490b36f7b72e2037f81a511"
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_tips": "string",
"return_info": {
"app_id": "string",
"thirdparty_id": "string",
"settle_no": "string",
"out_settle_no": "string",
"out_return_no": "string",
"merchant_uid": "string",
"return_amount": 0,
"return_status": "string",
"return_no": "string",
"fail_reason": "string",
"finish_time": 0,
"cp_extra": "string"
}
}修改于 2023-12-05 02:04:35