メンバーカードエリア(2)


#8 会員カードの管理

8.1 会員情報の取得 (ポイントクエリ) インターフェース

インターフェースの説明

開発者がカード ID とコードに基づいてメンバー情報 (アクティベーション情報、ポイント情報、残高、その他の情報を含む) をクエリできるようにサポートします。

インターフェイス呼び出しリクエストの説明

HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN

パラメータの説明

##パラメータデータを投稿 IS JSONデータ#

戻りデータ

{   "card_id": "pbLatjtZ7v1BG_ZnTjbW85GYc_E8",   "code": "916679873278"}
##ボーナス ポイント情報 バランス バランス情報 性別 # User_info ## Custom_field_list 名前例: レベル値など。 現在のユーザー会員カードのステータス、NORMAL Normal EXPIRE 期限切れGIFTING 転送中 GIFT_SUCC 転送成功 GIFT_TIMEOUT 転送タイムアウト DELETE 削除済み、UNAVAILABLE 無効 会員カード表面情報、カード情報バウチャー属性情報の変更に対応しました。 
{
    "errcode": 0,
    "errmsg": "ok",
    "openid": "obLatjjwDolFjRRd3doGIdwNqRXw",
    "nickname": "Fourier",
    "membership_number": "316510891298",
    "bonus": 460,
    "sex": "MALE",
    "user_info": {
        "common_field_list": [
            {
                "name": "USER_FORM_INFO_FLAG_MOBILE",
                "value": "15521328888"
            },
            {
                "name": "USER_FORM_INFO_FLAG_NAME",
                "value": "微信"
            }
        ],
        "custom_field_list": []
    },
    "user_card_status": "NORMAL"
}
POST データ は Json データ #access_token は
パラメータ名コード、0 は正常です エラーメッセージ' の ' の桁から 0 まで コード内の固有の識別コード
ニックネーム ユーザーニックネーム
## ユーザーの性別
開発者によって設定されたメンバーシップ カードのメンバーシップ情報カテゴリ (レベルなど)。
user_card_status
8.2 会員カード情報の変更インターフェースインターフェースの説明
インターフェイス呼び出しリクエストの説明パラメータの説明
##パラメータ

呼び出しインターフェイスの資格情報

投稿データ

HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/update?access_token=TOKEN

サポート修正フィールド：

# Base_infoフィールド：

#パラメーター名タイプ128） お知らせ カードとクーポンをご確認ください。 説明 は string (3072) ##サービス電話’’ ’1 1から1 t t in bool会員証中央のジャンプボタンの名前はとなっておりますので、ご利用をお勧めいたします。##center_sub_title 説明文言なし カードの中央にあるボタンは、custom_url_name ##名前をカスタマイズします。ジャンプ入り口。 custom_url リダイレクトされた URL。 custom_url_sub_titleプロンプト。 マーケティング シナリオのカスタム エントリ名。 ## get_limit ##＃ #can_give_friendタイムスタンプ、2 の入力はサポートされていません
使用上の注意、最大文字数は漢字16文字です。
と組み合わせて使用​​することはできませんその他の特典をお楽しみください

使用説明書。
##location_id_list いいえ。 use_all_locationsNo
#trueすべてのストアをサポートし、クーポン ストアを入力しますマーチャント ストアの更新に従って更新されました。center_title
##promotion_url_name No string(16) - 商品紹介。
プロモーション URLアドレスは外部リンクにリンクします。                                                                                                              # 文字列 (18) 。 マーケティング入口の右側に表示されるプロンプト。                                                                                                            
コードコード表示タイプ「CODE_TYPE_TEXT」テキスト「CODE_TYPE_BARCODE」一次元コード "CODE_TYPE_QRCODE 二次元コード "CODE_TYPE_ONLY_QRCODE" QR コードのみ表示

"CODE_TYPE_ONLY_BARCODE"

1 次元コードのみ表示 		"CODE_TYPE_NONE"

No 何も表示しないパターン＃＃＃
# Ain_share ##ブール false
Begin_timestアンプ いいえ unsigned into 日付範囲は特別であり、開始時刻を示します。 (単位は秒)
## End_timestamp No unsigned into 。終了時刻を示します。終了時間は後でのみ延長できます。

会員カード専用フィールドの変更:

更新をサポートする以下のフィールドは、基本情報base_infoの構造には含まれていないことに注意してください。

string(3072) ポイントのクリアルール。 #バランス IS String（3072） は ワンクリックでカードを開く詳細については、自動アクティベーション# custom_field3 no                                                                                                                                                                                           FIELD_NAME_TYPE_LEVEL レベルFIELD_NAME_TYPE_COUPON クーポンFIELD_NAME_TYPE_STAMP スタンプFIELD_NAME_TYPE_DISCOUNT 割引 FIELD_NAME_TY PE_ACHIEVEMEN ACHIEVEMENTFIELD_NAME_TYPE_MILEAGE いいえ #一度に獲得できるポイントの上限 ステット ## 5 ごとポイント。 reduce_money #いいえ ##パラメータ名説明 エラー メッセージ。

開発者向けノート

1. カードとクーポンの一部のフィールドを変更した後、レビューのために再送信されます。詳細については、フィールドの説明を参照してください。更新が成功した後、確認できます。インターフェイスを呼び出してカードとクーポンの詳細を表示することにより、更新結果を確認します。;

2. 更新する必要があるフィールドのみを入力します。多くの開発者は、ブランド名などのフィールドに入力します。このインターフェイスを呼び出すときの変更はサポートされていないため、更新が失敗します。

3. このインターフェイスを呼び出してカードとクーポンの情報を変更した後、必ず カードとクーポンの詳細の表示インターフェイス を呼び出して、変更が反映されたかどうかを確認してください。成功。

8.3 推奨事項に従う設定

機能紹介

ポイント変更メッセージの下部にあるカードの構成やジャンプの設定を開発者がサポートします。チェーンURLの具体的な形式は以下の通りで、URLでもクーポンでも構いません。

领券页面

開発者向けノート

1. 次の 2 種類の推奨構成をサポートします

1. 広告スローガン URL は、販売者が 16 文字の漢字とクリックしてジャンプするリンクを使用してコピーライティングを設定できるようにします。

2. カードとクーポンを推奨し、加盟店がこの公式アカウントでカードとクーポンを設定できるようにします。

2. レコメンデーション掲載順位の有効期間制御

1. 広告スローガン URL タイプは、マーチャントがアクティビティ期間に応じて表示時間をカスタマイズできるようにサポートします。

2. 推奨されるカードとクーポンの種類 カードとクーポンの有効性は WeChat バックエンドによって決定されます カードとクーポンの有効期限が切れた場合、収集された場合、または設定されている場合無効と判断された場合は、自動的に棚から削除されて表示されます。

8.3.1 次の推奨インターフェイスを設定します

インターフェイスの説明

更新カードとクーポンを呼び出す情報インターフェイスが追加されます。 レビューに合格したカードとクーポンに推奨フィールドが更新されます。カードやクーポンを作成する際の対応するフィールドへの入力もサポートします。


インターフェースの詳細

インターフェース呼び出しリクエストの説明

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "background_pic_url": "https://mmbiz.qlogo.cn/mmbiz/0?wx_fmt=jpeg",
        "base_info": {
            "logo_url": "http:\/\/www.supadmin.cn\/uploads\/allimg\/120216\/1_120216214725_1.jpg",
            "color": "Color010",
            "notice": "使用时向服务员出示此券",
            "service_phone": "020-88888888",
            "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食\n餐前不可打包，餐后未吃完，可打包\n本团购券不限人数，建议2人使用，超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料",
            "location_id_list": [
                123,
                12321,
                345345
            ]
        },
        "bonus_cleared": "aaaaaaaaaaaaaa",
        "bonus_rules": "aaaaaaaaaaaaaa",
        "prerogative": "",
        "auto_activate": true,
        //也可以填写wx_activate"activate_url"：""
    }
}

パラメータの説明

# パラメータ名 #background_pic_url をピリットするかどうか いいえ ' ' to ' ' ' ' ' ' ' 'アウトアウトアウトスルーアウトの「s」 ‐ ‐ ‐ ‐ ‐ ‐
##bonus_rules は string(3072) ポイント ルールです。
##特権
string(3072) - 特権の説明。いいえ true の場合、カードはワンクリックでカードを開くことをサポートします。詳細については、を参照してください。 このオプションは activate_url と相互に排他的です。いいえ true に設定すると、ユーザーのメンバーシップ カードが自動的にアクティベーションに設定されます。
を参照してください。
activate_urlいいえ string(128)
リンクをアクティブにする
custom_field1 。                                                                                                                                                                                                        ​
url custom_cell1 ## ボーナス_ルール 否 JSON 構造
int Cost_bonus_unit No
#使用ボーナスの最小額 いいえ #int 割引、以下の者が享受できる割引特典。この会員カード
##エラーコード。 errmsg
send_check この更新をレビューする必要があるかどうか。true は必要であることを意味し、false は必要がないことを意味します。
パラメータ ##そうですか必要な##データを投稿します

メッセージを使用してクーポンを設定

{   "errcode":0,   "errmsg":"ok",  "send_check"：true}


メッセージを使用して URL を設定

http请求方式: POSThttps://api.weixin.qq.com/card/update?access_token=TOKEN

フィールドの説明

#フィールド名 注 Card_id URL_CELL ## リンクの推奨ビット。 Json構造の参考例。 card_id締め切り。 テキスト テキスト コンテンツ。 url ジャンプリンク。 戻りデータ
{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "modify_msg_operation": {
            "card_cell": {
                "end_time": 1452724561,
                "card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI"
            }
        }
    }
}
フィールドの説明フィールド名
## i i ID。                                                                                                                                                                                                                                                                         ​Json構造の参考例。
説明#ERRMSG

8.4 メンバーとしての支払いの設定

8.4.1 メンバーとしての支払いルール インターフェイスの追加

WeChat 支払いを開始した販売者WeChat決済後、自動的にカード回収メッセージがユーザーに送信され、ユーザーはメッセージをクリックすることで会員カードを受け取ることができます。

201610130915202689.jpg

インターフェイスの説明

加盟店による支払いルールの設定をサポートし、期間と金額の範囲に基づいてメンバーシップ カードを発行できます。

インターフェイス呼び出しリクエストの説明

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "modify_msg_operation": {
            "url_cell": {
                "end_time": 1452724561,
                "text": "更多优惠",
                "url": "www.qq.com"
            }
        }
    }
}

パラメータの説明

##パラメータJson データ POST データフィールドの説明
データを投稿 は
#access_token — は 呼び出しインターフェイスの資格情報 
{   "errcode":0,   "errmsg":"ok" }
フィールド名

注

Card_id ## カウンターバウチャー ID は、非カスタム CODE モードの Card_id と、事前に保存されたコード モードの Card_id のみをサポートします。 jump_url＃クーポンルールをサポートする商人アカウントのリスト‐    zhe_locked
Max_cost このルールの有効な支払い金額は制限されており、単位
##Q に分割されます。設定された販売者番号。デフォルトは true

戻りデータの説明

データ例:

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/add?access_token=TOKEN
パラメータ名 説明
errcode エラー コード、0 は正常を意味します。
errmsg エラー メッセージ。
succ_list ##mchid現在占有されているアプリ ID は、販売者がバインドを解除してリセットするために使用する必要があります。 。

開発者向けノート

1. メンバーシップ カード収集メッセージは 1 人の新規ユーザーに 1 回だけ送信されます。ユーザーがすでにメンバーシップ カードを受け取っている場合、またはメンバーシップ カードを受け取っている場合、メッセージは繰り返し送信されません。

2. このルールによって設定されたcard_id のクーポン appid は、現在の mch_id の対象 appid と一致している必要があり、そうでない場合はエラー 72001 が報告されます。

3. メンバーシップ カード タイプのクーポンのみがサポートされており、それ以外の場合はエラーが報告されます: 72003;

4. メンバーシップとして支払いを設定する場合、次のことを確認する必要があります。呼び出し側インターフェイスの appid が現在の Card_id 本体と一致しており、appid が mchid と一致していること バインディング関係があり、そうでない場合はエラーが報告されます: 72002;

5. mchid が以前に他の appid によって設定されていないことを確認する必要があります。そうでない場合は、エラー 72004 が報告されます;

6. 一度に設定できる mchid は 100 個のみです。 100 を超える場合は、このインターフェイスを複数回呼び出してください。

8.4.2 メンバーシップとしての支払いルールインターフェイスの削除

以前に設定されたメンバーシップとしての支払いルールを削除します。

インターフェイスの説明

加盟店による支払いルールの設定をサポートし、期間と金額の範囲に基づいてメンバーシップ カードを発行できます。

インターフェイス呼び出しリクエストの説明

{
    "card_id": "xxxxxxxxa",
    "jump_url": "mp.weixin.qq.com/wiki",
    "mchid_list": [
        "123",
        "1234",
        "12345"
    ],
    "begin_time": 146324567,
    "end_time": 147234567,
    "min_cost": 1000,
    "max_cost": 10000000,
    "is_locked": true
}

パラメータの説明

##パラメータJson データ POST データフィールドの説明
データを投稿 は
#access_token — は 呼び出しインターフェイスの資格情報 
{
    "errcode": 0,
    "errmsg": "ok",
    "succ_list"：[
    "134xxxxxx"
    ],
    "fail_list"：[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ]
}
フィールド名

注

## Card_id ## カード ID。 # MCHID_LIST

戻りデータの説明

データ例:

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/delete?access_token=TOKEN
##8.4.3 販売者番号のクエリまたは支払いまたはメンバーシップ ルール インターフェイスインターフェース呼び出しリクエストの説明
{
    "card_id": "xxxxxxxxa",
    "mchid_list": [
        123,
        1234,
        12345
    ]
}
パラメータ##必要ですか##access_token
パラメータ名 説明
errcode エラー コード、0 は正常を意味します。
errmsg エラー メッセージ。
succ_list ##mchid現在占有されているアプリ ID は、販売者がバインドを解除してリセットするために使用する必要があります。 。
インターフェイスの説明 販売アカウントがメンバーシップとしての支払い機能をサポートしているかどうかを照会できます
パラメータの説明

は' ' ' s ' s ' s with ' s ' s ‐ ‐ ‐ ‐ ‐ POST データ

{
    "errcode": 0,
    "errmsg": "ok",
    "succ_list"：[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ],
    "fail_list"：[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ]
}

フィールドの説明

##フィールド名。

戻りデータの説明

データ例:

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/get?access_token=TOKEN

8.5 WeChat 支払いカード スワイプ インターフェイスを終了するようにメンバー カードを設定します

合格 このインターフェイスは、カード スワイプ タイプをサポートするメンバーシップ カードを作成します。ユーザーがクイック支払いをクリックした後、カード スワイプ インターフェイスを引き出して支払いを行うことができます。以下は概略図です:

201610130915204982.png


#8.5.1 WeChat 支払いカード支払いをサポートするメンバーシップ カードを作成する

販売者は、WeChat 支払いスワイプをサポートする会員カードを作成でき、会員カード作成インターフェイスの JSON に次のフィールドを追加する必要があります: 

{"mchid":"xxxxxxxx"}

8.5.2 メンバーシップの更新WeChat 支払いカードのスワイプをサポートするカード

販売者は、WeChat 支払いカードのスワイプをサポートするように既存の会員カードを更新できます。また、会員カード更新インターフェイスの JSON に次のフィールドを追加する必要があります: 

{
    "errcode": 0,
    "errmsg": ok,
    "card_id": "xxxxxxxxxxxxxxxxxx",
    "occupy_appid": "wxxxxxxxxxxx",
    "is_locked": true
}


←
→

PHP中国語ウェブサイト

ホームページホームページコースコース記事記事に質問に質問辞書辞書マニュアルマニュアルダウンロードダウンロード検索検索APPダウンロード APPダウンロード