通知退款结果
POST
/v1.0/badge/codes/refundResults最后修改时间:: 2 年前
责任人: 未设置
说明
用户使用钉工牌码支付后,如果发生退款,退款完成后,调用本接口同步退款结果,生成对应账单。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 钉工牌基础数据写权限 | API Explorer |
第三方企业应用 | 支持 | 钉工牌基础数据写权限 | API Explorer |
第三方个人应用 | 暂不支持 | 钉工牌基础数据写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | invalidParameter | 无效的请求参数 | 无效的请求参数 |
400 | invalidParameter | 无效请求参数 | 无效请求参数 |
400 | missingParameter | 缺少必须参数 | 缺少必须参数 |
400 | invalidPayCode | 无效payCode | 无效payCode |
400 | dataNotConsist | 数据不一致 | 数据不一致 |
400 | moneyNotConsist | 金额不一致 | 金额不一致 |
500 | unknownError | 未知错误 | 未知错误 |
500 | callAlipayFail | 调用支付宝异常 | 无效的请求参数 |
500 | callOrgFail | 调用内部通讯录异常 | 调用内部通讯录异常 |
500 | accessStorageFail | 访问存储异常 | 访问存储异常 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
corpId
string
必需
企业的corpId。
userId
string
必需
用户userid,需要与生成码时使用的userid保持一致。
tradeNo
string
交易订单号。
refundOrderNo
string
本次退款订单号。
remark
string
备注。
refundAmount
string
退款金额。
refundPromotionAmount
string
退款的优惠金额。
gmtRefund
string
必需
退款时间。格式:yyyy-MM-dd HH:mm:ss。
payChannelDetailList
array [object {7}]
支付渠道明细信息。
payChannelName
string
支付渠道名称。
payChannelType
string
必需
支付渠道类型,取值:
amount
string
金额。
payChannelOrderNo
string
支付渠道号。
payChannelRefundOrderNo
string
支付渠道退款号。
promotionAmount
string
优惠金额。
fundToolDetailList
array [object {6}]
支付资金列表。
payCode
string
必需
支付时使用的付款码。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
string
处理结果。
示例
{
"result": "string"
}
最后修改时间: 2 年前