Tarkibga o'tish

Parametrlarni qaytarish

So'rov parametrlari

Parametrlar                        Tur Majburiy Tavsif
version string(10) ixtiyoriy Protokol versiyasi.
Bo'sh qiymat: 1.0.1
1.0 versiyasi eskirgan
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
amount butun son(12) majburiy Ajratuvchi bo'lmagan buyurtma summasi
currency string(3) majburiy Buyurtma valyutasi. Qo'llab-quvvatlanadigan qiymatlar:
EUR — yevro
USD — AQSh dollari
GBP — funt sterling
CZK — chex koruna
GEL — gruzin larisi
UZS — o'zbek som
Qo'llab-quvvatlanadigan valyutalar to'liq ro'yxati
email string(254) ixtiyoriy Bekor qilishni boshlagan savdogarning xodimining elektron pochta manzili
comment string(1024) ixtiyoriy Savdogarning bekor qilish sababi bo'yicha izohi UTF-8
reverse_id string(50) ixtiyoriy Xavfsiz pulni qaytarish bo'yicha qayta urinishlar uchun qayta ishlatilmaydigan bekor qilish kaliti. Sotuvchi har bir urinish uchun order_id asosida noyob qiymat yaratishi kerak.
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.
Parametrlar                        Tur Tavsif
order_id string(1024) Savdochi tomonidan yaratilgan buyurtma identifikatori.
merchant_id butun son(12) Yagona savdogar identifikatori. Savdogar ro'yxatdan o'tkazilganda Payme tomonidan yaratilgan.
currency string(3) Buyurtma valyutasi. Qo'llab-quvvatlanadigan qiymatlar: Valyutalar manziliga qarang.
reverse_status string(50) Buyurtma qayta ishlash holati. Quyidagi qiymatlarni o'z ichiga olishi mumkin:
created — buyurtma yaratildi, ammo mijoz hali to'lov ma'lumotlarini kiritmagan; sotuvchi buyurtma holatini tekshirishni davom ettirishi kerak
processing — buyurtma hali ham to'lov darvozasi tomonidan qayta ishlanmoqda; savdogar buyurtma holatini tekshirishni davom ettirishi kerak
declined — buyurtma Payme to'lov darvozasi, bank yoki tashqi to'lov tizimi tomonidan rad etilgan
approved — buyurtma muvaffaqiyatli yakunlandi; to'lovchining hisobida mablag' ajratilgan va tez orada savdogarga o'tkaziladi; savdogar xizmat ko'rsatishi yoki tovarni jo'natishi mumkin
expired — buyurtmaning amal qilish muddati lifetime tugadi.
reversed — ilgari tasdiqlangan tranzaksiya to'liq bekor qilindi. Bu holda reversal_amount parametri actual_amount ga teng bo'ladi.
response_status string(50) So'rovni qayta ishlash holati. Agar savdogar tomonidan yuborilgan parametrlar tasdiqdan o'tmasa, holat 'failure' bo'ladi; aks holda 'success' bo'ladi.
reverse_id string(50) ixtiyoriy
transaction_id string(50) ixtiyoriy
signature string(40) Buyurtma imzosi. Savdogarning so'rovi haqiqiyligini va asl ekanligini tasdiqlash uchun zarur. Imzo yaratish algoritmi uchun So'rovlar va javoblar uchun imzo yaratish va javobga qarang.
response_code butun son(4) Buyurtmani rad etish uchun javob kodi. Mumkin bo'lgan kodlar uchun 'Javob kodlari' bo'limiga qarang.
response_description string(1024) Javob kodlari tavsifi uchun Javob kodlari bo'limiga qarang.
comment string(1024) Savdogarning bekor qilish sababi bo'yicha izohi UTF-8

Misollar

{
  "request": {
    "order_id": "test_12343242111",
    "currency": "UZS",
    "amount": "1",
    "signature": "29a569275265925c2ec356d3adada1929fd8bb8c",
    "merchant_id": "4056281"
  }
}
{
    "response": {
        "reverse_status": "approved",
        "order_id": "test_12343242111",
        "response_description": "",
        "response_code": "",
        "merchant_id": 4056281,
        "response_status": "success",
        "signature": "3656398d3e2aaf83138223cf97ce497871495904",
        "reverse_id": "",
        "reversal_amount": "16",
        "transaction_id": "2011080263"
    }
}
{
    "response": {
        "error_code": 1007,
        "error_message": "Parameter `signature` is incorrect",
        "request_id": "e96rGwTzLjFmR",
        "response_status": "failure"
    }
}