RozetkaPay

Фіскалізація продажів (ПРРО)

Автоматична фіскалізація онлайн-продажів через RozetkaPay API

RozetkaPay підтримує автоматичну фіскалізацію онлайн-продажів (ПРРО) для:

Податкові групи (tax_group)

КодОпис
1ПДВ 20%
2Без ПДВ
3ПДВ 20% + акциз 5%
4ПДВ 7%
5ПДВ 0%
6Без ПДВ + акциз 5%
7Не є об’єктом ПДВ
8ПДВ 20% + ПФ 7.5%
9ПДВ 14%

Фіскалізація інтернет-еквайрингу

Передавайте products[] у запиті Create payment.

Параметри товару

ПараметрОбов’язковийТипОпис
nameТакstringНазва товару
quantityТакstringКількість одиниць
net_amountТакstringВартість без ПДВ
vat_amountТакstringЦіна з ПДВ
tax_groupТакintegerПодаткова група (див. таблицю вище)
currencyНіstringВалюта
categoryНіstringКатегорія
descriptionНіstringОпис
imageНіstringURL зображення
idНіstringID товару
urlНіstringПосилання на товар

Приклад

curl -X POST https://api.rozetkapay.com/api/payments/v1/new \
  -u "login:password" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "order_12345",
    "mode": "direct",
    "amount": 100,
    "currency": "UAH",
    "callback_url": "https://your-site.com/callback",
    "customer": {
      "external_id": "user_123",
      "phone": "380501234567",
      "payment_method": {
        "type": "cc_token",
        "cc_token": { "token": "tok_abc", "use_3ds_flow": true }
      }
    },
    "products": [
      {
        "id": "fff1bb85-383e-4e20-8238-b32a7c69db5d",
        "name": "Product item 1",
        "description": "Your partner",
        "category": "dogs",
        "quantity": "1",
        "currency": "UAH",
        "net_amount": "50",
        "vat_amount": "0",
        "tax_group": 4
      },
      {
        "id": "5e0343a3-9994-4a7f-93e0-5cc1ddfe3b3c",
        "name": "Product item 2",
        "quantity": "1",
        "currency": "UAH",
        "net_amount": "50",
        "vat_amount": "0",
        "tax_group": 4
      }
    ]
  }'

Фіскалізація при оплаті частинами

Для «Оплатити частинами» діє інший набір полів у products[].

Параметри товару

ПараметрОбов’язковийТипОпис
external_idНіstringID товару
nameТакstringНазва
quantityТакintegerКількість
priceТакnumberВартість товару
tax_groupНіintegerПодаткова група
category_nameНіstringКатегорія

Приклад

curl -X POST https://api.rozetkapay.com/api/payparts/v1/order/create \
  -u "login:password" \
  -H "Content-Type: application/json" \
  -d '{
    "auto_confirm_after_success": false,
    "bank_name": "abank",
    "mode": "direct",
    "external_id": "order_12345",
    "amount": 500,
    "currency": "UAH",
    "parts_count": 4,
    "description": "Замовлення",
    "products": [
      {
        "external_id": "91562a47-732a-4963-9935-f6bd1cf5e531",
        "name": "Повербанк",
        "quantity": 1,
        "price": 300,
        "tax_group": 4
      },
      {
        "external_id": "1314b476-5807-433e-9d48-3094eafd5142",
        "name": "LG Телефон",
        "quantity": 1,
        "price": 200,
        "tax_group": 4
      }
    ],
    "customer": { "first_name": "I", "last_name": "I", "phone": "+380501234567" }
  }'

Блок fiscalization у відповіді

Після успішної фіскалізації відповідь розширюється полем fiscalization:

ПараметрТипОпис
fiscal_idstringФіскальний номер
fiscal_urlstringПосилання на фіскальний чек
statusstringPending, Success або Failed
status_codeintegerСтатус-код фіскалізації
status_descriptionstringОпис статусу
{
  "is_success": true,
  "details": { "status": "success", "amount": "100", "currency": "UAH" },
  "fiscalization": {
    "fiscal_id": "0000000001",
    "fiscal_url": "https://cabinet.tax.gov.ua/cabinet/faces/public/...",
    "status": "Success",
    "status_code": 1001,
    "status_description": "Fiscalization successful."
  }
}