Создание платежа по форме

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

Процесс оплаты через СБП состоит из четырёх этапов:

1. Инициализация — ваш сервер отправляет запрос с параметрами заказа на эндпоинт 1Payment.
2. Получение ссылки — в ответ система возвращает уникальный URL платёжной страницы.
3. Оплата — вы перенаправляете пользователя по полученному адресу; там он выбирает банк, переходит в мобильное приложение и подтверждает платёж.
4. Уведомление (колбек) — после завершения транзакции мы отправляем уведомление о статусе платежа на ваш notify_url.

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

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

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

Формула:

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

Пример строки до хеширования:

init_formamount=100.00&partner_id=123&payment_type=sbp&project_id=456&shop_url=myshop.ru&user_data=order_777secret_key

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

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

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

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

// Пример данных запроса
const mockApiKey = process.env.ONEPAYMENT_API_KEY;
const mockData = {
  partner_id: 123,
  project_id: 456,
  amount: '100.00',
  payment_type: 'sbp',
  user_data: 'order_777',
  shop_url: 'myshop.ru',
};

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

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

{
  "url": "https://merchant.1payment.com/xZ5g7F"
}

Поле url — адрес платёжной страницы, на которую нужно перенаправить плательщика.

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

{
  "error_code": 2
}

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

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

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

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