Connecting Telr
To use the Telr payment system in MaviBot, you need to obtain your store credentials from your Telr account and enter them in the payment system settings.
Obtaining Store Credentials
Sign an agreement with Telr and gain access to your merchant account.
In Stores → Store details, copy the following values:
| Telr Field | MaviBot Field |
|---|---|
| Store ID | Store ID |
| Authentication key | Authentication Key |
Configuring Payment Notifications
Open Payment Page (or Security) → Transaction advice and specify the following notification URL:
https://chatter.mavibot.ai/telr_callback/result
Select the transaction types for which you want to receive notifications.
In the same section, copy the Secret key. This key is used to verify notification signatures.
Important! Configuring Transaction advice is mandatory. Without it, MaviBot will not receive payment notifications, and no callback will be sent to the bot.
Connecting Telr in MaviBot
Open Payment Systems in your project settings, select Telr, and fill in the following fields:
| Field | Description |
|---|---|
| Store ID | Numeric identifier of your Telr store. |
| Authentication Key | Used to generate payment links. |
| Secret Key | Used to verify payment notification signatures. Without it, payment notifications will be rejected. |
| Test Mode | Enables test payments using Telr test cards without charging real funds. Disable this option to accept real payments. |
Once all fields are completed, the integration is ready to use.
Generating a Payment Link
Use the following Calculator function:
get_telr_payment_url(amount, description, currency, product_name)
Parameters
| Parameter | Description |
|---|---|
amount |
Payment amount. Required. |
description |
Payment description. Optional. Maximum length: 63 characters. |
currency |
Three-letter currency code (AED, SAR, USD, EUR, GBP, and other currencies available for your Telr account). Optional. Default: AED. |
product_name |
Product name. Optional. |
The function returns a payment URL.
Important! Payment links remain valid for a limited time. Send the link to the customer immediately after generating it.
Example
Payment Link Button
To send a payment button:
- Create a button with the Pay function.
- Select Telr as the payment system.
- Specify:
- Product name
- Payment amount
- Currency
Payment Callbacks
After the customer completes the payment, MaviBot automatically receives a callback.
Successful Payment
Example:
SDJ91MTKTT_success 100
Where:
-
SDJ91MTKTT— the first 10 characters of your Authentication Key. -
100— the payment amount.
Failed or Cancelled Payment
Example:
SDJ91MTKTT_fail 100
Payment Under Bank Review
If a payment is authorized but placed on hold by the bank for additional verification, no callback is sent until the review is complete.
Once the bank approves or declines the transaction, Telr sends a notification, and the callback is delivered to MaviBot automatically.
Customer Variables After a Successful Payment
| Variable | Description |
|---|---|
telr_callback_data |
Payment information received from the Telr payment system. |
telr_payment_completed |
"True" if the payment has been successfully processed. |
telr_tran_ref |
Telr transaction reference (tran_ref). |