Reģistrācija

Pēc reģistrēšanās https://auth.inxy.io/ servisā, dodieties uz Payment gateway API kreisās puses izvēlnē un aizpildiet šādus datus - maka nosaukums un apraksts, kā arī ikona. Saite uz jūsu vietni nav obligāta. Atzīmējiet visas kriptovalūtas, kuras vēlaties pieņemt, ar izvēles rūtiņu un noklikšķiniet uz Save Changes


Pēc saglabāšanas atvērsies logs ar savienojuma datiem. Pēc tam ģenerējiet API atslēgu, noklikšķinot uz pogas Generate (1), un ievadiet kodu, kas nosūtīts uz jūsu e-pastu. Saglabājiet iegūto mainīgo drošā vietā. Kopējiet ģenerēto Secret Key tajā pašā vietā. Atslēgas, ja tās tiek pazaudētas, var tikt atkārtoti ģenerētas (šajā gadījumā neaizmirstiet mainīt datus projektā). Ievadiet URL tīmekļa paziņojumiem https://chatter.mavibot.ai/inxy\_callback/result laukā Postback URL (2).


Savienojuma iestatīšana

Pēc tam dodieties uz Mavibot — Payment systems — INXY un noklikšķiniet uz pogas Connect. Ievadiet saņemtās API un Secret atslēgas attiecīgajos laukos.

скрин на подключение из Mavibot

Maksājuma saites ģenerēšana

Lai ģenerētu maksājuma saiti, ievadiet mainīgā payment_sum vērtību (piem., 1), pēc tam parādīsies mainīgais inxy_pay_url. Šo mainīgo varat pievienot ekrānā kā saiti vai ievietot to pogā Pay.

PIEZĪME! Sistēma strādā ar USD! Summa mainīgajā payment_sum tiek uzskatīta par USD INXY maksājumu sistēmā.

Saite izskatās šādi: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1

Turklāt pirms summas ievadīšanas mainīgajam payment_sum, varat ievadīt šādus neobligātos mainīgos maksājuma iestatīšanai
inxy_currency — kriptovalūta, kas tiks izmantota maksājumam. Varat ievadīt vienu no pieejamajām kriptovalūtām, kuras esat izvēlējies ar izvēles rūtiņu API atslēgas ģenerēšanas laikā. Ja atstāj tukšu, spēlētāji paši izvēlas kriptovalūtu no izvēlēto saraksta. Pieejamās vērtības: ‘BTC’,‘ETH’,‘LTC’,‘DOGE’,‘USDT’,‘USDC’,‘DAI’

inxy_description – maksājuma apraksts.

PIEZĪME! Vispirms ievadiet neobligātos mainīgos iestatīšanai, un pēc tam payment_sum.

Mainīgos var ievadīt agrāk ķēdē, nevis vienā blokā. Kamēr mainīgais inxy_pay_url, kas ietver saiti, ir jāizvada pareizajā vietā. Šī saite atver maksājuma formu.

PIEZĪME! Rinda Total amount parāda vērtību USD, kas ir vienāda ar payment_sum. Zemāk esošā rinda Total crypto amount parāda vērtību izvēlētajā kriptovalūtā. Tā mainās atkarībā no pašreizējā valūtas kursa. Šī ir summa, kas jūsu klientam ir jāmaksā jums no viņa maka.

PIEZĪME! Maka adrese maksājumam vienas sesijas laikā ir rezervēta tikai klientam tikai 2 stundas. Ieteiciet klientam pārliecināties, ka laiks nav beidzies un maka adrese joprojām ir derīga, kad tiek veikts maksājums. Ja sesijas laiks ir beidzies — viss maksājuma process ir jāsāk no jauna.

Maksājuma atgriezeniskā saite

Pēc veiksmīga maksājuma bots saņems atgriezenisko saiti, kas paziņos, ka maksājums ir veiksmīgi veikts. Jūs redzat šo atgriezenisko saiti sistēmā kā ziņojumu no lietotāja, lai lietotājs to nevarētu nosūtīt. Lietotāji PAŠI NEVAR redzēt atgriezenisko saiti, tikai operators to var redzēt. INXY ir vairāki atgriezenisko saišu veidi:

  1. Veiksmīgas atgriezeniskās saites sastāv no pirmajiem 10 tokena simboliem, kam seko ‘success’, piem.: uc8zsjNN1x_success

Šāda atgriezeniskā saite tiek nosūtīta, ja klients ir samaksājis pilnu summu un maksājuma laikā nav radušās problēmas. Kopā ar šo atgriezenisko saiti projektam tiks pievienoti divi mainīgie: inxy_payment_completed ir vienāds ar True; un inxy_payment_status ar vērtību paid.

Procesa laikā mainīgais inxy_payment_status maina savu vērtību. Pēc tam, kad lietotājs atver formu, tas mainīsies uz waiting_payment, maksājuma apstrādes laikā tas mainīsies uz waiting_confirmation, un pēc veiksmīgas apstrādes tam būs vērtība paid vai partially_paid.

Atgriezeniskās saites apstrādes laikā salīdzināšanas veidam jābūt Full match. Piem.: varat izveidot veiksmīgas maksājuma apstrādes bloku ar nosacījumu un parādīt lietotājam atbilstošu ziņojumu:

2. Dažreiz kriptovalūtu valūtas kursi mainās vai makiem tiek piemērota papildu maksa par operācijām, tāpēc saņemtā summa nav pilna. Šādos gadījumos mainīgajam inxy_payment_status būs vērtība partially_paid, un sistēma saņems atgriezenisko saiti, kas izskatās šādi:


Šajā gadījumā jums būs jānosūta klientam ziņojums ar lūgumu segt trūkstošo summu. Piem.: varat iestatīt nosacījumu savas atgriezeniskās saites sākumam un, saņemot to, nosūtīt klientam iepriekš ģenerētu URL ar maksājuma saiti, vai arī varat iestatīt nosacījumu, ka bloks aktivizējas, kad mainīgā inxy_payment_status vērtība ir partially_paid.

Atcerieties, ka maksājuma saite ir derīga tikai 2 stundas! Ja klients laikā neveic trūkstošās summas maksājumu, to nevar atvērt. Tā kā INXY šajā posmā apstrādās pirmo daļējo maksājumu, nauda neatgriezīsies klientam. Lai to atgrieztu, jums būs jāiet uz savu INXY kontu un jāveic atgriešanas operācija.

Abonementa izveide

INXY sistēma ļauj lietotājiem izveidot abonementus. Lai to izdarītu, pievienojiet jebkuru vērtību mainīgajam inxy_subscription_payment, un tiks izveidots ikmēneša abonements. Ja vēlaties iestatīt citu periodu, izmantojiet šādus mainīgos:
inxy_subscription_interval vienāds ar ‘day’ — izveidos abonementa intervālu, kas vienāds ar dienām (noklusējums ir mēnesis)
inxy_subscription_period — pievienojiet mainīgo no 1 līdz 30, lai iestatītu periodu. Piem., lai izveidotu abonementa maksājumu reizi 15 dienās, iestatiet inxy_subscription_interval =‘day’ un inxy_subscription_period=15, un, lai maksājums tiktu veikts divas reizes gadā, iestatiet inxy_subscription_period=6 (jo inxy_subscription_interval pēc noklusējuma ir vienāds ar mēnesi)

Saite arī atvērs maksājuma formu, bet tā būs atšķirīga: pirmkārt, sānos tiks parādīts, ka maksājums ir abonementa veida ar norādīto periodu, otrkārt, forma piedāvās klientam pievienot depozītu vairākiem maksājumiem uz priekšu.

INXY īpatnības: Ja klients maksā х2 vai х3 no summas, Mavibot saņems ziņojumu par vienu summu. Pārējais tiks ieskaitīts klienta bilancē un tiks izmantots turpmākajiem maksājumiem. Tā kā kriptovalūtas valūtas kurss mainās, galu galā šī summa var nebūt pietiekama vienam no nākamajiem maksājumiem, kā rezultātā abonements netiks apmaksāts. Šādā gadījumā jūs saņemsiet atgriezenisko saiti, kurā norādīts ‘fail’, un varat iestatīt atgādinājumu savam klientam.

Abonementu nevar daļēji apmaksāt. Klienta bilance tiek pārbaudīta pirms maksājuma. Ja nav pietiekami daudz līdzekļu, maksājums netiek veikts vispār.

Pēc veiksmīga abonementa klienta mainīgie ietvers inxy_subscribtion_id (atsauces numurs) un inxy_subscription_status.

Abonementa atcelšana

Lai atceltu abonementu, izmantojiet šādu funkciju inxy_remove_subscription(inxy_subscription_id). Ievadiet abonementa id numuru kā inxy_subscribtion_id funkcijā, un abonements tiks atcelts.

Veiksmes gadījumā jūs saņemsiet atgriezenisko saiti ‘Subscription status inxy_subscription_id - deleted’, un mainīgais inxy_subscription_status mainīsies uz atbilstošo vērtību.