Возвраты платежей

Метод инициирует возврат успешного платежа (канал link). Передайте order_id исходной оплаты и отдельный user_data для операции возврата. После принятия запроса API вернёт refund_order_id и статус REFUND_PENDING; финальный результат придёт на notify_url проекта.

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

1. Исходный платёж — возврат возможен по order_id платежа в статусе успеха (SUCCESS, код 3). ID берётся из ответа создания по форме или GATE.
2. Инициация — подписанный запрос на init_refund с уникальным user_data возврата (не совпадает с user_data платежа).
3. Ответ — refund_order_id, status 9 (REFUND_PENDING) и status_description.
4. Финал — колбек POST JSON на notify_url; при необходимости опросите статус по refund_order_id через Статусы платежей.

Расшифровка status и status_description для возвратов — в Статусы транзакций (REFUND, REFUND_PENDING).

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

Формула:

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

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

init_refundorder_id=8p3brmb19gfg0sg8gcwhws8kgc748s87&partner_id=1234&project_id=5678&user_data=abcd1234secret_key

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

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

async function initLinkRefund(apiKey, params) {
  const sortedKeys = Object.keys(params).sort();
  const queryString = sortedKeys.map((key) => `${key}=${params[key]}`).join('&');

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

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

const apiKey = process.env.ONEPAYMENT_API_KEY;
const data = {
  partner_id: 1234,
  project_id: 5678,
  order_id: '8p3brmb19gfg0sg8gcwhws8kgc748s87',
  user_data: 'abcd1234',
};

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

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

{
  "refund_order_id": "crf_1p3brmb19gfg0sg8gcwhws8kgc748s87",
  "status": 9,
  "status_description": "REFUND_PENDING",
  "status_code": 0
}

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

{
  "error_code": 2
}

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

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

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

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