Menyambungkan sistem pembayaran
Menyambung di pihak Telegram
Langkah 1. Log masuk ke akaun rakan kongsi anda
Pada halaman yang terbuka, klik "Log masuk melalui Telegram", kemudian masukkan nombor telefon anda dalam tetingkap timbul "Appears oauth.telegram.org" dan klik "Apply".
Adalah perlu untuk menyambungkan sistem pembayaran melalui pelayar web dan melalui aplikasi:
- Anda akan menerima mesej Telegram yang meminta kebenaran - klik "Apply".
- Anda juga perlu klik "Apply" dalam tetingkap timbul "oauth.telegram.org" dalam pelayar web.
Adalah disyorkan untuk menggunakan akaun yang boleh diakses oleh orang yang bertanggungjawab dalam kewangan. Bagi entiti undang-undang – wakil yang diberi kuasa.
Langkah 2. Ambil tinjauan ringkas
Jika anda log masuk buat kali pertama atau anda memerlukan beberapa maklumat tambahan, WalletPay menawarkan anda untuk menjawab beberapa soalan untuk mendapatkan maklumat yang lebih terperinci. Terdapat dua langkah:
1. Soal selidik
2. Pemeriksaan KYB (Know Your Business) atau KYC (Know Your Customer)
Selepas selesai, permohonan anda akan disemak tidak lama lagi dan anda akan dimaklumkan tentang keputusan. Jika berjaya, anda akan melihat komisen yang dikenakan oleh perkhidmatan dan mendapat akses ke akaun anda di mana anda boleh memulakan integrasi.
Bagi entiti undang-undang, borang hanya boleh diisi oleh orang yang dipercayai: pengarah atau pekerja melalui surat kuasa.
Langkah 3. Cipta "Kedai" pertama.
Selepas berjaya melengkapkan "Tinjauan", anda akan dicadangkan untuk mencipta kedai pertama anda.
Langkah 4. Cipta "Kunci API"
Selepas nama kedai pertama, anda akan dicadangkan untuk menyediakannya:
- Jana kunci API.
- Salin kunci API anda dan mula berintegrasi dengan Mavibot.
Langkah 5. Cipta pesanan dan terima pautan pembayaran
Jika anda ingin meletakkan pautan dalam butang, gunakan Inline Button.
Sila ambil perhatian bahawa hanya "customerTelegramUserId" yang ditentukan boleh membuka halaman pembayaran.
Langkah 6. Keluarkan dana
Selepas pelanggan mengesahkan pembayaran, dana akan dikreditkan ke aset anda dan akan ditahan selama 48 jam secara lalai. Selepas masa ini, anda akan dapat mengeluarkan dana ke baki Wallet anda, yang anda gunakan untuk log masuk ke perkhidmatan Paypal Wallet.
Langkah 7. Pulangan dana
Pada masa ini, pengeluaran dana tersedia dari akaun Wallet anda, yang anda gunakan untuk log masuk ke WalletPay. Tetapi ia akan tersedia dalam akaun Merchant anda tidak lama lagi.
Bagaimanakah rupa butang pembayaran?
Apabila menyepadukan Bot Telegram anda dengan "Wallet Pay API", pastikan butang pembayaran mematuhi cadangan berikut:
- Dinamakan sebagai salah satu daripada dua cara:
- 👛 Wallet Pay
- 👛 Bayar melalui Wallet
- Terletak di atas butang lain (jika ada).
Nota. 👛 — ini adalah emoji (lihat https://emojipedia.org/purse/).
Lihat contoh dalam [Demo Store Bot].
Menyambung ke Mavibot
Log masuk ke projek dan klik butang “Connect” untuk Wallet Pay dalam bahagian “Payment systems”.
Dalam tetingkap yang terbuka, masukkan kunci API yang dijana untuk kedai WalletPay anda.
- Sedia! Kini pelanggan boleh membayar pembelian di kedai anda dalam mata wang kripto (USDT, Toncoin dan Bitcoin) menggunakan perkhidmatan Paypal Wallet.
Cara menjana pautan pembayaran
Cipta blok pembina corong dan panggil fungsi “wallet_pay_generate_payment_url” dalam kalkulator, dengan menghantar parameter yang diperlukan kepadanya:
| Parameter | Penerangan parameter |
|---|---|
| amount | jumlah pembayaran dalam mata wang kripto atau mata wang fiat lain yang tersedia untuk penukaran kepada “TON”. |
| сurrency_code | Mata wang pembayaran lalai ialah "RUB". Senarai mata wang yang tersedia: "TON" "BTC" "USDT" "EUR" "USD" "RUB" |
| description | penerangan ringkas pesanan dari 5 hingga 100 aksara. |
| timeout_seconds | Tempoh sah pautan dalam saat, lalai ialah 3600 saat. |
Apabila blok dicetuskan dalam sembang dengan bot, pelanggan akan menerima pautan pembayaran, dan pembolehubah pelanggan wallet_pay_payment_completed akan dicipta dengan nilai False.
Pautan ini hanya boleh dibuka dalam sembang dengan bot yang disambungkan ke akaun pengebilan WalletPay.
Pengesahan pembayaran
Selepas pembayaran berjaya, pembolehubah wallet_pay_payment_completed pelanggan akan ditetapkan kepada True, dan penjual akan menerima panggil balik dalam bentuk 4690FE98_success, yang terdiri daripada:
- “4690FE98” - ini adalah 8 aksara pertama kunci API Wallet Pay.
- perkataan tentang kejayaan
! jika terdapat ralat pembayaran, anda akan menerima panggil balik dengan akhiran “_fail”.
Alamat untuk pemberitahuan (panggil balik): https://chatter.salebot.pro/wallet_pay/payment_callback - dimasukkan ke dalam tetapan sistem pembayaran
Panggil balik boleh dibenamkan dalam syarat blok untuk menghantar mesej kepada pelanggan tentang pembayaran yang berjaya (atau ralat pembayaran):
Jika anda tidak mahu mengeluarkan pelanggan daripada skema chatbot utama, gunakan blok "Non state condition". Anda tidak boleh pergi ke blok ini, jadi pelanggan tidak akan dikeluarkan daripada corong utama selepas pembayaran dan akan menerima pemberitahuan pembayaran berjaya.
pemberitahuan tentang pembayaran berjaya.Dan jika anda perlu meneruskan corong dengan reaksi terhadap pembayaran yang berjaya, maka gunakan blok "Start condition", maka pelanggan akan bergerak dari blok pembayaran ke blok "Start condition", dari mana anda boleh meneruskan corong.
Maklumat lanjut tentang blok bersyarat disediakan dalam artikel dengan nama yang sama. pautanblok dengan syarat diterangkan