カードやクーポンを書き消す


カードとバウチャーのキャンセル

更新ログ

##バージョン番号更新内容V1.01. 償却ガイダンス プロセスを標準化します。開発者は、書き込みメソッドを呼び出す前に、クエリ コード インターフェイスを呼び出してコードのステータスを確認することをお勧めします。 -off インターフェイス
##更新時刻

2. クエリ コード インターフェイスを最適化して、開発者が使いやすくし、古いインターフェイスとの互換性を確保します。

2015-8-31








#このセクションでは、開発者がどのように作成するのかを主に紹介します。ユーザーがクーポンを使用した後にクーポンがユーザーの WeChat クライアントから消えることを、消失といいます。


#Writoff は現在、オンライン 消込とオフライン 消込の 2 つのタイプに分かれています。

#オンライン キャンセル

は、## などのクーポン ページから HTML5 Web ページにアクセスした後、ユーザーが積極的にクーポンを販売するプロセスを指します。 #WeChat モール クーポン、セルフサービス認証 # など;オフライン認証

は、ユーザーが店舗に到着した後、QR コードまたは文字列コードを提示し、レジ担当者が書き込み用の

コードをスキャンするなどの書き込み操作を完了することを意味します。オフ、機械償却 など。

#1 オフライン消込

##1.1 クエリ コード インターフェイス

開発者は、ライトオフ コード インターフェイスを呼び出す前にクエリ コード インターフェイスを呼び出し、不正なステータス (転送中、削除中、検証中など) のコードをチェックすることを強くお勧めします。償却する前に。売上など）が処理されます。


インターフェース呼び出しリクエストの説明

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

パラメータの説明

##

# は 呼び出しインターフェイス資格情報です






POST データ

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


パラメータの説明

#パラメータ必須かどうか説明
POST データ は #Json データ
access_token
##コードクーポン ID はクーポンの種類を表します。カスタムコードクーポンが必要です。 #check_consume







check_consume が true の場合にデータを返す

カードのステータスが正常です: 

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

カード異常クーポン ステータス: 

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


#check_consume が false の場合にデータを返す

カードの状態が正常です: 

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

カードの状態が異常です: 

 {
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjnK8NLbWgwMgfMtnj3gaglw",
    "begin_time": 1457625600,
    "end_time": 1460217599
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": false,
  "user_card_status": "GIFTING"
}
#パラメータ名必須タイプ 値の例説明
は string(20)110201201245単一カード規格の唯一のものです。
#card_idNostring(32)

pFS7Fjg8kV1I

##dDz01r4SQwMkuCKc

Nobooltrueコードの書き込みステータスを検証するかどうか、true と false を入力した場合、コード例外ステータスの戻りデータが異なります。
#エラー コードerrmsgopenidcard_id利用開始時間終了時刻終了時刻can_consume 償却できるかどうか。true は償却できることを意味し、false は償却できないことを意味します





















＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃予防：＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃ ＃ 1. 固定期間の有効期間は、ユーザーが実際に収集した時刻に応じて換算されます。たとえば、ユーザーが 2013 年 10 月 1 日にサブスクリプションを収集した場合、固定期間の有効期間は 90 日、つまり有効期間となります。期間は2013年10月1日から2013年12月29日まで。


#2. check_consume に true が入るか false が入るかに関わらず、コードが追加されていない場合やコードの送受信が行われた場合は一律エラーとなります。無効なシリアル コード

1.2 償却コード インターフェイス

が報告されます。消費コード インターフェイスは、カードとクーポンを清算するために開発された唯一のインターフェイスです。ユーザーは現在のインターフェイスを呼び出してユーザーのクーポンをキャンセルでき、このプロセスは元に戻すことができません。

インターフェイス呼び出しリクエストの説明

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

参数说明

パラメータ名説明
##エラーコード
##エラー メッセージ
useropenid
#クーポンID##begin_time
user_card_status

現在のコードに対応するカードのステータス

NORMAL 通常

CONSUMED 消失しました

##EXPIRE 期限切れ

GIFTING Re- Gifting

GIFT_TIMEOUT 転送タイムアウト

DELETE 削除されました

UNAVAILABLE 期限切れ

コードが追加されていない場合、または転送および受信された場合は、エラーが報告されます: 無効なシリアルコード

# は 呼び出しインターフェイス資格情報です






データを投稿#

非自定义Code卡券的请求
{
  "code": "12312313"
}
或自定义Code卡券的请求
{
  "code": "12312313",
  "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
#パラメータ必須かどうか説明
POST データ は #Json データ
access_token
##値の例説明##card_id#1231231削除されるコード。








##データを返す

 {
"errcode":0,
"errmsg":"ok",
"card":{"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"},
"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"
}
パラメータ名必須タイプ
Nostring(32)##pFS7Fjg8kV1Id

##Dz01r4SQwMkuCKc

クーポンID。クーポン作成時に use_custom_code を true に設定する場合は必須です。カスタム以外のコードを入力する必要はありません。
#コード は string(20)## です
エラー メッセージ。 公開アカウント内のユーザーの一意の ID。 #card_id カード ID。
パラメータ名説明
##エラーコード # ＃＃＃＃＃＃＃＃＃＃＃エラーコード。 #errmsg
#openid








##注:

1. 償却カードおよび異常状態のクーポンは消却できません。 (例外ステータスには、カードとクーポンが削除された、無効、期限切れ、転送中、転送が返された、期限切れが含まれます)

2.カスタマイズ コード付きのクーポン (use_custom_code が true) の場合、コードがキャンセルされるときにこのインターフェイスを呼び出す必要があります。ユーザークライアントのコードステータスを変更するために使用されます。カスタム コードを使用してカードおよびクーポンのインターフェイスを呼び出す場合、投稿データには Card_id が含まれている必要があり、そうでない場合は無効なシリアル コードが報告されます。カスタム コード以外のコードは報告する必要はありません。

2 オンライン検証

#2.1 プル カードおよびクーポン リスト インターフェイス (JS-SDK)

WeChat JS-SDKはWeChatの内蔵ブラウザでのみ使用でき、他のブラウザからの呼び出しは無効です。 WeChat は、販売者のフロントエンド Web ページを呼び出すためのchooseCard インターフェイスを提供します。これは、ユーザーの名前で販売者のフィルター条件のカードとクーポンのコンテンツを取得するために使用されます。クリックして表示 # 店舗に該当するカードとクーポンのリストを呼び出し、ユーザー選択リスト JS-SDK

1476165443869832.jpg

2.2 コード デコード インターフェイス

コード デコード インターフェイスは、次の 2 つのシナリオをサポートします。

1. 販売者は、chooses_card_info を取得した後、デコード インターフェイスを介して Card_id フィールドと encrypt_code フィールドを渡し、実際のコードを取得します。

#2. コードはカード内の外部リンクの署名で暗号化され、実際のコードはデコード インターフェイスを呼び出すことで取得されます。

#インターフェイス呼び出しリクエストの説明

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

パラメータの説明

# は 呼び出しインターフェイス資格情報です






データを投稿#

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


  参数说明

#パラメータ必須かどうか説明
POST データ は #Json データ
access_token
##encrypt_code
#パラメータ名必須タイプ 値の例説明
##string(128)##XXIzTtMqCxwOaawoE91 VJdsFmv7b

##8g0VZIZkqf4GWA60Fzpc8ksZ/ 5ZZ0DVkXdE

暗号化されたコード。








戻りデータ

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

パラメータの説明


#エラー コードerrmsgエラー メッセージcode復号化後に取得される実際のコード







## 注意事項


#1. この公式アカウントが取得した暗号化コードのみを復号することができます。

2. 開発者が URL から暗号化コードを取得する場合は、最初に urldecode に注意してください。そうでないとエラーが報告されます。 。

#3.encrypt_code は、カードコードを暗号化した暗号化コードコードであり、コードと 1 対 1 に対応します。

4. 開発者は、この公開アカウントの暗号化されたコードのみを復号化でき、それ以外の場合はエラーが報告されます。

2.3 クエリ コード インターフェイス

開発者は、ライトオフ コード インターフェイスを呼び出す前にクエリ コード インターフェイスを呼び出すことを強くお勧めします。不正な状態にあるコード (転送、削除、消去など) は、消去する前に処理する必要があります。

2.4 認証コード インターフェース

通常のクーポンのオンライン認証インターフェースはオフラインと同じです。検証インターフェース 通常のクーポンを販売するインターフェースと同じです。

←
→

PHP中国語ウェブサイト

ホームページホームページコースコース記事記事に質問に質問辞書辞書マニュアルマニュアルダウンロードダウンロード検索検索APPダウンロード APPダウンロード
#パラメータ名説明
エラーコード