附录4-卡券扩展字段及签名生成算法
JSSDK使用者请读这里，JSAPI用户可以跳过
卡券签名和JSSDK的签名完全独立，两者的算法和意义完全不同，请不要混淆。JSSDK的签名是使用所有JS接口都需要走的一层鉴权，用以标识调用者的身
份，和卡券本身并无关系。其次，卡券的签名考虑到协议的扩展性和简单的防数据擅改，设计了一套独立的签名协议。另外由于历史原因，卡券的JS接口先于
JSSDK出现，当时的JSAPI并没有鉴权体系，所以在卡券的签名里也加上了appsecret/api_ticket这些身份信息，希望开发者理解。
卡券 api_ticket
卡券 api_ticket 是用于调用卡券相关接口的临时票据，有效期为 7200 秒，通过 access_token 来获取。这里要注意与
jsapi_ticket 区分开来。由于获取卡券 api_ticket 的 api 调用次数非常有限，频繁刷新卡券 api_ticket 会导致
api 调用受限，影响自身业务，开发者必须在自己的服务全局缓存卡券 api_ticket 。
1.参考以下文档获取access_token（有效期7200秒，开发者必须在自己的服务全局缓存access_token）：../15/54ce45d8d30b6bf6758f68d2e95bc627.html
2.用第一步拿到的access_token 采用http GET方式请求获得卡券 api_ticket（有效期7200秒，开发者必须在自己的服务全局缓存卡券 api_ticket）：https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=wx_card
卡券扩展字段cardExt说明
cardExt本身是一个JSON字符串，是商户为该张卡券分配的唯一性信息，包含以下字段：
| 字段 | 是否必填 | 是否参与签名 | 说明 |
|---|---|---|---|
| code | 否 | 是 | 指定的卡券code码，只能被领一次。自定义code模式的卡券必须填写，非自定义code和预存code模式的卡券不必填写。详情见： 是否自定义code码 |
| openid | 否 | 是 | 指定领取者的openid，只有该用户能领取。bind_openid字段为true的卡券必须填写，bind_openid字段为false不必填写。 |
| timestamp | 是 | 是 | 时间戳，商户生成从1970年1月1日00:00:00至今的秒数,即当前的时间,且最终需要转换为字符串形式;由商户生成后传入,不同添加请求的时间戳须动态生成，若重复将会导致领取失败！。 |
| nonce_str | 否 | 是 | 随机字符串，由开发者设置传入， 加强安全性（若不填写可能被重放请求） 。随机字符串，不长于32位。推荐使用大小写字母和数字，不同添加请求的nonce须动态生成，若重复将会导致领取失败。 |
| fixed_begintimestamp | 否 | 否 | 卡券在第三方系统的实际领取时间，为东八区时间戳（UTC+8,精确到秒）。当卡券的有效期类型为 DAT E_TYPE_FIX_TERM时专用，标识卡券的实际生效时间，用于解决商户系统内起始时间和领取时间不同步的问题。 |
| outer_str | 否 | 否 | 领取渠道参数，用于标识本次领取的渠道值。 |
| signature | 是 | - | 签名，商户将接口列表中的参数按照指定方式进行签名,签名方式使用SHA1,具体签名方案参见下文;由商户按照规范签名后传入。 |
签名说明
- 将 api_ticket、timestamp、card_id、code、openid、nonce_str的value值进行字符串的字典序排序。
- 将所有参数字符串拼接成一个字符串进行sha1加密，得到signature。
- signature中的timestamp，nonce字段和card_ext中的timestamp，nonce_str字段必须保持一致。
- code=1434008071，timestamp=1404896688，card_id=pjZ8Yt1XGILfi-
FUsewpnnolGgZk， api_ticket=ojZ8YtyVyr30Hheh2CM73y7h2jJE ，nonce_str=123
则
signature=sha1(12314048966881434008071ojZ8YtyVyr30Hheh2CM73y7h2jJEpjZ8Yt1XGILfi-
FUsewpnnolGgZk)=f137ab68b7f8112d20ee528ab6074564e2796250。
强烈建议开发者使用卡券资料包中的签名工具SDK进行签名或使用debug工具进行校验： http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=cardsign
卡券签名cardSign说明
1.将 api_ticket、appid、location_id、timestamp、nonce_str、card_id、card_type的value值进行字符串的字典序排序。
2.将所有参数字符串拼接成一个字符串进行sha1加密，得到cardSign。