Mavibot жүйесінде Garanti BBVA (Sanal POS) төлем жүйесін пайдалану үшін банктен виртуалды POS терминал деректерін алып, оларды интеграция параметрлеріне енгізу қажет. Төлем банктің қауіпсіз бетінде 3D Secure растауымен өңделеді.

Деректерді алу

Garanti BBVA-мен Sanal POS (виртуалды POS) қызметіне келісімшарт жасаңыз. Қызметті іске қосу кезінде банктен терминалыңыз үшін Ortak Ödeme (ортақ төлем беті) мүмкіндігін қосуды сұраңыз. Бұл мүмкіндіксіз банктің төлем беті арқылы төлемдер жұмыс істемейді.

Банк сізге келесі деректерді береді:

  • Merchant ID (Üye İşyeri No) — сіздің сатушы идентификаторыңыз;
  • Terminal ID — сіздің терминал идентификаторыңыз;
  • Provision User ID — провизия пайдаланушы аты (әдетте PROVAUT немесе PROVOOS);
  • Provision Password — провизия пайдаланушы құпия сөзі.

Store Key (3D Secure кілті) Sanal POS басқару панелінде (Yönetim → 3D Secure) сіз жасайсыз. Оны сақтауды ұмытпаңыз, себебі ол интеграция үшін де қажет.

Garanti BBVA-ны Mavibot-қа қалай қосуға болады?

Mavibot бағдарламасының Acquiring бөлімінде Garanti BBVA тармағын таңдап, келесі мәліметтерді енгізіңіз:

  • Merchant ID — сіздің сатушы идентификаторыңыз.
  • Terminal ID — сіздің терминал идентификаторыңыз.
  • Provision User ID — провизия пайдаланушы аты. Бос қалдырсаңыз, PROVAUT пайдаланылады.
  • Provision Password — провизия пайдаланушы құпия сөзі.
  • Store Key — сіздің 3D Secure кілтіңіз.
  • Store Name — банктің төлем бетінде клиенттерге көрсетілетін атау. Бос қалдырсаңыз, "Online store" көрсетіледі.
  • Test Mode — интеграцияны банктің сынақ деректерімен тексеру үшін осы опцияны қосыңыз. Нақты төлемдерді өңдеу үшін бұл опция өшірілуі керек.

Интеграция аяқталды.

Төлем сілтемесін жасау

Калькулятор функциясы:

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

Параметрлер:

Параметр Сипаттама Міндетті Әдепкі / Рұқсат етілген мәндер
amount Төлем сомасы. ✅ —
description Төлем сипаттамасы. Жоқ —
currency Төлем валютасы. Жоқ TRY (әдепкі). Қолдау көрсетілетін мәндер: TRY, USD, EUR, GBP, JPY
customer_email Клиенттің электрондық поштасы. Жоқ —
language Төлем бетінің тілі. Жоқ tr (әдепкі). Қолдау көрсетілетін мәндер: tr, en

Функция төлем URL мекенжайын қайтарады.

Батырмадағы төлем сілтемесі

Төлем сілтемесі бар батырманы жіберу үшін Payment батырма түрін таңдап, төлем провайдері ретінде Garanti BBVA тармағын таңдаңыз. Содан кейін өнім атауын, төлем сомасын және қажет болса, төлем валютасын енгізіңіз.

1-мысал: Жұмыс ағынын конфигурациялау

1-қадам. Start блогын жасаңыз.

Start блогы әдетте жұмыс ағынындағы бірінші қош келдіңіз хабарламасын және пайдаланушыға қажетті кез келген кіріспе ақпаратты көрсету үшін пайдаланылады.

2-қадам. Төменде көрсетілген блокты жасаңыз.

3-қадам. Connection параметрлеріне өтіңіз.

Клиенттің жарамды электрондық пошта мекенжайын енгізгенін тексеру үшін келесі тұрақты өрнек қажет:

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

Сондай-ақ, User enters data опциясын қосып, customer_email енгізіңіз.

4-қадам. Екінші блокқа хабарламаны енгізіңіз.

5-қадам. Үшінші блокты жасап, екінші және үшінші блоктар арасындағы Connection параметрлерін ашыңыз.

Келесі блокқа автоматты түрде өту үшін таймерді қосыңыз.

6-қадам. Үшінші блокта Calculator бөліміне функцияны енгізіңіз.

Көшіруге арналған мысал:

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

Егер Түрік лирасынан (TRY) басқа валютада төлемдер қабылдағыңыз келсе, төменде көрсетілгендей валютаны көрсетіңіз.

Көшіруге арналған мысал:

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

2-мысал. Төлем батырмасы

Бұл мысал 1-мысалмен дерлік бірдей.

Дегенмен, төлем сілтемесін жасау функциясы бар үшінші блокты жасаудың орнына, екінші блокта батырма жасауға болады.

Ашылған терезеде:

  • Батырма мәтінін енгізіңіз.
  • Billing функциясын таңдаңыз.
  • Төлем провайдері ретінде Garanti BBVA тармағын таңдаңыз.

Содан кейін келесіні енгізіңіз:

  • Product Name.
  • Payment Amount.
  • Currency (міндетті емес).
  • Client Full Name (міндетті емес). Мұны клиенттің электрондық поштасын енгізуді конфигурациялағандай конфигурациялауға болады.
  • Customer Email — #{customer_email} айнымалысын енгізіңіз.

Содан кейін Add түймесін басыңыз.

Төлемнен кейінгі хабарландырулар

Клиент төлем сілтемесі бойынша өтіп, төлемді аяқтағаннан кейін әңгімеге хабарландыру (callback) жіберіледі.

Сәтті төлем үшін:

SDJ91MTKTT_success 100

Мұнда:

  • SDJ91MTKTT — Store Key кілтіңіздің алғашқы 10 таңбасы.
  • 100 — төлем сомасы.

Егер төлем сәтсіз болса, келесі хабарландыру жіберіледі:

SDJ91MTKTT_fail 100

Сәтті немесе сәтсіз төлемге жауапты қалай жіберуге болады

1-қадам. Trigger блогын жасаңыз.

2-қадам. Шарт өрісіне әрбір төлемге әрекет еткіңіз келсе, SDJ91MTKTT_success хабарландыру мәтінін — төлем сомасынсыз — енгізіңіз.

Бұл жағдайда Match Type By Keywords күйіне орнатылуы керек.

Немесе, егер белгілі бір төлемге әрекет еткіңіз келсе, Trigger өрісіне толық callback мәтінін енгізіңіз. Бұл жағдайда Match Type Exact Match күйіне орнатылуы керек.

Егер сәтті төлемнен кейін жұмыс ағынын жалғастырғыңыз келсе, Trigger блогының орнына Start блогын жасап, бот ағынын сол жерден құруды жалғастыра аласыз.

Сәтті төлемнен кейінгі клиент айнымалылары