创建及列表查询商家名片会员卡模板

创建会员卡模板

通过此接口可以创建一张会员卡模板，创建成功将获得会员卡模板card_id

请求参数	类型	描述
json	object	声明请求的`JSON`数据结构
brand_id	string	品牌ID
appid	string	商户AppId
card_type	string	会员卡类型 `PURCHASE` \| `NORMAL` \| `BALANCE` 枚举值之一
card_title	string	卡名称
card_color	string	卡背景颜色
card_picture_url	string	卡背景图URL
code_mode	string	会员卡code分配类型 `SYSTEM_ALLOCATE` \| `MERCHANT_ALLOCATE` 枚举值之一
code_type	string	会员码型 `NONE_CODE` \| `BAR_CODE` \| `QR_CODE` \| `BAR_CODE_AND_QR_CODE` \| `JUMP_MINI_PROGRAM` 枚举值之一
code_jump_information	object	会员码跳转信息
jump_appid	string	会员码跳转AppID
jump_path	string	会员码跳转路径
benefits	string	会员权益
notify_url	string	回调地址
need_pinned	boolean	是否置顶
need_display_level	boolean	是否展示会员等级
init_level	string	会员初始等级
service_phone	string	服务电话
legal_agreement	string	商家法务协议
valid_date_information	object	会员卡有效期
type	string	有效期类型 `FIX_TIME_RANGE` \| `FIX_TERM` \| `PERMANENT` 枚举值之一
available_begin_time	string	有效期开始时间
available_end_time	string	有效期结束时间
available_day_after_receive	integer	生效后N天内有效
points_information	object	积分信息
jump_appid	string	积分跳转AppID
jump_path	string	积分跳转路径
balance_information	object	储值信息
jump_appid	string	储值小程序AppID
jump_path	string	储值小程序路径
purchase_information	object	付费会员信息
price	number	付费会员价格
jump_appid	string	付费会员跳转AppID
jump_path	string	付费会员跳转路径
user_information	object	用户开卡信息
common_field_list	string[]	平台提供的通用开卡信息字段 `USER_FORM_FLAG_SEX` \| `USER_FORM_FLAG_NAME` \| `USER_FORM_FLAG_BIRTHDAY` \| `USER_FORM_FLAG_ADDRESS` \| `USER_FORM_FLAG_EMAIL` \| `USER_FORM_FLAG_CITY` 枚举值之一
custom_field_list	object[]	商户自定义的开卡信息字段
type	string	商户自定义的开卡信息字段类型 `CHECK_BOX` \| `RADIO` 枚举值之一
name	string	字段名称
values	string[]	字段值

php

$instance->v3->brand->partner->cardMember->cards->postAsync([
  'json' => [
    'brand_id'               => '1004',
    'appid'                  => 'wxea9c30890f48d5ae',
    'card_type'              => 'PURCHASE',
    'card_title'             => '测试卡',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'code_mode'              => 'SYSTEM_ALLOCATE',
    'code_type'              => 'NONE_CODE',
    'code_jump_information'  => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/code/code',
    ],
    'benefits'               => '会员折扣、专属价',
    'notify_url'             => 'https://www.weixin.qq.com/wxpay/notify.php',
    'need_pinned'            => true,
    'need_display_level'     => true,
    'init_level'             => '白银会员',
    'service_phone'          => '010-8877xxxx',
    'legal_agreement'        => '商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。',
    'valid_date_information' => [
      'type'                        => 'FIX_TIME_RANGE',
      'available_begin_time'        => '2020-05-20T13:29:35.120+08:00',
      'available_end_time'          => '2030-05-20T13:29:35.120+08:00',
      'available_day_after_receive' => 200,
    ],
    'points_information'     => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/points/points',
    ],
    'balance_information'    => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/balance/balance',
    ],
    'purchase_information'   => [
      'price'      => 100,
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/purchase/purchase',
    ],
    'user_information'       => [
      'common_field_list' => ['USER_FORM_FLAG_SEX'],
      'custom_field_list' => [[
        'type'   => 'CHECK_BOX',
        'name'   => '喜欢的运动',
        'values' => ['篮球'],
      ],],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance->chain('v3/brand/partner/card-member/cards')->postAsync([
  'json' => [
    'brand_id'               => '1004',
    'appid'                  => 'wxea9c30890f48d5ae',
    'card_type'              => 'PURCHASE',
    'card_title'             => '测试卡',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'code_mode'              => 'SYSTEM_ALLOCATE',
    'code_type'              => 'NONE_CODE',
    'code_jump_information'  => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/code/code',
    ],
    'benefits'               => '会员折扣、专属价',
    'notify_url'             => 'https://www.weixin.qq.com/wxpay/notify.php',
    'need_pinned'            => true,
    'need_display_level'     => true,
    'init_level'             => '白银会员',
    'service_phone'          => '010-8877xxxx',
    'legal_agreement'        => '商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。',
    'valid_date_information' => [
      'type'                        => 'FIX_TIME_RANGE',
      'available_begin_time'        => '2020-05-20T13:29:35.120+08:00',
      'available_end_time'          => '2030-05-20T13:29:35.120+08:00',
      'available_day_after_receive' => 200,
    ],
    'points_information'     => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/points/points',
    ],
    'balance_information'    => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/balance/balance',
    ],
    'purchase_information'   => [
      'price'      => 100,
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/purchase/purchase',
    ],
    'user_information'       => [
      'common_field_list' => ['USER_FORM_FLAG_SEX'],
      'custom_field_list' => [[
        'type'   => 'CHECK_BOX',
        'name'   => '喜欢的运动',
        'values' => ['篮球'],
      ],],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance['v3/brand/partner/card-member/cards']->postAsync([
  'json' => [
    'brand_id'               => '1004',
    'appid'                  => 'wxea9c30890f48d5ae',
    'card_type'              => 'PURCHASE',
    'card_title'             => '测试卡',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'code_mode'              => 'SYSTEM_ALLOCATE',
    'code_type'              => 'NONE_CODE',
    'code_jump_information'  => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/code/code',
    ],
    'benefits'               => '会员折扣、专属价',
    'notify_url'             => 'https://www.weixin.qq.com/wxpay/notify.php',
    'need_pinned'            => true,
    'need_display_level'     => true,
    'init_level'             => '白银会员',
    'service_phone'          => '010-8877xxxx',
    'legal_agreement'        => '商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。',
    'valid_date_information' => [
      'type'                        => 'FIX_TIME_RANGE',
      'available_begin_time'        => '2020-05-20T13:29:35.120+08:00',
      'available_end_time'          => '2030-05-20T13:29:35.120+08:00',
      'available_day_after_receive' => 200,
    ],
    'points_information'     => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/points/points',
    ],
    'balance_information'    => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/balance/balance',
    ],
    'purchase_information'   => [
      'price'      => 100,
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/purchase/purchase',
    ],
    'user_information'       => [
      'common_field_list' => ['USER_FORM_FLAG_SEX'],
      'custom_field_list' => [[
        'type'   => 'CHECK_BOX',
        'name'   => '喜欢的运动',
        'values' => ['篮球'],
      ],],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$response = $instance->v3->brand->partner->cardMember->cards->post([
  'json' => [
    'brand_id'               => '1004',
    'appid'                  => 'wxea9c30890f48d5ae',
    'card_type'              => 'PURCHASE',
    'card_title'             => '测试卡',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'code_mode'              => 'SYSTEM_ALLOCATE',
    'code_type'              => 'NONE_CODE',
    'code_jump_information'  => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/code/code',
    ],
    'benefits'               => '会员折扣、专属价',
    'notify_url'             => 'https://www.weixin.qq.com/wxpay/notify.php',
    'need_pinned'            => true,
    'need_display_level'     => true,
    'init_level'             => '白银会员',
    'service_phone'          => '010-8877xxxx',
    'legal_agreement'        => '商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。',
    'valid_date_information' => [
      'type'                        => 'FIX_TIME_RANGE',
      'available_begin_time'        => '2020-05-20T13:29:35.120+08:00',
      'available_end_time'          => '2030-05-20T13:29:35.120+08:00',
      'available_day_after_receive' => 200,
    ],
    'points_information'     => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/points/points',
    ],
    'balance_information'    => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/balance/balance',
    ],
    'purchase_information'   => [
      'price'      => 100,
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/purchase/purchase',
    ],
    'user_information'       => [
      'common_field_list' => ['USER_FORM_FLAG_SEX'],
      'custom_field_list' => [[
        'type'   => 'CHECK_BOX',
        'name'   => '喜欢的运动',
        'values' => ['篮球'],
      ],],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance->chain('v3/brand/partner/card-member/cards')->post([
  'json' => [
    'brand_id'               => '1004',
    'appid'                  => 'wxea9c30890f48d5ae',
    'card_type'              => 'PURCHASE',
    'card_title'             => '测试卡',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'code_mode'              => 'SYSTEM_ALLOCATE',
    'code_type'              => 'NONE_CODE',
    'code_jump_information'  => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/code/code',
    ],
    'benefits'               => '会员折扣、专属价',
    'notify_url'             => 'https://www.weixin.qq.com/wxpay/notify.php',
    'need_pinned'            => true,
    'need_display_level'     => true,
    'init_level'             => '白银会员',
    'service_phone'          => '010-8877xxxx',
    'legal_agreement'        => '商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。',
    'valid_date_information' => [
      'type'                        => 'FIX_TIME_RANGE',
      'available_begin_time'        => '2020-05-20T13:29:35.120+08:00',
      'available_end_time'          => '2030-05-20T13:29:35.120+08:00',
      'available_day_after_receive' => 200,
    ],
    'points_information'     => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/points/points',
    ],
    'balance_information'    => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/balance/balance',
    ],
    'purchase_information'   => [
      'price'      => 100,
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/purchase/purchase',
    ],
    'user_information'       => [
      'common_field_list' => ['USER_FORM_FLAG_SEX'],
      'custom_field_list' => [[
        'type'   => 'CHECK_BOX',
        'name'   => '喜欢的运动',
        'values' => ['篮球'],
      ],],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance['v3/brand/partner/card-member/cards']->post([
  'json' => [
    'brand_id'               => '1004',
    'appid'                  => 'wxea9c30890f48d5ae',
    'card_type'              => 'PURCHASE',
    'card_title'             => '测试卡',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'code_mode'              => 'SYSTEM_ALLOCATE',
    'code_type'              => 'NONE_CODE',
    'code_jump_information'  => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/code/code',
    ],
    'benefits'               => '会员折扣、专属价',
    'notify_url'             => 'https://www.weixin.qq.com/wxpay/notify.php',
    'need_pinned'            => true,
    'need_display_level'     => true,
    'init_level'             => '白银会员',
    'service_phone'          => '010-8877xxxx',
    'legal_agreement'        => '商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。',
    'valid_date_information' => [
      'type'                        => 'FIX_TIME_RANGE',
      'available_begin_time'        => '2020-05-20T13:29:35.120+08:00',
      'available_end_time'          => '2030-05-20T13:29:35.120+08:00',
      'available_day_after_receive' => 200,
    ],
    'points_information'     => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/points/points',
    ],
    'balance_information'    => [
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/balance/balance',
    ],
    'purchase_information'   => [
      'price'      => 100,
      'jump_appid' => 'wxea9c30a90fs8d3fe',
      'jump_path'  => '/pages/purchase/purchase',
    ],
    'user_information'       => [
      'common_field_list' => ['USER_FORM_FLAG_SEX'],
      'custom_field_list' => [[
        'type'   => 'CHECK_BOX',
        'name'   => '喜欢的运动',
        'values' => ['篮球'],
      ],],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
card_id	string	会员卡模板ID
brand_id	string	品牌ID
appid	string	商户AppId
card_type	string	会员卡类型 `PURCHASE` \| `NORMAL` \| `BALANCE` 枚举值之一
card_title	string	卡名称
card_color	string	卡背景颜色
card_picture_url	string	卡背景图URL
code_mode	string	会员卡code分配类型 `SYSTEM_ALLOCATE` \| `MERCHANT_ALLOCATE` 枚举值之一
code_type	string	会员码型 `NONE_CODE` \| `BAR_CODE` \| `QR_CODE` \| `BAR_CODE_AND_QR_CODE` \| `JUMP_MINI_PROGRAM` 枚举值之一
code_jump_information	object	会员码跳转信息
jump_appid	string	会员码跳转AppID
jump_path	string	会员码跳转路径
benefits	string	会员权益
notify_url	string	回调地址
need_pinned	boolean	是否置顶
need_display_level	boolean	是否展示会员等级
init_level	string	会员初始等级
service_phone	string	服务电话
legal_agreement	string	商家法务协议
valid_date_information	object	会员卡有效期
type	string	有效期类型 `FIX_TIME_RANGE` \| `FIX_TERM` \| `PERMANENT` 枚举值之一
available_begin_time	string	有效期开始时间
available_end_time	string	有效期结束时间
available_day_after_receive	integer	生效后N天内有效
points_information	object	积分信息
jump_appid	string	积分跳转AppID
jump_path	string	积分跳转路径
balance_information	object	储值信息
jump_appid	string	储值小程序AppID
jump_path	string	储值小程序路径
purchase_information	object	付费会员信息
price	number	付费会员价格
jump_appid	string	付费会员跳转AppID
jump_path	string	付费会员跳转路径
user_information	object	用户开卡信息
common_field_list	string[]	平台提供的通用开卡信息字段 `USER_FORM_FLAG_SEX` \| `USER_FORM_FLAG_NAME` \| `USER_FORM_FLAG_BIRTHDAY` \| `USER_FORM_FLAG_ADDRESS` \| `USER_FORM_FLAG_EMAIL` \| `USER_FORM_FLAG_CITY` 枚举值之一
custom_field_list	object[]	商户自定义的开卡信息字段
type	string	商户自定义的开卡信息字段类型 `CHECK_BOX` \| `RADIO` 枚举值之一
name	string	字段名称
values	string[]	字段值

参阅官方文档

查询会员卡模板列表

通过此接口可查询指定某品牌的所有会员卡模板列表

请求参数	类型	描述
query	object	声明请求的查询参数
brand_id	string	品牌id
state	string	状态 `CARD_EFFECTIVE` \| `CARD_INVALID` 枚举值之一
offset	integer	分页页码
limit	integer	分页大小

php

$instance->v3->brand->partner->cardMember->cards->getAsync([
  'query' => [
    'brand_id' => '1004',
    'state'    => 'CARD_EFFECTIVE',
    'offset'   => 0,
    'limit'    => 20,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance->chain('v3/brand/partner/card-member/cards')->getAsync([
  'query' => [
    'brand_id' => '1004',
    'state'    => 'CARD_EFFECTIVE',
    'offset'   => 0,
    'limit'    => 20,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance['v3/brand/partner/card-member/cards']->getAsync([
  'query' => [
    'brand_id' => '1004',
    'state'    => 'CARD_EFFECTIVE',
    'offset'   => 0,
    'limit'    => 20,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$response = $instance->v3->brand->partner->cardMember->cards->get([
  'query' => [
    'brand_id' => '1004',
    'state'    => 'CARD_EFFECTIVE',
    'offset'   => 0,
    'limit'    => 20,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance->chain('v3/brand/partner/card-member/cards')->get([
  'query' => [
    'brand_id' => '1004',
    'state'    => 'CARD_EFFECTIVE',
    'offset'   => 0,
    'limit'    => 20,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance['v3/brand/partner/card-member/cards']->get([
  'query' => [
    'brand_id' => '1004',
    'state'    => 'CARD_EFFECTIVE',
    'offset'   => 0,
    'limit'    => 20,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
total_count	integer	总数量
offset	integer	分页页码
limit	integer	分页大小
data	object[]	会员卡模板列表
card_id	string	会员卡模板ID
brand_id	string	品牌ID
appid	string	商户AppId
card_type	string	会员卡类型 `PURCHASE` \| `NORMAL` \| `BALANCE` 枚举值之一
card_title	string	卡名称
card_color	string	卡背景颜色
card_picture_url	string	卡背景图URL
code_mode	string	会员卡code分配类型 `SYSTEM_ALLOCATE` \| `MERCHANT_ALLOCATE` 枚举值之一
code_type	string	会员码型 `NONE_CODE` \| `BAR_CODE` \| `QR_CODE` \| `BAR_CODE_AND_QR_CODE` \| `JUMP_MINI_PROGRAM` 枚举值之一
code_jump_information	object	会员码跳转信息
jump_appid	string	会员码跳转AppID
jump_path	string	会员码跳转路径
benefits	string	会员权益
notify_url	string	回调地址
need_pinned	boolean	是否置顶
need_display_level	boolean	是否展示会员等级
init_level	string	会员初始等级
service_phone	string	服务电话
legal_agreement	string	商家法务协议
valid_date_information	object	会员卡有效期
type	string	有效期类型 `FIX_TIME_RANGE` \| `FIX_TERM` \| `PERMANENT` 枚举值之一
available_begin_time	string	有效期开始时间
available_end_time	string	有效期结束时间
available_day_after_receive	integer	生效后N天内有效
points_information	object	积分信息
jump_appid	string	积分跳转AppID
jump_path	string	积分跳转路径
balance_information	object	储值信息
jump_appid	string	储值小程序AppID
jump_path	string	储值小程序路径
purchase_information	object	付费会员信息
price	number	付费会员价格
jump_appid	string	付费会员跳转AppID
jump_path	string	付费会员跳转路径
user_information	object	用户开卡信息
common_field_list	string[]	平台提供的通用开卡信息字段 `USER_FORM_FLAG_SEX` \| `USER_FORM_FLAG_NAME` \| `USER_FORM_FLAG_BIRTHDAY` \| `USER_FORM_FLAG_ADDRESS` \| `USER_FORM_FLAG_EMAIL` \| `USER_FORM_FLAG_CITY` 枚举值之一
custom_field_list	object[]	商户自定义的开卡信息字段
type	string	商户自定义的开卡信息字段类型 `CHECK_BOX` \| `RADIO` 枚举值之一
name	string	字段名称
values	string[]	字段值

参阅官方文档

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

区块链电子发票

自建/三方模式

二级商户授权

即时(需用户确认)模式

预约模式

电子回单

免确认

免确认

直连商户模式

合作伙伴模式

进件(融合钱包)

基础支付

账单

清关报关

创建及列表查询商家名片会员卡模板 ​

创建会员卡模板 ​

查询会员卡模板列表 ​

创建及列表查询商家名片会员卡模板

创建会员卡模板

查询会员卡模板列表