Interface de carte et de coupon WeChat
1 Instructions
Pour lire certains documents d'interface pour les cartes et les coupons, assurez-vous de lire le document d'instructions générales du développeur de la plateforme publique WeChat « Spécifications du développeur WeChat » et « Interface du compte officiel WeChat Instructions d'autorisation 》Deux chapitres pour en savoir plus sur les méthodes d'appel de base de l'interface de la plateforme publique WeChat, les spécifications du développeur et la gestion des problèmes anormaux pendant le processus d'appel.
2 Demander un compte de test sandbox
Si vous n'avez pas de compte de test de carte et de coupon disponible, vous pouvez demander un numéro de test temporaire pour les coupons via le Test de l'outil d'application du compte de test de l'interface WeChat. Vous pouvez vous connecter à l'application de compte de test d'interfaceet parcourir WeChat pour obtenir une toute nouvelle application (vous avez déjà la permission de créer des cartes et des coupons, y compris les coupons d'amis)et le secret d'application est utilisé pour appeler la carte et interface de coupons.
Remarque : les coupons créés par cette application ne seront ni examinés ni approuvés. Ils sont limités à des tests à petite échelle et ne peuvent pas être utilisés par les développeurs à d'autres fins.
3 Carte et coupon HelloWorld
Les développeurs peuvent utiliser l'outil de débogage pour terminer rapidement le processus de création, de placement et d'annulation des cartes si vous souhaitez avoir une compréhension plus approfondie de la carte. et l'interface du coupon , vous devez lire la partie correspondante du document en détail.
Étape 1 Obtenez access_token
Adresse de la page : http://mp.weixin.qq.com/debug/
Type d'interface : support de base
Liste des interfaces : obtenir l'interface access_token
Remarques : développement du remplissage des paramètres appid et secret de l'utilisateur
Cliquez pour vérifier le problème et vous pourrez revenir au access_token. Le access_token est valable deux heures et doit être obtenu à nouveau après deux heures
Étape 2 Téléchargez la carte et logo du coupon
Adresse de la page : http://mp.weixin.qq.com/debug/
Type d'interface : support de base
Liste des interfaces : interface de téléchargement de matériel photo
access_token : obtenu dans le étape précédente access_token
buffer : l'image que vous choisissez
Cliquez pour vérifier la question et vous pourrez obtenir l'url de l'image. À l'étape suivante, vous devez créer un coupon dans les paramètres
. Étape 3 Créez un coupon
Adresse de la page : http://mp.weixin.qq.com/debug/
Type d'interface : Interface de la carte
Liste des interfaces : Créer une interface de carte
access_token : D'abord Le access_token
Exemple JSON obtenu à la première étape :
{
"card": {
"card_type": "GROUPON",
"groupon": {
"base_info": {
"logo_url":
"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmx ibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
"brand_name":"微信餐厅",
"code_type":"CODE_TYPE_TEXT",
"title": "132元双人火锅套餐",
"sub_title": "周末狂欢必备",
"color": "Color010",
"notice": "使用时向服务员出示此券",
"service_phone": "020-88888888",
"description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食",
"date_info": {
"type": "DATE_TYPE_FIX_TERM",
"fixed_term": 15 ,
"fixed_begin_term": 0
},
"sku": {
"quantity": 500000
},
"get_limit": 3,
"use_custom_code": false,
"bind_openid": false,
"can_share": true,
"can_give_friend": true,
"location_id_list" : [123, 12321, 345345],
"custom_url_name": "立即使用",
"custom_url": "http://www.qq.com",
"custom_url_sub_title": "6个汉字tips",
"promotion_url_name": "更多优惠",
"promotion_url": "http://www.qq.com"
},
"deal_detail": "以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸 菜鱼锅可选）：\n大锅1份 12元\n小锅2份 16元 "}
}
}Remarque : Le date_info utilise l'horodatage Unix. Attention à changer le start_timestamp pour qu'il soit inférieur à l'heure actuelle, et le end_timestamp à l'heure après aujourd'hui, afin que le la carte peut être annulée plus tard. Le test du coupon peut réussir
Adresse de l'interface : Créer une interface de carte et de coupon
Étape 4 Créer une livraison par code QR
Adresse de la page : http://mp.weixin.qq.com/debug/
Type d'interface : Interface de la carte
Interface liste : Créer une interface de ticket de code QR
access_token : access_token obtenu lors de la première étape
Exemple JSON :
{
"action_name": "QR_CARD",
"action_info": {
"card": {
"card_id": "po_2DjgJ2zrboM6SzK3qNuje5iWQ",
}
}
}Adresse d'interface : Créer une interface de code QR
Étape 5 Afficher le code QR
Cliquez sur le lien dans le champ show_qrcode_url en revenant de l'étape précédente pour afficher le code QR pour la collecte du coupon.
Exemple : https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQEr8ToAAAAAAAAAAASxodHRwOi8vd2V********NjRjVuAAIE3kqwVQMEgDPhAQ==
Ouvrir WeChat et scannez, puis recevez le coupon. S'il apparaît que le coupon n'a pas réussi l'examen, vous devez configurer une liste blanche de test à l'étape suivante. Si vous pouvez le recevoir, ignorez la sixième étape.
Vous pouvez scanner le code QR suivant pour découvrir les coupons WeChat :
Étape 6 Configurez la liste blanche de test
Adresse de la page : http://mp.weixin.qq.com/debug/
Type d'interface : Interface de la carte
Liste des interfaces : Configurez l'interface de liste blanche de test
access_token : Le access_token obtenu lors de la première étape
Exemple JSON :
{ "username":["usr1","usr2"] }Remarques : où usr1, sur2 sont les identifiants WeChat pour recevoir la carte
Adresse de l'interface : Définir l'interface de la liste blanche
Étape 7 Vérification du bon de carte
Adresse de la page http://mp.weixin.qq.com/debug/
Type d'interface : Interface du coupon de carte
Liste des interfaces : Interface du coupon de carte de vérification
access_token : access_token obtenu lors de la première étape
Exemple JSON :
{ "code"："759733467744" }Remarque : ne prend en charge que l'approbation et pendant la période de validité de la carte Adresse de l'interface du coupon : Interface de vérification
4 Présentation de l'interface des cartes et des coupons
L'interface des cartes et des coupons WeChat met principalement en place une série d'interfaces autour de la création, de la collecte, du placement et de la vérification des cartes et des coupons. Les développeurs peuvent suivre Choisissez l'interface appropriée pour l'effet que vous souhaitez obtenir
développer pour réaliser des applications de cartes et de coupons uniques dans l'industrie.
5 Introduction à la terminologie des cartes et des coupons
Voici les concepts clés que vous devez comprendre pendant le processus de développement des cartes et des coupons :
Nom du paramètre | Description |
card_id | ID de carte. Un identifiant de coupon correspond à un type de coupon et contient le code de la quantité en stock correspondante. |
code | Code promo. L'identifiant unique d'une carte et d'un coupon. Ce code de chaîne est utilisé lors de l'annulation de la carte et du coupon. Il prend en charge la personnalisation du commerçant. |
openid | Identité unique de l'utilisateur sous ce compte officiel. |
access_token | Les informations d'identification pour appeler l'interface sont valables pour 7200s et actualisées à chaque demande est obtenue via l'interface get access_token. il faut bien sauvegarder et créez un mécanisme de cache. |
| jsapi_ticket | Le ticket de signature qui doit être utilisé pour appeler l'interface JS-SDK qui appelle la fonction native WeChat sur la page Web WeChat. Pour plus de détails, voir : Section JS-SDK | .
api_ticket | Le ticket temporaire signé lors de l'appel à l'interface de carte et de coupon WeChat est valable pendant 7200s. Il reste inchangé pour les demandes répétées dans les 7200s Obtenez l'interface api_ticketObtenez-le. |
card_ext | Informations supplémentaires extensibles de la carte, qui sont utilisées pour placer la carte et le coupon et sont livrées avec les informations de base de la carte. |
outer_id | La valeur de la scène du canal de collecte de coupons . Il aide les commerçants à remplir la valeur de scène personnalisée dans card_ext pour l'émission de cartes et de coupons. Lorsque l'utilisateur reçoit la carte, la valeur de scène correspondante sera notifiée au commerçant via un événement. |
Lorsque | la carte passe l'examen, la carte est reçue, la carte est supprimée ou la carte est radiée , L'événement sera poussé pour avertir le développeur, et l'adresse de réception est l'URL du serveur renseignée dans le centre de développement de la plateforme publique. |
Entrée personnalisée | La création de cartes et de coupons via l'API prend en charge la page de détails des cartes et des coupons personnalisés des commerçants pour accéder à l'unité de lien externe. |
"Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X)
AppleWebKit/534.46(KHTML,like Geocko)Mobile/9B206 MicroMessenger/6.0.2 "
où 6.0.2 est le numéro de version de WeChat installé par l'utilisateur. Les commerçants peuvent déterminer si le numéro de version est supérieur ou égal à 6.0.2.
6.2 Restrictions de placement de cartes et de coupons
Seules les cartes et les coupons sous le nom de domaine du compte officiel sont pris en charge dans l'environnement de session de compte officiel. L'envoi de coupons d'autres marchands au sein d'une session de compte public n'est pas pris en charge sans l'autorisation de la plateforme. Sinon, les utilisateurs seront invités lors de la réception de coupons : "Ne peut pas être publié sans l'autorisation du marchand de coupons" . Il n’existe aucune restriction de ce type en dehors des conversations de compte public (telles que les Moments et les environnements de conversation).
Notes
Les actions qui se produisent dans la boîte de dialogue du compte public et les liens Web qui sautent de la boîte de dialogue du compte public se trouvent dans l'environnement de session du compte public.
6.3 Règles d'encodage
Toutes les données POSTées par l'interface API ne prennent en charge que l'encodage UTF-8, sinon une erreur sera renvoyée.
6.4 Description du paramètre de lien externe de saut
Afin de répondre aux exigences d'expansion des coupons en fonction de la carte et elle-même, les sauts d'URL sont autorisés à être ajouté à la page intérieure de la carte et du coupon. Liens externes.
Le lien externe que la carte et le coupon sautent peut contenir les paramètres des informations sur la carte et le coupon, qui sont utilisés par les développeurs pour confirmer l'identité de l'utilisateur sur la page.
Les champs inclus sont encrypt_code, card_id, openid, outside_str (carte de membre uniquement).
Remarque : encrypt_code est le code crypté, vous devez appeler l'interface de décodage pour obtenir le vrai code. Si l'url spécifiée est http://www.qq.com, lorsque l'utilisateur clique, l'url redirigée sera : http://www.qq.com?encrypt_code=ENCRYPT_CODE&card_id=CARDID&openid=xxxx&outer_str=xxxxx
6.5 Contactez-nous
Si vous rencontrez des problèmes avec le développement de cartes et de coupons, vous pouvez nous contacter par e-mail weixin_card@foxmail.com. Vous pouvez également rejoindre le groupe de communication du développeur QQ 205482166 512568283. Assurez-vous d'indiquer le nom du commerçant et son entreprise pour vérification.
7 Téléchargement du package d'informations sur les cartes et les coupons
Les développeurs peuvent télécharger le Pack d'informations sur l'interface des cartes et des coupons :
- SDK de l'outil de création et de signature
- Carte et coupon ; processus d'appel d'interface Image ;
- Nouvelle description des fonctionnalités de l'interface
- SDK pour Android
- SDK pour iOS ;
Remarque : encrypt_code est le code crypté, vous devez appeler l'interface de décodage pour obtenir le vrai code. Si l'url spécifiée est http://www.qq.com, lorsque l'utilisateur clique, l'url redirigée sera : http://www.qq.com?encrypt_code=ENCRYPT_CODE&card_id=CARDID&openid=xxxx&outer_str=xxxxx
- SDK de l'outil de création et de signature
