Create host2host (GATE) payment

GATE integration lets you initiate a bank card payment directly from your server: you pass card details and order parameters to the 1Payment API. If 3-D Secure is required, the response includes redirect_url to redirect the payer.

1. Request — your server sends payment parameters and card data to the init_payment endpoint with payment_type=card.
2. Response — the system returns order_id, status, and if needed redirect_url for 3-D Secure.
3. 3-D Secure — if the response contains redirect_url, redirect the payer to that address to complete payment.
4. Notification (callback) — the final status arrives at your notify_url.

Passed to complete 3-D Secure version 2.x.

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

Formula:

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

Example string before hashing:

init_paymentaccount=4111111111111111&amount=50&card_holder=TEST&cvc=111&description=test_payment&month=01&partner_id=1234&payment_type=card&project_id=5678&year=22secret_key

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

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

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

  // 3. Отправляем POST-запрос
  try {
    const response = await axios.post('https://api.1payment.com/init_payment', params);
    return response.data;
  } catch (error) {
    console.error('Ошибка:', error.message);
  }
}

// Пример данных запроса
const mockApiKey = process.env.ONEPAYMENT_API_KEY;
const mockData = {
  partner_id: 1234,
  payment_type: 'card',
  project_id: 5678,
  account: '4111111111111111',
  card_holder: 'TEST',
  year: '22',
  month: '01',
  cvc: '111',
  amount: '50.00',
  user_data: 'order_777',
  shop_url: 'https://test.com',
  description: 'test_payment',
};

createCardPayment(mockApiKey, mockData).then(console.log);

Successful response (200):

{
  "order_id": "8p3brmb19gfg0sg8gcwhws8kgc748s87",
  "status": 2,
  "status_description": "PENDING",
  "status_code": 0,
  "redirect_url": "https://testsite.com"
}

If the response contains redirect_url, redirect the payer to that address to complete payment.

Request error (400):

{
  "error_code": 2
}

You can use the following data to test card payments:

After the status changes, a POST notification in JSON format is sent 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 with & + API_KEY (without the init_payment prefix). For details, see API request format.

• Create payment via form
• Create subscription payment
• Payment statuses
• Payment refunds
• Transaction statuses
• Error codes (API)
• Error codes (declines)