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

Фискализация

Процесс фискализации состоит из нескольких этапов

sequenceDiagram
  participant Merchant as Мерчант
  participant Payme API as Payme API
  participant FiscalServer as Государственный фискальный сервер
  Merchant->>PaymeAPI: 1. Создание покупки с параметром reservation_data.products
  PaymeAPI->>Merchant: 2. Покупка подтверждена  
  loop Фискализация
    PaymeAPI->>FiscalServer: 3. Отправка платежных данных на государственный фискальный сервер
    FiscalServer->>PaymeAPI: 4. Успешная фискализация
  end
  Merchant->>PaymeAPI: 5. Опрос фискальных данных покупки     
  1. Вам необходимо создать покупку. При создании покупки нужно передать дополнительный атрибут products параметра reservation_data. Ознакомьтесь с описанием этого параметра.
  2. Payme утверждает платежи через платежную организацию и отправляет ответ на server_callback_url и response_url
  3. После успешного завершения платежа Payme отправляет атрибут products параметра reservation_data вместе с другими платежными данными на государственный фискальный сервер.
  4. Государственные органы осуществляют фискальный контроль над платежами и предоставляют URL-адрес квитанции с подробными данными.
  5. Вам следует собрать финансовые данные с помощью запроса POST https://pay.payme.uz/api/fiscal_data, описанного ниже

Создание заказа

Создайте заказ с помощью Redirect, Direct или любого другого типа интеграции. Передайте параметр BASE64 reservation_data, чтобы заказ мог быть фискализирован.

Обратите внимание

Фискализация доступна только для покупок без предварительной авторизации (параметр preauth = N или пустой).

Пример

    curl -L 'https://pay.payme.uz/api/checkout/3dsecure_step1' \
    -H 'Content-Type: application/json' \
    -d '{
          "request": {
            "merchant_id": 4056281,
            "order_desc": "test order",
            "amount": "200000",
            "currency": "UZS",
            "card_number": "860049XXXXXX6478",
            "expiry_date": "0399",
            "cvv2": "***",
            "preauth": "N",
            "reservation_data": "ewogICJwcm9kdWN0cyI6IFsKICAgIHsKICAgICAgImlkIjogMSwKICAgICAgIm5hbWUiOiAiUHJvZHVjdCBBIiwKICAgICAgInByaWNlIjogMTAwLjAwLAogICAgICAicXVhbnRpdHkiOiAyLAogICAgICAidmF0X3BlcmNlbnQiOiAyMCwKICAgICAgImNvZGUiOiAiMDA3MDIwMDEwMDEwMDAwMDEiLAogICAgICAidW5pdHMiOiAxLAogICAgICAiZGlzY291bnQiOiAxMC4wMCwKICAgICAgInBhY2thZ2VfY29kZSI6ICI1Njc4IiwKICAgICAgInRvdGFsX2Ftb3VudCI6IDE5MC4wMAogICAgfSwKICAgIHsKICAgICAgImlkIjogMSwKICAgICAgIm5hbWUiOiAiUHJvZHVjdCBCIiwKICAgICAgInByaWNlIjogMTAwLjAwLAogICAgICAicXVhbnRpdHkiOiAyLAogICAgICAidmF0X3BlcmNlbnQiOiAyMCwKICAgICAgImNvZGUiOiAiMDA3MDIwMDEwMDEwMDAwMDEiLAogICAgICAidW5pdHMiOiAxLAogICAgICAiZGlzY291bnQiOiAxMC4wMCwKICAgICAgInBhY2thZ2VfY29kZSI6ICI1Njc5IiwKICAgICAgInRvdGFsX2Ftb3VudCI6IDE5MC4wMAogICAgfQogIF0KfQ==",
            "order_id": "testpg16968413",
            "signature": "0d75c7ea9c0f2d6ada857fe5c462d0c232513f34"
          }
        }'
    curl -L 'https://pay.payme.uz/api/checkout/url' \
    -H 'Content-Type: application/json' \
    -d '{
          "request": {
            "merchant_id": 4056281,
            "order_desc": "test order",
            "amount": "200000",
            "currency": "UZS",
            "preauth": "N",
            "reservation_data": "ewogICJwcm9kdWN0cyI6IFsKICAgIHsKICAgICAgImlkIjogMSwKICAgICAgIm5hbWUiOiAiUHJvZHVjdCBBIiwKICAgICAgInByaWNlIjogMTAwLjAwLAogICAgICAicXVhbnRpdHkiOiAyLAogICAgICAidmF0X3BlcmNlbnQiOiAyMCwKICAgICAgImNvZGUiOiAiMDA3MDIwMDEwMDEwMDAwMDEiLAogICAgICAidW5pdHMiOiAxLAogICAgICAiZGlzY291bnQiOiAxMC4wMCwKICAgICAgInBhY2thZ2VfY29kZSI6ICI1Njc4IiwKICAgICAgInRvdGFsX2Ftb3VudCI6IDE5MC4wMAogICAgfSwKICAgIHsKICAgICAgImlkIjogMSwKICAgICAgIm5hbWUiOiAiUHJvZHVjdCBCIiwKICAgICAgInByaWNlIjogMTAwLjAwLAogICAgICAicXVhbnRpdHkiOiAyLAogICAgICAidmF0X3BlcmNlbnQiOiAyMCwKICAgICAgImNvZGUiOiAiMDA3MDIwMDEwMDEwMDAwMDEiLAogICAgICAidW5pdHMiOiAxLAogICAgICAiZGlzY291bnQiOiAxMC4wMCwKICAgICAgInBhY2thZ2VfY29kZSI6ICI1Njc5IiwKICAgICAgInRvdGFsX2Ftb3VudCI6IDE5MC4wMAogICAgfQogIF0KfQ==",
            "order_id": "testpg16968413",
            "signature": "1fdb9eb25a985960a86585aa856218dca90e86f9"
          }
        }'
    curl -L 'https://pay.payme.uz/api/recurring' \
    -H 'Content-Type: application/json' \
    -d '{
          "request": {
            "merchant_id": 4056281,
            "order_desc": "test order",
            "amount": "200000",
            "currency": "UZS",
            "preauth": "N",
            "rectoken": "6aDyYLI2n7aq6ZHBBIiwwglz97emriquch",
            "reservation_data": "ewogICJwcm9kdWN0cyI6IFsKICAgIHsKICAgICAgImlkIjogMSwKICAgICAgIm5hbWUiOiAiUHJvZHVjdCBBIiwKICAgICAgInByaWNlIjogMTAwLjAwLAogICAgICAicXVhbnRpdHkiOiAyLAogICAgICAidmF0X3BlcmNlbnQiOiAyMCwKICAgICAgImNvZGUiOiAiMDA3MDIwMDEwMDEwMDAwMDEiLAogICAgICAidW5pdHMiOiAxLAogICAgICAiZGlzY291bnQiOiAxMC4wMCwKICAgICAgInBhY2thZ2VfY29kZSI6ICI1Njc4IiwKICAgICAgInRvdGFsX2Ftb3VudCI6IDE5MC4wMAogICAgfSwKICAgIHsKICAgICAgImlkIjogMSwKICAgICAgIm5hbWUiOiAiUHJvZHVjdCBCIiwKICAgICAgInByaWNlIjogMTAwLjAwLAogICAgICAicXVhbnRpdHkiOiAyLAogICAgICAidmF0X3BlcmNlbnQiOiAyMCwKICAgICAgImNvZGUiOiAiMDA3MDIwMDEwMDEwMDAwMDEiLAogICAgICAidW5pdHMiOiAxLAogICAgICAiZGlzY291bnQiOiAxMC4wMCwKICAgICAgInBhY2thZ2VfY29kZSI6ICI1Njc5IiwKICAgICAgInRvdGFsX2Ftb3VudCI6IDE5MC4wMAogICAgfQogIF0KfQ==",
            "order_id": "testpg16968413",
            "signature": "1fdb9eb25a985960a86585aa856218dca90e86f9"
          }
        }'

Получение фискальных данных

Для получения фискальных данных заказ должен быть либо captured, либо одобрен без параметра preauth = Y.

Параметры

Параметры запроса

POST https://pay.payme.uz/api/fiscal_data

Название параметра Тип Описание Пример
order_id string(1024) обязательный Идентификатор заказа, сгенерированный мерчантом
merchant_id integer(12) обязательный Уникальный идентификатор мерчанта. Генерируется Paymeпри регистрации мерчанта
signature string(40) обязательный Подпись заказа. Требуется для проверки согласованности и подлинности запроса мерчанта. Алгоритм генерации подписи см. на Генерация подписи для запроса и ответа и response

Request eamples

curl -L 'https://pay.payme.uz/api/fiscal_data' \
-H 'Content-Type: application/json' \
-d '{
  "request": {
    "merchant_id": 4056281,
    "order_id": "6120b190-2a39-4fde-acae-a9761e7e58bd",
    "signature": "b8f84562d3e2a971aea7d173c6fb59084f414d23"
  }
}'

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

{
    "response": {
        "error": "Merchant account not found",
        "response_status": "success"
    }
}
{
    "response": {
        "order_id": "6120b190-2a39-4fde-acae-a9761e7e58bd",
        "fiscalisation_data": {
            "2079125283": {
                "message": {
                    "ru": "Фискальные данные не найдены.",
                    "uz": "Fiskal ma`lumotlar topilmadi.",
                    "en": "Fiscal data not found."
                },
                "code": -31603
            }
        },
        "response_status": "success"
    }
}
{
    "response": {
        "order_id": "pgtest000-1_02",
        "fiscalisation_data": {
            "9002999267": {
                "status_code": 0,
                "message": "",
                "terminal_id": "EZ000000000658",
                "date": "",
                "fiscal_sign": "",
                "qr_code_url": "https://ofd.soliq.uz/epi?t=XXX&r=XXX&c=XXX&s=XXX",
                "type": 0,
                "receipt_id": 3340,
                "external": true,
                "processed_date": 1736320610322
            }
        },
        "response_status": "success"
    }
}