通知退款结果

说明

用户使用钉工牌码支付后，如果发生退款，退款完成后，调用本接口同步退款结果，生成对应账单。
服务地址：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

必需

支付时使用的付款码。

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码