1.1 Платежный виджет
1.1.1 Подключение
Для подключения платежного виджета используется скрипт:
https://paymo.ru/paymentgate/iframe/checkout.js
1.1.2 Вызов платежного виджета
Ниже приведен пример для метода
set()иopen():
<script src="https://paymo.ru/paymentgate/iframe/checkout.js"></script>
<script>
PaymoFrame.set({
parent_id: "iframe_parent",
api_key: "e5ebc0d4-f90b-409b-874c-c729987001da",
tx_id: "123",
description: "Тестовый платеж",
amount: 1000,
signature: "0cm9ri03f303ed09mf3",
success_redirect: "http://yoursite.ru/success_redirect",
fail_redirect: "http://yoursite.ru/success_redirect",
auto_return: 1,
rebill: {},
extra:{
some_key: "some_value",
some_key2: "some_value2"
},
phone: "79991234567",
email: "email@mail.com",
send_post_message: false,
version: "2.0.0"
})
</script>
<div id="iframe_parent"></div>
Существует объект PaymoFrame и его два метода для вызова платежного виджета: set() и open().
При использовании метода open() виджет будет отображаться по центру экрана,
тогда как при методе set() добавление виджета будет произведен в тот элемент, который
передается в параметре parent_id.
Демо-магазин можно посмотреть: Вариант 1 и Вариант 2.
Описание параметров
| Название | Обязательно | Описание |
|---|---|---|
parent_id |
Да | Элемент, в который будет произведено добавление iframe. |
api_key |
Да | Ключ магазина, который генерируется автоматически при создании магазина. Доступен на вкладке "Магазины" личного кабинета. |
tx_id |
Да | Номер транзакции в магазине. Может быть любым набором символов. Должен быть уникален в пределах выбранного магазина. |
description |
Нет | Назначение (описание) платежа. |
amount |
Да | Сумма платежа в копейках. |
signature |
Да | Формирование подписи. По умолчанию подпись формируется с помощью алгоритма SHA256: sha256("api_key"+"tx_id"+"amount"+"secret_key"). Пример на php: $signature = hash('sha256', $api_key.$tx_id.$amount.$secret_key); secret_key задается в Личном кабинете, раздел Магазины => Настройки => Технические настройки |
success_redirect |
Нет | URL для возврата при успешном платеже. |
fail_redirect |
Нет | URL для возврата при неуспешном платеже (fail и success URL могут быть одинаковыми). |
auto_return |
Нет | Автоматический редирект на success_redirect (или fail_redirect) после оплаты. Задается в секундах, например при: auto_return: 1, редирект произойдет через 1 секунду. |
rebill |
Нет | При использовании рекуррентных платежей (см. Рекурректные платежи). |
extra |
Нет | Дополнительные параметры платежа (см. Дополнительные параметры платежа). |
phone |
Нет | Номер телефона пользователя. |
email |
Нет | Email пользователя. |
send_post_message |
Нет | Метод postMessage() отправляет сообщение от iframe на сайт мерчанта. При инициализации виджета отправляется сообщение paymo-widget-init. При успешном платеже отправляется сообщение paymo-payment-success, а при неуспешном платеже отправляется сообщение paymo-payment-unsuccess. Уведомления при ошибке инициализации: paymo-init-error-api_key, paymo-init-error-invalid_parameters, paymo-init-error-payment_module, paymo-init-error-invalid_transaction, paymo-init-error-invalid_data, paymo-init-error-amount, paymo-init-error |
version |
Нет | Версия платежного виджета. Доступны две версии: 1.0.0 и 2.0.0 |
1.2 Страница UNIFORM
Пример кода для вставки:
<div>
<form action="https://checkout.paymo.ru/uniform/" method="POST">
<input