Pendaftaran

Selepas mendaftar dalam perkhidmatan https://auth.inxy.io/ pergi ke menu API Gerbang Pembayaran dan isi maklumat berikut:

  1. Nama dompet dan penerangan, ikon.
  2. Pautan ke laman web diletakkan atas permintaan anda.

Semua jenis mata wang kripto yang diterima hendaklah ditandakan dan klik Simpan Perubahan

Selepas menyimpan, medan data komunikasi akan dibuka.

Seterusnya, hasilkan kunci API dengan mengklik Jana(1) dan masukkan kod yang dihantar ke e-mel anda.

Pembolehubah yang diterima hendaklah disimpan di lokasi yang selamat. Juga salin Kunci Rahsia di sana.

Kunci, sekiranya hilang, boleh dijana semula (jika ini berlaku, jangan lupa untuk menukar data dalam projek).

Dalam medan Postback Url (2), nyatakan url untuk webhooks https://chatter.salebot.pro/inxy\\_callback/result

Tetapan sambungan

Kemudian pergi ke Mavibot → bahagian "Pemerolehan" → INXY dan klik sambung. Masukkan kunci API dan Rahsia yang diterima ke dalam medan.

Menjana pautan pembayaran

Untuk menjana pautan pembayaran, anda perlu menetapkan nilai pembolehubah payment_sum (contohnya, 1). Selepas itu, pembolehubah inxy_pay_url akan muncul. Pembolehubah ini boleh dipaparkan dengan pautan atau diletakkan dalam butang "Bayar".

PERHATIAN!!! Sistem berfungsi dengan dolar! Jumlah yang dinyatakan dalam payment_sum akan diterima oleh sistem pembayaran INXY sebagai dolar.

Pautan kelihatan seperti: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1

Juga, sebelum menetapkan nilai pembolehubah payment_sum, anda boleh menetapkan pembolehubah pilihan berikut untuk menyediakan pembayaran:
inxy_currency - mata wang kripto yang akan digunakan untuk pembayaran.

Anda boleh menentukan salah satu mata wang kripto yang mungkin yang anda tandakan semasa membuat kunci API. Jika anda biarkan kosong, maka pembayar akan memilih mata wang kripto daripada yang telah ditandakan..

Nilai yang tersedia: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'

inxy_description – penerangan pembayaran

Perhatian! Pertama, pembolehubah tambahan ditetapkan untuk tetapan, kemudian payment_sum.

Pembolehubah boleh ditetapkan lebih awal dalam rantai, bukannya semuanya dalam satu blok. Dan pembolehubah inxy_pay_url, yang mengandungi pautan, harus dipaparkan di tempat yang betul. Apabila anda mengklik padanya, borang pembayaran akan dibuka.

Perhatian! Baris jumlah keseluruhan mengandungi nilai dolar yang sama dengan payment_sum. Di bawah dalam jumlah kripto keseluruhan - adalah nilai dalam mata wang kripto yang dipilih. Ia sering berubah bergantung pada kadar pertukaran semasa. Ini adalah nilai yang perlu dibayar oleh pelanggan kepada anda dari dompetnya.

Perhatian!!! Alamat dompet untuk pembayaran, dalam satu sesi, dikhaskan untuk pelanggan hanya selama 2 jam. Nasihatkan pelanggan supaya memastikan masa belum tamat dan alamat dompet adalah terkini pada masa pembayaran. Jika masa sesi tamat, maka anda perlu memulakan semula proses pembayaran.

Pemprosesan hasil pembayaran (panggil balik pembayaran)

Selepas pembayaran berjaya, panggil balik akan dihantar ke bot, yang akan memberitahu anda bahawa pembayaran berjaya. Anda melihat panggil balik ini dalam sistem sebagai mesej daripada pengguna, supaya pengguna tidak boleh menghantarnya. Panggil balik ini TIDAK DILIHAT oleh pengguna sendiri, ia hanya dipaparkan kepada pengendali. INXY mempunyai beberapa jenis panggil balik:

  1. Panggil balik yang berjaya terdiri daripada 10 aksara pertama token dan postskrip kejayaan, contohnya: uc8zsjNN1x_success

Panggil balik ini diterima jika pelanggan telah membayar sepenuhnya jumlah tersebut dan tiada masalah dengan pembayaran. Bersama dengan panggil balik ini, pembolehubah inxy_payment_completed akan ditambahkan pada pembolehubah projek, yang ditetapkan kepada True. Dan juga pembolehubah inxy_payment_status akan mengambil nilai paid.

Pembolehubah inxy_payment_status boleh menukar nilainya sepanjang tempoh pemprosesan pembayaran. Selepas pengguna membuka borang, ia akan mengambil status waiting_payment, kemudian semasa pemprosesan pembayarannya ia akan mengambil nilai waiting_confirmation, dan selepas pemprosesan berjaya ia akan mempunyai nilai paid atau partially_paid.

Semasa memproses panggil balik, jenis perbandingan hendaklah "Padanan Tepat".

Sebagai contoh, anda boleh memproses pembayaran yang berjaya dalam blok bersyarat dan memaparkan mesej yang sepadan kepada pengguna:

2. Terdapat kes apabila kadar pertukaran kripto telah berubah atau dompet telah mengeluarkan komisen daripada operasi, akibatnya jumlah yang tidak lengkap dikreditkan ke akaun anda. Dalam kes ini, pembolehubah inxy_payment_status akan mengambil nilai partially_paid dan panggil balik akan dihantar ke sistem.

Dalam kes ini, anda perlu menghantar pemberitahuan kepada pelanggan yang meminta pembayaran tambahan.

Sebagai contoh, anda boleh menetapkan syarat untuk permulaan panggil balik dan, selepas mendapatkannya, hantar semula url yang telah dijana dengan pautan pembayaran kepada pelanggan, atau tetapkan syarat bahawa blok itu dicetuskan apabila pembolehubah inxy_payment_status sama dengan partially_paid.

Sila ambil perhatian bahawa pautan pembayaran hanya sah selama 2 jam! Jika pelanggan tidak sempat membayar baki bahagian, dia tidak boleh lagi membukanya. Memandangkan INXY akan memproses pembayaran pertama yang tidak lengkap pada peringkat ini, wang tidak akan dikembalikan kepada pelanggan. Untuk mengembalikannya, anda perlu pergi ke akaun peribadi INXY anda dan lakukan operasi bayaran balik.

Mencipta Langganan

Langganan boleh dibuat dalam sistem INXY. Untuk melakukan ini, tetapkan sebarang nilai kepada pembolehubah inxy_subscription_payment, dan kemudian langganan bulanan akan dibuat.

Jika anda ingin menentukan tempoh yang berbeza, gunakan pembolehubah berikut: inxy_subscription_interval sama dengan 'day' - menetapkan selang sama dengan hari (secara lalai, ia adalah sebulan)
inxy_subscription_period - nyatakan pembolehubah dari 1 hingga 30 untuk menetapkan kekerapan.

Sebagai contoh, untuk membuat caj langganan sekali setiap 15 hari, anda perlu menetapkan inxy_subscription_interval =’day’ dan inxy_subscription_period=15, dan untuk pembayaran dicaj setiap enam bulan, anda hanya perlu nyatakan inxy_subscription_period=6 (kerana inxy_subscription_interval adalah sebulan secara lalai)

Apabila mengikuti pautan, pengguna akan melihat halaman pembayaran yang sama, tetapi dengan beberapa perbezaan: pertama, akan ada nota di sisi yang menunjukkan bahawa pembayaran adalah sebahagian daripada langganan dengan kekerapan yang ditentukan; dan kedua, halaman pembayaran akan menawarkan pilihan kepada pelanggan untuk membayar dua atau tiga jumlah terlebih dahulu.

Ciri sistem pembayaran INXY: Jika pelanggan membayar x2 atau x3 daripada jumlah tersebut, Mavibot akan menerima pemberitahuan tentang pembayaran hanya untuk satu daripadanya. Baki jumlah akan dihantar ke baki pelanggan, dari mana jumlah tersebut akan dikeluarkan dalam debit berikutnya. Oleh kerana kadar pertukaran mata wang kripto sentiasa berubah, akibatnya, jumlah ini mungkin tidak mencukupi untuk debit berikutnya, yang akan membawa kepada situasi dengan langganan yang tidak dibayar sepenuhnya. Dalam kes ini, anda akan menerima panggil balik “fail” dan anda boleh menyediakan peringatan kepada pelanggan.

Tidak boleh ada pembayaran separa mengikut jadual. Baki diperiksa sebelum pembayaran, dan jika baki tidak mencukupi, wang tidak akan didebitkan daripada akaun pelanggan.

Selepas langganan berjaya, pembolehubah inxy_subscription_id akan muncul dalam pembolehubah pelanggan, menunjukkan nombor langganan dan inxy_subscription_status dengan statusnya.

Membatalkan langganan

Untuk membatalkan langganan anda, gunakan fungsi inxy_remove_subscription(inxy_subscription_id). Masukkan ID langganan inxy_subscription_id ke dalam fungsi, dan langganan akan dibatalkan.

Sekiranya berjaya, anda akan menerima panggil balik ‘Status langganan inxy_subscription_id - dipadam’ dan pembolehubah inxy_subscription_status akan berubah kepada nilai yang sesuai.