Фискализация
Процесс фискализации состоит из нескольких этапов
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. Опрос фискальных данных покупки
- Вам необходимо создать покупку. При создании покупки нужно передать дополнительный атрибут
productsпараметраreservation_data. Ознакомьтесь с описанием этого параметра. - Payme утверждает платежи через платежную организацию и отправляет ответ на
server_callback_urlиresponse_url - После успешного завершения платежа Payme отправляет атрибут
productsпараметраreservation_dataвместе с другими платежными данными на государственный фискальный сервер. - Государственные органы осуществляют фискальный контроль над платежами и предоставляют URL-адрес квитанции с подробными данными.
- Вам следует собрать финансовые данные с помощью запроса
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"
}
}