Form payment creation

Integration via the 1Payment payment form is the simplest way to start accepting payments through the Faster Payments System (SBP). You do not need to generate QR codes or integrate with bank APIs yourself — 1Payment handles the technical side.

The SBP payment flow consists of four steps:

1. Initialization — your server sends a request with order parameters to the 1Payment endpoint.
2. Receiving the link — the system returns a unique URL of the payment page.
3. Payment — you redirect the user to the received address; there they select a bank, open the mobile app, and confirm the payment.
4. Notification (callback) — after the transaction completes, we send a payment status notification to your notify_url.

These fields are required to create the payment form correctly.

Configure form behavior and pass customer data.

Signature: MD5, lowercase (hex). General rules — API request format.

Formula:

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

Example string before hashing:

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);

Successful response (200):

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

The url field is the payment page address to redirect the payer to.

Request error (400):

{
  "error_code": 2
}

After the transaction status changes, our server sends a POST request in JSON format to your notify_url.

Important: your server must return HTTP 200 OK. Otherwise the system retries the callback once per minute for 10 minutes.

Callback signature verification: MD5 of all parameters in alphabetical order joined by & + API_KEY (without the init_form prefix). See API request format.

• Payment status
• Payment refunds
• Host-to-host payment creation (GATE)
• Transaction statuses
• Error codes (API)
• Decline error codes