Fiskallashtirish
Fiskallashtirish jarayoni bir nechta bosqichlardan iborat
sequenceDiagram
participant Merchant as Savdogar
participant PaymeAPI as Payme API
participant FiscalServer as Davlat fiskal serveri
Merchant->>PaymeAPI: 1. reservation_data.products parametri bilan xarid yaratish
PaymeAPI->>Merchant: 2. Xarid tasdiqlandi
loop Fiskallashtirish
PaymeAPI->>FiscalServer: 3. To'lov ma'lumotlarini davlat fiskal serveriga yuborish
FiscalServer->>PaymeAPI: 4. Fiskallashtirish muvaffaqiyatli yakunlandi
end
Merchant->>PaymeAPI: 5. Xaridning fiskal ma'lumotlarini so'rash
- Siz xarid yaratishingiz kerak. Xarid yaratayotganda,
reservation_dataparametriga qo'shimchaproductsatributini uzatishingiz shart. Ushbu parametr bo'yicha batafsil ma'lumot uchun ta'rif havolasiga murojaat qiling. - Payme to'lov tashkiloti orqali to'lovlarni amalga oshirishga ruxsat beradi va
server_callback_urlhamdaresponse_urlmanzillariga javob yuboradi. - To'lov muvaffaqiyatli yakunlangach, Payme'
reservation_data' parametrining 'products' atributini boshqa to'lov ma'lumotlari bilan birga davlat moliyaviy serveriga yuboradi. - Hukumat organlari to'lovlar ustidan moliyaviy nazoratni amalga oshiradi va batafsil ma'lumotni o'z ichiga olgan kvitansiya uchun URL manzilini taqdim etadi.
- Moliyaviy ma'lumotlarni quyida tavsiflab o'tilgan
POST https://pay.payme.uz/api/fiscal_data, so'rovi yordamida yig'ishingiz kerak.
Buyurtma yaratish¶
Yo'naltirish, To'g'ridan-to'g'ri yoki boshqa har qanday integratsiya turi yordamida buyurtma yarating.
BASE64 parametrini reservation_data deb o'tkazing, shunda buyurtma moliyaviy hisobga olinishi mumkin.
E'tibor bering
Fiskallashtirish faqat O'zbekistonda mavjud.
Fiskallashtirish faqat oldindan avtorizatsiyasiz xaridlar uchun mavjud (preauth = N parametri yoki bo'sh).
Xarid yaratish so'rovi misoli
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": "flittpg16968413",
"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": "flittpg16968414",
"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": "flittpg16968414",
"signature": "1fdb9eb25a985960a86585aa856218dca90e86f9"
}
}'
Moliyaviy ma'lumotlarni olish¶
Moliyaviy ma'lumotlarni olish uchun buyurtma 'qayd etilgan' bo'lishi yoki 'preauth = Y' parametri kiritilmagan holda tasdiqlanishi kerak.
Parametrlar¶
So'rov parametrlari
POST https://pay.payme.uz/api/fiscal_data
| Parametr nomi | Tur | Tavsif | Misol |
|---|---|---|---|
order_id |
string(1024) | majburiy | Savdochi tomonidan yaratilgan buyurtma identifikatori |
merchant_id |
butun son(12) | majburiy | Yagona savdogar identifikatori. Savdogar ro'yxatdan o'tkazilganda Payme tomonidan yaratiladi |
signature |
string(40) | majburiy | Buyurtma imzosi. Savdogarning so'rovi haqiqiyligini va asl ekanligini tasdiqlash uchun zarur. Imzo yaratish algoritmi uchun So'rovlar va javoblar uchun imzo yaratish va javobni ko'ring. |
So'rov misollari
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"
}
}'
Javob misoli
{
"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"
}
}