В главное меню

Подтверждение оплаты пользователем


Введение

Метод необходим для подтверждения оплаты пользователем. Для этого передается:

  • session-id;
  • и в случае, если было подтверждение по otp - значение, которое ввел пользователь/плательщик.

Входные параметры

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

POST
Endpoint: /payment/confirm HTTP/1.1
Content-Type: application/json
Session-Id: {значение}
<Основные параметры>

Параметр запроса

Поле

Тип

Обяз.

Описание

Session-Id

string [36]

да

Идентификатор платежной сессии

Основные параметры

Поле

Тип

Обяз.

Описание

Request-IdguidдаИдентификатор конкретного запроса

Requestor-Name

string

нет

Наименование сервиса.

  • Для веба - домен, на котором запущен виджет.
  • Для SDK - идентификатор приложения.
  • Для API - имя вызывающей системы.
Requestor-Typestringнет

Тип витрины.

  • API
  • Web Widget
  • Web Page
  • SDK Apple
  • SDK Android
Requestor-VersionstringнетВерсия виджета/sdk

Тело запроса

Поле

Тип

Обяз.

Описание

confirmInput

object

да

Объект указывающий процесс подтверждения, может быть пустым

Описание структуры confirm

Поле

Тип

Обяз.

Описание

otp

string

один из

код из SMS. Обязательно если подтверждение с OTP

card3dsstringодин изPaRes полученный от банка эмитента
3ds2stringодин изcRes полученный от банка эмитента
amountamountодин изверификационная сумма

Выходные параметры

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело ответа

Поле

Тип

Обяз.

Описание

result

object

да

Структура данных успешной операции

Описание структуры result

Поле

Тип

Обяз.

Описание

operationDate

dateTime

да

Дата и время выполнения операции

paymentIdint64даИдентификатор платежа
processingIdstringдаИдентификатор платежа в системе процессинга
statusstringда

Статус платежа

  • inProgress - в процессе исполнения
  • executed - выполнен
paymentToolInfostringдаСпособ оплаты, которым проведен платеж

Пример

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

POST /payment/confirm HTTP/1.1
Host:
Content-Type: application/json
Request-Id: 428069fa-90dd-4c67-8e6f-ba5a9275f6d2
Session-Id: d6946779-dd1a-4e91-8e21-e0ddc8a00288

Тело запроса

Для подтверждения по OTP

{
    "confirmInput": {
        "card3ds": "eJxVUdtygjAQ/RXG...."
    }
}

Для подтверждения по 3ds

{
    "confirmInput": {
        "card3ds": "eJxVUdtygjAQ/RXG...."
    }
}

Для подтверждения по 3ds2

{
    "confirmInput": {
        "3ds2": "eJxVUdtygjAQ/RXG...."
    }
}

Для подтверждения по sberPay

{
    "confirmInput": {}
}

Для подтверждения по amount

{
    "confirmInput": {
        "amount": 10.2
    }
}

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело ответа

{
  "result": {
    "operationDate": "2020-12-28T07:40:29.870Z",
    "paymentId": 1234456,
    "processingId": "1232399"   
}

Возможные коды ошибок

code

message

userMessage

00199998

Validation error

Не пройдена валидация данных

00199999

An unexpected error has occurred

Непредвиденная ошибка

00100001

Session {0} not found

Сессия не найдена

00100003

The payment is already completed within this session {0}

Платеж уже завершен в рамках этой сессии

00100004

The sequence of operations is broken. {0}

В процессе проведения операции произошла ошибка. Попробуйте позже.

00100007The limit of attempts to enter the SMS code has been exceededПревышен лимит попыток ввода SMS кода. Попробуйте позже.
00100010There is no PaRes valueВ процессе проведения операции произошла ошибка. Попробуйте позже.
00100020Invoice payment declinedПлатеж по счету отклонен
00100021Invoice payment in progressПлатеж по счету в процессе проведения
00100036Failed to create payment token. Payment cancelled. Please try again.Не удалось создать платежный токен. Платеж отменен. Повторите попытку.
02000017Payment completed unsuccessfullyПопробуйте повторить операцию или обратитесь в службу поддержки
02005000PCEK: unexpected error. extSystemErrorCode: [errorCode]Непредвиденная ошибка
02005001PCEK: payment confirmation problems. extSystemErrorCode: [errorCode]Проблемы с подтверждением платежа. Попробуйте снова.
02005002PCEK: card expired. extSystemErrorCode: [errorCode]Истёк срок действия карты
02005003MPI: 3d secure problems. extSystemErrorCode: [errorCode]Проблемы с подтверждением платежа. Попробуйте снова.
02005006PCEK: payment limits restriction. extSystemErrorCode: [errorCode]Превышен лимит на платежи через выбранный способ оплаты
02005007PCEK: service unavailableСервис временно недоступен. Попробуйте повторить позже.
02005009PCEK: insufficient funds. extSystemErrorCode: [errorCode]Недостаточно средств
02005011PCEK: CVC/CVV is invalid. extSystemErrorCode: [errorCode]Неверный код безопасности (CVC/CVV)
02005013PCEK: expiry date is invalid. extSystemErrorCode: [errorCode]Неверный срок действия карты
02005014PCEK: card pan is invalid. extSystemErrorCode: [errorCode]Неверный номер карты
02005016Bank acquirer: invalid merchant or terminal. extSystemErrorCode: [errorCode]Оплата через выбранный способ оплаты временно недоступна
02005017Bank issuer: general error. extSystemErrorCode: [errorCode]Ваш банк отклонил платёж
02005018Bank issuer: potential fraud or safety restriction. extSystemErrorCode: [errorCode]Оплата по выбранной карте недоступна
02005019PCEK: payment declined. extSystemErrorCode: [errorCode]Платёж отклонен. Смените способ оплаты и попробуйте снова.
02005023PCEK: The amount is greater than the maximum allowed. extSystemErrorCode: [errorCode]Сумма платежа больше максимально разрешенной
02005024PCEK: The amount is less than the minimum allowed. extSystemErrorCode: [errorCode]Сумма платежа меньше минимально разрешенной
02005025PCEK: potential fraud or safety restriction. extSystemErrorCode: [errorCode]Платёж отклонён системой безопасности
02005030Fraudcontrol: exceeding limits. extSystemErrorCode: [errorCode]Платёж отклонен системой безопасности
02005031PCEK: invalid provider or provider configuration. extSystemErrorCode: [errorCode]Оплата через выбранный способ оплаты временно недоступна
02005032ESPP: account top up is not available. extSystemErrorCode: [errorCode]Пополнение выбранного счёта недоступно
02005033PCEK Provider: The system cannot process the paymentОперация не выполнена. Выберете другой способ оплаты или обратитесь в службу поддержки.
02005034PCEK FM: bank card is used in another account. extSystemErrorCode: [errorCode]Банковская карта уже привязана к другому аккаунту
02005036Bank issuer: payment restriction. extSystemErrorCode: [errorCode]Ваш банк ограничил оплату с выбранной карты
02005040PCEK FM: safety restriction. extSystemErrorCode: [errorCode]Превышен лимит на платежи
02005042PCEK: service unavailable. extSystemErrorCode: [errorCode]Сервис временно недоступен
02005043PCEK: bank issuer have some problems. extSystemErrorCode: [errorCode]Ваш банк отклонил платёж
02005044PCEK FM: potential fraud or safety restriction. extSystemErrorCode: [errorCode]Платёж отклонён системой безопасности
02005047PCEK Provider: service unavailable. extSystemErrorCode: [errorCode]Сервис временно недоступен
02005048PCEK Provider: wrong payment parameters specified. extSystemErrorCode: [errorCode]Неверные реквизиты оплаты
02005049PCEK: payment from billing account is not available. extSystemErrorCode: [errorCode]Оплата со счёта телефона временно недоступна
02005051ESPP: service unavailable. extSystemErrorCode: [errorCode]Оплата временно недоступна
02005052ESPP: client is legal entity. extSystemErrorCode: [errorCode]Выбранный способ оплаты доступен только физическим лицам
02005053ESPP: payment restriction installed by the client. extSystemErrorCode: [errorCode]Оплата со счёта запрещена
02005054ESPP: incorrect account parameters. extSystemErrorCode: [errorCode]Оплата через выбранный способ оплаты временно недоступна
02005055ESPP: insufficient funds. extSystemErrorCode: [errorCode]Недостаточно средств
02005056Bank issuer: insufficient funds extSystemErrorCode: [errorCode]Недостаточно средств
02005057Bank issuer: invalid CVC or another safety restriction. extSystemErrorCode: [errorCode]Неверный код безопасности (CVC/CVV)
02005058Bank issuer: card expired. extSystemErrorCode: [errorCode]Истек срок действия карты
02005060Bank issuer: potential fraud or safety restriction. extSystemErrorCode: [errorCode]Ваш банк отклонил платеж. Ограничения на карте.
02005061Bank acquirer: general error. extSystemErrorCode: [errorCode]Банк отклонил платёж
02005064Bank issuer: payment restriction. extSystemErrorCode: [errorCode]Ваш банк ограничил оплату с выбранной карты
02005065Bank acquirer: fatal general error. extSystemErrorCode: [errorCode]Банк отклонил платёж
03000001Provider unavailableНедоступен один из узлов взаимодействия
03000007Subscription {0} not foundВ процессе проведения операции произошла ошибка. Обратитесь в службу поддержки.
03000008Invalid operation for current subscription status: Current status: {0}В процессе проведения операции произошла ошибка. Попробуйте позже.