Создание инвойса

Метод позволяет выставить инвойс (счёт на оплату) и получить ссылку на платёжную форму. Запрос отправляется на эндпоинт init_invoice. После оплаты или истечения срока действия инвойса финальный статус приходит на invoice_notify_url, указанный в настройках проекта.

Формат запросов и подписи — в разделе Формат запроса к API.

1. Запрос — ваш сервер отправляет подписанный запрос на init_invoice с суммой и invoice_user_data.
2. Ответ — API возвращает invoice_id и url платёжной страницы.
3. Оплата — вы перенаправляете плательщика по url или передаёте ссылку иным способом.
4. Уведомление (колбек) — при финальном статусе инвойса отправляется POST JSON на invoice_notify_url проекта.

Расшифровка кодов status — в разделе Статусы транзакций.

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

Формула:

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

Пример строки до хеширования (как в архивной документации, без invoice_user_data в минимальном примере):

init_invoiceamount=50&description=test_payment&partner_id=1234&project_id=5678secret_key

Если передаёте invoice_user_data, success_url и другие поля, они участвуют в строке подписи в алфавитном порядке.

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

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

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

  // 3. GET-запрос
  const response = await axios.get('https://api.1payment.com/init_invoice', { params });
  return response.data;
}

const apiKey = process.env.ONEPAYMENT_API_KEY;
const data = {
  partner_id: 1234,
  project_id: 5678,
  amount: 50,
  description: 'test_payment',
  invoice_user_data: 'inv_12345',
};

createInvoice(apiKey, data).then(console.log);

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

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

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

{
  "error_code": 2
}

После получения финального статуса инвойса на ваш invoice_notify_url (из настроек проекта) отправляется POST-уведомление в формате JSON.

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

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

• Формат запроса к API
• Статусы транзакций
• Коды ошибок (API)
• Коды ошибок (отказы)