Создание платежа по подписке (рекурренты)

Рекуррентные платежи через СБП позволяют автоматически списывать средства со счёта клиента в банковском приложении без его повторного участия. Идентификация счёта выполняется по токену, который выдаётся при первичной привязке.

Для активации функционала в проекте обратитесь к сопровождающему менеджеру 1Payment.

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

1. Привязка счёта (первый запрос) — вы проводите успешный платёж с суммой больше 0 и параметром subscribe=1 через форму оплаты или GATE. Плательщик подтверждает привязку в приложении банка.
2. Получение токена — после подтверждения банком 1Payment отправляет колбек с уникальным token. Сохраните его для последующих списаний.
3. Автосписание (рекуррент) — для повторных оплат ваш сервер вызывает GATE (init_payment), передавая сохранённый token. Списание проходит без участия плательщика.
4. Уведомление — после каждой попытки списания приходит колбек с финальным результатом транзакции.

Формат ответа: JSON. Для СБП в запросах указывайте payment_type=sbp.

Для регистрации подписки проведите успешный платёж с суммой больше 0 и параметром subscribe=1. Подробнее о параметрах формы и GATE — в разделах Создание платежа по форме и Создание платежа по host2host (GATE). Ниже — обязательный набор для привязки.

Подпись при регистрации через форму — префикс init_form. Через GATE — префикс init_payment.

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

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

Для автоматического списания отправьте запрос на GATE с сохранённым token. При активной подписке участие клиента не требуется.

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

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

// 1. Инициация подписки (первичная привязка)
async function setupSbpSubscription(apiKey, params) {
  const sortedKeys = Object.keys(params).sort();
  const queryString = sortedKeys.map((k) => `${k}=${params[k]}`).join('&');

  const baseString = `init_form${queryString}${apiKey}`;
  params.sign = crypto.createHash('md5').update(baseString).digest('hex');

  const response = await axios.post('https://api.1payment.com/init_form', params);
  return response.data; // ссылка для подтверждения в приложении банка
}

// 2. Рекуррентное списание (по токену)
async function chargeSbpByToken(apiKey, params) {
  const sortedKeys = Object.keys(params).sort();
  const queryString = sortedKeys.map((k) => `${k}=${params[k]}`).join('&');

  const baseString = `init_payment${queryString}${apiKey}`;
  params.sign = crypto.createHash('md5').update(baseString).digest('hex');

  const response = await axios.post('https://api.1payment.com/init_payment', params);
  return response.data;
}

const secretKey = process.env.ONEPAYMENT_API_KEY;

// Пример: привязка
const setupData = {
  partner_id: 1234,
  project_id: 5678,
  amount: '50.00',
  subscribe: 1,
  payment_type: 'sbp',
  user_data: 'sbp_setup_777',
  shop_url: 'http://myshop.ru',
};
// setupSbpSubscription(secretKey, setupData).then(console.log);

// Пример: списание
const recurringData = {
  partner_id: 1234,
  payment_type: 'sbp',
  project_id: 5678,
  token: 'sbp_t_1a2b3c',
  amount: '500.00',
  user_data: 'sbp_order_888',
  shop_url: 'http://myshop.ru',
};
chargeSbpByToken(secretKey, recurringData).then(console.log);

При успешном рекуррентном запросе (200):

{
  "order_id": "8p3brmb19gfg0sg8gcwhws8kgc748s87",
  "status": 2,
  "status_description": "PENDING"
}

При регистрации через форму в ответе будет поле url (см. Создание платежа по форме); через GATE — redirect_url (см. Создание платежа по host2host (GATE)).

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

{
  "error_code": 2
}

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

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

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

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