Протокол обработки карточных операций¶
Поддерживается модифицированный протокол сообщений стандарта ISO-8583 SVFE_POS_ISO8583 от терминалов.
| Правила взаимодействия | Ожидаемый результат | 
|---|---|
| Обработка сообщений 0200(финансовая транзакция, платёж) | Результат обработки — сообщение 0210с кодом ответа в поле39 | 
| Обработка сообщений 0200:• получение в поле 39сообщения0210кода, отличного от000(успешная транзакция);• отсутствие ответа по таймауту | Отправка сообщения 0400(отмена операции). В полях3,37сообщения переданы значения из исходной платёжной операции | 
| Обработка сообщений 0400(отмена операции) | Результат обработки — сообщение 0410 | 
| Обработка сообщений 0400: отсутствие ответа по таймауту | Повторная отправка сообщения 0400(отмена операции) до получения ответа0410от сервера | 
| Обработка сообщений 0200с кодом20в поле3(возврат) | Обработка сообщения выполняется аналогично финансовой транзакции 0200 | 
Важная информация
В ежедневном реестре тип операций возврата и отмены указывается как Возврат. При этом удерживается комиссия за исходную платёжную операцию.
Схема обмена сообщениями для платежа изображена на диаграмме ниже.
%%{init: {
    "sequence" : {
        "messageFontSize":14,
        "noteFontSize":12,
        "actorMargin":
        125 }}}%%
sequenceDiagram
    participant P as POS-терминал
    participant Q as QIWI ISO-8583
    P->>Q: 0200
    Note right of P: Платёжная операция
    alt Ответ с кодом успеха
    Q-->>P: 0210
    Note right of P: Получен ответ, операция завершилась успешно
    else Ответ с кодом неуспеха
    rect rgb(255, 238, 223)
    Q-->>P: 0210
    Note right of P: Получен ответ, операция завершилась неуспешно
    P->>Q: 0400
    Note right of P: Отмена операции (см. схему ниже)
    Q-->>P: 0410
    P->>Q: 0200
    Note right of P: Новая платёжная операция
    Q-->>P: 0210
    end
    else Ответ отсутствует (таймаут)
    rect rgb(230, 230, 230)
    P->>Q: 0400
    Note right of P: Отмена операции (см. схему ниже)
    Q-->>P: 0410
    P->>Q: 0200
    Note right of P: Новая платёжная операция
    Q-->>P: 0210
    end
    endСхема обмена сообщениями для отмены операции изображена ниже.
%%{init: {
    "sequence" : {
        "messageFontSize":14,
        "noteFontSize":12,
        "actorMargin":
        125 }}}%%
sequenceDiagram
    participant P as POS-терминал
    participant Q as QIWI ISO-8583
    P->>Q: 0400
    Note right of P: Отмена операции
    alt Ответ
    Q-->>P: 0410
    Note right of P: Получен ответ, операция завершилась успешно
    else Ответ отсутствует (таймаут)
    loop Цикл до получения ответа
    rect rgb(230, 230, 230)
    P->>Q: 0400
    Q-->>P: Таймаут, ответ не получен
    end
    end
    Q-->>P: 0410
    Note right of P: Получен ответ, операция завершилась успешно
    endAPI удаленной отмены¶
Если функциональность отмен/возвратов не поддерживается POS-терминалом, агрегатор может использовать метод API для удаленной отмены без участия банковской карты покупателя и POS-терминала.