Lai Mavibot izmantotu EBANX maksājumu platformu, jums ir jāiegūst sava Integrācijas atslēga no EBANX konta un jāievada tā maksājumu iestatījumos.

EBANX ir vietējo maksājumu metožu apkopotājs visā Latīņamerikā. Maksājumi tiek apstrādāti drošā EBANX mitinātā norēķinu lapā, kur klientiem tiek parādītas viņu valstī pieejamās maksājumu metodes (piemēram, PIX un boleto Brazīlijā, OXXO un SPEI Meksikā, PSE Kolumbijā, kredīt-/debetkartes un citas).

Integrācijas atslēgas iegūšana

Noslēdziet līgumu ar EBANX un iegūstiet piekļuvi EBANX Business Portal (jūsu tirgotāja panelim).

Reģistrācijas procesa laikā atlasiet valstis, kurās vēlaties pieņemt maksājumus. Klienti varēs maksāt tikai no tām valstīm, kas ir iespējotas jūsu EBANX kontā.

Integrācijas iestatījumos nokopējiet savu Integrācijas atslēgu. Tā būs nepieciešama, lai savienotu EBANX ar Mavibot.

Testēšanas nolūkos EBANX nodrošina atsevišķu smilškastes kontu ar savu Integrācijas atslēgu. Skatiet Testa režīms zemāk.

EBANX savienošana

Maksājumu sistēmu iestatījumos atlasiet EBANX un ievadiet sekojošo:

  • Integrācijas atslēga — jūsu nokopētā EBANX Integrācijas atslēga.
  • Valsts — noklusējuma maksājuma valsts (divu burtu mazo burtu valsts kods: br Brazīlijai, mx Meksikai, co Kolumbijai, cl Čīlei, pe Peru, ar Argentīnai utt.). Tas nosaka, kuras maksājumu metodes klienti redzēs norēķinu lapā. Atlasītajai valstij ir jābūt iespējotai jūsu EBANX kontā.
  • Testa režīms — iespējojiet šo opciju, lai testētu integrāciju, izmantojot EBANX smilškastes vidi. Kad Testa režīms ir iespējots, izmantojiet Integrācijas atslēgu no sava smilškastes konta. Lai pieņemtu reālus maksājumus, atspējojiet Testa režīmu un izmantojiet savu tiešraides Integrācijas atslēgu.

Iestatīšana tagad ir pabeigta.

Maksājuma saites ģenerēšana

Kalkulatora funkcija:

get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

Parametri

  • amount — maksājuma summa. Obligāts.

  • customer_email — klienta e-pasta adrese. Obligāts. EBANX nevar izveidot maksājumu bez tās. Klients saņems arī maksājuma apstiprinājumu uz šo e-pasta adresi.

  • full_name — klienta pilns vārds. Obligāts.

  • description — maksājuma apraksts. Neobligāts.

  • currency — maksājuma valūta. Varat izmantot:

    • maksājuma valsts vietējo valūtu (piemēram, BRL, MXN, COP, CLP, PEN, ARS utt.), vai
    • savu EBANX konta valūtu (parasti USD), tādā gadījumā EBANX konvertēs summu pēc sava valūtas kursa.

    Neobligāts. Noklusējuma vērtība ir USD.

  • country — maksājuma valsts (divu burtu mazo burtu valsts kods). Neobligāts. Ja izlaists, tiks izmantota maksājumu iestatījumos norādītā noklusējuma valsts.

Funkcija atgriež maksājuma URL.

Piezīme: Atlasītajai valūtai jābūt saderīgai ar maksājuma valsti. Tai ir jābūt vai nu valsts vietējai valūtai, vai jūsu EBANX konta valūtai. Piemēram, br (Brazīlijai) derīgas ir BRL un USD, bet MXN nav derīga.

Maksājuma saites poga

Lai nosūtītu maksājuma pogu, atlasiet Maksājuma pogas veidu un izvēlieties EBANX kā maksājumu sistēmu.

Ievadiet:

  • produkta nosaukumu;
  • maksājuma summu;
  • valūtu;
  • mainīgos, kas satur klienta pilnu vārdu un e-pasta adresi.

Pēc izvēles norādiet maksājuma valsti.

1. piemērs: Darbplūsmas konfigurācija

1. solis. Izveidojiet Sākuma bloku.

Sākuma bloks parasti tiek izmantots, lai darbplūsmā parādītu pirmo sveiciena ziņojumu kopā ar jebkādu ievada informāciju, kas lietotājam nepieciešama.

2. solis. Izveidojiet zemāk redzamo bloku.

3. solis. Dodieties uz Savienojuma iestatījumiem.

Jums būs nepieciešama šāda regulārā izteiksme, lai pārbaudītu, vai klients ir ievadījis derīgu e-pasta adresi:

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

Tāpat iespējojiet opciju Lietotājs ievada datus un ievadiet customer_email.

4. solis. Ievadiet ziņojumu otrajā blokā.

5. solis. Izveidojiet trešo bloku un atveriet Savienojuma iestatījumus starp otro un trešo bloku.

Iespējojiet taimeri, lai automātiski pārietu uz nākamo bloku.

6. solis. Trešajā blokā ievadiet funkciju Kalkulatorā.

Kopējamais piemērs:

amount = 1000
description = "Product1 is product of great reliability!"
currency = "BRL"
link = get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

Ja vēlaties pieņemt maksājumus citā valūtā, nevis USD, norādiet valūtu, kā parādīts zemāk.

2. piemērs. Norēķinu poga

Šis piemērs ir gandrīz identisks 1. piemēram.

Tomēr tā vietā, lai izveidotu trešo bloku ar funkciju maksājuma saites ģenerēšanai, varat izveidot pogu otrajā blokā.

Atvērtajā logā:

  • Ievadiet pogas tekstu.
  • Atlasiet funkciju Norēķini.
  • Kā maksājumu pakalpojumu sniedzēju atlasiet EBANX.

Pēc tam ievadiet sekojošo:

  • Produkta nosaukums.
  • Maksājuma summa.
  • Valūta (neobligāti).
  • Klienta pilns vārds (neobligāti). To var konfigurēt tāpat kā klienta e-pasta ievadi.
  • Klienta e-pasts — ievadiet mainīgo #{customer_email}.

Pēc tam noklikšķiniet uz Pievienot.

Paziņojumi pēc maksājuma

Pēc tam, kad klients atver maksājuma saiti un pabeidz maksājumu, sarunai tiek nosūtīts šāds atzvanīšanas pieprasījums pēc veiksmīga maksājuma:

SDJ91MTKTT_success 100

Kur:

  • SDJ91MTKTT ir pirmās 10 jūsu Integrācijas atslēgas rakstzīmes.
  • 100 ir maksājuma summa.

Ja maksājums tiek atcelts, tiek nosūtīts šāds atzvanīšanas pieprasījums:

SDJ91MTKTT_fail 100

Bezsaistes maksājumu metodēm (piemēram, boleto, OXXO utt.) maksājuma apstiprinājums nav tūlītējs. EBANX nosūta atzvanīšanas pieprasījumu tikai pēc līdzekļu saņemšanas, kas var aizņemt 1–3 darba dienas. Atzvanīšanas pieprasījums tiks piegādāts automātiski, tiklīdz maksājums būs apstiprināts.

Kā nosūtīt atbildi uz veiksmīgu vai neveiksmīgu maksājumu

1. solis. Izveidojiet Trigera bloku.

2. solis. Nosacījuma laukā ievadiet paziņojuma tekstu SDJ91MTKTT_success — bez maksājuma summas —, ja vēlaties reaģēt uz katru maksājumu.

Šajā gadījumā Saskaņošanas veids ir jāiestata uz Pēc atslēgvārdiem.

Alternatīvi, ievadiet visu atzvanīšanas teksta saturu Trigera laukā, ja vēlaties reaģēt uz konkrētu maksājumu. Šajā gadījumā Saskaņošanas veids ir jāiestata uz Precīza atbilstība.

Ja vēlaties turpināt darbplūsmu pēc veiksmīga maksājuma, varat izveidot Sākuma bloku, nevis Trigera bloku, un no turienes turpināt veidot sava bota plūsmu.

Klienta mainīgie pēc veiksmīga maksājuma

Mainīgais Vērtība
ebanx_callback_data Informācija par maksājumu, kas saņemta no maksājumu sistēmas
ebanx_payment_completed "True" — maksājums apstrādāts kā veiksmīgs
ebanx_payment_hash Maksājuma identifikators EBANX (hash)