Tarkibga o'tish

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     
  1. Siz xarid yaratishingiz kerak. Xarid yaratayotganda, reservation_data parametriga qo'shimcha products atributini uzatishingiz shart. Ushbu parametr bo'yicha batafsil ma'lumot uchun ta'rif havolasiga murojaat qiling.
  2. Payme to'lov tashkiloti orqali to'lovlarni amalga oshirishga ruxsat beradi va server_callback_url hamda response_url manzillariga javob yuboradi.
  3. To'lov muvaffaqiyatli yakunlangach, Payme'reservation_data' parametrining 'products' atributini boshqa to'lov ma'lumotlari bilan birga davlat moliyaviy serveriga yuboradi.
  4. Hukumat organlari to'lovlar ustidan moliyaviy nazoratni amalga oshiradi va batafsil ma'lumotni o'z ichiga olgan kvitansiya uchun URL manzilini taqdim etadi.
  5. 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"
    }
}