当前位置：首页 > news >正文

如何用pass-js快速创建Apple Wallet优惠券？3步上手教程

news 2026/7/16 16:34:29

如何用pass-js快速创建Apple Wallet优惠券？3步上手教程

【免费下载链接】pass-jsApple Wallet Passes generating library for Node.JS项目地址: https://gitcode.com/gh_mirrors/pa/pass-js

想要为你的业务创建专业的Apple Wallet优惠券吗？使用pass-js这个强大的Node.js库，你可以轻松生成符合Apple Wallet标准的数字优惠券！本文将为你展示如何通过简单的3个步骤，快速创建精美实用的Apple Wallet优惠券，让你的客户一键添加到iPhone钱包中。

Apple Wallet优惠券是一种创新的数字营销工具，它可以直接存储在用户的iPhone钱包中，无需下载额外应用。通过pass-js库，开发者可以轻松生成标准的.pkpass文件，实现优惠券的快速创建和分发。这个开源项目完全免费，零运行时依赖，是创建Apple Wallet优惠券的终极解决方案。

📱 什么是Apple Wallet优惠券？

Apple Wallet优惠券是苹果公司推出的一种数字凭证格式，用户可以将优惠券、折扣码、会员卡等添加到iPhone的Wallet应用中。这种数字优惠券具有以下优势：

便捷访问：用户无需打开特定App，直接在Wallet中查看
实时更新：支持通过Web服务推送更新，如余额变化、有效期延长
安全可靠：采用数字签名技术，防止伪造
多语言支持：支持本地化文本和图片
NFC功能：部分优惠券支持NFC近场通信

使用pass-js生成的优惠券示例 - 支持多种样式和布局

🚀 准备工作：安装和配置

1. 安装pass-js库

首先，在你的Node.js项目中安装pass-js库：

npm install @walletpass/pass-js # 或者 yarn add @walletpass/pass-js

2. 获取Apple开发者证书

要创建Apple Wallet优惠券，你需要从Apple开发者中心获取Pass Type ID证书。每个Pass Type ID需要一个独立的证书。

获取证书后，你需要将其转换为.pem格式。pass-js提供了一个便捷的工具：

./bin/passkit-keys ./pathToKeysFolder

或者使用openssl命令：

openssl pkcs12 -in <certificate>.p12 -clcerts -out com.example.passbook.pem -passin pass:<password>

🎯 3步创建你的第一个优惠券

第一步：创建模板（Template）

模板是优惠券的基础框架，包含共享的字段、图片和本地化设置：

import { Template } from '@walletpass/pass-js'; // 创建优惠券模板 const template = new Template('coupon', { passTypeIdentifier: 'pass.com.example.passbook', teamIdentifier: 'YOUR_TEAM_ID', backgroundColor: '#FF5733', labelColor: '#FFFFFF', organizationName: '我的商店' }); // 加载签名证书 await template.loadCertificate( './keys/com.example.passbook.pem', 'your_password' ); // 添加共享图片 await template.images.load('./images');

模板文件通常存储在src/template.ts中，定义了优惠券的基本结构和样式。

第二步：定制个性化优惠券

基于模板创建具体的优惠券实例：

// 从模板创建优惠券 const coupon = template.createPass({ serialNumber: 'COUPON-2024-001', description: '新用户专属8折优惠', logoText: '欢迎光临' }); // 设置优惠券字段 coupon.primaryFields.add({ key: 'discount', label: '折扣', value: '20% OFF' }); coupon.secondaryFields.add({ key: 'validUntil', label: '有效期至', value: '2024-12-31' }); coupon.auxiliaryFields.add({ key: 'code', label: '优惠码', value: 'WELCOME2024' }); // 添加条形码或二维码 coupon.barcodes = [{ format: 'PKBarcodeFormatQR', message: 'COUPON-2024-001', messageEncoding: 'iso-8859-1' }];

字段管理API非常直观，支持add、get、delete等操作，详细实现可以参考src/lib/fieldsMap.ts。

第三步：生成并分发.pkpass文件

最后一步是生成Apple Wallet可识别的.pkpass文件：

import { writeFile } from 'node:fs/promises'; // 生成优惠券文件 const pkpassBuffer = await coupon.asBuffer(); // 保存到本地文件 await writeFile('my_coupon.pkpass', pkpassBuffer); // 或者在Web服务器中直接返回 app.get('/coupon/:id', async (req, res) => { res.type('application/vnd.apple.pkpass'); res.send(await coupon.asBuffer()); });

优惠券图标示例 - 支持1x、2x、3x多种分辨率

🔧 高级功能：让优惠券更强大

本地化支持

为不同地区的用户提供本地化内容：

// 添加中文支持 coupon.localization.add('zh-CN', { DISCOUNT: '折扣', VALID_UNTIL: '有效期至', CODE: '优惠码', WELCOME: '欢迎使用' }); // 添加英文支持 coupon.localization.add('en', { DISCOUNT: 'Discount', VALID_UNTIL: 'Valid Until', CODE: 'Promo Code', WELCOME: 'Welcome' });

本地化功能在src/lib/localizations.ts中有完整实现。

NFC功能集成

为会员卡类优惠券添加NFC功能：

template.nfc.message = 'member-id'; template.nfc.encryptionPublicKey = '...'; template.personalization = { description: '加入会员计划', requiredPersonalizationFields: [ 'PKPassPersonalizationFieldName', 'PKPassPersonalizationFieldEmailAddress' ], termsAndConditions: '会员条款和条件' };

日期和时间格式化

import { constants } from '@walletpass/pass-js'; coupon.primaryFields.add({ key: 'issueDate', label: '发放日期', value: new Date(), dateStyle: constants.dateTimeFormat.SHORT, timeStyle: constants.dateTimeFormat.SHORT, changeMessage: '发放日期更新为%@' });