Letakkan kupon


Log kemas kini

1. Buat kad dan rak kupon baharu Antara muka menyokong pembangun untuk memanggil antara muka untuk membuat rak kad dan kupon untuk meletakkan kad dan kupon






1 Cipta antara muka kod QR

Pembangun boleh menghubungi antara muka ini untuk menjana kad dan kod QR kupon untuk pengguna mengimbas dan menambah kad dan kupon pada pakej kad.

Apabila memanggil antara muka untuk kad dan kupon dengan kod kod tersuai, kod tersebut perlu dinyatakan dalam data POST tidak perlu dinyatakan Perkara yang sama berlaku untuk menentukan openid. Kod QR yang ditetapkan hanya boleh diimbas dan dikumpulkan sekali oleh pengguna.

Selepas mendapatkan tiket kod QR, pembangun boleh menukar tiket untuk antara muka kod QR.

Penerangan permintaan panggilan antara muka

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

Penerangan parameter

Nombor versiKemas kini kandungan Masa kemas kini

2 Antara muka kod import baharu ditambah untuk menyokong pembangun kod tersuai mengimport kod untuk mengedarkan kad dan kupon melalui pengedaran besar-besaran. , perkhidmatan pelanggan dan saluran lain

2015-8 -31

Data JSON access_tokenialah Kelayakan antara muka panggilan
Adakah parameter diperlukan Penerangan
data POS
🎜🎜






POS data

Pemaju boleh menetapkan Imbasan kod QR untuk menerima satu kupon Pada masa ini, data POST ialah: 

 {
"action_name": "QR_CARD", 
"expire_seconds": 1800,
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", 
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"is_unique_code": false ,
"outer_str":"12b"
  }
 }
}

Apabila pembangun menyediakan untuk mengimbas kod QR untuk menerima berbilang kupon, data POST ialah: 

{
"action_name": "QR_MULTIPLE_CARD", 
"action_info": {
"multiple_card": {
"card_list": [
{
"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo88",
"code":"2392583481",
"outer_str":"12b"
}, 
{
"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo98",
"code":"2392583482",
"outer_str":"12b"
}
]
}
}
}

Parameter. penerangan Nama parameter

kodID Kupon. openidnostring(32)Untuk kod QR kad keahlian, setiap kali pengguna mengimbas kod untuk membuka kad keahlian dan mengklik mana-mana URL, nilainya akan dieja ke dalam; URL untuk memudahkan pembangun mencari sumber kod yang diimbas

























🎗 

{
 "errcode": 0,
 "errmsg": "ok",
 "ticket":      "gQHB8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0JIV3lhX3psZmlvSDZmWGVMMTZvAAIEsNnKVQMEIAMAAA==",//获取ticket后需调用换取二维码接口获取二维码图片，详情见字段说明。
 "expire_seconds": 1800,
 "url": "http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o ",
 "show_qrcode_url": " https://mp.weixin.qq.com/cgi-bin/showqrcode?  ticket=gQH98DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0czVzRlSWpsamlyM2plWTNKVktvAAIE6SfgVQMEgDPhAQ%3D%3D"
 }

Perihalan parameter

Nama parameter
ialah rentetan(20) 110201201245Kupon dan kupon mesti diisi jika medan use_custom_code adalah benar. .

oXch-jkrxp42VQu8weCwDt97qo		Nyatakan openid penerima, dan hanya pengguna ini boleh menerimanya. Kad dan kupon yang medan bind_openidnya adalah benar mesti diisi, dan openid yang tidak ditentukan tidak perlu diisi.
expire_secondsnounsigned int 60Specify masa kesahihan kod QR, julatnya adalah 60 ~ 1800 saat. Jika tidak diisi, ia akan sah selama 365 hari secara lalai kod QR, dan yang dihasilkan Kod QR akan diberikan secara rawak, Ia tidak boleh diimbas semula selepas menerimanya. Isikan benar atau salah. Nilai lalai adalah palsu. Harap maklum bahawa apabila mengisi medan ini, kad mesti lulus semakan dan inventori bukan 0. ID ialah integer, panjang Terhad kepada 60 digit.Nilai adegan tersuai ini akan dimasukkan dalam tolak acara yang dicetuskan selepas pengguna menerima kupon. medan versi , jenis rentetan Apabila pengguna menerima kad buat kali pertama , dia akan menerimanya melalui Acara itu ditolak kepada peniaga

Mesej ralattiket Dapatkan Tiket kod QR, dengan panggilan tiket ini anda boleh menukar kod QR dalam masa yang sah. . untuk melompat ke halaman kod QR
melalui antara muka kod QR pertukaran tiket










Nota:

1. Kupon kod tersuai, QR yang dijana kod hanya boleh dikumpul sekali pada satu masa. Jika pembangun mahu menggunakan sistem kod sirinya sendiri dan mahu menggunakan kod QR WeChat


, dia mesti mengimport kod tersuai ； 2. Untuk menerima berbilang kod QR, isikan sehingga 5 kad_id pada satu masa, jika tidak, ralat akan dilaporkan.

2 pengeluaran kupon dalam talian HTML5 (antara muka JS-SDK) WeChat JS-SDK hanya menyokong penggunaan dalam penyemak imbas terbina dalam WeChat, dan panggilan daripada penyemak imbas lain tidak sah.

WeChat menyediakan antara muka addCard untuk pedagang menghubungi halaman web bahagian hadapan, yang digunakan untuk menambah satu atau lebih kad dan kupon pada pakej kad pengguna. Untuk butiran, sila lihat Batch Tambah Kad dan Antara Muka Baucar.

1476408558333646.jpg


3 Meletakkan kupon melalui rak kupon

Pengenalan kepada kupon. rak pon menyokong pembangun untuk menjana kad dengan memanggil Baucar antara muka koleksi halaman H5, dan dapatkan pautan halaman untuk melaksanakan tindakan kad dan kupon.

Pada masa ini, kad dan rak kupon hanya menyokong kad dan kupon tanpa kod tersuai

Kad dan kupon dengan kod tersuai mesti terlebih dahulu menghubungi Import antara muka kod untuk mengimport kod sebelum ia boleh digunakan seperti biasa. . Apabila membuat rak, anda perlu mengisi medan pemandangan laluan penghantaran.

1476408583576222.png

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

Permintaan perihalan parameter

Adakah parameter






POS data

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

Penerangan parameter

diperlukan?
SCENE_NEAR_BY menu tersuai SCENE_MENU berdekatan SCENE_QRCODE QR code SCENE_ARTICLE artikel akaun awam SCENE_H5 h5 halaman SCENE_IVR balasan automatik SCENE_CARD_CUSTOM_CELL kad dan sel tersuai kupon kad
















Kembalikan keterangan data

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

Penerangan MedanKod ralat 0 adalah perkara biasa.

fielddescriptionis ia diperlukan?
BannerThe Banner Image Link halaman mesti dipanggil. ialah tajuk halaman
tajuk.Ya
boleh_shareJika page boleh dikongsi, isikan betul/salah Nilai adegan hantaran halaman;
ialah
card_listsenarai kupon kad, setiap item mempunyai dua medan ialah
kad_id untuk diletakkan pada halaman is
thumb_urlthumbnail urlis
errmsg mesej ralat.
urlpautan rak.
page_idID Rak. Pengecam unik rak.








kad kumpulan keluaran Pemaju sila beri perhatian khusus pada masa ini, kad pengeluaran kumpulan dan antara muka kupon hanya menyokong pengeluaran bukan Kad dengan kod kod tersuai. Jika pedagang dengan kod tersuai ingin menggunakan fungsi ini, mereka perlu memanggil antara muka kod import untuk mengimport kod tersuai ke dalam pelayan WeChat terlebih dahulu.

4.1 Import kod tersuai (hanya untuk peniaga kod tersuai)

Pengenalan antara muka

Modul ini hanya untuk pedagang kod tersuai, pembangun kod bukan tersuai harus mengabaikannya secara automatik. Pembangun boleh mengimport kod tersuai ke dalam pelayan WeChat terlebih dahulu untuk mendapatkan keupayaan penghantaran yang sama seperti pedagang bukan kod tersuai, seperti pengedaran kumpulan, mengeluarkan kad dan kupon melalui mesej perkhidmatan pelanggan, dsb.

Kupon selepas mengimport kod adalah bersamaan dengan kupon bukan kod tersuai apabila dikeluarkan kupon adalah berbeza daripada kaedah penciptaan sebelumnya Adalah disyorkan bahawa pembangun menggunakan proses berikut untuk membuat kupon mod kod pra-simpan, jika tidak, ralat akan dilaporkan.

Langkah 1: Buat kupon mod pra-simpan, tetapkan nilai awal kuantiti inventori kepada 0, dan isikan medan get_custom_code_mode; antara muka kod import dan Semak kod

Langkah 3: Panggil antara muka inventori pengubahsuaian untuk membuat inventori kad kurang daripada atau sama dengan bilangan kod yang diimport. (Adalah disyorkan untuk menetapkannya sama untuk mengelakkan kekeliruan)


1476408598664187.png

Kupon yang tidak baru dibuat

Jika pembangun sudah mempunyai kupon dan mahu menukarnya kepada mengikuti proses pra-simpan kod itu, ia adalah kod proses yang dicadangkan berikut. untuk mengemas kini kupon.

Langkah 1: Panggil antara muka kod import untuk mengimport sejumlah kod tersuai dan semak kod

Langkah 2: Panggil kad pertukaran dan antara muka maklumat kupon untuk mengisi medan get_custom_code_mode; antara muka inventori ubah suai untuk menyimpan kad dan kupon dalam inventori Kuantiti ditetapkan kepada nombor yang sama dengan bilangan kod yang diimport.

1476408610235204.png


4.1.1 Isi/kemas kini medan kod import yang diperlukan

Penerangan antara muka

Kad dan kupon dengan kod tersuai hanya menyokong penciptaan API semasa membuat, pastikan anda menambah medan berikut pada base_info (lihat dokumen antara muka CreateCard untuk mendapatkan butiran Hanya selepas menambah dua medan yang dinyatakan berikut, anda boleh menghubungi antara muka import kod untuk kod Import

BidangContohPenerangan
base_info get_custom_code_mode
DAPATKAN_CUSTOM_CODE_MODE_DEPOSITSelepas mengisi ruangan ini, sejak Hanya selepas menentukan kupon kod anda boleh mengimport kod dan meletakkannya. use_custom_code
trueTetapkan kupon kepada kod tersuaiContoh JSON semasa membuat kad Nota:



Buat/ Bila mengemas kini get_custom_code_mode, anda mesti menyemak hubungan antara nombor inventori dan bilangan kod yang diimport Apabila bilangan kod yang diimport kurang daripada nombor inventori, ralat akan dilaporkan. . pengeluar Antara muka diimport ke bahagian belakang WeChat.



Penerangan Antara Muka


Pembangun boleh menghubungi antara muka ini untuk mengimport kod tersuai ke dalam kad WeChat dan hujung belakang kupon, dan ejen sampingan WeChat akan menyimpan dan mengeluarkan kod tersebut.

Nota: 1) Had atas bilangan kod masuk untuk satu panggilan ke antara muka ialah 100.

2) Setiap kod tidak boleh menjadi rentetan kosong.

3) Selepas import selesai, sistem akan secara automatik menentukan sama ada inventori yang ditetapkan oleh pembekal adalah konsisten dengan jumlah sebenar kod yang diimport.

4) Jika import gagal, import berulang disokong sehingga gesaan berjaya.

Perihalan permintaan panggilan antara muka

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

Permintaan perihalan parameter

Adakah parameter






POS data

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


penerangan medan ID

diperlukan?
ialah kod, yang perlu diimport ke dalam kad WeChat dan bahagian belakang kupon Had atas ialah 100.
ialah






Kembalikan keterangan data

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

Penerangan medan

fielddescription
errcodeerror code, 0 adalah normal; .
succ_codeBilangan kejayaan
duplikat_kodDupli diimport secara automatik
fail_codeBilangan kegagalan.
4.1.3 Tanya bilangan antara muka kod yang diimport



Penerangan antara muka



Pembangun disokong untuk memanggil antara muka ini untuk menanyakan bilangan import kod yang berjaya ke bahagian belakang WeChat.


Perihalan permintaan panggilan antara muka

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

Permintaan perihalan parameter

Adakah parameter
diperlukan?




POST data

FieldPeneranganAdakah ia diperlukan?
kad_id_id ialah .

Kod ralat 0 adalah perkara biasa.

errmsg mesej ralat.
countBilangan kod yang telah berjaya didepositkan.







🎚 Untuk mengelakkan ralat import, amat disyorkan bahawa pembangun menyemak nombor tersebut kod selepas Apabila menyemak kod pengesahan antara muka kod diimport ke bahagian belakang WeChat.

Penerangan antara muka

menyokong pembangun untuk memanggil antara muka ini untuk menanyakan status import kod ke bahagian belakang WeChat.

Perihalan permintaan panggilan antara muka

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

请求参数说明

Adakah parameter
diperlukan?




POST data

.

ialah kod telah diperibadikan dalam kad WeChat dan hujung belakang kupon, had atas ialah 100.
ialah






Kembalikan keterangan data

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

Penerangan medan

fielddescription
errcodeerror code, 0 adalah normal; .
exist_codeKod yang telah berjaya didepositkan.
not_exist_codeTiada kod disimpan.
.


Sokong pembangun untuk menghubungi antara muka ini untuk mendapatkan kad dan kupon yang dibenamkan grafik dan teks Kod format standard mesej Isikan kod kembali ke dalam medan kandungan dalam

muat naik imej dan antara muka bahan teks


untuk mendapatkan imej dan bahan mesej teks yang dibenamkan dalam kad.


Nota istimewa: Pada masa ini, antara muka ini hanya menyokong kad dan kupon dengan kod bukan tersuai Kad dan kupon dengan kod tersuai perlu diimport dahulu dan kemudian dipanggil.



Penerangan permintaan panggilan antara muka


{
   "card_id" : " pDF3iY0_dVjb_Pua96MMewA96qvA "
}

Penerangan parameterData JSON access_tokenialah Kelayakan antara muka panggilan
Adakah parameter diperlukan Penerangan
data POS
🎜🎜data 




{
  "errcode":0,
  "errmsg":"ok"，
  "count":123
}
ID Kupon.
Nama parameterDiperlukanJenisNilai contoh
kad_ idtidak rentetan(32) pFS7Fjg8kV1IdDz01r4SQwMkuCKc
🎜🎜🎜🎜





Pulangan data

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

Sokongan menghubungi antara muka ini untuk menghantar mesej kupon kepada pengguna dalam kumpulan tertentu. Untuk butiran, sila lihat

Antara muka penghantaran kumpulan


Pada masa ini, antara muka ini hanya menyokong kad dan kupon dengan kod bukan tersuai Kad dan kupon dengan kod tersuai perlu diimport dahulu dan kemudian dipanggil.

4.4 Penghantaran kumpulan kad dan mesej kupon berdasarkan senarai OpenID

menyokong penghantaran kumpulan kad asli dan kupon berdasarkan OpenID. Akaun langganan tidak tersedia Akaun perkhidmatan mempunyai kebenaran antara muka selepas pengesahan. Untuk butiran, sila lihat Antara muka penghantaran pukal berdasarkan senarai OpenID

Pada masa ini, antara muka ini hanya menyokong kad dan kupon dengan kod bukan tersuai Kad dan kupon dengan kod tersuai perlu diimport terlebih dahulu dan kemudian dipanggil.

4.5 Mengeluarkan kad dan kupon melalui mesej perkhidmatan pelanggan

menyokong pembangun untuk memanggil antara muka ini untuk mengeluarkan kad dan kupon. Akaun langganan tidak tersedia dan akan tersedia selepas akaun perkhidmatan disahkan. Untuk butiran, sila lihat Antaramuka Perkhidmatan Pelanggan-Hantar Mesej

Pada masa ini, antara muka ini hanya menyokong pengisian kad dan kupon dengan kod bukan tersuai Kad dan kupon dengan kod tersuai perlu diimport dahulu dan kemudian dipanggil.

4.6 Antara muka pratonton

menyokong pembangun untuk memanggil antara muka ini untuk mengeluarkan kad dan kupon. Akaun langganan tidak tersedia dan akan tersedia selepas akaun perkhidmatan disahkan. Untuk butiran, sila lihat Pratonton antara muka

5 Statistik data saluran penghantaran

Untuk memudahkan pembangun mengira data penghantaran kad dan kupon bagi setiap saluran, medan baharu disediakan tambah. Isikan outer_str (original outer_id) dengan nilai yang berbeza ke dalam struktur json card_ext Apabila pengguna menerima kad, outer_id yang sepadan akan dibawa ke dalam acara resit dan ditolak ke pelayan pembangun.

Contoh: Tetapkan outer_str kepada 12b dalam kaedah penghantaran kod QR

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

Terima fail XML acara

{
  "errcode":0,
  "errmsg":"ok"
  "exist_code":["11111","22222","33333"],
  "not_exist_code":["44444","55555"]
}

🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜 Penerangan antara muka 🎜🎜🎜 🎜🎜 Memandangkan kad dan kupon mempunyai keperluan audit, untuk memudahkan penyahpepijatan akaun rasmi, anda boleh menyediakan beberapa akaun ujian ini boleh menerima kad dan kupon yang belum lulus semakan dan mengalami keseluruhan proses. 🎜🎜🎜🎜🎜Nota untuk pembangun🎜🎜🎜🎜🎜🎜1 Menyokong tetapan senarai putih untuk kedua-dua medan "openid" dan "nama pengguna", dengan jumlah had atas 10. 🎜🎜🎜

2. Tetapkan antara muka senarai putih ujian kepada tetapan penuh, iaitu apabila senarai ujian berubah, anda perlu memanggil antara muka ini untuk memasukkan semula ID semua penguji

3 pengguna menerima kad, Abaikan status tidak sah kad, pemaju sila beri perhatian.

Penerangan permintaan panggilan antara muka

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

Penerangan parameter

Adakah parameter
Nama parameterPenerangan
errcode kod ralat
Mesej ralat
kandungan Mengembalikan sekeping kod html, yang boleh dibenamkan terus ke dalam badan mesej grafik. Iaitu, anda boleh membenamkan kod ini ke dalam medan kandungan dalam muat naik imej dan antara muka bahan mesej teks.





POS data

{
  "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}

perihalan parameterNama parameter

diperlukan?
dibuka
Tidakstring(20) o1Pj9jmZvwSyyyyyyBa4aULW2mA Senarai openid yang diuji.Nama pengguna




🎚 

 {
"errcode":0,
"errmsg":"ok",
"content":"<iframeclass=\"res_iframecard_iframejs_editor_card\"data-src=\"http: \/\/mp.weixin.qq.com\/bizmall\/appmsgcard?action=show&biz=MjM5OTAwODk4MA%3D%3D&cardid=p1Pj9jnXTLf2nF7lccYScFUYqJ0&wechat_card_js=1#wechat_redirect\">"
}
Nama parameterPenerangan
errcodeKod ralat, 0 adalah perkara biasa.
errmsg mesej ralat.

←
→

Laman web PHP Cina

RumahRumahKursusKursusArtikelArtikelSoal JawabSoal JawabKamusKamusManualManualMuat turunMuat turuncaricariAPPMuat turun APPMuat turun