PayTR integrācija ļauj pieņemt maksājumus, izmantojot PayTR — Turcijas maksājumu pakalpojumu sniedzēju. Klienti pabeidz maksājumus drošajā PayTR maksājumu lapā, kur var izmantot Turcijas banku kartes un citus vietējos maksājumu veidus.

Integrācijas akreditācijas datu iegūšana

Pirms PayTR pieslēgšanas noslēdziet līgumu ar PayTR un iegūstiet piekļuvi savam tirgotāja kontam.

Kreisajā izvēlnē atveriet Bilgi (Informācija) un atrodiet sadaļu API Entegrasyon Bilgileri. Nokopējiet šādas vērtības:

PayTR panelis Mavibot lauks
Mağaza No Tirgotāja ID (merchant_id)
Mağaza Anahtarı Tirgotāja atslēga (merchant_key)
Mağaza Şifresi Tirgotāja sāls (merchant_salt)

Piezīme: Šie akreditācijas dati ir pieejami tikai Ana Kullanıcı (Galvenajam lietotājam) un Teknik Sorumlu (Tehniskajam atbildīgajam). Ja nevarat redzēt šo sadaļu, lūdziet galvenajam konta īpašniekam piešķirt jums nepieciešamās atļaujas.

Jums nav jākonfigurē maksājuma paziņojuma (callback) URL PayTR panelī. Mavibot automātiski nosūta atzvanīšanas URL ar katru maksājuma saites pieprasījumu.

PayTR pieslēgšana

Atveriet Acquiring iestatījumus Mavibot un atlasiet PayTR.

Ievadiet šādus akreditācijas datus:

  • Tirgotāja ID (merchant_id) — jūsu Mağaza No
  • Tirgotāja atslēga (merchant_key) — jūsu Mağaza Anahtarı
  • Tirgotāja sāls (merchant_salt) — jūsu Mağaza Şifresi

Saglabājiet iestatījumus, lai pabeigtu integrāciju.

Maksājuma saites ģenerēšana

Izmantojiet kalkulatora funkciju:

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

Parametri

Parametrs Obligāts Apraksts
amount ✅ Maksājuma summa.
description Nē Maksājuma apraksts (produkts vai pakalpojums). Tiek parādīts PayTR maksājumu lapā.
currency Nē Maksājuma valūta: TL, USD, EUR, GBP vai RUB. Noklusējums: TL.
customer_email Nē Klienta e-pasta adrese.
product_name Nē Produkta nosaukums, kas tiek parādīts maksājumu lapā.
expired Nē Maksājuma saites derīguma termiņš sekundēs. Ja nav norādīts, saite nekad nebeidzas.
language Nē Maksājumu lapas valoda: tr (turku) vai en (angļu). Noklusējums: tr.

Funkcija atgriež maksājuma URL.

Piezīmes

  • Valūtas kods TRY tiek automātiski konvertēts uz TL.
  • Ja tiek norādīta neatbalstīta valūta, automātiski tiek izmantota TL.
  • Produkta nosaukumam jāsatur 4–200 rakstzīmes.
    • Nosaukumi, kas ir īsāki par 4 rakstzīmēm, tiek papildināti ar punktiem (.).
    • Nosaukumi, kas ir garāki par 200 rakstzīmēm, tiek automātiski saīsināti.

Piemērs

1. solis

Izveidojiet ziņojumu, kurā klientam tiek lūgts ievadīt savu e-pasta adresi.

2. solis

Izveidojiet nākamo bloku zem ziņojuma un atveriet bultiņas iestatījumus.

Konfigurējiet savienojumu šādi:

  • Saskaņošanas veids: Regulārā izteiksme
  • Iespējojiet opciju Lietotājs ievada datus.
  • Ievadiet mainīgā nosaukumu: customer_email

Saglabājiet savienojuma iestatījumus.

3. solis

Ievadiet funkcijas parametrus kalkulatorā.

Maksājuma pogas izveide

Lai nosūtītu maksājuma pogu Mavibot:

  1. Izveidojiet bloku ar pogu.

  1. Atlasiet veidu Norēķini.
  2. Izvēlieties PayTR kā maksājumu pakalpojumu sniedzēju.
  3. Norādiet:
    • Produkta nosaukumu
    • Maksājuma summu
    • Valūtu
  4. Pēc izvēles norādiet mainīgo, kas satur klienta e-pasta adresi.

Maksājuma atzvanīšanas

Pēc tam, kad klients ir pabeidzis maksājumu, Mavibot saņem atzvanīšanu un ievieto to sarunā.

Veiksmīgs maksājums

SDJ91MTKTT_success 100

Kur:

  • SDJ91MTKTT ir pirmās 10 jūsu Tirgotāja atslēgas (merchant_key) rakstzīmes.
  • 100 ir maksājuma summa.

Lai reaģētu uz veiksmīgiem vai neveiksmīgiem maksājumiem, nokopējiet atzvanīšanas vērtību un izveidojiet Sākuma bloku (vai Trigera bloku).

Ievadiet atzvanīšanas tekstu trigerī.

Pēc tam izveidojiet ziņojumu, informējot klientu, vai maksājums bija veiksmīgs vai neveiksmīgs.

No šī bloka varat turpināt tērzēšanas robota plūsmu pēc nepieciešamības.

Piezīme: Šajā piemērā parādītā trigera konfigurācija reaģēs uz katru veiksmīgu maksājumu, jo tā izmanto tikai atzvanīšanas prefiksu bez maksājuma summas.
Ja vēlaties reaģēt tikai uz konkrēta produkta iegādi vai maksājuma summu, ievadiet pilnu atzvanīšanas tekstu, ieskaitot maksājuma summu, un mainiet Saskaņošanas veidu uz Precīza atbilstība.

Neveiksmīgs maksājums

SDJ91MTKTT_fail 100

Piezīme: PayTR maksājumu saites ir vienreizējas. Pēc veiksmīga maksājuma saite tiek automātiski deaktivizēta. Ģenerējiet jaunu maksājuma saiti katram jaunam maksājumam.

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

Mainīgais Apraksts
paytr_callback_data Maksājuma informācija, kas saņemta no PayTR.
paytr_payment_completed "True", ja maksājums tika veiksmīgi apstrādāts.
paytr_merchant_oid PayTR darījuma identifikators (merchant_oid).