Lai izmantotu Garanti BBVA (Sanal POS) maksājumu sistēmu Mavibot, jums ir jāiegūst virtuālā POS termināļa akreditācijas dati no bankas un tie jāievada integrācijas iestatījumos. Maksājums tiek apstrādāts bankas drošajā lapā ar 3D Secure apstiprinājumu.

Akreditācijas datu iegūšana

Noslēdziet līgumu ar Garanti BBVA par Sanal POS (virtuālā POS) pakalpojumu. Aktivizējot pakalpojumu, lūdziet bankai iespējot Ortak Ödeme (kopīgā maksājumu lapa) jūsu terminālim. Bez šīs funkcijas maksājumi, izmantojot bankas maksājumu lapu, nedarbosies.

Banka jums nodrošinās:

  • Merchant ID (Üye İşyeri No) — jūsu tirgotāja ID;
  • Terminal ID — jūsu termināļa ID;
  • Provision User ID — nodrošinājuma lietotājvārds (parasti PROVAUT vai PROVOOS);
  • Provision Password — nodrošinājuma lietotāja parole.

Store Key (3D Secure atslēga) tiek izveidota jūsu Sanal POS pārvaldības panelī (Yönetim → 3D Secure). Noteikti to saglabājiet, jo tā ir nepieciešama arī integrācijai.

Kā savienot Garanti BBVA ar Mavibot?

Mavibot sadaļā Acquiring atlasiet Garanti BBVA un ievadiet šādu informāciju:

  • Merchant ID — jūsu tirgotāja ID.
  • Terminal ID — jūsu termināļa ID.
  • Provision User ID — nodrošinājuma lietotājvārds. Ja atstāj tukšu, tiks izmantots PROVAUT.
  • Provision Password — nodrošinājuma lietotāja parole.
  • Store Key — jūsu 3D Secure atslēga.
  • Store Name — nosaukums, kas tiek rādīts klientiem bankas maksājumu lapā. Ja atstāj tukšu, tiks rādīts "Online store".
  • Test Mode — iespējojiet šo opciju, lai testētu integrāciju, izmantojot bankas testa akreditācijas datus. Lai apstrādātu reālus maksājumus, šī opcija ir jāatspējo.

Integrācija tagad ir pabeigta.

Maksājuma saites ģenerēšana

Kalkulatora funkcija:

get_garanti_payment_url(amount, description, currency, customer_email, language)

Parametri:

Parametrs Apraksts Obligāts Noklusējums / Atļautās vērtības
amount Maksājuma summa. ✅ —
description Maksājuma apraksts. Nē —
currency Maksājuma valūta. Nē TRY (noklusējums). Atļautās vērtības: TRY, USD, EUR, GBP, JPY
customer_email Klienta e-pasta adrese. Nē —
language Maksājuma lapas valoda. Nē tr (noklusējums). Atļautās vērtības: tr, en

Funkcija atgriež maksājuma URL.

Maksājuma saite pogā

Lai nosūtītu pogu ar maksājuma saiti, atlasiet pogas veidu Payment un izvēlieties Garanti BBVA kā maksājumu pakalpojumu sniedzēju. Pēc tam ievadiet produkta nosaukumu, maksājuma summu un, ja nepieciešams, maksājuma valūtu.

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

1. solis. Izveidojiet Start bloku.

Start 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 Connection 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 User enters data un ievadiet customer_email.

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

5. solis. Izveidojiet trešo bloku un atveriet Connection 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 Calculator.

Kopējamais piemērs:

amount = 1000
description = "Product1 is a product of great reliability!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)

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

Kopējamais piemērs:

amount = 1000
description = "Product1 is a product of great reliability!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)

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 Billing.
  • Atlasiet Garanti BBVA kā maksājumu pakalpojumu sniedzēju.

Pēc tam ievadiet:

  • Product Name.
  • Payment Amount.
  • Currency (neobligāti).
  • Client Full Name (neobligāti). To var konfigurēt tāpat kā klienta e-pasta ievadi.
  • Customer Email — ievadiet mainīgo #{customer_email}.

Pēc tam noklikšķiniet uz Add.

Paziņojumi pēc maksājuma

Pēc tam, kad klients seko maksājuma saitei un pabeidz maksājumu, sarunā tiks nosūtīts paziņojums (callback).

Par veiksmīgu maksājumu:

SDJ91MTKTT_success 100

Kur:

  • SDJ91MTKTT ir pirmās 10 jūsu Store Key rakstzīmes.
  • 100 ir maksājuma summa.

Ja maksājums neizdodas, tiks nosūtīts šāds paziņojums:

SDJ91MTKTT_fail 100

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

1. solis. Izveidojiet Trigger 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ā Match Type ir jāiestata uz By Keywords.

Alternatīvi, ievadiet visu callback tekstu Trigger laukā, ja vēlaties reaģēt uz konkrētu maksājumu. Šajā gadījumā Match Type ir jāiestata uz Exact Match.

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

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

Mainīgais Apraksts
garanti_callback_data Maksājuma informācija, kas saņemta no maksājumu sistēmas.
garanti_payment_completed "True", ja maksājums ir veiksmīgi apstrādāts.
garanti_auth_code Bankas darījuma autorizācijas kods.