凭证核销准备

支付宝平台券码的核销, 需要先调用本接口, 查询订单的凭证列表，选择要验的凭证，再调用凭证核销接口，核销券码

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/marketing/certificate/certification/preconsult' \ --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 '{ "encrypted_data":"JRTFSQW5WK1c4bmxvbnNWdUQ2Wk8", "code":"00000000000", "cross_order":false }'

{ "user_id":"2088XXXXX", "order_id":"2021042322001426261436764012", "certificate_prepare_info_list":[ { "certificate_id":"2021042322001426261436764012", "encrypted_code":"Q2Wk85Y1N0eHpRUFpMMmZwNTdFM2NKeWlFN", "order_id":"1997081101502300000001290055702988", "valid_begin_time":"2023-05-15 10:00:00", "valid_end_time":"2023-06-21 10:00:00", "sku_info":{ "sku_id":"2018091300502200001600103072", "out_sku_id":"2018091300502200001600103072", "item_id":"2018091300502200004400104166", "out_item_id":"2018091300502200004400104166", "title":"测试商品名称", "item_type":"1" }, "amount_info":{ "original_price":"10.00", "sale_price":"5.00", "receipt_amount":"4.00" }, "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

encrypted_data

string

必需

【描述】根据用户出示的核销二维码解析出来的标识【注意事项】encrypted_data/code必须二选一【示例值】JRTFSQW5WK1c4bmxvbnNWdUQ2Wk8

code

string

必需

【描述】用户出示的核销二维码下方的12位券码【注意事项】encrypted_data/code必须二选一【示例值】00000000000

cross_order

boolean

必需

【描述】是否启用跨单核销。该值默认为false 用户多次下单购买相同商品，当cross_order为true时，传入任一订单二维码信息可以获取用户多次购买该商品的所有有效券码信息。【示例值】false

示例

返回响应

🟢200成功

application/json

Body

user_id

string

可选

【描述】凭证归属支付宝用户id，核销接口使用【示例值】2088XXXXX

order_id

string

必需

【描述】购买商品的订单id，核销接口使用【示例值】2021042322001426261436764012

certificate_prepare_info_list

array [object {8}]

必需

【描述】凭证信息列表

certificate_id

string

必需

【描述】凭证id 【示例值】2021042322001426261436764012

encrypted_code

string

必需

【描述】加密券码，核销接口使用【示例值】Q2Wk85Y1N0eHpRUFpMMmZwNTdFM2NKeWlFN

order_id

string

必需

【描述】购买商品的订单id 【示例值】1997081101502300000001290055702988

valid_begin_time

string

必需

【描述】券的有效期开始时间【示例值】2023-05-15 10:00:00

valid_end_time

string

必需

【描述】券的有效期结束时间【示例值】2023-06-21 10:00:00

sku_info

object

【描述】商品信息

必需

amount_info

object

可选

【描述】凭证实例的金额信息，在异常场景下可能为空，需要判断是否有值才可进行使用。【注意事项】在网络异常的场景下此字段可能为空，商家需要保证对此字段非强诉求。

times_card_info

object

可选

【描述】商品类型为次卡时该值必填