查询凭证信息
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/marketing/certificate/certification/batchquery
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | SYSTEM_ERROR | 服务器异常 | 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | INVALID_PARAMETER | 参数有误参数有误参数有误参数有误参数有误参数有误参数有误,请检查参数 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/marketing/certificate/certification/batchquery' \
--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 '{
"user_id":"2088XXXXX",
"order_id":"2021042322001426261436764012",
"certificate_id_list":[
"2023081100445005155200003598",
"2023081100445005155200003599"
]
}'响应示例响应示例
200 - 成功示例
{
"certificate_info_list":[
{
"certificate_id":"2023052800445005825800000196",
"code":"123AB",
"status":"UNUSE",
"valid_begin_time":"2023-01-01 00:00:00",
"valid_end_time":"2023-03-31 23:59:59",
"out_order_id":"2023073101",
"amount_info":{
"original_price":"10.00",
"sale_price":"5.00",
"receipt_amount":"4.00"
},
"sku_info":{
"sku_id":"2018091300502200001600103072",
"out_sku_id":"2018091300502200001600103072",
"item_id":"2018091300502200004400104166",
"out_item_id":"2018091300502200004400104166",
"title":"测试商品名称",
"item_type":"1"
},
"use_rule_info":{
"use_num_limit":"{\"limit\":\"1\",\"num\":\"3\"}",
"use_limit":"{\"use_time_type\":\"2\",\"use_date_list\":[{\"days_of_week\":[\"1\",\"7\"],\"start_time\":\"HH:mm:ss\",\"end_time\":\"HH:mm:ss\",\"end_time_type\":\"SAME_DAY\"}],\"can_no_use_date_list\":[{\"holidays\":[{\"start_time\":\"HH:mm:ss\",\"end_time\":\"HH:mm:ss\",\"end_time_type\":\"SAME_DAY\"}]}]}"
},
"times_card_info":{
"total_count":10,
"used_count":0,
"serial_info_list":[
{
"serial_no":"11111",
"status":"USED",
"amount_info":{
"original_price":"10.00",
"sale_price":"5.00",
"receipt_amount":"4.00"
}
}
]
}
}
]
}请求参数
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
返回响应
修改于 2023-11-22 02:09:48