1. Платежи
Platega.io API
  • Авторизация
  • Модули CMS
  • SDK
  • Платежи
    • Приём карт по H2H
    • Рекуррентные СБП-подписки
      • Пробный доступ и изменение суммы подписки
      • Подписки по H2H
      • Создать подписку
      • Получить подписку
      • Список подписок
      • Отменить подписку
      • Проверка возможности обновить подписку
      • Обновление подписки
    • Создание платежной ссылки без заданного метода
      POST
    • Создание платежной ссылки с заданным методом
      POST
    • Получение QR-кода для H2H-транзакции
      GET
    • Проверка статуса оплаты платежа
      GET
    • Выгрузка транзакций в CSV
      POST
    • Выгрузка транзакций в Excel
      POST
    • Выгрузка транзакций в Json
      POST
  • Балансы
    • Получение балансов
      GET
  • Возвраты
    • Проверка возможности отмены транзакции
      GET
    • Отмена транзакции
      POST
    • Частичная отмена транзакции
      POST
  • Выводы
    • Создаёт вывод на рублёвую карту через Payout API
    • Создаёт вывод на криптокошелек через Payout API
    • Получение сохранённых карт
      GET
    • Получение сохраненных криптокошельков
      GET
  • Callbacks
    • Колбэки — общая информация
    • CONFIRMED
    • CANCELED
    • CHARGEBACKED
    • PARTIALLY_REFUNDED
    • DISPUTED
  • Schemas
    • Schemas
      • PaymentStatus
      • PaymentMethodInt
      • CreateTransactionRequest
      • CreateTransactionResponse
      • TransactionStatusResponse
      • SubscriptionStatus
      • CallbackSubscriptionStatus
      • SubscriptionInterval
    • Статус платежа в колбэке
    • Результат операции возврата
    • Общие поля колбэка
    • Поля колбэка по возврату
    • CallbackPayload
    • Поля колбэка по подписке
  1. Платежи

Создание платежной ссылки без заданного метода

POST
/v2/transaction/process
Создает транзакцию и возвращает данные для оплаты. ID транзакции генерируется системой автоматически — не передавайте поле id в запросе.
Поле metadata обязательно. В каждом запросе передавайте идентификатор покупателя в metadata.user_email — как его сформировать, описано ниже, в разделе «Метаданные платежа».
При посещении страницы плательщик сам выбирает способ оплаты.
Метаданные платежа
metadata.user_email — идентификатор покупателя в виде адреса электронной почты. По нему платёжная система узнаёт покупателя и видит историю его платежей. Без него платежи одного покупателя не связываются между собой, а платёжная форма запрашивает адрес у плательщика сама, добавляя лишний шаг в оплату.
metadata.userId — уникальный идентификатор плательщика в вашей системе. Для магазинов отдельных категорий он обязателен: уточните у вашего менеджера, требуется ли это для вашего магазина. Отсутствие metadata.userId при наличии требования отключает антифрод-защиту и может привести к отключению магазина.
metadata.userName — любые дополнительные данные о плательщике, которые вы хотите сохранить вместе с транзакцией.
Главное правило: один покупатель — один адрес. Передавайте одно и то же значение во всех платежах покупателя. Случайный адрес под каждый заказ разрывает историю: каждый платёж выглядит как платёж нового покупателя.
Как сформировать user_email
Выберите один из трёх сценариев.
1. Вы собираете e-mail покупателя. Передавайте адрес без изменений — в том виде, в каком покупатель указал его при регистрации или оформлении заказа. Перед отправкой проверьте формат адреса.
Формат: {e-mail покупателя}
ivan.petrov@gmail.com — подходит: адрес, который ввёл покупатель
test@test.ru — не подходит: заглушка
orders@yourshop.ru — не подходит: адрес магазина, а не покупателя
2. Магазин в Telegram. Используйте числовой Telegram ID покупателя с доменом telegram.org. Числовой ID постоянен, это поле from.id в Bot API. Username вида @name не подходит: его можно сменить.
Формат: {telegram_id}@telegram.org
5512345678@telegram.org — подходит: числовой Telegram ID
ivan_petrov@telegram.org — не подходит: username вместо ID
5512345678 — не подходит: нет домена
3. Вы не собираете e-mail. Соберите адрес из постоянного идентификатора покупателя в вашей системе и известного почтового домена — например gmail.com, mail.ru, yandex.ru. Идентификатор должен быть постоянным для покупателя, а не новым под каждый заказ.
Формат: {ID покупателя}@{почтовый домен}
100482@mail.ru — подходит: постоянный ID покупателя
k7f2x9q1@mail.ru — не подходит: случайная строка под заказ
order-55831@mail.ru — не подходит: номер заказа, а не покупателя
100482@myshop.xyz — не подходит: домен не является известным почтовым сервисом
Редирект через Telegram-бота
По умолчанию при использовании paymentMethod: 13 (криптоплатежи) пользователь перенаправляется на веб-пейформу.
Если вы хотите, чтобы оплата проходила через Telegram-бота — обратитесь к вашему менеджеру для подключения.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Успешно создано
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v2/transaction/process' \
--header 'X-MerchantId;' \
--header 'X-Secret;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "paymentDetails": {
        "amount": 500,
        "currency": "RUB"
    },
    "description": "Оплата мешков картошки клиенту №293",
    "return": "https://google.com/success",
    "failedUrl": "https://google.com/fail",
    "payload": "Дополнительная информация о платеже",
    "metadata": {
        "userId": "123456789",
        "userName": "@username",
        "clientIp": "111.47.86.11",
        "user_email": "100482@mail.ru"
    }
}'
Response Response Example
{
    "transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "PENDING",
    "url": "https://pay.platega.io/?id=f8000067-a4a0-0000-0000-2556a0b40000&mh=0a0000a4-0000-0000-0000-200004060000",
    "expiresIn": "00:15:00",
    "rate": 91.2
}
Modified at 2026-10-30 13:06:28
Previous
Обновление подписки
Next
Создание платежной ссылки с заданным методом
Built with