Создание платежа по host2host (GATE)

Интеграция GATE позволяет создать платёж напрямую с вашего сервера и получить готовую ссылку на оплату в Системе быстрых платежей (СБП). Вы полностью контролируете внешний вид: можете отрисовать ссылку как QR-код на сайте или сделать кнопку «Оплатить», которая откроет приложение банка на телефоне клиента.

Процесс проведения платежа через API состоит из четырёх шагов:

1. Инициализация — ваш сервер формирует запрос с параметрами заказа и отправляет его на эндпоинт 1Payment.
2. Получение ссылки — в ответ система возвращает прямую ссылку на оплату в СБП (redirect_url).
3. Оплата — вы отрисовываете ссылку в виде QR-кода на сайте или используете её для кнопки «Оплатить» в мобильной версии; клиент переходит в приложение банка и подтверждает платёж.
4. Уведомление (колбек) — после изменения статуса операции мы отправляем POST-уведомление на ваш notify_url с финальным результатом транзакции.

Эти поля должны присутствовать в каждом запросе для корректного создания платежа.

Позволяют передать расширенную информацию о клиенте или активировать подписку.

Подпись: MD5, lowercase (hex). Общие правила — Формат запроса к API.

Формула:

MD5(init_payment + <параметры_без_sign_в_алфавитном_порядке_через_&> + <API_KEY>)

Сценарий 1 — только обязательные параметры

Параметры: amount=50, partner_id=1, payment_type=sbp, project_id=5678, shop_url=test.com, user_data=order123.

init_paymentamount=50&partner_id=1&payment_type=sbp&project_id=5678&shop_url=test.com&user_data=order123secret_key

Сценарий 2 — с полем description

При добавлении description=Payment1 поле включается в строку по алфавиту:

init_paymentamount=50&description=Payment1&partner_id=1&payment_type=sbp&project_id=5678&shop_url=test.com&user_data=order123secret_key

const crypto = require('crypto');
const axios = require('axios');

async function createSbpPayment(apiKey, params) {
  // 1. Сортируем параметры по алфавиту
  const sortedKeys = Object.keys(params).sort();
  const queryString = sortedKeys.map((key) => `${key}=${params[key]}`).join('&');

  // 2. Формируем подпись с префиксом init_payment
  const baseString = `init_payment${queryString}${apiKey}`;
  params.sign = crypto.createHash('md5').update(baseString).digest('hex');

  // 3. Отправляем POST-запрос
  try {
    const response = await axios.post('https://api.1payment.com/init_payment', params);
    return response.data; // order_id, status, redirect_url
  } catch (error) {
    console.error('Ошибка при создании платежа:', error.message);
  }
}

// Пример данных запроса
const apiKey = process.env.ONEPAYMENT_API_KEY;
const data = {
  partner_id: 1234,
  payment_type: 'sbp',
  project_id: 5678,
  amount: 50.0,
  user_data: 'inv_12345',
  shop_url: 'https://myshop.com',
};

createSbpPayment(apiKey, data).then((result) => console.log('Ответ системы:', result));

Успешный ответ (200):

{
  "order_id": "8p3brmb19gfg0sg8gcwhws8kgc748s87",
  "status": 2,
  "status_description": "PENDING",
  "redirect_url": "https://qr.nspk.ru/XXX"
}

Ошибка запроса (400):

{
  "error_code": 2
}

Если при инициации платежа система не смогла получить данные для редиректа, в ответе на init_payment не будет параметра redirect_url. Тогда redirect_url поступит позже на ваш notify_url в промежуточном статусе.

После изменения статуса операции наш сервер отправляет POST-запрос в формате JSON на ваш notify_url.

Важно: ваш сервер должен вернуть HTTP 200 OK. Иначе система повторяет отправку колбека раз в минуту в течение 10 минут.

Проверка подписи колбека: MD5 от всех параметров в алфавитном порядке через & + API_KEY (без префикса init_payment). Подробнее — в разделе Формат запроса к API.

• Создание платежа по форме
• Статусы платежей
• Возвраты платежей
• Создание платежа по подписке (рекурренты)
• Статусы транзакций
• Коды ошибок (API)
• Коды ошибок (отказы)