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

Протокол обработки карточных операций

Поддерживается модифицированный протокол сообщений стандарта 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: Получен ответ, операция завершилась успешно
    end

API удаленной отмены

Если функциональность отмен/возвратов не поддерживается POS-терминалом, агрегатор может использовать метод API для удаленной отмены без участия банковской карты покупателя и POS-терминала.