Щоб використовувати Clip у MaviBot, потрібно створити пару облікових даних у своєму обліковому записі Clip та ввести їх у налаштуваннях платіжної системи.
Clip — це мексиканський платіжний сервіс.
Отримання облікових даних
Укладіть угоду з Clip та отримайте доступ до Developer Dashboard у своєму обліковому записі Clip.
У розділі облікових даних натисніть Crear credencial (Створити облікові дані), введіть назву та підтвердьте створення.
Скопіюйте такі облікові дані:
- API key
- Clave secreta (Секретний ключ)
Важливо! Секретний ключ відображається лише один раз, одразу після створення облікових даних. Збережіть його в безпечному місці. Ви не зможете переглянути його знову в обліковому записі Clip. Якщо ви його втратите, вам потрібно буде створити нову пару облікових даних.
Облікові дані створюються окремо для робочого та тестового середовищ. Ви можете створити до 6 додатків на один обліковий запис.
Для інтеграційного тестування створіть тестову пару облікових даних. Для прийому реальних платежів використовуйте робочі облікові дані.
Вам не потрібно налаштовувати URL-адресу сповіщення про платіж у своєму обліковому записі Clip. MaviBot автоматично надсилає URL-адресу сповіщення під час створення кожного платежу.
Підключення Clip
На вкладці Acquiring виберіть Clip та введіть:
| Поле | Опис |
|---|---|
| API key | Ідентифікатор додатку. |
| Secret key (Clave secreta) | Секретний ключ додатку. |
Підключення завершено.
Генерація платіжного посилання
Використовуйте наступну функцію Calculator:
get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)
Параметри
| Параметр | Опис |
|---|---|
amount |
Сума платежу. Обов'язково. Мінімальна сума — 1 в основній грошовій одиниці. Вказуйте суму як 100.55, а не 10055. |
description |
Опис платежу. Необов'язково. Максимальна довжина: 250 символів. Клієнт може бачити його на сторінці оплати та в чеку. |
currency |
Трилітерний код валюти (MXN та інші валюти, доступні для вашого облікового запису Clip). Необов'язково. За замовчуванням: MXN. |
customer_email |
Електронна адреса клієнта. Необов'язково. Автоматично вставляється у платіжну форму. |
customer_phone |
Номер телефону клієнта. Необов'язково. Автоматично вставляється у платіжну форму. |
full_name |
Ім'я клієнта. Необов'язково. Автоматично вставляється у платіжну форму. |
product_name |
Назва товару. Необов'язково. |
language |
Мова сторінки оплати: es для іспанської (за замовчуванням) або en для англійської. |
Функція повертає URL-адресу платежу.
Кнопка платіжного посилання
Щоб надіслати клієнту кнопку оплати:
- Створіть кнопку з функцією Pay.
- Виберіть Clip як платіжну систему.
- Вкажіть назву товару, суму та валюту.
- За потреби вкажіть змінні, що містять ім'я клієнта, електронну адресу та номер телефону.
Зворотні виклики платежів
Після того, як клієнт перейде за платіжним посиланням і завершить оплату, MaviBot отримує зворотний виклик.
Успішний платіж
Приклад:
SDJ91MTKTT_success 100.55
Де:
-
SDJ91MTKTT— перші 10 символів вашого API-ключа. -
100.55— сума платежу.
Невдалий платіж
Якщо платіж не вдався, надсилається наступний зворотний виклик:
SDJ91MTKTT_fail 100.55
Важливо! Зворотний виклик про невдалий платіж надсилається лише після остаточного закриття платіжного посилання: після 5 невдалих спроб оплати або після закінчення терміну дії посилання.
Поки у клієнта залишаються доступні спроби оплати, посилання залишається активним, і зворотний виклик про невдалий платіж не надсилається.
Змінні клієнта після успішної оплати
| Змінна | Опис |
|---|---|
clip_callback_data |
Інформація про платіж, отримана від платіжної системи Clip. |
clip_payment_completed |
"True", якщо платіж було успішно оброблено. |
clip_payment_request_id |
Ідентифікатор платіжного посилання в Clip. |
clip_receipt_no |
Номер чека Clip. |