Placer des coupons

1. Créer une nouvelle étagère de cartes et de coupons L'interface permet aux développeurs d'appeler l'interface pour créer des étagères de cartes et de coupons pour placer des cartes et des coupons

2 Ajout d'une nouvelle interface de code d'importation pour aider les développeurs de codes personnalisés à distribuer des cartes et des coupons via la distribution de masse, le service client et. d'autres chaînes en important des codes

outer_str

outer_id version améliorée du champ , type de chaîne Lorsque l'utilisateur reçoit la carte pour la première fois. , il le recevra via L'événement est poussé vers le commerçant ;

Pour le code QR de la carte de membre, chaque fois que l'utilisateur scanne le code pour ouvrir la carte de membre et clique sur n'importe quelle URL, la valeur sera épelée dans l'URL pour faciliter aux développeurs de localiser la source du code scanné

Données POST

{  
"banner":"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7h  icFN",
   "page_title": "惠城优惠大派送",
   "can_share": true,
   "scene": "SCENE_NEAR_BY",
   "card_list": [
       {
           "card_id": "pXch-jnOlGtbuWwIO2NDftZeynRE",
           "thumb_url": "www.qq.com/a.jpg"
       },
       {
           "card_id": "pXch-jnAN-ZBoRbiwgqBZ1RV60fI",
           "thumb_url": "www.qq.com/b.jpg"
       }
   ]
}

Description du paramètre

Description des données de retour

{
     "errcode":0,
     "errmsg":"ok",
     "url":"www.test.url",
     "page_id":1
 }

Description du champ

Les développeurs doivent prêter une attention particulière à l'interface d'émission de cartes et de coupons de groupe. ne prend en charge que l'émission de non-cartes avec des codes de code personnalisés. Si les commerçants disposant de codes personnalisés souhaitent utiliser cette fonction, ils doivent d'abord appeler l'interface d'importation de code pour importer le code personnalisé dans le serveur WeChat.

Ce module est uniquement destiné aux marchands de code personnalisé, les développeurs de code non personnalisé doivent automatiquement l'ignorer. Les développeurs peuvent importer des codes personnalisés dans le serveur WeChat à l'avance pour obtenir les mêmes capacités de livraison que les commerçants de codes non personnalisés, telles que la distribution de groupe, l'émission de cartes et de coupons via les messages du service client, etc. Les coupons après l'importation du code sont équivalents aux coupons de code non personnalisés une fois publiés. les coupons sont différents des méthodes de création précédentes. Il est recommandé aux développeurs d'utiliser le processus suivant pour créer des coupons en mode code pré-stockés, sinon une erreur sera signalée.

Étape 1 : Créez un coupon de mode pré-enregistré, définissez la valeur initiale de la quantité en stock sur 0 et remplissez le champ get_custom_code_mode

Étape 2 : Une fois le coupon passé l'examen, appelez ; l'interface de code d'importation et Vérifiez le code ; Étape 3 : Appelez l'interface d'inventaire de modification pour rendre l'inventaire de la carte inférieur ou égal au nombre de codes importés. (Il est recommandé de le régler sur égal pour éviter toute confusion)

Coupons non nouvellement créés

Si le développeur dispose déjà d'un coupon et souhaite le faire passer en mode code pré-enregistré, il est recommandé au développeur de suivre le processus suivant pour mettre à jour le coupon.

Étape 1 : Appelez l'interface de code d'importation pour importer une certaine quantité de code personnalisé et vérifiez le code ;

Étape 2 : Appelez l'interface d'informations sur la carte de changement et le coupon pour remplir le champ get_custom_code_mode ;

Étape 3 : Appelez l'interface de modification d'inventaire pour stocker la carte et les coupons en inventaire. La quantité est fixée à un nombre égal au nombre de codes importés.

4.1.1 Remplissez/mettez à jour les champs obligatoires du code d'importation

Description de l'interface

Les cartes et les coupons avec des codes personnalisés prennent uniquement en charge la création d'API. Lors de la création, assurez-vous d'ajouter les champs suivants à base_info (voir le document d'interface CreateCard pour plus de détails). Ce n'est qu'après avoir ajouté les deux champs spécifiés suivants que vous pourrez appeler l'interface d'importation de code. coder Importer

Exemple JSON lors de la création d'une carte

{
 "card": {
     "card_type": "GROUPON",
     "groupon": {
     "base_info": {
     ··········
     "use_custom_code":true,
     "get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",
         },
          "advanced_info": {
      ··········
          },
         "deal_detail": "示例"
     }
   }
}

Exemple JSON lors de la mise à jour d'une carte

 {
      "card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",
      "groupon": { 
      "base_info": {
      ·········		            
        "get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",
      ·········
              }
        }
 }

Remarque :

Créer/Quand en mettant à jour get_custom_code_mode, vous devez vérifier la relation entre le numéro d'inventaire et le nombre de codes importés. Lorsque le nombre de codes importés est inférieur au numéro d'inventaire, une erreur sera signalée.

4.1.2 Interface d'importation de code

Une fois le coupon de code personnalisé créé avec succès et passé l'examen, le code personnalisé doit être importé dans le code selon le numéro convenu avec le émetteur L'interface est importée dans le backend WeChat.

Description de l'interface

Les développeurs peuvent appeler cette interface pour importer le code personnalisé dans le backend de la carte et du coupon WeChat, et l'agent secondaire WeChat stockera et émettra le code.

Remarque : 1) La limite supérieure du nombre de codes entrants pour un seul appel vers l'interface est de 100.

2) Chaque code ne peut pas être une chaîne vide.

3) Une fois l'importation terminée, le système déterminera automatiquement si l'inventaire défini par le fournisseur est cohérent avec la quantité réelle de code importé.

4) Si l'importation échoue, l'importation répétée est prise en charge jusqu'à ce que l'invite réussisse.

Description de la demande d'appel d'interface

HTTP请求方式: POST
URL:http://api.weixin.qq.com/card/code/deposit?access_token=ACCESS_TOKEN

Description du paramètre de demande

{
   "card_id": "pDF3iY0_dVjb_Pua96MMewA96qvA",
   "code": [
       "11111",
       "22222",
       "33333",
       "44444",
       "55555"
   ]
}

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

HTTP请求方式: POST
URL:http://api.weixin.qq.com/card/code/getdepositcount?access_token=ACCESS_TOKEN