通知支付结果
POST
/v1.0/badge/codes/payResults最后修改时间:: 2 年前
责任人: 未设置
说明
用户使用钉工牌码扫码支付完成后,可调用本接口同步支付结果,并通知用户完成消费,同时为用户记录账单。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 钉工牌基础数据写权限 | API Explorer |
第三方企业应用 | 支持 | 钉工牌基础数据写权限 | API Explorer |
第三方个人应用 | 暂不支持 | 钉工牌基础数据写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
500 | unknownError | 未知错误 | 未知错误 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
payCode
string
付款码值。
corpId
string
企业corpId。
userId
string
必需
用户userid,需要与生成码时传入的userid保持一致。
gmtTradeCreate
string
必需
交易开始时间。格式:yyyy-MM-dd HH:mm:ss。
gmtTradeFinish
string
必需
交易结束时间。格式:yyyy-MM-dd HH:mm:ss。
tradeNo
string
交易号。
tradeStatus
string
交易状态,取值:
title
string
订单标题。
remark
string
备注。
amount
string
订单金额。
promotionAmount
string
订单优惠金额。
chargeAmount
string
收费金额。
payChannelDetailList
array [object {8}]
支付渠道明细信息。
payChannelName
string
支付渠道名称。
gmtCreate
string
开始时间。
gmtFinish
string
结束时间。
payChannelType
string
必需
支付渠道类型,取值:
amount
string
支付金额。
payChannelOrderNo
string
支付渠道单号。
promotionAmount
string
优惠金额。
fundToolDetailList
array [object {6}]
资金工具明细。
tradeErrorCode
string
可选
支付失败错误码,当tradeStatus为FAIL时必须传入。
tradeErrorMsg
string
可选
支付失败信息,当tradeStatus为FAIL时必须传入。
extInfo
string
扩展信息。
merchantName
string
商户名称。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
string
处理结果,取值:
示例
{
"result": "string"
}
最后修改时间: 2 年前