撤销凭证核销状态

商户调用该接口进行凭证冲正处理，接口同步返回结果。

公共错误码

业务错误码

状态码	错误码	错误描述	解决方案
400	SYSTEM_ERROR	系统繁忙	可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
400	INVALID_PARAMETER	参数有误参数有误,请检查参数	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
400	CERTIFICATE_NOT_EXIST	凭证不存在或未发放	对应的凭证不存在，修改入参后进行重试。
400	CERTIFICATE_NOT_USED	凭证尚未被核销,不支持撤销核销	对应的凭证未被核销，不能撤销核销，修改入参或核销后进行重试。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/marketing/certificate/certification/refund' \ --header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \ --header 'alipay-request-id: $requestid' \ --header 'Content-Type: application/json' \ --data-raw '{ "out_biz_no":"1002600620019090123143254436", "user_id":"2088XXXXX", "use_order_no_list":[ "2023052100445005835800000045" ] }'

{ "certificate_reverse_result_list":[ { "certificate_id":"2021042322001426261436764012", "use_order_no":"2023052100445005835800000045", "result":"SUCCESS", "msg":"撤销成功" } ] }

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

out_biz_no

string

必需

【描述】外部业务单号，用作幂等控制。幂等作用：参数不变的情况下，再次请求返回与上一次相同的结果。外部接入方需保证业务单号唯一【示例值】1002600620019090123143254436

user_id

string

必需

【描述】凭证归属支付宝用户id 【示例值】2088XXXXX

use_order_no_list

array[string]

必需

【描述】已核销的凭证id.在核销接口返回不区分平台码与三方码【示例值】["2023052100445005835800000045"]

示例

application/json

Body

certificate_reverse_result_list

array [object {4}]

必需

【描述】撤销核销结果列表

certificate_id

string

可选

use_order_no

string

可选

result

string

可选

msg

string

可选

撤销凭证核销状态

公共错误码#

业务错误码#

请求参数

返回响应

公共错误码

业务错误码