Kawasan Kad Ahli (2)


8 Urus Kad Keahlian

8.1 Tarik Maklumat Ahli (Pertanyaan Mata) Antara Muka

Penerangan Antara Muka

Menyokong pemaju untuk menanyakan maklumat ahli berdasarkan kad_id dan Kod, termasuk maklumat, baki pengaktifan dan maklumat lain .

Interface Call permintaan Keterangan

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

parameter Keterangan

json data Call Interface kelayakan POS data
Parameters adalah diperlukan is
access_token is
{   "card_id": "pbLatjtZ7v1BG_ZnTjbW85GYc_E8",   "code": "916679873278"}
Nama parameter            

Adakah diperlukan                 
cardid​ ​ ​ is ​ ​ ​ Soal kad kad keahlian ​​​
kod ​ ​ ​ adalah ​ ​ pertanyaan Nilai kod yang diterima oleh pengguna

return data

{
    "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"
}
eerrmsg Kod Pengenalan CnickName Pengguna Nickname bonus Maklumat Mata Balance Baki Maklumat Sex User Gender_info Maklumat Ahli custom_field_list Kategori maklumat keahlian kad keahlian yang ditetapkan oleh pembangun, seperti tahap. Nama kategori maklumat ahli T_TIMEOUT Pemindahan tamat masa DELETE Dipadam, UNAVAILABLE telah tamat tempoh 8.2 Tukar antara muka maklumat kad keahlian Interface Call Request Description
HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/update?access_token=TOKEN
eparameters adalah diperlukan is json data access_token is call kelayakan antara muka

DATA POST

{
    "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":""
    }
}

menyokong mengubah suai medan:

medan_maklumat asas:

parameter Nama Penerangan ke
Penerangan antara muka Menyokong menukar maklumat permukaan kad keahlian dan maklumat atribut kad.
parameter Description
LOGO kupon kad, adalah disyorkan bahawa piksel ialah 300*300.                                                                                                                                                                                                                                           Nombor telefon perkhidmatan pelanggan.                                                                                                                                                                                                                                                      Warna kupon.                                                                                                                                                                                                                                                                            Sokongan mengemas kini senarai kedai yang berkenaan. . … tengah kad keahlian                                                                                                                                                                                                                              Sesuaikan URL yang diubah hala. Gegaran yang dipaparkan di sebelah kanan pintu masuk.                                                                                                                                                                                                                                           ​ ​ ​​ ​ Nama pintu masuk tersuai untuk senario pemasaran. _TEKS. "CODE_TYPE_ONLY_BARCODE" Sama ada Sama ada boleh atau tidak pungutan kad can_give_friendly Khas untuk julat tarikh tetap, menunjukkan masa tamat. Masa akhir hanya boleh dilanjutkan kemudian. ​ ​
nama parameter                                                                                                                                                                                                                                                                                                                                             Pengesahan kod untuk kad dan kupon. 上 Gunakan peringatan, had atas perkataan ialah 16 aksara Cina.                                                                                                                                                                                                                                                     Berkongsi diskaun dengan orang lain Arahan penggunaan.                                                                                                                                                                                                                                                                 ​
center_sub_title                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             - Sesuaikan nama pintu masuk lompat.                                                                                                                                                                                                                                        
Pintu masuk melompat ke pautan alamat pautan luaran.                                                                                               Tidak string (18) Diskaun besar di kedai. ​ ​ ​ Gesaan dipaparkan di sebelah kanan pintu masuk pemasaran.                                                                                                                                                                                                                                                                 
Jenis paparan kod kod, "CODE_TYPE_TEXT" teks "CODE_TYPE_BARCODE" kod satu dimensi "CODE_TYPE_QRCODE QR code

"CODE_TYPE_BARCODE" paparan kod QR_

SAHAJA             

Hanya paparan satu kod QR

"CODE_TYPE_NONE"

tidak memaparkan sebarang corak kod

MGet_limit
IINT 1 Bilangan setiap orang boleh menerima baucar terhad CAN_SHARE
dikongsi bersama
date_info                                                                                                               Peluasan julat yang sah                                                                                                                                                                                                                                tidak disokong begin_timestamp No unsigned int 14300000 Khas untuk julat tarikh tetap, menunjukkan masa pengaktifan. (Unit ialah saat)                                        

Pengubahsuaian medan eksklusif kad ahli:

Perhatian khas bahawa medan berikut yang menyokong pengemaskinian tiada dalam struktur asas_info maklumat.​​​​     

Tidak                                                                                                                                                                                                                                 ​ ​ string(3072) Peraturan pembersihan mata. ​ ​ ​ ​ bonus_rules ​ ​ ​ ialah ​ ​ ​ string(3072) ​ ​ ​ peraturan mata. ​ ​​ ​ peraturan_imbangan ​ ​ ialah ​ ​ ​ ​ rentetan(3072) ​ ​ perihalan nilai tersimpan.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         IWX_ACTIVATE Sama ada untuk membuka kad satu klik atau tidak untuk membuka kad Apabila anda menetapkannya kepada Benar, kad akan menyokong butiran kad satu klik. Pilihan ini saling eksklusif dengan activate_url.                                                                                                                                                                                                                                                                                       Kad ditetapkan secara automatik untuk diaktifkan Pengaktifan AutomatikFIELD_NAME_TYPE_STAMP Cop FIELD_NAME_TYPE_TYPEKategori Maklumat Ahli -ahli Kadar yang Diaktifkan oleh Kad Keahlian diaktifkan points meningkat mengikut jumlah penggunaan di atas Tidak                                                                                                                           Pengguna Mata awal diperolehi selepas pengaktifan kos_bonus_unit kos_bonus_unit int 5 mata setiap penggunaan                                                                                                                                                                                                                                   duit_minimum_untuk_menggunakan_bonus             errmsg​​​​​​
Lihat untuk butiran. ​
Activate_Urlno string (128)
Activate link
custom_field1 mengomentasi kategori maklumat keahlian, yang akan dipaparkan selepas kad keahlian diaktifkan.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             FIELD_NAME_TYPE_LEVEL Level FIELD_NAME_TYPE_COUPON Kupon
FIELD_NAME_TYPE_DISKAUN FIELD_NAME_TYPE FIELD_NAME_TYPE_STAMP PE_MILEAGE Batu Batu
bonus_rule ney_unit peningkatan bonus no int
bonus_peningkatan_maks
Tiada
Tidak ​                                                                Nama parameter                                                                                                                                                                                                              kod biasa, ​​​​​​​
Mesej ralat. E Send_Check Sama ada kemas kini ini perlu disemak kali ini, Benar diperlukan dan palsu tidak diperlukan. ​ ​

Nota Pembangun

1. Selepas menukar beberapa medan kad dan kupon, ia akan diserahkan semula untuk semakan dan antara muka butiran kupon;

2 Hanya Isikan medan yang perlu dikemas kini.

3 Selepas menghubungi antara muka ini untuk menukar maklumat kad dan kupon, pastikan anda menghubungi Lihat antara muka butiran kad dan kupon untuk mengesahkan sama ada perubahan telah berjaya.

8.3 Sediakan ikuti cadangan Pengenalan Function

Pemaju sokongan untuk mengkonfigurasi kupon atau menetapkan URL pautan luaran di bahagian bawah mesej perubahan mata. sebuah kupon. Nota Pemaju .

2. Syorkan kad dan kupon, membolehkan peniaga mengkonfigurasi kad dan kupon di bawah akaun rasmi ini. 领券页面

2. Kawalan tempoh sah bagi jawatan yang disyorkan

1. Slogan pengiklanan + jenis URL menyokong peniaga untuk menyesuaikan masa paparan mengikut tempoh aktiviti.

2. Jenis kad dan kupon yang disyorkan Kesahihan kad dan kupon akan ditentukan oleh bahagian belakang WeChat Apabila kad dan kupon telah tamat tempoh, telah dikumpul atau telah ditetapkan sebagai tidak sah, ia akan dialih keluar secara automatik. dari rak untuk dipamerkan.

8.3.1 Sediakan antara muka pengesyoran ikut

Penerangan antara muka

Panggil kad kemas kini dan antara muka maklumat kupon untuk mengemas kini medan yang disyorkan kepada kad dan kupon yang telah berjaya lulus semakan. Ia juga menyokong pengisian medan yang sepadan semasa membuat kad dan kupon. .   

token_akses                                                                                                                                                                                                                                                                                                                                     Json data

Gunakan mesej untuk mengkonfigurasi kad

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


Gunakan mesej untuk mengkonfigurasi URL

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

Penerangan medan

Simptom Mesej baki mata Kupon kad disyorkan. Contoh rujukan struktur Json. ​ ​ ​ ​ Kedudukan pengesyoran untuk jenis pautan. Contoh rujukan struktur Json.                                                                                                                                                                                                                     ... d dalam kedudukan operasi. ​ ​​ ​ Kandungan teks. ​ ​ ​ Lompat pautan. ​​​​​errmsg                                                                                                                                                                           

8.4 Sediakan pembayaran sebagai ahli

8.4.1 Tambah pembayaran sebagai antara muka peraturan ahli

Pedagang yang telah membuka pembayaran WeChat boleh menyediakannya supaya pengguna akan menghantar mesej pengumpulan kad secara automatik kepada pengguna selepas membayar di WeChat, dan pengguna boleh mengklik pada mesej Dapatkan kad keahlian anda.

201610130915202689.jpg

Perihalan antara muka

Menyokong pedagang untuk menetapkan peraturan pembayaran kepada keahlian, dan boleh mengeluarkan kad keahlian berdasarkan tempoh masa dan julat amaun.

Interface Call Request Description

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "modify_msg_operation": {
            "card_cell": {
                "end_time": 1452724561,
                "card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI"
            }
        }
    }
}
e

parameter Description

Nama medan                                                                                  ​ ID Kupon. _Modify_msg_opration
Card_cell
url_cell ​ ​ ​
teks ​ ​ ​
url ​ ​ ​
Kod ralat, 0 bermaksud biasa; 43008 bermakna pedagang tidak mempunyai kebenaran pembayaran WeChat
json data call bukti kelayakan antara muka​​​mchid_list
parameters adalah diperlukan is
access_token is
ID kupon kad, hanya menyokong kad_id dalam mod bukan kod tersuai dan kad_id dalam mod kod pra-simpan. Rjump_url URL mesej templat, boleh menjadi pautan web kad tersuai bagi peniaga
Senarai sokongan nombor pedagang untuk peraturan baucar

_Peraturan masa tamat masa . akaun yang telah ditetapkan dalam peraturan ini, lalai adalah benar

Mengembalikan keterangan data Contoh data:

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

Nama parameter Penerangan Errcode kod ralat, 0 adalah perkara biasa. ​​​​​​​errmsg​​​​​​Mesej ralat. ISUCC_LIST Tetapkan senarai MCHID yang berjaya Fail_List Tetapkan senarai MCHID yang gagal MCHID Nombor saudagar appy
Apabila kegagalan diselesaikan, ia diulang tetapan, mchid adalah sedang diduduki oleh appid. Pedagang mesti menggunakan appid ini untuk menyahikat dan kemudian menetapkan semula. ​ ​

Nota untuk pembangun

1. Mesej koleksi kad keahlian hanya dihantar sekali kepada pengguna baharu Jika pengguna telah menerima atau menerima kad keahlian, ia tidak akan dihantar berulang kali

2. Lulus peraturan ini Appid kupon set card_id mestilah konsisten dengan appid utama mch_id semasa, jika tidak ralat 72001 akan dilaporkan

3. Hanya kad dan kupon jenis kad keahlian disokong, jika tidak ralat akan; dilaporkan: 72003;

4. Tetapkan pembayaran sebagai ahli Semasa membuat panggilan, anda mesti mengesahkan bahawa appid antara muka panggilan adalah konsisten dengan badan card_id semasa dan bahawa appid mempunyai hubungan yang mengikat dengan mchid, jika tidak, ralat akan dilaporkan: 72002;

5. Ia mesti dipastikan bahawa mchid belum ditetapkan oleh appid lain sebelum ini, jika tidak, ralat 72004 akan dilaporkan

6. Hanya 100 mchids boleh ditetapkan; masa. Jika terdapat lebih daripada 100, sila hubungi antara muka ini beberapa kali.

8.4.2 Padam pembayaran sebagai antara muka peraturan keahlian

Padamkan pembayaran sebagai peraturan keahlian yang telah ditetapkan sebelum ini.

Penerangan Antara Muka

Menyokong pedagang untuk menetapkan peraturan pembayaran sebagai keahlian, dan boleh mengeluarkan kad keahlian berdasarkan tempoh masa dan julat amaun.

Interface Call Request Description

{   "errcode":0,   "errmsg":"ok" }
e

parameter Description

parameters adalah diperlukan is json data access_token is call bukti kelayakan antara muka​​ID Kupon.                                                                                                                                                  

Mengembalikan keterangan data Contoh data:

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

Nama parameter Penerangan Errcode kod ralat, 0 adalah perkara biasa. ​​​​​​​errmsg​​​​​​Mesej ralat. ISUCC_LIST Tetapkan senarai MCHID yang berjaya Fail_List Tetapkan senarai MCHID yang gagal MCHID Nombor saudagar appy Penerangan antara muka parameter Sama ada 明Post data
Apabila kegagalan diselesaikan, ia diulang tetapan, mchid adalah sedang diduduki oleh appid Pedagang mesti menggunakan appid ini untuk menyahikat dan kemudian menetapkan semula. 3. 8.4.3 Pertanyaan Pembayaran Pedagang ialah Antara Muka Peraturan Ahli
boleh bertanya sama ada nombor pedagang menyokong pembayaran, iaitu fungsi keahlian permintaan panggilan antara muka
{
    "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
}

perihalan parameter

ialah json data

Access_token

Nama medan                                                                                                                                                                                                                                                                                                                        Nama medan ​ ​

Kembalikan keterangan data

Contoh data:

{
    "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"
        }
    ]
}

8.5 Sediakan kad keahlian untuk memaparkan antara muka leret kad pembayaran WeChat

Buat kad keahlian yang menyokong jenis leretan pengguna untuk membayar dengan cepat, antara muka meleret kad boleh ditarik keluar untuk pembayaran . Berikut ialah gambarajah skematik:

201610130915204982.png


8.5.1 Cipta kad keahlian untuk menyokong leretan pembayaran WeChat

Pedagang boleh membuat kad keahlian untuk menyokong WeChat, dan perlu menambahkan leretan pembayaran berikut JSON antara muka penciptaan kad keahlian :

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

8.5.2 Kemas kini kad keahlian untuk menyokong leretan pembayaran WeChat

Merchant boleh mengemas kini kad keahlian sedia ada untuk menyokong leretan pembayaran WeChat. Medan berikut mesti ditambahkan pada JSON antara muka kemas kini kad keahlian:

{
    "card_id": "xxxxxxxxa",
    "mchid_list": [
        123,
        1234,
        12345
    ]
}