Ініціювання платіжних операцій, статуси платежів та сценарії авторизації через PISP.
Цей розділ містить Специфікацію API ініціювання платіжної операції (PIS – Payment Initiation Service), версія 2.1 (українська адаптація специфікації Berlin Group). Специфікація описує взаємодію між PISP та ASPSP для ініціювання платежів, отримання їх статусів та проходження сценаріїв авторизації PSU.
Ліцензія та використання: матеріали поширюються за умовами CC BY-ND 4.0; при поширенні необхідно наводити зазначені в документі умови ліцензування.
Документ є адаптованим перекладом Berlin Group XS2A API (PSD2) для ініціювання платіжних операцій в Україні та визначає перелік рахунків, валютні/статусні обмеження і обов’язкові сценарії застосування (Use Cases) для PIS API.
Статуси платіжної операції (transactionStatus) у PIS API відповідають ISO20022 та визначають етапи обробки платежу від отримання до завершення або відхилення.
Описує обов’язкові endpoints та методи доступу до PIS API.
Описує модель даних PIS, умовні позначення та вимоги до request/response (для позитивних відповідей), а також перелік ключових атрибутів і їх розташування.
Ініціювання платіжних операцій з мультивалютних рахунків дозволене лише з UAH-субрахунку.
Опис ендпойнта POST /v2/payments/{payment-product} для ініціювання платіжної операції у форматі JSON: параметри, заголовки, тіло запиту та відповідь.
Описує ендпоїнти GET /v2/{payment-service}/{payment-product}/{paymentId}/status та GET /v2/{payment-service}/{payment-product}/{paymentId}, їх параметри, заголовки та структури відповідей.
Описує сценарій ініціювання платіжної операції PSU через PISP (Redirect SCA / Decoupled SCA), кроки основного та альтернативних сценаріїв, і відповідні виклики API.
ASPSP може періодично перевіряти платіжні операції у статусі RCVD та переводити їх у RJCT після визначеного часу.
Посилання на ключові документи та репозиторій YAML, використані під час розробки специфікації.
Перелік додатків до розділу PIS API v2.1.
Приклади тест-кейсів для контрактного тестування PIS API: ініціювання платіжної операції, авторизація ресурсу платіжної операції, перевірка статусу платіжної операції.
