Telr savienošana
Lai izmantotu Telr maksājumu sistēmu MaviBot, jums ir jāiegūst sava veikala akreditācijas dati no Telr konta un jāievada tie maksājumu sistēmas iestatījumos.
Veikala akreditācijas datu iegūšana
Noslēdziet līgumu ar Telr un iegūstiet piekļuvi savam tirgotāja kontam.
Sadaļā Stores → Store details nokopējiet šādas vērtības:
| Telr lauks | MaviBot lauks |
|---|---|
| Store ID | Store ID |
| Authentication key | Authentication Key |
Maksājumu paziņojumu konfigurēšana
Atveriet Payment Page (vai Security) → Transaction advice un norādiet šādu paziņojumu URL:
https://chatter.mavibot.ai/telr_callback/result
Izvēlieties darījumu veidus, par kuriem vēlaties saņemt paziņojumus.
Tajā pašā sadaļā nokopējiet Secret key. Šī atslēga tiek izmantota paziņojumu parakstu pārbaudei.
Svarīgi! Transaction advice konfigurēšana ir obligāta. Bez tās MaviBot nesaņems maksājumu paziņojumus, un robotam netiks nosūtīts neviens atzvans.
Telr savienošana MaviBot
Projekta iestatījumos atveriet Payment Systems, izvēlieties Telr un aizpildiet šādus laukus:
| Lauks | Apraksts |
|---|---|
| Store ID | Jūsu Telr veikala ciparu identifikators. |
| Authentication Key | Izmanto maksājumu saišu ģenerēšanai. |
| Secret Key | Izmanto maksājumu paziņojumu parakstu pārbaudei. Bez tā maksājumu paziņojumi tiks noraidīti. |
| Test Mode | Iespējo testa maksājumus, izmantojot Telr testa kartes, neiekasējot reālus līdzekļus. Atspējojiet šo opciju, lai pieņemtu reālus maksājumus. |
Kad visi lauki ir aizpildīti, integrācija ir gatava lietošanai.
Maksājuma saites ģenerēšana
Izmantojiet šādu Kalkulatora funkciju:
get_telr_payment_url(amount, description, currency, product_name)
Parametri
| Parametrs | Apraksts |
|---|---|
amount |
Maksājuma summa. Obligāts. |
description |
Maksājuma apraksts. Neobligāts. Maksimālais garums: 63 rakstzīmes. |
currency |
Trīs burtu valūtas kods (AED, SAR, USD, EUR, GBP un citas valūtas, kas pieejamas jūsu Telr kontam). Neobligāts. Noklusējums: AED. |
product_name |
Produkta nosaukums. Neobligāts. |
Funkcija atgriež maksājuma URL.
Svarīgi! Maksājumu saites ir derīgas ierobežotu laiku. Nosūtiet saiti klientam uzreiz pēc tās ģenerēšanas.
Piemērs
Maksājuma saites poga
Lai nosūtītu maksājuma pogu:
- Izveidojiet pogu ar funkciju Pay.
- Izvēlieties Telr kā maksājumu sistēmu.
- Norādiet:
- Produkta nosaukumu
- Maksājuma summu
- Valūtu
Maksājumu atzvani
Pēc tam, kad klients ir pabeidzis maksājumu, MaviBot automātiski saņem atzvanu.
Veiksmīgs maksājums
Piemērs:
SDJ91MTKTT_success 100
Kur:
-
SDJ91MTKTT— pirmās 10 jūsu Authentication Key rakstzīmes. -
100— maksājuma summa.
Neveiksmīgs vai atcelts maksājums
Piemērs:
SDJ91MTKTT_fail 100
Maksājums bankas pārskatīšanā
Ja maksājums ir autorizēts, bet banka to ir aizturējusi papildu pārbaudei, atzvans netiek nosūtīts, kamēr pārskatīšana nav pabeigta.
Kad banka apstiprina vai noraida darījumu, Telr nosūta paziņojumu, un atzvans tiek automātiski piegādāts MaviBot.
Klienta mainīgie pēc veiksmīga maksājuma
| Mainīgais | Apraksts |
|---|---|
telr_callback_data |
Maksājuma informācija, kas saņemta no Telr maksājumu sistēmas. |
telr_payment_completed |
"True", ja maksājums ir veiksmīgi apstrādāts. |
telr_tran_ref |
Telr darījuma atsauce (tran_ref). |