查询、修改品牌用户名片会员卡信息

查询用户会员卡信息

通过此接口可查询指定用户会员卡的信息，如会员积分、储值余额、开卡信息等

请求参数	类型	描述
user_card_code	string	会员卡code
query	object	声明请求的查询参数
brand_id	string	品牌id
card_id	string	会员卡模版ID
openid	string	用户标识

php

$instance->v3->brand->partner->cardMember->userCards->_user_card_code_->getAsync([
  'user_card_code' => '478515832665',
  'query' => [
    'brand_id' => '1004',
    'card_id'  => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
    'openid'   => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
  ],
])
->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/user-cards/{user_card_code}')->getAsync([
  'user_card_code' => '478515832665',
  'query' => [
    'brand_id' => '1004',
    'card_id'  => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
    'openid'   => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance['v3/brand/partner/card-member/user-cards/{user_card_code}']->getAsync([
  'user_card_code' => '478515832665',
  'query' => [
    'brand_id' => '1004',
    'card_id'  => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
    'openid'   => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$response = $instance->v3->brand->partner->cardMember->userCards->_user_card_code_->get([
  'user_card_code' => '478515832665',
  'query' => [
    'brand_id' => '1004',
    'card_id'  => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
    'openid'   => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance->chain('v3/brand/partner/card-member/user-cards/{user_card_code}')->get([
  'user_card_code' => '478515832665',
  'query' => [
    'brand_id' => '1004',
    'card_id'  => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
    'openid'   => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance['v3/brand/partner/card-member/user-cards/{user_card_code}']->get([
  'user_card_code' => '478515832665',
  'query' => [
    'brand_id' => '1004',
    'card_id'  => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
    'openid'   => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
user_card_code	string	会员卡code
card_id	string	会员卡模板ID
openid	string	用户标识
card_color	string	卡背景颜色
card_picture_url	string	卡背景图URL
brand_id	string	品牌ID
card_type	string	会员卡类型 `PURCHASE` \| `NORMAL` \| `BALANCE` 枚举值之一
phone_number	string	加密的手机号
level	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天内有效
pickup_time	string	领取时间
user_information	object	用户开卡时填写的个人信息
common_field_list	object[]	平台提供的通用开卡信息字段
name	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` 枚举值之一
value	string	加密的用户开卡时填写的个人信息
custom_field_list	object[]	商户自定义的开卡信息字段
name	string	字段名称
user_chosen_values	string[]	加密的用户选择的字段值列表
attach	string	商家数据包
user_card_state	string	用户会员卡状态 `UNACTIVATED` \| `EFFECTIVE` \| `EXPIRED` \| `INVALID` 枚举值之一
invalid_reason	string	作废原因
invalid_time	string	作废时间

参阅官方文档

修改用户会员卡信息

通过此接口可更新指定用户的会员卡背景图、会员卡号、等级等信息

请求参数	类型	描述
user_card_code	string	会员卡code
json	object	声明请求的`JSON`数据结构
brand_id	string	品牌ID
openid	string	用户标识
card_color	string	卡背景颜色
card_picture_url	string	卡背景图URL
phone_number	string	加密的手机号
level	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天内有效
pickup_time	string	领取时间
user_information	object	用户开卡时填写的个人信息
common_field_list	object[]	平台提供的通用开卡信息字段
name	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` 枚举值之一
value	string	加密的用户开卡时填写的个人信息
custom_field_list	object[]	商户自定义的开卡信息字段
name	string	字段名称
user_chosen_values	string[]	加密的用户选择的字段值列表
attach	string	商家数据包
query	object	声明请求的查询参数
card_id	string	会员卡模板ID

php

$instance->v3->brand->partner->cardMember->userCards->_user_card_code_->patchAsync([
  'user_card_code' => '478515832665',
  'json' => [
    'brand_id'               => '1004',
    'openid'                 => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'phone_number'           => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
    'level'                  => '钻石会员',
    '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,
    ],
    'pickup_time'            => '2020-05-20T13:29:35.120+08:00',
    'user_information'       => [
      'common_field_list' => [[
        'name'  => 'USER_FORM_FLAG_SEX',
        'value' => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
      ],],
      'custom_field_list' => [[
        'name'               => '喜欢的运动',
        'user_chosen_values' => ['vvysDQeEaH3I+wRh14St0abIkvQyFgh/'],
      ],],
    ],
    'attach'                 => '自定义数据说明',
  ],
  'query' => [
    'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
  ],
])
->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/user-cards/{user_card_code}')->patchAsync([
  'user_card_code' => '478515832665',
  'json' => [
    'brand_id'               => '1004',
    'openid'                 => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'phone_number'           => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
    'level'                  => '钻石会员',
    '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,
    ],
    'pickup_time'            => '2020-05-20T13:29:35.120+08:00',
    'user_information'       => [
      'common_field_list' => [[
        'name'  => 'USER_FORM_FLAG_SEX',
        'value' => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
      ],],
      'custom_field_list' => [[
        'name'               => '喜欢的运动',
        'user_chosen_values' => ['vvysDQeEaH3I+wRh14St0abIkvQyFgh/'],
      ],],
    ],
    'attach'                 => '自定义数据说明',
  ],
  'query' => [
    'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance['v3/brand/partner/card-member/user-cards/{user_card_code}']->patchAsync([
  'user_card_code' => '478515832665',
  'json' => [
    'brand_id'               => '1004',
    'openid'                 => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'phone_number'           => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
    'level'                  => '钻石会员',
    '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,
    ],
    'pickup_time'            => '2020-05-20T13:29:35.120+08:00',
    'user_information'       => [
      'common_field_list' => [[
        'name'  => 'USER_FORM_FLAG_SEX',
        'value' => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
      ],],
      'custom_field_list' => [[
        'name'               => '喜欢的运动',
        'user_chosen_values' => ['vvysDQeEaH3I+wRh14St0abIkvQyFgh/'],
      ],],
    ],
    'attach'                 => '自定义数据说明',
  ],
  'query' => [
    'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$response = $instance->v3->brand->partner->cardMember->userCards->_user_card_code_->patch([
  'user_card_code' => '478515832665',
  'json' => [
    'brand_id'               => '1004',
    'openid'                 => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'phone_number'           => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
    'level'                  => '钻石会员',
    '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,
    ],
    'pickup_time'            => '2020-05-20T13:29:35.120+08:00',
    'user_information'       => [
      'common_field_list' => [[
        'name'  => 'USER_FORM_FLAG_SEX',
        'value' => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
      ],],
      'custom_field_list' => [[
        'name'               => '喜欢的运动',
        'user_chosen_values' => ['vvysDQeEaH3I+wRh14St0abIkvQyFgh/'],
      ],],
    ],
    'attach'                 => '自定义数据说明',
  ],
  'query' => [
    'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance->chain('v3/brand/partner/card-member/user-cards/{user_card_code}')->patch([
  'user_card_code' => '478515832665',
  'json' => [
    'brand_id'               => '1004',
    'openid'                 => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'phone_number'           => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
    'level'                  => '钻石会员',
    '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,
    ],
    'pickup_time'            => '2020-05-20T13:29:35.120+08:00',
    'user_information'       => [
      'common_field_list' => [[
        'name'  => 'USER_FORM_FLAG_SEX',
        'value' => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
      ],],
      'custom_field_list' => [[
        'name'               => '喜欢的运动',
        'user_chosen_values' => ['vvysDQeEaH3I+wRh14St0abIkvQyFgh/'],
      ],],
    ],
    'attach'                 => '自定义数据说明',
  ],
  'query' => [
    'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance['v3/brand/partner/card-member/user-cards/{user_card_code}']->patch([
  'user_card_code' => '478515832665',
  'json' => [
    'brand_id'               => '1004',
    'openid'                 => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
    'card_color'             => '#FFFF00',
    'card_picture_url'       => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0',
    'phone_number'           => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
    'level'                  => '钻石会员',
    '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,
    ],
    'pickup_time'            => '2020-05-20T13:29:35.120+08:00',
    'user_information'       => [
      'common_field_list' => [[
        'name'  => 'USER_FORM_FLAG_SEX',
        'value' => 'vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWY==',
      ],],
      'custom_field_list' => [[
        'name'               => '喜欢的运动',
        'user_chosen_values' => ['vvysDQeEaH3I+wRh14St0abIkvQyFgh/'],
      ],],
    ],
    'attach'                 => '自定义数据说明',
  ],
  'query' => [
    'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
user_card_code	string	会员卡code
card_id	string	会员卡模板ID
openid	string	用户标识
card_color	string	卡背景颜色
card_picture_url	string	卡背景图URL
brand_id	string	品牌ID
card_type	string	会员卡类型 `PURCHASE` \| `NORMAL` \| `BALANCE` 枚举值之一
phone_number	string	加密的手机号
level	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天内有效
pickup_time	string	领取时间
user_information	object	用户开卡时填写的个人信息
common_field_list	object[]	平台提供的通用开卡信息字段
name	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` 枚举值之一
value	string	加密的用户开卡时填写的个人信息
custom_field_list	object[]	商户自定义的开卡信息字段
name	string	字段名称
user_chosen_values	string[]	加密的用户选择的字段值列表
attach	string	商家数据包
user_card_state	string	用户会员卡状态 `UNACTIVATED` \| `EFFECTIVE` \| `EXPIRED` \| `INVALID` 枚举值之一
invalid_reason	string	作废原因
invalid_time	string	作废时间

参阅官方文档

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

区块链电子发票

自建/三方模式

二级商户授权

即时(需用户确认)模式

预约模式

电子回单

免确认

免确认

直连商户模式

合作伙伴模式

进件(融合钱包)

基础支付

账单

清关报关

查询、修改品牌用户名片会员卡信息 ​

查询用户会员卡信息 ​

修改用户会员卡信息 ​

查询、修改品牌用户名片会员卡信息

查询用户会员卡信息

修改用户会员卡信息