Первичная Авторизация и Завершение Авторизации
На этой странице вы можете ознакомиться с подробностями первичной авторизации и завершения авторизации.
Первичная Авторизация и Non-3D Secure
URL
Информация о конечной точке и методе HTTP, используемых для запуска первичной авторизации, предоставлена ниже:
| HTTP Metod | URL |
|---|---|
POST |
/payment/v1/card-payments |
Параметры Запроса
Все параметры обычного запроса на платеж также применимы к первичной авторизации. Для создания первичной авторизации запрос должен быть отправлен с параметром paymentPhase в значении PRE_AUTH.
Вы можете создать первичную авторизацию, изучив службу приема платежей и отправив ожидаемый параметр в запросе первичной авторизации. Ответ, полученный в процессе создания первичной авторизации, аналогичен ответу в обычном запросе на платеж.
Смотрите : Прием Платежей
Первичная Авторизация и 3D Secure
Первичная авторизация с использованием 3D Secure также применима для обычных потоков 3D Secure. Когда конечный пользователь подтверждает себя с помощью полученного кода OTP, операция с PRE_AUTH будет завершена как 3D Secure.
Операция PRE_AUTH 3D Secure должна быть сначала завершена с помощью службы 3D Complete, а затем использован запрос на завершение авторизации.
URL
Информация о конечной точке и методе HTTP, используемых для запуска первичной авторизации с 3D Secure, предоставлена ниже:
| HTTP Method | URL |
|---|---|
POST |
/payment/v1/card-payments/3ds-init |
Параметры Запроса
Все параметры обычного запроса на 3D Secure платеж также применимы к первичной авторизации. Для создания первичной авторизации запрос должен быть отправлен с параметром paymentPhase в значении PRE_AUTH.
Вы можете создать первичную авторизацию, изучив службу приема платежей и отправив ожидаемый параметр в запросе первичной авторизации. Ответ, полученный в процессе создания первичной авторизации, аналогичен ответу в обычном запросе на платеж.
Смотрите услугу приема платежей: Прием Платежей
Важные моменты
- Операция первичной авторизации не поддерживает модель платформы продаж. Вы можете начать первичную авторизацию для платежей по листингу/подписке.
- Операция первичной авторизации может быть выполнена только с информацией о сохраненной карте или открытой карте. Кошелек не поддерживается.
- Во время процесса завершения первичной авторизации информация о цене, отправленная во время процесса завершения, должна быть меньше или равна сумме, отправленной во время первичной авторизации.
- Операцию первичной авторизации можно использовать для виртуальных POS банков, но не поддерживается для электронных денег.
Завершение Авторизации
Для успешно созданного первичного авторизации платежа вы можете завершить авторизацию, чтобы завершить платеж.
URL
Информация о конечной точке и методе HTTP, используемых для завершения первичной авторизации, указана ниже:
| HTTP Metod | URL |
|---|---|
POST |
/payment/v1/card-payments/:id/post-auth |
Параметры Запроса
| Название Параметра | Тип | Обязательный | Описание |
|---|---|---|---|
id |
number |
Да | ID платежа, на который была совершена первичная авторизация |
paidPrice |
number |
Да | Сумма, необходимая для завершения авторизации |
Параметры Возврата
Параметры, возвращаемые в результате процесса оплаты, подчиняются правилам, указанным в разделе Форматы возврата на основной странице документации API. Ответ, полученный в процессе завершения авторизации, аналогичен ответу на обычный запрос оплаты. См. Получение оплаты для платежной службы.
Дополнительные актуальные операции предварительной авторизации
- Отмена предварительной авторизации:
POST /payment/v1/card-payments/{paymentId}/cancel-pre-auth. Тело запроса не требуется. - Завершение предварительной авторизации по нескольким картам:
POST /payment/v1/card-payments/{conversationId}/multi_post-auth. - Тело завершения поддерживает поля
paidPrice(положительное число, максимум 2 000 000),hostReference,authCodeиtransId. Для завершения по нескольким картам используется толькоpaidPrice.