Skip to main content

Платежный виджет 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_idStringНомер заказа на стороне мерчантаДа
request_urlStringАбсолютная ссылка на сайт мерчанта для перенаправления пользователя.Да
back_urlStringАбсолютная ссылка на сайт мерчанта для отправки статуса платежа. Детальное описание запроса ниже.Да
descriptionStringОписание платежаДа
amountIntegerСумма заказаДа
merchant_idIntegerID мерчантаДа
user_idIntegerID пользователяНет
secret_keyStringПоле secret_key необходимо формировать конкатенацией параметров: reference_id + секретный ключ (Ваш ID заказа и секретный ключ в вашем личном кабинете). Полученный результат необходимо обернуть в bcrypt, где модификатор входа хэш-функции (соль/round) равен 10.Да
is_testBooleanТестовый платежНет
user_emailStringEmail пользователяНет

Дополнительные параметры

НазваниеТипОписаниеОбязательность
hashSecretKeyBooleanПолезен для тестов, дефолтное значение - false

true - хэширование происходит на стороне виджета, в secret_key нужно будет указать только secret_key
false - хэширование происходит на стороне мерчанта
Нет
type"payin" | "payout" | "card-linking"Тип платежа, дефолтное значение - payin
payin - Прием
payout - Выплата
card-linking - Привязка карты
Нет
isDevBooleanПереключение запроса на дев или продакшн сервер, дефолтное значение - falseНет