PayTR интеграциясы PayTR арқылы төлемдерді қабылдауға мүмкіндік береді, бұл түрік төлем провайдері. Тұтынушылар төлемдерін қауіпсіз PayTR төлем парақшасында аяқтайды, онда олар түрік банк карталарын және басқа да жергілікті төлем әдістерін пайдалана алады.

Интеграциялық тіркелгі деректерін алу

PayTR-ді қоспас бұрын, PayTR-мен келісімге қол қойып, өзіңіздің сатушы тіркелгіңізге қол жеткізіңіз.

Сол жақ мәзірде Bilgi (Ақпарат) бөлімін ашып, API Entegrasyon Bilgileri бөлімін табыңыз. Келесі мәндерді көшіріңіз:

PayTR басқару панелі Mavibot өрісі
Mağaza No Сатушы идентификаторы (merchant_id)
Mağaza Anahtarı Сатушы кілті (merchant_key)
Mağaza Şifresi Сатушы тұзы (merchant_salt)

Ескерту: Бұл тіркелгі деректері тек Ana Kullanıcı (Негізгі пайдаланушы) және Teknik Sorumlu (Техникалық жауапты тұлға) үшін қолжетімді. Егер сіз бұл бөлімді көре алмасаңыз, негізгі аккаунт иесінен қажетті рұқсаттарды беруді сұраңыз.

PayTR басқару панелінде төлем хабарландыруының (кері шақыру) URL мекенжайын конфигурациялаудың қажеті жоқ. Mavibot әрбір төлем сілтемесі сұрауымен бірге кері шақыру URL мекенжайын автоматты түрде жібереді.

PayTR-ді қосу

Mavibot-та Acquiring параметрлерін ашып, PayTR таңдаңыз.

Келесі тіркелгі деректерін енгізіңіз:

  • Сатушы идентификаторы (merchant_id) — сіздің Mağaza No
  • Сатушы кілті (merchant_key) — сіздің Mağaza Anahtarı
  • Сатушы тұзы (merchant_salt) — сіздің Mağaza Şifresi

Интеграцияны аяқтау үшін параметрлерді сақтаңыз.

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

Калькулятор функциясын пайдаланыңыз:

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

Параметрлер

Параметр Міндетті Сипаттама
amount ✅ Төлем сомасы.
description Жоқ Төлем сипаттамасы (өнім немесе қызмет). PayTR төлем парақшасында көрсетіледі.
currency Жоқ Төлем валютасы: TL, USD, EUR, GBP немесе RUB. Әдепкі: TL.
customer_email Жоқ Тұтынушының электрондық пошта мекенжайы.
product_name Жоқ Төлем парақшасында көрсетілетін өнім атауы.
expired Жоқ Төлем сілтемесінің секундпен өмір сүру уақыты. Егер көрсетілмесе, сілтеме ешқашан жарамсыз болмайды.
language Жоқ Төлем парақшасының тілі: tr (түрік) немесе en (ағылшын). Әдепкі: tr.

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

Ескертулер

  • TRY валюта коды автоматты түрде TL-ге түрлендіріледі.
  • Егер қолдау көрсетілмейтін валюта көрсетілсе, автоматты түрде TL пайдаланылады.
  • Өнім атауы 4–200 таңбадан тұруы керек.
    • 4 таңбадан қысқа атаулар нүктелермен (.) толтырылады.
    • 200 таңбадан ұзын атаулар автоматты түрде қысқартылады.

Мысал

1-қадам

Тұтынушыдан электрондық пошта мекенжайын енгізуді сұрайтын хабарлама жасаңыз.

2-қадам

Хабарламаның астында келесі блокты жасап, көрсеткі параметрлерін ашыңыз.

Қосылымды келесідей конфигурациялаңыз:

  • Сәйкестендіру түрі: Тұрақты өрнек
  • Пайдаланушы деректерді енгізеді опциясын қосыңыз.
  • Айнымалы атауын енгізіңіз: customer_email

Қосылым параметрлерін сақтаңыз.

3-қадам

Калькуляторда функция параметрлерін енгізіңіз.

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

Mavibot-та төлем түймесін жіберу үшін:

  1. Түймесі бар блокты жасаңыз.

  1. Төлем түрін таңдаңыз.
  2. Төлем провайдері ретінде PayTR таңдаңыз.
  3. Көрсетіңіз:
    • Өнім атауы
    • Төлем сомасы
    • Валюта
  4. Қажет болса, тұтынушының электрондық пошта мекенжайын қамтитын айнымалыны көрсетіңіз.

Төлем кері шақырулары

Тұтынушы төлемді аяқтағаннан кейін, Mavibot кері шақыруды алып, оны әңгімеге орналастырады.

Сәтті төлем

SDJ91MTKTT_success 100

Мұнда:

  • SDJ91MTKTT — сіздің Сатушы кілтіңіздің (merchant_key) алғашқы 10 таңбасы.
  • 100 — төлем сомасы.

Сәтті немесе сәтсіз төлемдерге жауап беру үшін, кері шақыру мәнін көшіріп, Бастау блогын (немесе Триггер блогын) жасаңыз.

Триггерге кері шақыру мәтінін енгізіңіз.

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

Осы блоктан бастап, чат-бот ағынын қажетінше жалғастыра аласыз.

Ескерту: Осы мысалда көрсетілген триггер конфигурациясы әрбір сәтті төлемге жауап береді, себебі ол төлем сомасынсыз тек кері шақыру префиксін пайдаланады.
Егер сіз тек белгілі бір өнімді сатып алуға немесе төлем сомасына жауап бергіңіз келсе, толық кері шақыру мәтінін, соның ішінде төлем сомасын енгізіп, Сәйкестендіру түрін Нақты сәйкестік деп өзгертіңіз.

Сәтсіз төлем

SDJ91MTKTT_fail 100

Ескерту: PayTR төлем сілтемелері бір реттік. Сәтті төлемнен кейін сілтеме автоматты түрде өшіріледі. Әрбір жаңа төлем үшін жаңа төлем сілтемесін жасаңыз.

Сәтті төлемнен кейінгі тұтынушы айнымалылары

Айнымалы Сипаттама
paytr_callback_data PayTR-ден алынған төлем ақпараты.
paytr_payment_completed Егер төлем сәтті өңделсе, "True".
paytr_merchant_oid PayTR транзакция идентификаторы (merchant_oid).