Отримання результату фіскалізації
Після надсилання запиту на фіскалізацію необхідно дочекатися результату обробки.
Успішне завершення платіжної операції та успішна фіскалізація — це два окремі процеси.
Платіж може мати статус SUCCESS, тоді як фіскалізація ще перебуватиме в обробці.
AlliancePay надсилає окремий Callback із результатом фіскалізації на адресу notificationUrl, передану в запиті. Структуру повідомлення та приклад наведено в документі «Callback по фіскалізації».
Рекомендується використовувати отриманий результат для оновлення стану фіскалізації замовлення у власній системі.
7.1. Статуси фіскалізації
SUCCESS
Фіскалізація успішна; фіскальний номер присутній.
FAIL
Поточний запит завершився помилкою. Після усунення її причини операцію можна повторно подати на фіскалізацію.
PENDING
Запит прийнято до опрацювання; потрібно очікувати результату.
RECEIPT
Чек сформовано в офлайн-режимі під час недоступності ДПС. У Callback уже є фіскальний номер; для мерчанта це успішний результат.
Якщо ДПС недоступна, мерчант отримує Callback зі статусом RECEIPT і фіскальним номером. Після відновлення доступу чек автоматично реєструється в ДПС, а статус фіскалізації змінюється з RECEIPT на SUCCESS. Повторний Callback після цієї зміни не надсилається. Тому RECEIPT слід обробляти як успішний результат для мерчанта, не очікуючи ще одного повідомлення.
Платіжний Callback зі статусом SUCCESS підтверджує оплату, але не фіскалізацію. Оновлюйте стан фіскалізації за її окремим Callback зі статусом SUCCESS, RECEIPT або FAIL.
Тіло повідомлення
merchantRequestId
Ідентифікатор первинного запиту Merchant.
string
Так
"8d2d1234-5678-4e92-a975-672f42fca5e3"
merchantId
Ідентифікатор Merchant у Ecom.
string
Так
"f3bb63ae-0ed7-422b-a36a-98f0c65a36b3"
operationId
Ідентифікатор платіжної операції Ecom.
string
Так
"1772887138149SIx5b1QV7AI"
operationType
Тип операції в термінах Ecom.
string, enum: PURCHASE, REFUND
Так
"PURCHASE"
bucketId
Ідентифікатор фіскального документа Alliance Kasa.
string / null
Так після того, як Kasa прийняла або знайшла запит; для локальної validation error може бути null.
"17884211495330w3O5fjP0Jj"
status
Поточний статус фіскалізації.
string, enum: PENDING, SUCCESS, RECEIPT, FAIL
Так
"PENDING"
fiscalNumber
Фіскальний номер чека.
string / null
Так для SUCCESS і RECEIPT; інакше null.
"7711175116"
receiptUrl
Посилання на фіскальний чек.
string / null
Так для SUCCESS і RECEIPT; інакше null.
"https://example.com/check/17884211495330w3O5fjP0Jj"
receiptComment
Коментар, який передав Merchant.
string / null
Ні
"PAYMENT_FOR_ORDER_123"
notificationUrl
URL Merchant для доставки callback.
string
Так у callback за чинним описом; для sync response потребує підтвердження, оскільки є transport field.
"https://merchant.example.com/fiscalization/callback"
fiscalizationDateTime
Час фіскалізації на стороні Alliance Kasa/ДПС.
datetime з timezone / null
Так для SUCCESS і RECEIPT; інакше null.
"2026-09-03T10:39:10.000+03:00"
fiscalizationModificationDateTime
Час останньої зміни фіскальних даних на стороні Alliance Kasa.
datetime з timezone / null
Ні; передається, якщо Kasa повернула modificationDataTime.
"2026-09-03T10:39:10.602+03:00"
creationDateTime
Час створення запису фіскалізації в Ecom.
datetime з timezone
Так
"2026-09-03T10:39:09.540+03:00"
modificationDateTime
Час останньої зміни локального запису фіскалізації в Ecom.
datetime з timezone
Так
"2026-09-03T10:39:10.602+03:00"
errorCode
Код помилки Ecom або Alliance Kasa.
string / null
Так для FAIL, якщо error code доступний; інакше null.
"541"
errorDescription
Безпечний для Merchant опис помилки.
string / null
Так для FAIL, якщо опис доступний; інакше null.
"Помилка під час підписання"
products
Незмінний список товарів/послуг первинного запиту Merchant.
array<object>
Так для повної єдиної DTO.
[]
products[].id
ID товару в системі Merchant.
string
Так
"yuiofaa2-7428-4053-8156-de4de571ac0e"
products[].name
Назва товару/послуги.
string
Так
"Товар 1"
products[].count
Кількість товару.
number
Так
2.000
products[].measurementCode
Код одиниці виміру.
string
Так
"0001"
products[].unitPrice
Ціна за одиницю у копійках — у форматі Merchant API.
integer
Так
12000
products[].taxCode
Код податкової групи.
integer / null
Умовно
2
products[].classificationCode
УКТЗЕД.
string / null
Умовно
"2203000000"
products[].exciseLabels
Акцизні марки.
array<string>
Умовно
["AATE123456"]
Потребує звірки зі схемою API: У таблиці
products[].taxCodeмає типinteger, а в наведеному прикладі передається як рядок ("1","2").
Приклад Callback
Останнє оновлення