Платежи кошельком

Актуальный public API кошелька использует базовый путь /payment/v1/wallet.

Инициализация платежа кошельком

Вызовите POST /payment/v1/wallet/init с merchantId в header. Тело использует актуальный контракт CreatePaymentRequest, описанный в разделе Payments. Поле walletIntegratorType задается настроенной интеграцией: ODERO_PAY, GARANTI_PAY, OLIZ_PAY или ABB_PAY. Успешный запрос возвращает 201 Created.

Ответ содержит id, source, timestamp, resultCode, resultMessage, errors и response. Элементы ошибок содержат code, type и message; данные response — orderId, status, redirectUrl и qrText.

Callback завершения

• POST /payment/v1/wallet/complete/garantipay: поля тела orderId и signMessage; возвращает OK в стандартном wrapper.
• POST /payment/v1/wallet/complete/abb-pay: поля тела orderId, externalId и status; возвращает OK в стандартном wrapper.

Эти endpoint являются callback платежных провайдеров и в текущем controller не требуют merchant header.

Получение статуса платежа

Вызовите GET /payment/v1/wallet/status/{orderId} с merchantId в header. Ответ содержит статус платежа. При несовпадении merchant возвращается wrapped-ошибка с кодом 404.

Варианты рассрочки GarantiPay

Вызовите POST /payment/v1/wallet/garantipay/v0/options с контрактом запроса вариантов рассрочки GarantiPay. Ответ провайдера возвращается в стандартном API wrapper.

В актуальном исходном коде нет активных public endpoint отмены или возврата кошелька; соответствующие методы закомментированы и поэтому не документируются как доступные API.