- 支付
- 私域
- 公域
- 营销
- 资金
- 会员
- 信用
- 安全
- 其他
同步券核销状态
开发环境
开发环境
POST
/v3/alipay/marketing/ordervoucher/activity/{activity_id}/voucher/{voucher_code}/use
alipay.marketing.activity.ordervoucher
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/marketing/ordervoucher/activity//voucher//use' \
--header 'Content-Type: application/json' \
--data-raw ''响应示例响应示例
200 - 示例 1
{
"voucher_use_detail_result_info": {
"voucher_max_un_use_times": 0
},
"activity_id": "2016042700826004508401111111"
}请求参数
Path 参数
activity_id
string
活动id
voucher_code
string
待核销的券码。
Body 参数application/json
voucher_use_detail_info
object (VoucherUseDetailInfo)
可选
voucher_use_times
integer
可选
示例值:
1
goods_detail
array[object (GoodsDetailDTO) {4}]
可选
goods_id
string
商品编号
示例值:
apple-01
goods_name
string
商品名称
示例值:
ipad
price
string
可选
示例值:
2000.00
quantity
integer
商品数量
示例值:
1
merchant_access_mode
string
商户接入模式
示例值:
AGENCY_MODE
out_biz_no
string
可选
示例值:
20170101000001654bb46ba
real_shop_id
string
可选
示例值:
2018051000502000000011111111
store_id
string
可选
示例值:
2018051000502000000011111111
total_fee
string
订单优惠前的总金额
示例值:
999.99
trade_channel
string
交易渠道。
示例值:
ZHIFUBAO_TRADE_CHANNEL
trade_no
string
可选
示例值:
2021042322001426261436764012
biz_dt
string
可选
示例值:
{}
示例
返回响应
🟢200common response
application/json
Body
voucher_use_detail_result_info
object (VoucherUseDetailResultInfo)
可选
voucher_max_un_use_times
integer
剩余可核销次数
activity_id
string
优惠券活动id
示例值:
2016042700826004508401111111
🔴500请求失败
修改于 2023-11-22 05:59:57