Hapus kad dan kupon


Pengesahan kad dan kupon

Kemas kini log

V1.01. Seragamkan proses panduan hapus kira Adalah disyorkan bahawa pembangun memanggil antara muka kod pertanyaan untuk menyemak status kod sebelum memanggil antara muka hapus kira
Nombor versi masa terkini

2. Optimumkan antara muka kod pertanyaan untuk memudahkan pembangun menggunakan dan serasi dengan antara muka lama

2015-8-31








Bahagian ini terutamanya memperkenalkan cara pembangun boleh mengalih keluar kupon daripada akaun WeChat pengguna selepas pengguna menggunakan kupon. Proses kehilangan pelanggan dipanggil hapus kira.


Hapus kira kini terbahagi kepada dua jenis: hapus kira dalam talian dan hapus kira luar talian.

Online Verification merujuk kepada proses pengguna secara aktif menjual kupon selepas memasuki laman web HTML5 dari halaman kupon, seperti kupon wechat mall, pengesahan layan diri, dan sebagainya; . dimatikan, hapus kira mesin, dsb.

. sebelum menghapus kira Kod dalam status haram (seperti dipindahkan, dipadam, dihapus kira, dsb.) akan diproses.


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

Penerangan parameter

Adakah parameter

diperlukan?






POS data

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


Parameter Penerangan

Nama parameter

kodKad dan ID kupon mewakili sejenis kad dan kupon. Kupon kod tersuai diperlukan. Check_consumenobooltruememara mengesahkan status penghapusan kod, data pengecualian pengecualian kod adalah berbeza apabila benar dan palsu dipenuhi dalam.










Kembalikan data apabila check_consume adalah benar

Status kad dan kupon adalah 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"
}

Status kad dan kupon tidak normal:


Kembalikan data apabila check_consume adalah palsu

Status kad adalah normal: 🎜🎜
{
 "errcode": 40127,
 "errmsg": "invalid user-card status! Hint: the card was given to user, but may be deleted or set unavailable ! hint: [iHBD40040ent3]"
}
🎜🎜Status kad tidak 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"
}
ialah rentetan(20) 110201201245Satu-satunya standard untuk satu kad.
kad_idnostring(32)

pFS7Fjg8kV1I

MkuCKc

Mesej ralatdibuka User openidcard_idkad IDbegin_time
Nama parameterPenerangan
errcode kod ralat
masa penggunaan
masa tamat
user_card_status

Status kad yang sepadan dengan kod semasa

NORMAL Normal

DIBATALKAN RE                                                                                                                                                                                                                                                                                                                                                                    Tamat                                           Tamat tempoh                                                                                                          Dibenarkan tamat tamat tempoh tamat

TIDAK TERSEDIA Tidak sah

Jika kod tidak ditambah atau dipindahkan dan diterima, ralat akan dilaporkan: kod bersiri tidak sah

boleh dihapuskan benar bermakna ia boleh dihapuskan, palsu bermakna ia tidak boleh dihapuskan






















Nota:

1 Tempoh sah tempoh tetap akan ditukar mengikut masa pengambilan sebenar oleh pengguna , 2013, tempoh sah tempoh tetap ialah 90 hari, iaitu Ia sah dari 1 Oktober hingga 29 Disember 2013.

2. Tidak kira sama ada check_consume diisi dengan benar atau palsu, apabila kod tidak ditambah atau kod dipindahkan dan diterima, ralat seragam akan dilaporkan: kod siri tidak sah

1.2 Antara muka Kod Pengunderaitan

Antara muka kod penggunaan ialah satu-satunya antara muka untuk membatalkan kupon Pembangun boleh menghubungi antara muka semasa untuk membatalkan kupon pengguna.

Perihalan permintaan panggilan antara muka

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

参数说明

Adakah parameter
diperlukan?






POS data

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

rentetan(32)

pFS7Fjg8kV1Id

🎜🎜Dz01r4SQwMkuCKc🎜🎜		ID Kupon. Diperlukan apabila use_custom_code diisi dengan benar semasa membuat kupon. Kod bukan tersuai tidak perlu diisi.
kod ialah kod kod yang perlu disahkan.








Pulangan data 

非自定义Code卡券的请求
{
  "code": "12312313"
}
或自定义Code卡券的请求
{
  "code": "12312313",
  "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
Nama parameterPenerangan
errcodeKod ralat.
errmsg mesej ralat.
openidIdentiti unik pengguna dalam akaun awam.
kad_idID kupon kad.








:

1. Hanya kad dan kupon yang sah boleh dihapuskan, jika kad dan kupon adalah status abnormal, tidak boleh dihapuskan. (Status pengecualian termasuk: kad dan kupon dipadamkan, tidak sah, tamat tempoh, sedang dipindahkan, dikembalikan untuk pemindahan, tidak sah)

2.

Kupon dengan kod tersuai (use_custom_code is true) dihapuskan dalam kod , antara muka ini mesti dipanggil. Digunakan untuk menukar status kod pelanggan pengguna. Apabila memanggil antara muka untuk kad dan kupon dengan kod tersuai, data pos mesti mengandungi card_id, jika tidak, kod bersiri yang tidak sah akan dilaporkan.

2 Pengesahan dalam talian

2.1 Tarik kad dan antara muka senarai kupon (JS-SDK)

WeChat JS-SDK hanya boleh digunakan dalam penyemak imbas terbina dalam WeChat yang lain, dan panggilan tidak sah daripada penyemak imbas terbina dalam yang lain WeChat menyediakan antara muka chooseCard untuk halaman web bahagian hadapan pedagang untuk dihubungi, yang digunakan untuk menarik keluar kad dan kandungan kupon syarat penapis pedagang di bawah nama pengguna. Klik untuk melihat Panggil senarai kad dan kupon yang berkenaan dengan kedai dan dapatkan senarai pilihan pengguna JS-SDK

1476165443869832.jpg

2.2 Antara muka penyahkodan kod

antara muka penyahkodan kod

menyokong dua senario: 🎜 🎜

1. Selepas pedagang memperoleh chooses_card_info, lulus medan card_id dan encrypt_code melalui antara muka penyahkodan untuk mendapatkan kod sebenar.

2. Kod akan disulitkan dalam tandatangan pautan luar dalam kad, dan kod sebenar boleh diperolehi dengan menghubungi antara muka penyahkodan.

Penerangan permintaan panggilan antara muka

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

Penerangan parameter

Adakah parameter
diperlukan?






POS data

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


  参数说明

Nama parameter encrypt_code
ialah string(128) XXIzTtMqCxwOaawoE91+VJdsFmv7b8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdEKod Disulitkan.








Pulangan data

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

Perihalan parameter
Nama parameter

Mesej ralatkodpenyahsulitan Kod sebenar diperolehi kemudianakaun dinyahkod Mendapat kod penyulitan.




2. Jika pembangun memperoleh kod yang disulitkan daripada URL, sila beri perhatian kepada urldecode terlebih dahulu, jika tidak, ralat akan dilaporkan.



3.encrypt_code ialah kod yang disulitkan yang diperolehi dengan menyulitkan kod kad, yang sepadan dengan kod satu sama satu.


4. Pembangun hanya boleh menyahsulit kod akaun rasmi ini, jika tidak, ralat akan dilaporkan.

2.3 Antara muka Kod Pertanyaan

Kami amat mengesyorkan agar pembangun memanggil antara muka kod pertanyaan sebelum memanggil antara muka kod hapus kira dan menyemak kod dalam status haram (seperti dipindahkan, dipadamkan dan disahkan ) sebelum menghapuskannya Jualan, dsb.) diproses.

2.4 Antara muka Kod Hapus Kira

Antara muka untuk menghapuskan kupon biasa dalam talian adalah sama seperti antara muka untuk menghapuskan kupon biasa di luar talian.

←
→

Laman web PHP Cina

RumahRumahKursusKursusArtikelArtikelSoal JawabSoal JawabKamusKamusManualManualMuat turunMuat turuncaricariAPPMuat turun APPMuat turun