5.4 KiB
支付宝卡包
产品文档：https://docs.alipay.com/mini/introduce/voucher
配置
use EasyAlipay\Factory;
$options = [
'app_id' => '2016051900098985',
'alipay_public_key' => '支付宝公钥',
'merchant_private_key' => '应用私钥',
// ...
];
$app = Factory::marketing($options);
卡券模板创建
$app['pass']->createTemplate($tpl_id,$tpl_content);
参数说明
tpl_id：商户用于控制模版的唯一性，长度不超过999。（可以使用时间戳保证唯一性），长度不超过30。例如：20140709150010
tpl_content：模板内容信息，遵循JSON规范，长度不超过99999。详情参见：tpl_content参数说明
卡券模板更新
$app['pass']->updateTemplate($tpl_id,$tpl_content);
tpl_id：商户用于控制模版的唯一性，长度不超过999。（可以使用时间戳保证唯一性），长度不超过30。例如：20140709150010
tpl_content：模板内容信息，遵循JSON规范，长度不超过99999。详情参见：tpl_content参数说明
卡券实例发放
$app['pass']->addInstance($tpl_id,$tpl_params,$recognition_type,$recognition_info);
tpl_id：商户用于控制模版的唯一性，长度不超过999。例如：20140709150010
tpl_params：模版动态参数信息：对应模板中$变量名$的动态参数，见模板创建接口返回值中的tpl_params字段，长度不超过99999。
recognition_type：Alipass添加对象识别类型：1–订单信息。长度不超过999。
recognition_info：支付宝用户识别信息，长度不超过999。 包括partner_id（商户的签约账号）和out_trade_no（某笔订单号）。例如：{"partner_id":"2088102114633762","out_trade_no":"1234567"}
卡券实例更新
$app['pass']->updateInstance($serial_number,$channel_id,$tpl_params,$status,$verify_code,$verify_type);
参数说明
serial_number：商户指定卡券唯一值，卡券JSON模板中fileInfo->serialNumber字段对应的值，长度不超过999。
channel_id：代理商代替商户发放卡券后，再代替商户更新卡券时，此值为商户的pid/appid，长度不超过999。
tpl_params：对应模板中$变量名$的动态参数，见模板创建接口返回值中的tpl_params字段，长度不超过99999。
status：券状态，支持更新为USED、CLOSED两种状态
verify_code：核销码串值【当状态变更为USED时，建议传】。该值正常为模板中核销区域（Operation）对应的message值。长度不超过999。
verify_type：核销方式，该值正常为模板中核销区域（Operation）对应的format值。verify_code和verify_type需同时传入，长度不超过99999。
tpl_content示例
{
"logo": "https://alipass.alipay.com//temps/free/logo.png",
"strip": "https://alipass.alipay.com//temps/free/strip.png",
"icon": "http://alipassprod.test.alipay.net/temps/free/icon.png",
"content": {
"evoucherInfo": {
"title": "优惠券",
"type": "boardingPass",
"product": "free",
"startDate": "2019-07-25 15:05:22",
"endDate": "2029-12-31 23:59:59",
"operation": [{
"message": "$ackCode$",
"messageEncoding": "UTF-8",
"format": "barcode",
"altText": "$ackCode$"
}],
"einfo": {
"logoText": "优惠券",
"headFields": [{
"key": "status",
"label": "状态",
"value": "可使用",
"type": "text"
}],
"primaryFields": [{
"key": "strip",
"label": "",
"value": "凭此券即可抵扣1元",
"type": "text"
}],
"secondaryFields": [{
"key": "validDate",
"label": "有效期至：",
"value": "2029-12-31 23:59:59",
"type": "text"
}],
"auxiliaryFields": [{
"key": "key_1",
"label": "",
"value": "卡券Demo演示",
"type": "text"
}],
"backFields": [{
"key": "description",
"label": "详情描述",
"value": "1.该优惠有效期：截止至2029年12月31日；2.凭此券可以享受以下优惠：享门抵扣1元不与其他优惠同享。详询商家。",
"type": "text"
}]
},
"locations": [],
"remindInfo": {
"offset": "2"
}
},
"merchant": {
"mname": "君泓测试",
"mtel": "",
"minfo": ""
},
"platform": {
"channelID": "2088201564809153",
"webServiceUrl": "https://alipass.alipay.com/builder/syncRecord.htm?tempId=2019030622051381011176571"
},
"style": {
"backgroundColor": "RGB(255,126,0)"
},
"fileInfo": {
"formatVersion": "2",
"canShare": true,
"canBuy": false,
"canPresent": false,
"serialNumber": "$serialNumber$",
"supportTaxi": "false",
"taxiSchemaUrl": "alipays://platformapi/startapp?appId=20000778&bizid=260&channel=71322"
},
"appInfo": {
"app": {
"android_appid": "com.taobao.ecoupon",
"ios_appid": "taobaolife://",
"android_launch": "com.taobao.ecoupon",
"ios_launch": "taobaolife://",
"android_download": "http://download.taobaocdn.com/freedom/17988/andriod/Ecoupon_2.0.1_taobao_wap.apk",
"ios_download": "https://itunes.apple.com/cn/app/id583295537"
},
"label": "券券APP",
"message": "点击调起APP"
},
"source": "alipassprod",
"alipayVerify": ["qrcode", "barcode", "text", "wave"]
}
}