Чтобы использовать 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 key. -
100.55— сумма платежа.
Неудачный платеж
Если платеж не прошел, отправляется следующий обратный вызов:
SDJ91MTKTT_fail 100.55
Важно! Обратный вызов о неудачном платеже отправляется только после окончательного закрытия платежной ссылки: после 5 неудачных попыток оплаты или по истечении срока действия ссылки.
Пока у клиента остаются доступные попытки оплаты, ссылка остается активной, и обратный вызов о неудачном платеже не отправляется.
Переменные клиента после успешного платежа
| Переменная | Описание |
|---|---|
clip_callback_data |
Информация о платеже, полученная от платежной системы Clip. |
clip_payment_completed |
"True", если платеж был успешно обработан. |
clip_payment_request_id |
Идентификатор платежной ссылки в Clip. |
clip_receipt_no |
Номер чека Clip. |