Перейти к содержанию

api/wallet/pay-in-alfa-pay - Пополнение Кошелька через AlfaPay

  • HTTP‑метод: POST
  • URL: /api/wallet/pay-in-alfa-pay
  • Форма взаимодействия: Сервер-сервер
  • Формат тела запроса: application/json
  • Назначение: пополнение Кошелька с помощью AlfaPay.

URL

1
https://gateway-docs.wallet.kvell.group/api/wallet/pay-in-alfa-pay

1
/api/wallet/pay-in-alfa-pay

Структура запроса

Поле Тип Обяз. Описание
terminal str ✔ Уникальный идентификатор учетной записи ТСП в ПЦ.
os_type str ✔ Тип операционной системы мобильного устройства или персонального компьютера. Возможные значения: android — операционная система Android; ios — операционная система iOS; other — другая операционная система.
signature str ✔ Цифровая подпись запроса. Алгоритм расчёта — см. Формирование подписи.
Условно‑обязательные параметры
amount int Общая сумма всех последующих расходов по сделке в минимальных единицах валюты. Для рублей — копейки. Обязателен, если не указан order_id (тогда значение берётся из заказа).
description str Описание перевода. Обязателен, если не указан order_id (тогда значение берётся из заказа).
Необязательные параметры
currency int Код валюты по ISO4217 (643 для RUB; 978 для EUR; 840 для USD).
order_id int Уникальный идентификатор платежа (Заказа) в ПЦ.
receiver object Данные Кошелька-получателя. Значимое поле (см. структуру payer/receiver): wallet_public_id (вариант учета №2).
fee int Комиссия для удержания с Плательщика при списании средств с его карты в минимальных единицах валюты. Для рублей — копейки.
tx_client_id str Номер перевода на стороне ТСП (в ИС ТСП). Если в запросе указан параметр order_id, значение tx_client_id из запроса игнорируется.
return_url str Адрес страницы на стороне ТСП, на которую автоматически переводится Плательщик по завершении Операции. Если в запросе указан параметр order_id, значение return_url из запроса игнорируется.
fail_url str Адрес страницы на стороне ТСП, на которую автоматически переводится Плательщик в случае неуспешного окончания проведения Операции. Если не указан, ПЦ считает его равным значению return_url.
payer object Данные Плательщика. Значимое поле (см. структуру payer/receiver): phone.
mobile_deep_url str Ссылка для возврата в мобильное приложение ТСП (мерчанта) после оплаты. Если было указано при регистрации заказа (api/register), и в запросе указан order_id — значение берётся из заказа.

Структура ответа

Поле Тип Обяз. Описание
order_id int ✔ Идентификатор заказа в ПЦ. Пример: 1009982
order_status str ✔ Статус заказа. Пример: REGISTERED
client_id str Идентификатор пользователя ТСП. Пример: test
tx_id int ✔ Идентификатор операции в ПЦ. Пример: 5587788
tx_date datetime ✔ Дата и время совершения операции в ПЦ. Пример: 2024.01.28 00:23:19
tx_type str ✔ Тип операции. Пример: P2PTRANSFER
tx_status str ✔ Статус операции. Пример: PENDING
amount int ✔ Сумма операции в минимальных единицах валюты. Пример: 50000
currency int ✔ Код валюты по ISO4217. Пример: 643
alfapay_link str URL оплаты по AlfaPay. Пример: https://alfa.rbsuat.com/payment/acsRedirect.do?orderId=03e3eb4c-e799-7b1e

Пример ответов

{
    "order_id": 1009982,
    "order_status": "REGISTERED",
    "client_id": "test",
    "tx_id": 5587788,
    "tx_date": "2024.01.28 00:23:19",
    "tx_type": "P2PTRANSFER",
    "tx_status": "PENDING",
    "amount": 50000,
    "currency": 643,
    "alfapay_link": "https://alfa.rbsuat.com/payment/acsRedirect.do?orderId=03e3eb4c-e799-7b1e"
}

{
    "error_code": "TERMINAL_NOT_FOUND",
    "technical_message": "Terminal not found",
    "timestamp": 1751976000,
    "details": null,
    "request_id": "b3b3c1f0-4b3a-4f3a-9b1a-1234567890ab"
}

Примечания

  • При получении запроса ПЦ проверяет правильность расчета подписи и корректность параметров запроса.
  • Если order_id не указан, обязательны amount и description (значение currency в этом случае необязательно, в отличие от других services эндпоинтов).
  • Обратите внимание: у этого эндпоинта поле даты операции в ответе называется tx_date, а не tx_completed_at, как в большинстве остальных services методов.