Платежный виджет v6
Платежный виджет — всплывающая форма на сайте Партнера без перенаправления на сервер Системы для ввода реквизитов карты Клиента. Для ее использования на сервере Партнера необходимо провести ряд действий описанных ниже.
Установка
Для установки виджета необходимо прописать на сайте скрипт в раздел head
<script src="https://proxyd.tarlanpayments.kz/tarlan/widget/v6/widget.js"></script>
function generateForm() {
var widget = new tp.TarlanPayments();
widget.checkout(
{
reference_id: 543819, // номер заказа
request_url: 'https://site.kz/request', // адрес для перенаправления после платежа
back_url: 'https://site.kz/back_url', // адрес для отправки коллбека
description: 'оплата заказа', // описание платежа
amount: 100, // сумма заказа
merchant_id: 1, // номер мерчанта
is_test: 1, // опция для тестовой оплаты
secret_key: 'merchant_api', // ключ выдданный для мерчанта
},
function (data) {
// при успешной оплате
},
function (err) {
// при неуспешной оплате
}
);
}
document.querySelector('.make-payment').addEventListener('click', generateForm);
Основые параметры
Название | Тип | Описание | Обязательность |
---|---|---|---|
reference_id | String | Номер заказа на стороне мерчанта | Да |
request_url | String | Абсолютная ссылка на сайт мерчанта для перенаправления пользователя. | Да |
back_url | String | Абсолютная ссылка на сайт мерчанта для отправки статуса платежа. Детальное описание запроса ниже. | Да |
description | String | Описание платежа | Да |
amount | Integer | Сумма заказа | Да |
merchant_id | Integer | ID мерчанта | Да |
user_id | Integer | ID пользователя | Нет |
secret_key | String | Поле secret_key необходимо формировать конкатенацией параметров: reference_id + секретный ключ (Ваш ID заказа и секретный ключ в вашем личном кабинете). Полученный результат необходимо обернуть в bcrypt, где модификатор входа хэш-функции (соль/round) равен 10. | Да |
is_test | Boolean | Тестовый платеж | Нет |
user_email | String | Email пользователя | Нет |
Дополнительные параметры
Название | Тип | Описание | Обязательность |
---|---|---|---|
hashSecretKey | Boolean | Полезен для тестов, дефолтное значение - false true - хэширование происходит на стороне виджета, в secret_key нужно будет указать только secret_key false - хэширование происходит на стороне мерчанта | Нет |
type | "payin" | "payout" | "card-linking" | Тип платежа, дефолтное значение - payin payin - Прием payout - Выплата card-linking - Привязка карты | Нет |
isDev | Boolean | Переключение запроса на дев или продакшн сервер, дефолтное значение - false | Нет |