Банковская карта

Метод позволяет инициировать выплату на банковскую карту получателя. Запрос отправляется на эндпоинт init_payout с payout_type=card. Финальный статус приходит на notify_url, указанный в настройках выплат проекта; при необходимости статус можно опросить через Статус выплаты.

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

1. Запрос — ваш сервер отправляет подписанный запрос на init_payout с реквизитами карты и суммой выплаты.
2. Ответ — API возвращает order_id и начальный status (2, PENDING).
3. Обработка — система проводит выплату; при частичном зачислении возможен промежуточный статус PENDING с полем paid_amount в колбеке.
4. Уведомление (колбек) — финальный статус отправляется POST JSON на ваш notify_url.

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

Необходимость передачи уточняйте у менеджера 1Payment:

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

Формула:

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

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

init_payoutamount=50&destination=1234123412341234&partner_id=1234&payout_type=card&project_id=5678&user_data=1secret_key

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

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

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

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

const apiKey = process.env.ONEPAYMENT_API_KEY;
const data = {
  payout_type: 'card',
  partner_id: 1234,
  project_id: 5678,
  amount: 50,
  destination: '1234123412341234',
  user_data: '1',
  receiver_country: 'RU',
};

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

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

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

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

{
  "error_code": 2
}

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

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

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

• Статус выплаты
• PIX
• SEPA
• FPS
• Выплата по СБП
• Типы выплат
• Статусы транзакций
• Коды ошибок (API)
• Коды ошибок (отказы)