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

Этот способ интеграции позволяет создать платёж через SberPay напрямую с вашего сервера. Вы получаете два типа ссылок: обычную веб-ссылку и Deep Link для мгновенного перехода в мобильное приложение «СберБанк Онлайн».

Главное преимущество — возможность гибко управлять сценарием оплаты в зависимости от устройства пользователя (App-to-App или Web-to-App), что обеспечивает максимально высокую конверсию.

1. Запрос — ваш сервер отправляет данные заказа и выбранный тип взаимодействия (sberpay_type) на эндпоинт 1Payment.
2. Получение ссылок — в ответ вы получаете redirect_url и deep_link.
3. Оплата — вы перенаправляете клиента. Использование Deep Link на смартфонах позволяет сразу открыть приложение Сбера для подтверждения транзакции.
4. Уведомление (колбек) — мы присылаем callback с финальным статусом на ваш notify_url.

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

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

Подпись — это MD5-хеш в нижнем регистре. Общие правила — Формат запроса к API.

Формула:

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

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

Моковые данные: amount=50, partner_id=1234, payment_type=sberpay, project_id=5678, sberpay_type=app2app, user_data=order_777.

init_paymentamount=50&partner_id=1234&payment_type=sberpay&project_id=5678&sberpay_type=app2app&user_data=order_777secret_key

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

async function createSberPayPayment(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;
  } catch (error) {
    console.error('Ошибка:', error.message);
  }
}

// Пример данных запроса
const mockApiKey = process.env.ONEPAYMENT_API_KEY;
const mockData = {
  partner_id: 1234,
  project_id: 5678,
  amount: '50.00',
  payment_type: 'sberpay',
  sberpay_type: 'app2app',
  user_data: 'order_777',
};

createSberPayPayment(mockApiKey, mockData).then(console.log);

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

{
  "order_id": "8p3brmb19gfg0sg8gcwhws8kgc748s87",
  "status": 2,
  "status_description": "PENDING",
  "redirect_url": "https://secure_link_to_sberpay",
  "deep_link": "sberpay://link_to_app"
}

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

{
  "error_code": 2
}

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

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

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

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