Документация

Обзор

API интеграции мерчантов

Добро пожаловать в документацию GoPay API. Данное руководство поможет вам интегрировать обработку платежей в ваше приложение.

Начало работы

1. Получение доступа

Для начала интеграции необходимо запросить доступ к личному кабинету мерчанта. Свяжитесь с нашей службой поддержки для получения учётных данных.

2. Получение API-ключей

После входа в личный кабинет мерчанта вы получите:

API Key (X-Identity) — уникальный идентификатор для API-запросов
Secret Key — секретный ключ для подписи запросов алгоритмом HMAC-SHA1

3. Настройка вебхуков

Укажите URL для получения уведомлений (notificationUrl) для получения обновлений статуса платежей в реальном времени.

Методы интеграции

Host-to-Host интеграция

Прямая API-интеграция для взаимодействия сервер-сервер. Этот метод обеспечивает:

Полный контроль над процессом оплаты
Возможность реализации собственного UI
Обновления статуса в реальном времени через callbacks

Доступные сценарии:

Pay-In — приём платежей
Pay-Out — вывод средств на счета пользователей

Заголовки запросов

Все API-запросы должны содержать:

Заголовок	Описание
`Content-Type`	`application/json` или `multipart/form-data`
`X-Identity`	Ваш API-ключ
`X-Signature`	Подпись в формате Base64-encoded HMAC-SHA1

Подробнее о генерации подписи см. в разделе Авторизация.

Базовый URL

Code
 
https://api.example.com

Формат ответа

Все ответы имеют единую структуру:


Code
 
{
  "id": "60c96379-8f4c-4984-959d-58a9c9d94fc5",
  "internalId": "ваш-идентификатор-заказа",
  "type": "in",
  "status": "new",
  "sum": {
    "amount": "100.00",
    "currency": "RUB",
    "subunit": 2
  },
  "deals": [...]
}

Следующие шаги

Last modified on December 12, 2025

Авторизация