From 2f6f6a6f065e99c0888c94f92f8a719264c6994d Mon Sep 17 00:00:00 2001
From: overtrue <anzhengchao@gmail.com>
Date: Sun, 26 Apr 2015 01:41:46 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=8D=A1=E5=88=B8=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 二维码.md     |   2 +-
 卡券.md       | 148 ++++++++++++++++++++++++++++++++++++++++++++++++++
 短链接.md     |   2 +-
 自定义菜单.md |   2 +-
 4 files changed, 151 insertions(+), 3 deletions(-)
 create mode 100644 卡券.md

diff --git a/二维码.md b/二维码.md
index 341fd9a..5a07436 100644
--- a/二维码.md
+++ b/二维码.md
@@ -19,7 +19,7 @@ $qrcode = new QRCode($appId, $secret);
 ```
 
 
-## 方法
+## API
 
 + `Bag temporary($sceneId, $expireSeconds = null)` 创建临时二维码；
 + `Bag forever($sceneValue, $type = self::SCENE_QR_FOREVER)` 创建永久二维码，`$type`: `QR_LIMIT_SCENE` 为永久, `QR_LIMIT_STR_SCENE` 为永久的字符串参数值；
diff --git a/卡券.md b/卡券.md
new file mode 100644
index 0000000..8b534cb
--- /dev/null
+++ b/卡券.md
@@ -0,0 +1,148 @@
+本 SDK 由 `Overtrue\Wechat\Card` 提供微信卡券等服务。
+
+### 获取实例
+
+```php
+<?php
+
+use Overtrue\Wechat\Card;
+
+$appId  = 'wx3cf0f39249eb0e60';
+$secret = 'f1c242f4f28f735d4687abb469072a29';
+
+$card = new Card($appId, $secret);
+```
+
+
+## API
+
++ `string create(array $base, array $properties = array(), $type = self::GENERAL_COUPON)` 创建卡券，`$base` 为微信文档上的 `$baseInfo`, `$properties` 为类型 `$type` 的其它属性；
++ `Bag get($cardId)` 卡券详情
++ `boolean update($cardId, $type, array $base = array(), array $data = array())` 更新卡券，`$base` 为微信文档上的 `$baseInfo`, `$data` 为类型 `$type` 的其它需要更新的属性；
++ `boolean delete($cardId)` 删除卡券；
++ `array lists($offset = 0, $count = 10)` 批量获取卡券列表；
++ `boolean updateStock($cardId, $amount)` 修改库存，`$amount` 用正负表示增减；
++ `boolean incStock($cardId, $amount)` 递增库存
++ `boolean decStock($cardId, $amount)` 递减库存
++ `boolean decStock($cardId, $amount)` 递减库存
++ `Bag consume($code, $cardId = null)` 卡券核销，`$code` 要消耗序列号, `$cardId` 卡券 ID。创建卡券时 use_custom_code 填写 true 时必填。非自定义 code 不必填写;
++ `Bag getCode($code, $cardId = null)`  查询 code，获取 code 的有效性(非自定义 code),该 code 对应的用户 openid、卡券有效期等信息;
++ `boolean updateCode($code, $newCode, $cardId)` 更新 code;
++ `boolean disable($code, $cardId = null)` 废弃卡券，失效，将用户的卡券设置为失效状态；
++ `string getRealCode($encryptedCode)` code 解码；
+
+特殊卡券：
+
++ `boolean memberCardActivate($cardId, array $data)` 激活/绑定会员卡：
+
+  商户调用接口创建会员卡获取 card_id,并将会员卡下发给用户,用户领取后需**激活/绑定** update 会员卡编号及积分信息。会员卡暂不支持转赠。
+
+  激活/绑定会员卡支持以下两种方式:
+    1. 用户点击卡券内 “bind_old_card_url”、“activate_url” 跳转商户自定义的 `H5` 页面,填写相关身份认证信息后,商户调用接口,完成激活/绑定。
+    2. 商户已知用户身份或无需进行绑定等操作, 用户领取会员卡后,商户后台即时调用“激活/绑定会员卡”接口 update 会员卡编号及积分信息。
+
+    注:code 与会员卡编号 `membership_number` 为一一对应关系。商户在调用相关查询、交易接口时,需使用 `code` 字段。
+
+  `$data` 如下两种可选：
+
+    ```json
+    {
+        "init_bonus": 100,
+        "init_balance": 200,
+        "membership_number": "AAA00000001", "code": "12312313",
+        "card_id": "xxxx_card_id"
+    }
+    ```
+
+    或
+
+    ```json
+    {
+        "bonus": "www.xxxx.com",
+        "balance": "www.xxxx.com",
+        "membership_number": "AAA00000001",
+        "code": "12312313",
+        "card_id": "xxxx_card_id"
+    }
+    ```
+
++ `Bag memberCardTrade($cardId, array $data)` 会员卡交易：
+
+  会员卡交易后每次积分及余额变更需通过接口通知微信,便于后续消息通知及其他扩展功
+能。
+
+  `$data` 如下：
+
+    ```json
+    {
+        "code": "12312313",
+        "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
+        "record_bonus": "消费30元，获得3积分",
+        "add_bonus": 3,
+        "add_balance": -3000
+        "record_balance": "购买焦糖玛琪朵一杯，扣除金额30元。"
+    }
+    ```
+
+  返回值：
+
+    ```json
+    {
+        "errcode":0,
+        "errmsg":"ok",
+        "result_bonus": 100,
+        "result_balance": 200,
+        "openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"
+    }
+    ```
+
++ `boolean updateMovieTicket($cardId, array $data)` 更新电影票：
+
+  领取电影票后通过调用 “更新电影票” 接口 update 电影信息及用户选座信息。
+
+  `$data` 如下：
+
+    ```json
+    {
+        "code" : "277217129962",
+        "card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI",
+        "ticket_class": "4D",
+        "show_time": 1408493192, "duration"：120, "screening_room": "5 号影厅",
+        "seat_number": [ "5 排 14 号" , "5 排 15 号" ]
+    }
+    ```
+
++ `boolean updateMeetingTicket($cardId, array $data)` 更新会议门票：
+
+  支持调用 “更新会议门票” 接口 update 入场时间、区域、座位等信息。
+
+  `$data` 如下：
+
+    ```json
+    {
+        "code": "717523732898",
+        "card_id": "pXch-jvdwkJjY7evUFV-sGsoMl7A",
+        "zone" : "C 区",
+        "entrance" : "东北门",
+        "seat_number" : "2 排 15 号"
+    }
+    ```
+
++ `boolean checkin($cardId, array $data)` 在线值机：
+
+  用户点击商户指定的 URL 在线办理登机牌。办理成功 后,商户调用本接口,将值机信息同步。
+
+  `$data` 如下：
+
+    ```json
+    {
+        "code": "198374613512",
+        "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
+        "passenger_name": "乘客姓名",
+        "class": "舱等",
+        "seat": "座位号",
+        "etkt_bnr": "电子客票号", "qrcode_data": "二维码数据", "is_cancel ": false
+    }
+    ```
+
+关于卡券接口的使用请参阅官方文档：http://mp.weixin.qq.com/wiki/9/d8a5f3b102915f30516d79b44fe665ed.html
\ No newline at end of file
diff --git a/短链接.md b/短链接.md
index 32fe7d6..585caaf 100644
--- a/短链接.md
+++ b/短链接.md
@@ -16,7 +16,7 @@ $url = new Url($appId, $secret);
 ```
 
 
-## 方法
+## API
 
 + `string short($url)` 长链接转短链接
 
diff --git a/自定义菜单.md b/自定义菜单.md
index 5fcbce4..d8bcf09 100644
--- a/自定义菜单.md
+++ b/自定义菜单.md
@@ -28,7 +28,7 @@ $menu = new Menu($appId, $secret);
 ```
 
 
-## 方法
+## API
 
 + `array $menu->get();` 读取菜单
 + `boolean $menu->set(array $menus);` 设置菜单，参数为一个包含最多三个一级菜单项的数组