my.ap.prepareUseCertificate(Object object)

基础库 2.8.12 或更高版本；若版本较低，建议采取兼容处理。

主体： 企业支付宝小程序、个人支付宝小程序

相关文档： 本地生活商品产品接入流程、本地生活商品快速接入、团购券

简介

my.ap.prepareUseCertificate 本地生活商品凭证核销准备。

接入流程

凭证核销

为了确保准确接入**“凭证核销”**的能力，需要按照开发设置 > 绑定产品 > 本地生活商品接入 > 查询凭证 id > API 调用 > 凭证核销的流程接入。

1****开发设置开放平台

2****绑定产品开放平台

3****本地生活商品接入服务端

4****查询凭证 id服务端

5****API 调用小程序

6****凭证核销服务端

是否必须： 是。

使用 主账号 登录开放平台-开发设置，选择当前开发的小程序，根据下面的说明进行相关开发配置：

接口加签方式：必填

应用网关：必填

支付宝网关：必填

接口内容加密方式：选填，建议配置

服务器IP白名单：选填，涉及到敏感操作时建议配置

具体可参考文档开发设置。

入参

Object object

查看示例

属性	类型	默认值	必填	描述
certificateId	String	-	是	凭证 id 。可通过服务端接口 alipay.marketing.certificate.user.batchquery 获取
belongMerchantId	String	当前小程序请求商户 id	否	凭证归属商户 id（支付宝 id），与当前商户必须是同集团商户。如：2088721473131xxx 。
success	Function	-	否	调用成功的回调函数。
fail	Function	-	否	调用失败的回调函数。
complete	Function	-	否	调用结束的回调函数（调用成功、失败都会执行）。

success 回调函数

参数

Object res

	属性	类型	描述
	encryptedCode	String	加密 Code
	validBeginTime	Number	有效期开始时间
	validEndTime	Number	有效期结束时间
	certificateId	String	用户凭证 id
	itemId	String	支付宝平台侧商品 id
	outItemId	String	商家侧商品 id
	skuId	String	支付宝平台侧 skuId
	outSkuId	String	商家侧 skuId
	orderId	String	支付宝订单 id
	title	String	商品名称。最少不低于 3 个字符，最长不超过 60 个字符。注：商品名称是中文、数字、英文字母、特殊字符组成的字符集，且必须含有中文。
	itemType	String	商品模版类型。此字段与使用 alipay.open.app.localitem.create 接口创建本地生活商品时传入的 item_type 字段值保持一致。
枚举值描述兼容性1团购套餐-2代金券-
	amountInfo	Object	凭证实例的金额信息。在异常场景下可能为空，需要判断是否有值才可进行使用。
属性类型描述originalPriceString商品的原价，单位为元，精度为小数点后两位。如:10.00。salePriceString商品的售价，单位为元，精度为小数点后两位。如：5.00。receiptAmountString商品售价去除商家订单优惠后的商家实收，未计算收单费率等，单位为元，精度为小数点后两位。如：4.00。

错误码

fail 回调的参数为 Object，error 属性为错误码，errorMessage 属性为错误消息。

错误码	错误消息	解决方案
50022	未知的错误码 {err}	请检查参数是否正确，参考入参必填、类型和描述。
60000	凭证不存在或凭证不属于当前用户	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试。
60001	凭证不归属于该商户	检查请求参数正确性或指定有权限的 belongMerchantId 。
60002	凭证已核销或作废	凭证不可使用。
60003	凭证券码查询异常	请检查凭证券码是否正确；或可能发生了网络或者系统异常，导致服务调用失败，请稍后重试。
60004	请求限流	请稍后重试，或联系技术支持。
60005	系统繁忙	请稍后重试。

代码示例

my.ap.prepareUseCertificate(Object object)

小程序内凭证核销准备接口

my.ap.prepareUseCertificate(Object object)#

简介#

接入流程#

凭证核销#

入参#

Object object#

success 回调函数#

参数#

Object res#

错误码#

代码示例#

my.ap.prepareUseCertificate(Object object)

简介

接入流程

凭证核销

入参

Object object

success 回调函数

参数

Object res

错误码

代码示例