Skip to content

交易撤销接口

通过此接口发起交易撤销,注意:终态的交易不支持发起撤销请求。

业务请求参数

字段名称字段key必填格式备注
功能码funcodeMString(5)定值:order.cancel
版本号versionMString(1,8)固定值:1.0.0
应用编号appIdMString(1,40)商户后台创建的应用ID
原商户订单号orderIdMString(1,40)原正向交易订单号
撤销订单号cancelIdMString(1,40)全局保持唯一
原平台订单号transIdCString(1,40)
撤销原因reasonCString(1,256)

请求示例报文

json
{
    "appId": "000110011816681",
    "funcode": "order.cancel",
    "version": "1.0.0",
    "orderId": "6b6967ae-E27c-EAFC-26Eb-AE822fC68953",
    "cancelId": "e07DF6CD-3EDa-78Dc-1e2B-aB45EfEA5cFF",
    "reason": "test cancel"
}

接口同步返回

字段名称字段key必填类型备注
功能码funcodeMString(5)定值:order.cancel
版本号versionMString(1,8)固定值:1.0.0
应用编号appIdMString(1,40)商户后台创建的应用ID
原商户订单号orderIdMString(1,40)
商户撤销订单号cancelIdMString(1,40)
撤销订单金额cancelAmountMNumber(22)
撤销状态cancelStatusMString(4)参见 交易状态
平台撤销订单号cancelTransIdMString(0,64)
响应时间responseTimeMString(14)
响应码responseCodeMString(1,16)参见 交易响应码
响应信息responseMsgNString(1,200)参见 交易响应码
错误码errorCodeOString(1,16)请求失败时返回
参见 交易错误码
错误信息errorMsgOString(200)请求失败时返回
参见 交易错误码

返回示例报文

json
{
    "appId": "000110011816681",
    "cancelId": "e07DF6CD-3EDa-78Dc-1e2B-aB45EfEA5cFF",
    "cancelStatus": "success",
    "funcode": "order.cancel",
    "orderId": "6b6967ae-E27c-EAFC-26Eb-AE822fC68953",
    "responseCode": "success",
    "responseMsg": "请求成功",
    "responseTime": "20240108100519",
    "version": "1.0.0"
}

北京腾春科技有限公司