Cara menyambung

Untuk menyambung sistem pembayaran Coinpayments, anda memerlukan 4 nilai: ID penjual, rahsia IPN (untuk webhook), kunci api peribadi dan kunci api awam, serta menetapkan url webhook.

Pergi ke akaun Coinpayments -> Tetapan

https://ww.coinpayments.net/index.php?cmd=acct_settings

Pada tab pertama, salin ID penjual (seller ID)

Kemudian pergi ke tab Tetapan penjual dan cipta serta masukkan kunci rahsia IPN - IPN secret (Ini digunakan untuk mengesahkan bahawa webhook datang daripada kami, gunakan rentetan kompleks yang boleh dipercayai yang sukar diteka.)

Link IPN - url alamat untuk webhook, tambahkan yang berikut: https://chatter.salebot.pro/coinpayments_callback/result

Kemudian pergi ke bahagian API Keys dan hasilkan pasangan kunci untuk mengakses api.

Simpan semua tetapan, salin data dan pergi ke tetapan di Mavibot. Buka bahagian sistem pembayaran, pilih Coinpayments.

                                         ![](https://docs.mavibot.ai/files/MvNMf4eWw0m6naas0qkF)

Kita perlu memasukkan data.

Untuk menjana pautan ke pembayaran, anda perlu menetapkan nilai pembolehubah yang diperlukan: original_currency - Mata wang asal transaksi. sending_currency - Mata wang yang dihantar oleh pembeli. Contohnya, jika produk anda dihargai dalam USD tetapi anda menerima BTC, anda harus menggunakan original_currency = USD dan sending_currency = BTC. original_currency dan sending_currency boleh mempunyai nilai yang sama jika penukaran mata wang tidak diperlukan.

buyer_email ialah alamat e-mel pembeli. Untuk menghantar pemberitahuan jika pembayaran kurang dan anda perlu membayar tambahan atau untuk bayaran balik. Jika pembolehubah ini tidak dinyatakan, mel akan diambil secara automatik daripada pembolehubah e-mel, jika pengguna memilikinya di mavibot.

Selepas itu, anda harus menetapkan nilai pembolehubah payment_sum (contohnya, 10 atau 0.0055 (melalui titik!)), serta-merta selepas itu pembolehubah paycoinments_pay_url akan muncul. Pembolehubah ini boleh dipaparkan dengan pautan atau diletakkan pada butang dengan teks "Bayar". Pautannya ialah: https://www.coinpayments.net/index.php?cmd=checkout\\&id=CPFK5QZ3FKSNWHI75CO8M4BRVkey\\&e7782d2ce24f7d03815606a5c4a882eb

Juga, sebelum menetapkan nilai payment_sum, anda boleh menentukan pembolehubah pilihan berikut untuk mengkonfigurasi pembayaran.

payment_description - nama produk, akan dipaparkan pada halaman maklumat pembayaran dan dalam IPN untuk transaksi.

buyer_name - nama pembeli

Cara Membuat Pautan ke Pembayaran

Buat pautan ke pembayaran sebanyak 0.44444

                             ![](https://docs.mavibot.ai/files/DaNp1xDgBvz5OTcwBFvm)

Sila ambil perhatian:

  • Mula-mula nyatakan e-mel
  • Seterusnya parameter pilihan first_name, payment_description, dsb.
  • Dan akhir sekali, tetapkan nilai pembolehubah payment_sum

Perhatikan, mula-mula kita tetapkan pembolehubah untuk tetapan, kemudian payment_sum. Anda boleh menentukan pembolehubah lebih awal dalam rantai, bukan dalam satu blok, ini adalah contoh.

Seterusnya, di tempat yang sesuai, cetak pembolehubah coinpayments_pay_url yang mengandungi pautan

                                           ![](https://docs.mavibot.ai/files/JRMNcszCfDcEycARJXZN)

Untuk membuat pembayaran berulang, anda mesti menetapkan semula payment_sum, pautan yang dijana sebelumnya, dan selepas anda menetapkan semula pembolehubah payment_sum untuk mendapatkan pautan baharu

Cara memproses hasil

Selepas pembayaran berjaya, bot akan menerima kolbek, yang mana anda boleh memahami bahawa terdapat pembayaran yang berjaya. Kolbek ini dalam sistem anda lihat sebagai mesej daripada pengguna, supaya ia tidak boleh dihantar oleh pengguna, ia terdiri daripada 10 aksara pertama kunci rahsia dan notasi _success, contohnya: 16831CF4b5_success

Kolbek ini TIDAK DILIHAT oleh pengguna, ia hanya dipaparkan kepada pengendali.

Jenis perbandingan hendaklah "Padanan penuh"

Juga selepas pembayaran berjaya, pembolehubah coinpayments_payment_completed ditetapkan kepada true

Sebagai contoh, anda boleh membuat blok pemprosesan pembayaran berjaya dengan syarat dan mencetak mesej yang sepadan kepada pengguna:

Setelah selesai pembayaran, pembolehubah coinpayments_payment_callback akan ditambahkan kepada pelanggan, yang mengandungi data respons sistem pembayaran untuk transaksi yang telah selesai. Anda boleh mengekstrak data yang diperlukan daripada kamus menggunakan kaedah get.

Cara menyemak status pembayaran

Untuk menyemak status pembayaran, anda perlu memanggil coinpayments_get_payment_status() dalam medan Kalkulator

Contoh:

                                        ![](https://docs.mavibot.ai/files/5JsnGpdWPUT2RRfWWDcU)

                                       ![](https://docs.mavibot.ai/files/Lk88JB8Wzcq9RRSFSOqF)

Contoh status:

Menunggu dana pembeli...

Dana diterima dan disahkan dihantar kepada anda tidak lama lagi…

Selesai