# Создание платежа

Для создания платежа используется метод payments/create, поддерживающий тестовый режим. После успешной регистрации нового платежа в системе шлюза, API вернёт в ответ ссылку на страницу оплаты данного платежа.

После завершения работы с платежом, запрос с результатом будет отправлен на URL уведомлений, указанный в разделе "Технические параметры" личного кабинета.

Сумма платежа указывается в рублях.

# Параметры

Параметр Тип По-умолчанию Описание
id Число или строка Обязательный Идентификатор платежа в системе кассы
method Строка Необязательный Платёжный метод, используемый при оплате.
В случае указания страница выбора метода будет пропущена.
amount Число Обязательный Сумма платежа
description Строка Обязательный Описание платежа, которое будет показано пользователю при оплате.
successURL Строка Системная страница Страница для перенаправления в случае успешного проведения платежа.
failURL Строка Системная страница Страница для перенаправления в случае неуспешного проведения платежа.
resultURL Строка Системная страница Страница для перенаправления после проведения платежа. Автоматически устанавливает параметры successURL и failURL в переданное значение

# Примеры использования

Пример Вашей страницы оплаты с использованием SDK:

// Инициализация клиента API
$paysys = new QubiPay('5fead72e6c6eb9004990e29b', 'secret-key');

// Создание платежа
$payment_response = $paysys->createPayment(array(
    'id' => $mysqli->insert_id,
    'method' => 'bank-card',
    'amount' => 12,
    'description' => 'Оплата заказа в MyShop',
    'successURL' => 'https://my-shop.ru/payment/success',
    'failURL' => 'https://my-shop.ru/payment/fail',
));

if ($payment_response->success) {
    // Перенаправление пользователя на страницу оплаты
    header('Location: '.$payment_response->message);
} else {
    // Вывод ошибки в случае неудачи
    echo $payment_response->message;
}
// Инициализация клиента API
const paysys = new QubiPay('5fead72e6c6eb9004990e29b', 'secret-key');

// Создание платежа (асинхронно!)
const paymentResponse = await paysys.createPayment({
    id: payment._id,
    method: 'qiwi',
    amount: 340,
    description: 'Оплата заказа в MyShop',
    successURL: 'https://my-shop.ru/payment/success',
    failURL: 'https://my-shop.ru/payment/fail',
});

if (paymentResponse.success) {
    // Перенаправление пользователя на страницу оплаты
    // res - объект Responce фреймворка express, fastify или connect
    res.redirect(paymentResponse.message);
} else {
    // Вывод ошибки в случае неудачи
    res.send(paymentResponse.message);
}

Пример HTTP-запроса:

POST https://gateway.qubipay.io/api/v1/Payments/create
Authorization: Basic NWZlYWQ3MmU2YzZlYjkwMDQ5OTBlMjliOnNlY3JldC1rZXk=
Content-Type: application/json

{
    "id": "e1d703c1-669f-4328-ab6c-b6d93a6bd50f",
    "method": "qiwi",
    "amount": 12,
    "description": "Оплата заказа в MyShop",
    "successURL": "https://my-shop.ru/payment/success",
    "failURL": "https://my-shop.ru/payment/fail"
}
Последнее изменение: 3 месяцев назад