Espace Carte de Membre (2)


8 Gérer les cartes de membre

8.1 Interface d'extraction des informations sur les membres (requête de points)

Description de l'interface

Aider les développeurs à interroger les informations sur les membres en fonction de l'identifiant de la carte et du code, y compris les informations d'activation, les informations sur les points, le solde et d'autres informations. .

Description de la demande d'appel de l'interface

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

Description des paramètres

Données JSON ​ Interface d'appel informations d'identification Données POST
Paramètres                                             Est obligatoire                                                                             est ​ ​ ​
access_token ​est ​ ​ ​
{   "card_id": "pbLatjtZ7v1BG_ZnTjbW85GYc_E8",   "code": "916679873278"}
Nom du paramètre            

Est-il obligatoire                 Description               Requête du cardid de la carte de membre ​ ​ ​query La valeur du code reçue par l'utilisateur
cardid​ ​ ​ is ​ ​ ​
code ​ ​ ​ est ​ ​ ​

ATURNE 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"
}
Errmsg Code d'identification CNICKNAME surnom de l'utilisateur BONUS Points Informations Balance Informations d'équilibre SEX User Gender_info Informations sur les membres custom_field_list Catégories d'informations sur l'adhésion à la carte de membre définies par le développeur, telles que les niveaux. Name 信息 Nom de la catégorie d'informations sur le membre Value Valeur de la catégorie d'informations sur la carte de membre, telle que des valeurs de niveau telles que User_card_status Statut actuel de la carte de membre de l'utilisateur, expiration normale normale GIFT_SUCC Transféré avec succès GIFT_TIMEOUT Transfert timeout DELETE Supprimé, NON DISPONIBLE a expiré Prend en charge la modification des informations de surface de la carte de membre et des informations sur les attributs de la carte.
HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/update?access_token=TOKEN
Paramètres                                  Est obligatoire                                                                           est ​ ​ ​ Données Json ​ ​ access_token ​ ​
PARAMETER NOM Description à
8.2 Modifier l'interface des informations de la carte de membre Description de l'interface
Description de la demande d'appel de l'interfaceDescription des paramètres

est ​​ Appeler identifiants d'interface

POST data

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

prend en charge la modification des champs :

champ base_info :

Cartes coupons LOGO, il est recommandé que le le pixel est de 300*300.                                                                                                                                  Réductions partagées avec d'autres Numéro de téléphone du service client.                                                                                                                                      Couleur du coupon.                                                                                                                                                                   Prise en charge de la mise à jour de la liste des magasins concernés. use_all_locationsNon booltruePrend en charge tous les magasins. Après avoir rempli, le magasin de coupons sera mis à jour avec la mise à jour du magasin marchandcenter_title​ string(18) ​ ​ Utilisez maintenant Le nom du bouton de saut au milieu de la carte de membre                 Le bouton au milieu de la carte de membre correspond à l'url de redirection                                                                                          ‐ à -- Personnalisez le nom de l'entrée du saut.                                                                                                                               L'entrée passe directement au lien d'adresse du lien externe.                                                                                                _TEXT. Que ce soit Que ce soit ou non unsigned int
nom du paramètre              Description                                                                                                                                   /Http: // mmbiz .qpic.cn/ Vérification du code pour les cartes et les coupons. 上 Utilisez des rappels, la limite supérieure du mot est de 16 caractères chinois.                                                                                                                                            
Mode d'emploi.                                                                                                                                                 ​
, utilisation recommandée                          
center_sub_title                                                                                                                                                                                                                                                                                                                     
Personnalisez l'URL de redirection.                                                                                              Une invite affichée sur le côté droit de l'entrée.                                                                                                                                  ​                                                                                                                                                                                                                                                         Nom d'entrée personnalisé pour le scénario marketing.                                                                                                 Non string (18) Grosse remise en magasin. ​ ​ ​ ​ L'invite affichée sur le côté droit de l'entrée marketing.                                                                                                                                                        
Type d'affichage du code, "CODE_TYPE_TEXT" texte "CODE_TYPE_BARCODE" code unidimensionnel "CODE_TYPE_QRCODE QR code

"CODE_TYPE_ONLY_QRCODE"

Afficher uniquement le code QR           
"CODE_TYPE_ONLY_BARCODE"

Afficher uniquement un code QR

"CODE_TYPE_NONE"

n'affiche aucun modèle de code

MGet_limit

IINT 1 Le nombre de par personne peut recevoir le bon limité CAN_SHARE
Faux La page de collecte native des tickets de carte peut être partagée
can_give_friendly date_info                                                                                                                  Extension de la plage de validité                                                                                                                                                             L'horodatage de 1 n'est pas pris en charge. begin_. timestamp Non
14300000 Spécial pour une plage de dates fixe, indiquant l’heure d’activation. (Les unités sont en secondes)                                       Spécial pour une plage de dates fixe, indiquant l'heure de fin. L'heure de fin ne peut être prolongée que plus tard. ​ ​ ​

Modification des champs exclusifs de la carte de membre :

Note spéciale que les champs suivants qui prennent en charge la mise à jour ne sont pas dans la structure des informations de base base_info.​​​​     

Non                                                                                                                              ​ string(3072) Règles d'élimination des points. ​ ​ ​ ​ bonus_rules ​ ​ ​ est ​ ​ ​ ​ string(3072) ​ ​ ​ ​ règles de points. ​ ​ ​ ​ balance_rules ​ ​ est ​ ​ ​ ​ string(3072) ​ ​ ​ description de la valeur stockée.                                                                                                                                                                                                                                               . IWX_ACTIVATE S'il faut ou non ouvrir une carte en un clic pour ouvrir la carte Lorsque vous le définissez sur True, la carte prendra en charge les détails de la carte en un clic. Cette option s'exclut mutuellement avec activate_url.                                                                                                                                                          La carte est automatiquement configurée pour être activée Activation automatiqueFIELD_NAME_TYPE_STAMP Timbre Non                                                                        cost_bonus_unit int 5 points par utilisation.                                                                                                                                    Non​ Nom du paramètre                                                                                                                                 code, 0 est normal. ​​​​​​​
Voir pour plus de détails. ​ ​ ​
activate_urlNon string(128)
Activer le lien
custom_field1​ ​ ​ ​ Personnalisez les catégories d'informations sur l'adhésion, qui seront affichées une fois la carte de membre activée.                                                                                                                                                                                                                                                                                                                                                                                                                               FIELD_NAME_TYPE_LEVEL Niveau FIELD_NAME_TYPE_COUPON Coupon
FIELD_NAME_TYPE_DISCOUNT Remise FIELD_NAME_TYPE_ACHIEVEMEN RéalisationsFIELD_NAME_TYPE_MILE ÂGE Miles Miles
url                                                                                                   Pas de Structure JSONCatégorie d'informations personnalisées sur les membres, affichée une fois la carte de membre activée
bonus_rule                                                                                                                ney_unit                                                                                                            increase_bonus Non int Points augmentés en fonction du montant de consommation ci-dessus
max_increase_bonus int        Points initiaux utilisateur gagnés après l'activation
cost_bonus_unit Non int
least_money_to_use_bonus             int ​ ​ ​ Conditions de déduction, un maximum de xx points peuvent être utilisés pour une seule transaction​​​​​ remise                                                                                                                                      
errmsg​​​​​​Message d'erreur. E Send_Check Si cette mise à jour doit être révisée cette fois, True est nécessaire et false n'est pas nécessaire. ​ ​ ​

Notes du développeur

1. Après avoir modifié certains champs de la carte et du coupon, ils seront soumis à nouveau pour examen. Pour plus de détails, consultez la description du champ. Une fois la mise à jour réussie, vous pouvez vérifier le résultat de la mise à jour en appelant la vue de la carte. et l'interface des détails du coupon ;

2. Remplissez uniquement les champs qui doivent être mis à jour. De nombreux développeurs rempliront des champs tels que le nom de la marque qui ne prennent pas en charge la modification lors de l'appel de cette interface, ce qui entraînera l'échec de la mise à jour.

3. Après avoir appelé cette interface pour modifier les informations de la carte et du coupon, assurez-vous d'appeler l'interface Afficher les détails de la carte et du coupon pour vérifier si la modification a réussi.

8.3 Configurer les recommandations de suivi

Introduction à la fonction

Aider les développeurs à configurer les coupons ou à définir l'URL du lien externe de saut au bas du message de changement de points. Le formulaire spécifique est comme indiqué ci-dessous, il peut s'agir d'une URL ou. un coupon.

领券页面

Notes du développeur

1. Prend en charge deux types de configurations de recommandations de suivi

1. Slogan publicitaire + URL, aide les commerçants à configurer la rédaction de 16 caractères chinois et les liens cliquer pour accéder .

2. Recommander des cartes et des coupons, permettant aux commerçants de configurer une carte et un coupon sous ce compte officiel.

2. Contrôle de la période de validité des postes recommandés

1. Slogan publicitaire + type d'URL aide les commerçants à personnaliser le temps d'affichage en fonction de la période d'activité.

2. Types de cartes et de coupons recommandés. La validité des cartes et des coupons sera déterminée par le backend WeChat. Lorsque les cartes et les coupons auront expiré, auront été collectés ou auront été définis comme invalides, ils seront automatiquement supprimés. des étagères pour les exposer.

8.3.1 Configurez l'interface de recommandation de suivi

Description de l'interface

Appelez l'interface de mise à jour des informations sur la carte et le coupon pour mettre à jour le champ recommandé vers la carte et le coupon qui ont réussi l'examen. Il prend également en charge le remplissage des champs correspondants lors de la création de cartes et de coupons.


Détails de l'interface

Description de la demande d'appel de l'interface

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

Description des paramètres

Json données

Utiliser des messages pour configurer les cartes

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


Utiliser des messages pour configurer les URL

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

Descriptions des champs

Paramètres             Est-ce nécessaire          Description             
access_token                                                                                                                                                                                                  ​​​​​​​​​ Oui 🜜
Types de message de solde de points bit de recommandation de bons de carte. Exemple de référence de structure Json. ​ ​ ​ ​ Position de recommandation pour le type de lien. Exemple de référence de structure Json.                                                                                                                                                                                                                             Uce comme 2000 comme carte id en position de fonctionnement. ​ ​ ​ ​ Contenu textuel. ​ ​ ​ ​ Lien de saut. ​​​​
Nom du champ                                    ​ Identifiant du coupon. _Modify_msg_opration
Card_cell
url_cell ​ ​ ​
texte ​ ​ ​
url ​ ​ ​
Code d'erreur, 0 signifie normal ; 43008 signifie que le commerçant n'a pas l'autorisation de paiement WeChat ;                                                                                                                                           

8.4 Configurer le paiement en tant que membre

8.4.1 Ajouter le paiement en tant qu'interface de règle de membre

Les commerçants qui ont ouvert le paiement WeChat peuvent le configurer pour que l'utilisateur envoie automatiquement un message de collecte de carte à l'utilisateur après avoir payé sur WeChat, et l'utilisateur peut cliquer sur le message Obtenez votre carte de membre.

201610130915202689.jpg

Description de l'interface

Aide les commerçants à définir des règles de paiement pour l'adhésion et peut émettre des cartes de membre en fonction de périodes et de plages de montants.

Description de la demande d'appel de l'interface

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

Description des paramètres

Données Json ​ ​ Appeler informations d'identification de l'interface​​mchid_list
Paramètres                                  Est obligatoire                                                                            est ​ ​ ​
access_token ​ ​ est ​​
ID de coupon de carte, prend uniquement en charge card_id en mode code non personnalisé et card_id en mode code pré-stocké. Rjump_url URL de message modèle, peut être un lien Web de carte personnalisé du commerçant
Liste des numéros de commerçant pris en charge pour les règles des bons d'achat

Begin_time heure d'entrée en vigueur des règles EEnd_time _ heure de fin des règles min_cost La limite inférieure du montant de paiement de cette règle, et elle est divisée en unité max_cost Ces règles sont efficaces KS_Locked Si d'autres applications ont configuré le numéro de commerçant qui a été défini dans cette règle, la valeur par défaut est True

Renvoie la description des données Exemple de données :

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

Nom du paramètre Description Errcode code d'erreur, 0 est normal. ​​​​​​​errmsg​​​​​​Message d'erreur. ISUCC_LIST Définir la liste MCHID réussie Fail_List Définir la liste MCHID échouée MCHID Numéro de commerçant Occupy_appid Lorsque la panne est réglée, c'est des réglages répétés, Le mchid est actuellement occupé par l'appid. Le commerçant doit utiliser cet appid pour le dissocier puis le réinitialiser. ​ ​ ​

Notes pour les développeurs

1. Le message de collecte de la carte de membre n'est envoyé qu'une seule fois à un seul nouvel utilisateur. Si l'utilisateur a déjà reçu ou a reçu la carte de membre, elle ne sera pas envoyée à plusieurs reprises ; cette règle L'appid du coupon de l'ensemble card_id doit être cohérent avec l'appid principal du mch_id actuel, sinon une erreur de 72001 sera signalée

3. Seules les cartes de type carte de membre et les coupons sont pris en charge, sinon une erreur sera générée. être signalé : 72003 ;

4. Définir le paiement en tant que membre Lors de l'appel, vous devez confirmer que l'appid de l'interface appelante est cohérent avec le corps card_id actuel et que l'appid a une relation contraignante avec mchid, sinon un l'erreur sera signalée : 72002 ;

5. Il faut s'assurer que mchid n'a pas été défini par un autre appid auparavant, sinon une erreur 72004 sera signalée

6. Seuls 100 mchids peuvent être définis à un moment donné. S'il y en a plus de 100, veuillez appeler cette interface plusieurs fois.

8.4.2 Supprimer le paiement comme interface de règle d'adhésion

Supprimez le paiement comme règle d'adhésion qui a été définie auparavant. Description de l'interface

Aide les commerçants à définir des règles de paiement en tant qu'adhésion et peut émettre des cartes de membre en fonction de périodes et de plages de montants.

Description de la demande d'appel de l'interface

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

Description des paramètres

Paramètres                                  Est
obligatoire                                                                            access_token ​ ​
est ​ ​ ​ Données Json ​ ​
est ​​ Appeler informations d'identification de l'interface​​ID du coupon.                                                                                                    

Renvoie la description des données Exemple de données :

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

Nom du paramètre Description Errcode code d'erreur, 0 est normal. ​​​​​​​errmsg​​​​​​Message d'erreur. ISUCC_LIST Définir la liste MCHID réussie Fail_List Définir la liste MCHID échouée MCHID Numéro de commerçant Occupy_appid Lorsque la panne est réglée, c'est des réglages répétés, Le mchid est actuellement occupé par l'appid. Le commerçant doit utiliser cet appid pour le dissocier puis le réinitialiser. 3. 8.4.3 Demande de paiement du commerçant est l'interface des règles de membre Description de l'interface peut demander si un numéro de commerçant prend en charge le paiement, c'est-à-dire la fonction d'adhésion description des paramètres

demande d'appel d'interface
{
    "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"
        }
    ]
}
Paramètres

Si les données 明Post

sont des données

json

Access_token

Nom du champ                                                                                                                                                                                                                                 Nom du champ ​ ​ ​

Description des données de retour

Exemple de données :

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

8.5 Configurez la carte de membre pour afficher l'interface de balayage de la carte de paiement WeChat

Créez une carte de membre qui prend en charge le type de balayage via l'interface après que l'utilisateur a cliqué. lors d'un achat rapide, l'interface de glissement de la carte peut être retirée pour le paiement. Ce qui suit est un diagramme schématique :

201610130915204982.png


8.5.1 Créer une carte de membre pour prendre en charge le balayage des paiements WeChat

Les commerçants peuvent créer une carte de membre pour prendre en charge le balayage des paiements WeChat et doivent ajouter les champs suivants à le JSON de l'interface de création de carte de membre :

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

8.5.2 Mettre à jour la carte de membre pour prendre en charge le balayage des paiements WeChat

Le marchand peut mettre à jour la carte de membre existante pour prendre en charge le balayage des paiements WeChat. Les champs suivants doivent être ajoutés au JSON du. Interface de mise à jour de la carte de membre :

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