- Cara menyediakan Paypal
- Cara membuat pautan pembayaran
- Cara membuat pembayaran berulang
- Cara memproses hasil
Cara menyediakan Paypal
Untuk bekerja dengan Paypal, anda perlu mendapatkan dua kunci: client_id dan secret
Pergi ke halaman https://developer.paypal.com/developer/applications/
Dan pilih daripada senarai atau buat aplikasi baharu:
Di bahagian atas, tukar ke mod Live dan pilih aplikasi yang dikehendaki. Halaman tetapan dibuka, di mana data yang kami perlukan terletak:
Salin data dan tampalkannya ke dalam medan yang sesuai dalam tetapan Mavibot: pergi ke bahagian "Pemerolehan" dan cari perkhidmatan Paypal:
Seterusnya, klik "Sambung" dan isikan medan dengan kunci rahsia dan ID Pelanggan yang diterima sebelum ini:
Seterusnya, klik "Simpan tetapan". Ini melengkapkan sambungan.
Cara membuat pautan pembayaran
Menggunakan pembolehubah payment_sum
Untuk menjana pautan pembayaran, anda perlu menetapkan nilai pembolehubah payment_sum dan serta-merta selepas itu pembolehubah paypal_pay_url akan muncul.
| Parameter fungsi | Penerangan parameter | Nota |
|---|---|---|
| payment_title | (pembolehubah pilihan)ini adalah nama produk. | Jika tidak dinyatakan, ia diisi dengan teks: “Pembayaran invois order_id" (order_id ialah pengecam pesanan dalam mavibot) |
| payment_description | penerangan produk, medan pilihan | |
| company_name | nama syarikat anda dipaparkan di bahagian paling atas halaman pembayaran (contoh di bawah, syarikat) |
Selain itu, sebelum menentukan payment_sum, anda boleh menentukan bahasa halaman pembayaran.
Untuk melakukan ini, tetapkan pembolehubah locale. Bahasa lalai ialah Rusia (ru-RU). Pilihan yang mungkin: da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, zh-TW, dsb. (set bahasa yang tersedia berbeza-beza, rujuk sumber asal) sumber asal)
Anda juga boleh menentukan mata wang di mana pembayaran diterima. Untuk melakukan ini, nyatakan pembolehubah currency, ruble (RUB) ditetapkan secara lalai, untuk dolar, tetapkan nilainya kepada USD (currency = USD). Pilihan mata wang yang mungkin boleh didapati di pautan. pautan.
Dan parameter tambahan ketiga ialah company_name - nama syarikat anda, dipaparkan di bahagian paling atas halaman pembayaran (contoh di bawah, syarikat)
Pembolehubah paypal_pay_url boleh dipaparkan dengan pautan atau diletakkan pada butang dengan teks "Bayar".
Pautan kelihatan seperti: https://www.paypal.com/checkoutnow?token=07N53571YM296381N
Contoh pelaksanaan.
Menetapkan jumlah pembayaran dan nama syarikat
Sila ambil perhatian: pembolehubah payment_sum diberikan nilai terakhir, selepas pembolehubah pilihan payment_title, company_name, dsb.
Seterusnya, nyatakan pembolehubah #{paypal_pay_url} dalam blok "Status" kedua:
- Pembolehubah boleh dinyatakan dalam medan mesej:
- Pembolehubah boleh dinyatakan dalam medan url dalam tetapan lampiran:
- Pembolehubah boleh dinyatakan dalam medan url dalam tetapan butang:
Apabila membuka pautan pembayaran
Menggunakan fungsi kalkulator paypal_payment_url
Buat blok pembina corong dan gunakan fungsi paypal_payment_url dalam kalkulator, hantar parameter yang diperlukan kepadanya:
Apabila syarat blok dipenuhi, pelanggan akan menerima pautan pembayaran, dan pembolehubah pelanggan paypal_payment_completed akan dibuat dengan nilai False.
url = paypal_payment_url(2500,`` 'RUB', 'Pembayaran invois payment_id','penerangan pembayaran', 'nama organisasi', 'ru-Ru')
Cara membuat pembayaran berulang
Untuk membuat dan menerima pautan untuk membayar dengan pembayaran berulang, anda perlu membuat pelan langganan dalam akaun peribadi anda.
Memilih tawaran yang telah dibuat:
Sebagai alternatif, taip nama tawaran ke dalam bar carian dan klik "Buat".
Pilih jenis auto-debit Tetap:
Buat langganan
Memilih mata wang langganan dan syarat debit:
Perhatian!!
Dalam Mavibot, mata wang lalai adalah dalam euro, jika debit dalam dolar atau dalam mata wang lain, maka semasa membuat langganan, nyatakan mata wang yang anda perlukan dan dalam Mavibot mata wang yang sama daripada langganan Paypal.
Seterusnya, aktifkan langganan:
Selepas penciptaan, IDnya akan tersedia, yang akan kami gunakan pada masa hadapan untuk membuat langganan dan menerima pautan pembayaran.
Pautan pembayaran dijana dan dikembalikan oleh fungsi:
paypal_subscription_url(plan_id, shipping_currency, shipping_payment_sum, start_time)
| Parameter fungsi | Penerangan parameter |
|---|---|
| ! plan_id | ID pelan langganan |
| ! shipping_currency | jika pembayaran untuk pelan yang ditetapkan adalah dalam dolar, maka anda tidak perlu menghantar apa-apa, jika tidak, kami menghantar kod mata wang yang anda nyatakan dalam pelan. Mata wang di mana penghantaran dibayar dihantar di sini (walaupun untuk kos sifar). Secara lalai, USD |
| shipping_payment_sum | Ini adalah parameter pilihan yang menentukan kos penghantaran. Secara lalai, nilai ditetapkan kepada sifar. |
| start_time | parameter pilihan, tarikh dan masa mula langganan. Jika anda tidak menghantar apa-apa, maka tarikh mula langganan = tarikh pembayaran. Format: %d.%m.%Y atau %d.%m.%Y %H:%M. |
Semasa membuat pautan, pembolehubah paypal_subscription_id juga akan muncul, yang akan mengandungi ID langganan.
Semasa pembayaran, anda akan menerima panggil balik, yang serupa dengan membayar pembayaran biasa.
paypal_subscription_data(paypal_subscription_id) - mendapatkan maklumat tentang langganan
| Parameter fungsi | Penerangan parameter |
|---|---|
| paypal_subscription_id | ID langganan. |
Hasil pelaksanaan fungsi - ialah tatasusunan yang mengandungi semua maklumat tentang langganan, termasuk bilangan pembayaran, bilangan percubaan caj yang gagal, status, dan banyak lagi.
Cara membatalkan langganan
Fungsi paypal_remove_subscription(paypal_subscription_id) akan membantu pelanggan membatalkan langganan mereka kepada perkhidmatan anda.
Parameter:
| Parameter fungsi | Penerangan |
|---|---|
| paypal_subscription_id | ID langganan yang disimpan ke pembolehubah pelanggan semasa melanggan. |
Cara memproses hasil
Selepas pembayaran berjaya, panggil balik akan dihantar ke bot, yang akan memberitahu anda bahawa pembayaran berjaya.
Dalam sistem, anda melihat panggil balik sebagai mesej daripada pengguna, tetapi pengguna sendiri TIDAK MELIHATnya: ia dipaparkan hanya kepada pengendali.
Untuk memproses panggil balik dalam blok dan menghantar mesej kepada pengguna tentang status pembayaran, gunakan jenis perbandingan "Padanan tepat".
Panggil balik mungkin tertangguh, jadi selepas memaparkan pautan pembayaran kepada pengguna, adalah disyorkan untuk menghantar mesej seperti: “Selepas membuat pembayaran, sila tunggu mesej pengesahan yang menunjukkan bahawa pembayaran berjaya.”
Untuk pembayaran terus
Panggil balik pembayaran berjaya terdiri daripada 10 aksara pertama rahsia dan tandatangan dengan status. Contohnya: EHsWHYOoWV_success
Contoh 1: reaksi terhadap pembayaran berjaya menggunakan blok "Syarat Mula":
Contoh 2: reaksi terhadap pembayaran berjaya menggunakan blok "Syarat Mula":
Jika anda tidak mahu membawa pengguna keluar daripada aliran chatbot utama, gunakan blok "Tiada keadaan dengan syarat" — pengguna tidak boleh diubah hala ke blok ini secara langsung, jadi selepas pembayaran berjaya mereka akan kekal dalam corong utama, sambil juga menerima pemberitahuan tentang pembayaran berjaya.
Tetapi jika anda mahu meneruskan corong berdasarkan peristiwa pembayaran berjaya, gunakan blok "Syarat Mula". Dalam kes ini, selepas melengkapkan blok pembayaran, pengguna akan diubah hala ke blok "Syarat Mula", dari mana anda boleh terus membina corong anda.
Maklumat lanjut tentang blok bersyarat disediakan dalam artikel dengan nama yang sama. blok dengan syarat diberitahu
Selepas pembayaran berjaya, pembolehubah paypal_payment_completed ditetapkan kepada True.
Selepas pembayaran selesai, pembolehubah paypal_callback_data ditambahkan pada pelanggan, yang mengandungi data sistem pembayaran terkini tentang status transaksi. Anda boleh mengekstrak data yang diperlukan daripada kamus yang diterima menggunakan kaedah get.
Untuk membuat pembayaran berulang, anda perlu menetapkan semula pembolehubah payment_sum, pembolehubah dengan pautan yang dijana sebelum ini, dan kemudian tetapkan semula pembolehubah payment_sum atau panggil fungsi untuk mendapatkan pautan baharu.
Untuk pembayaran langganan
Fungsi tetapan panggil balik untuk operasi berkaitan langganan telah ditambahkan pada 09/01/2024. Untuk panggil balik kategori ini berfungsi dengan betul, anda perlu melumpuhkan dan menyambungkan integrasi sistem pembayaran Paypal dalam projek anda.
Semasa membuat pembayaran langganan, bot akan menerima salah satu mesej berikut:
- tentang pengaktifan langganan. Contohnya, subscription_I-PTV5H4MRC1H3_activated;
- Pemberitahuan pembayaran langganan berulang yang berjaya. Contohnya, subscription_I-PTV5H4MRC1H3_paid;
- atau tentang ralat pembayaran langganan. Contohnya, subscription_I-PTV5H4MRC1H3_not_paid;
Dalam contoh di atas “I-PTV5H4MRC1H3” -ialah ID langganan pelanggan, yang boleh diakses menggunakan pembolehubah paypal_subscription_id.
Panggil balik akan menambah pembolehubah paypal_subscription_callback_data pada pelanggan, yang mengandungi data sistem pembayaran terkini tentang status transaksi. Anda boleh mengekstrak data yang diperlukan daripada kamus yang diterima menggunakan kaedah get.
Contoh 1: reaksi terhadap pengaktifan langganan menggunakan blok "Syarat Mula":
Contoh 1: Reaksi terhadap pengaktifan langganan menggunakan blok "Bukan keadaan dengan syarat":
