# wx.openCard(Object object)

> 基础库 1.1.0 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：支持
> 
> __小程序插件__：不支持
> 
> __微信 鸿蒙 OS 版__：支持

## 功能描述

查看微信卡包中的卡券。只有通过 [认证](/miniprogram/product/renzheng.md) 的小程序或文化互动类目的小游戏才能使用。更多文档请参考 [微信卡券接口文档](https://mp.weixin.qq.com/cgi-bin/announce?action=getannouncement&key=1490190158&version=1&lang=zh_CN&platform=2)。

## 参数

### Object object


```json
[
  {
    "属性": "cardList",
    "类型": "Array.<Object>",
    "默认值": "",
    "必填": "是",
    "说明": "需要打开的卡券列表",
    "子项": [
      {
        "结构属性": "cardId",
        "类型": "string",
        "默认值": "",
        "必填": "是",
        "说明": "卡券 ID"
      },
      {
        "结构属性": "code",
        "类型": "string",
        "默认值": "",
        "必填": "是",
        "说明": "由 [wx.addCard](/miniprogram/dev/api/open-api/card/wx.addCard) 的返回对象中的加密 code 通过解密后得到，解密请参照：[code 解码接口](https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1499332673_Unm7V)"
      }
    ]
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数"
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数"
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）"
  }
]
```

## 示例代码

```js
wx.openCard({
  cardList: [{
    cardId: '',
    code: ''
  }, {
    cardId: '',
    code: ''
  }],
  success (res) { }
})
```