Annuler les cartes et les coupons


Vérification des cartes et des coupons

Journal de mise à jour

Numéro de versionContenu de mise à jourHeure de mise à jour
V1.0

1. Standardisez le processus de guidage de radiation. Il est recommandé aux développeurs d'appeler l'interface de code de requête pour vérifier l'état du code avant d'appeler l'interface de radiation

2. Optimiser l'interface de code de requête pour la rendre plus facile à utiliser et à utiliser par les développeurs. est compatible avec l'ancienne interface

2015-8-31








Cette section présente principalement comment les développeurs peuvent supprimer les coupons du compte WeChat de l'utilisateur après que l'utilisateur a utilisé le coupon Le processus de disparition du client est appelé radiation.


La radiation est actuellement divisée en deux types : la radiation en ligne et la radiation hors ligne.

Vérification en ligne fait référence au processus par lequel les utilisateurs vendent activement des coupons après avoir accédé à une page Web HTML5 à partir de la page de coupon, telle que Coupons du centre commercial WeChat, vérification en libre-service, etc.

Radiation hors ligne signifie qu'une fois que l'utilisateur est arrivé au magasin, il montre le code QR ou le code de série, et le caissier termine l'action de radiation, comme scanner l'écriture du code- extinction, radiation de machine, etc.

1 Radiation hors ligne

1.1 Interface de code de requête

Nous recommandons fortement aux développeurs d'appeler l'interface de code de requête avant d'appeler l'interface de code de radiation, et de vérifier le code avant d'être radiés, les codes ayant un statut illégal (tels que transférés, supprimés, radiés, etc.) seront traités.


Description de la demande d'appel d'interface

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

Description du paramètre

Le paramètre access_token
est-il obligatoire
is Identifiants de l'interface d'appel






Données POST

{
   "card_id" : "card_id_123+",
   "code" : "123456789",
   "check_consume" : true
}


Paramètres Descriptif

Nom du paramètreObligatoireTypeExemple de valeurDescription
code est string(20) 110201201245Le seul standard pour une seule carte.
card_idnostring(32)

pFS7Fjg8kV1I

dDz01r4SQw M kuCKc

L'ID de carte et de coupon représente un type de carte et de coupon. Des coupons de code personnalisés sont requis.
check_consumeNonbooltrueQue ce soit pour vérifier l'état d'annulation du code, les données de retour de l'état d'exception du code sont différentes lorsque vrai et faux sont rempli dans.











Renvoyer les données lorsque check_consume est vrai

Le statut de la carte et du coupon est normal : 

{
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjk4T4Hx-QFQGL4zGQy27_Qg",
    "begin_time": 1457452800,
    "end_time": 1463155199
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": true,
  "user_card_status": "NORMAL"
}

Le statut de la carte et du coupon est anormal :

Renvoie les données lorsque check_consume est faux


Le statut de la carte est normal : 

{
 "errcode": 40127,
 "errmsg": "invalid user-card status! Hint: the card was given to user, but may be deleted or set unavailable ! hint: [iHBD40040ent3]"
}

Le statut de la carte est anormal : 

{
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjk4T4Hx-QFQGL4zGQy27_Qg",
    "begin_time": 1457452800,
    "end_time": 1463155199
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": true,
  "user_card_status": "NORMAL"
}
S'il peut être radié, vrai signifie qu'il peut être radié, faux signifie qu'il ne peut pas être radié
Nom du paramètreDescription
errcodeCode d'erreur
errmsg Message d'erreur
openid Utilisateur openid
card_idcard ID
begin_timeDébut d'utilisation
end_ heure de fin
user_card_status

Le statut de la carte correspondant au code actuel

NORMAL Normal

CONSUMED A été annulé

EXPIRE                                                                                                                                                                  « Expiré                                GIFT_TIMEOUT Délai d'expiration du transfert

D SUPPRIMER Supprimé

INDISPONIBLE Invalide

Si le code n'est pas ajouté ou transféré et reçu, une erreur sera signalée : code de série invalide

can_consume






















Remarques :

1. La période de validité à durée fixe sera convertie en fonction de l'heure réelle de collecte par l'utilisateur. Par exemple, si l'utilisateur la récupère le 1er octobre. 2013, la durée de validité forfaitaire est de 90 jours, c'est-à-dire qu'elle est valable du 1er octobre au 29 décembre 2013.

2. Que check_consume soit rempli avec vrai ou faux, lorsque le code n'est pas ajouté ou que le code est transféré et reçu, une erreur uniforme sera signalée : code de série invalide

1.2 Interface du code de souscription

L'interface du code de consommation est la seule interface permettant d'annuler les coupons. Les développeurs peuvent appeler l'interface actuelle pour annuler les coupons de l'utilisateur.

Description de la demande d'appel d'interface

 {
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjnK8NLbWgwMgfMtnj3gaglw",
    "begin_time": 1457625600,
    "end_time": 1460217599
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": false,
  "user_card_status": "GIFTING"
}

参数说明

Le paramètre access_token
est-il obligatoire
is Identifiants de l'interface d'appel






Données POST

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/code/consume?access_token=TOKEN
Nom du paramètreObligatoireTypeExemple de valeurDescription
card_idnostring(32)

pFS7Fjg8kV1Id

Dz01r4SQwMkuCKc

Identifiant du coupon. Obligatoire lorsque use_custom_code est renseigné true lors de la création d'un coupon. Le code non personnalisé n'a pas besoin d'être rempli.
code est le code code qui doit être vérifié.








Retourner les données 

非自定义Code卡券的请求
{
  "code": "12312313"
}
或自定义Code卡券的请求
{
  "code": "12312313",
  "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
Nom du paramètreDescription
errcodeCode d'erreur.
errmsgmessage d'erreur.
openidL'identité unique de l'utilisateur au sein du compte public.
card_idID de carte.








Remarque :

1. Seules les cartes et coupons valides peuvent être radiés, si la carte et le coupon sont statut anormal, ne peut être radié. (Le statut d'exception inclut : carte et coupon supprimés, non valides, expirés, en cours de transfert, retournés pour transfert, invalides)

2.Les coupons avec un code personnalisé (use_custom_code est vrai) sont radiés dans le code, cette interface doit être appelée. Utilisé pour modifier l'état du code du client utilisateur. Lors de l'appel de l'interface pour des cartes et des coupons avec des codes personnalisés, les données de publication doivent contenir card_id, sinon un code de série invalide sera signalé. Les codes non personnalisés n'ont pas besoin d'être signalés.

2 Vérification en ligne

2.1 Interface de carte d'extraction et de liste de coupons (JS-SDK)

WeChat JS-SDK ne peut être utilisé que dans le navigateur intégré de WeChat, et les appels provenant d'autres navigateurs ne sont pas valides. WeChat fournit l'interface ChooseCard pour appeler la page Web frontale du commerçant, qui est utilisée pour extraire le contenu de la carte et du coupon des conditions de filtrage du commerçant sous le nom de l'utilisateur. Cliquez pour voir Appelez la liste des cartes et des coupons applicables au magasin et obtenez la liste de sélection des utilisateurs JS-SDK

1476165443869832.jpg

2.2 Interface de décodage de code

L'interface de décodage de code prend en charge deux scénarios :

1. Une fois que le commerçant a obtenu Chooses_card_info, transmettez les champs card_id et encrypt_code via l'interface de décodage pour obtenir le vrai code.

2. Le code sera crypté dans la signature du lien externe au sein de la carte, et le vrai code pourra être obtenu en appelant l'interface de décodage.

Description de la demande d'appel de l'interface

 {
"errcode":0,
"errmsg":"ok",
"card":{"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"},
"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"
}

Description des paramètres

Le paramètre access_token
est-il obligatoire
is Identifiants de l'interface d'appel






Données POST

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


  参数说明

Nom du paramètreObligatoireTypeExemple de valeurDescription
fr crypt_code est string(128)

XXIzTtMqCxwOaawoE91+VJdsFmv7b

8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE

Code crypté.








Données de retour

{
  "encrypt_code":"XXIzTtMqCxwOaawoE91+VJdsFmv7b8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE"
}


Description des paramètres

Nom du paramètreDescription
errcodeCode d'erreur
errmsg Message d'erreur
codedécryptage Le vrai code obtenu plus tard
1. Seul ce coupon de compte officiel peut être décodé d Obtention du code de cryptage.




2. Si le développeur obtient le code crypté à partir de l'URL, veuillez d'abord faire attention au urldecode, sinon une erreur sera signalée.



3.encrypt_code est le code crypté obtenu en cryptant le code de la carte, qui correspond au code un à un.


4. Les développeurs ne peuvent décrypter que le code crypté de ce compte officiel, sinon une erreur sera signalée.

2.3 Interface de code de requête

Nous recommandons fortement aux développeurs d'appeler l'interface de code de requête avant d'appeler l'interface de code d'annulation et de vérifier le code dans un statut illégal (par exemple, transféré, supprimé et vérifié ) avant de l'amortir Ventes, etc.) sont traités.

2.4 Interface de code d'annulation

L'interface pour annuler les coupons ordinaires en ligne est la même que l'interface pour annuler les coupons ordinaires hors ligne.

←
→

Site Web PHP chinois

MaisonMaisonCoursCoursArticleArticleQuestions et réponsesQuestions et réponsesDictionnaireDictionnaireManuelManuelTéléchargerTéléchargerrechercherechercheAPPTélécharger APPTélécharger