Tarkibga o'tish

Xaridni qabul qiling

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
order_desc string(1024) majburiy Buyurtma tavsifi. Har doim savdogar tomonidan UTF-8 kodlashda yaratilgan
amount butun son(12) majburiy Ajratuvchi bo'lmagan buyurtma summasi
currency string(3) majburiy Buyurtma valyutasi. Qo'llab-quvvatlanadigan qiymatlar:
AMD — Armaniston drammasi
AZN — Ozarbayjon manati
KZT — tenge
MDL — Moldova leyi
GEL — Gruziya larisi
UZS — O'zbek summasi
Qo'llab-quvvatlanadigan valyutalarning to'liq ro'yxati
response_url string(2048) ixtiyoriy To'lovni yakunlaganidan so'ng mijoz yo'naltiriladigan savdogarning veb-sayt URL manzili
server_callback_url string(2048) ixtiyoriy To'lov yakunlangach host-to-host callback yuboriladigan savdogarning veb-sayt URL manzili. Callbacklar haqida batafsil ma'lumot uchun qarang: Callbacklar.
signature string(40) majburiy Buyurtma imzosi. Sotuvchining so'rovi izchilligini va haqiqiyligini tasdiqlash uchun zarur. Imzo yaratish algoritmi haqida ma'lumot uchun So'rovlar va javoblar uchun imzo yaratish manziliga murojaat qiling.
lifetime butun son(9) ixtiyoriy Buyurtmaning amal qilish muddati soniyalarda. Ushbu muddat tugagach, agar mijoz buyurtma uchun to'lov qilmasa, buyurtma holati 'muddatidan o'tgan' ga o'zgaradi
. Standart qiymat: 36000
. Ruxsat etilgan maksimal qiymat: 69120000
merchant_data string(2048) ixtiyoriy response_url va/yoki server_callback_url manzillariga yuborilgan so'rovlarga javoban, shuningdek hisobotlarda sotuvchi olishni istagan istalgan ma'lumotlar to'plami
preauth string(1) ixtiyoriy
N — mablag' mijozning kartasidan darhol yechib olinadi va to'lovlarni hisob-kitob qilish qoidalariga muvofiq savdogarning hisobiga o'tkaziladi.
Y
— mablag' mijozning karta hisobida ushlab turiladi va savdogar tasdiqlash uchun capture so'rovini yubormaguncha yechilmaydi.
Standart qiymat: N
sender_email string(256) ixtiyoriy Mijoz elektron pochtasi
delayed string(1) ixtiyoriy Keyinga qoldirilgan buyurtma bayrog'i.
Y — mijozga savdogar tomonidan lifetime parametrida ko'rsatilgan muddat ichida buyurtma uchun to'lov qilish imkonini beradi. Savdogar bitta buyurtma doirasida hostlar o'rtasida bir nechta aylanishlar va brauzer yo'naltirishlarini kutishi kerak. Agar oldingi urinish muvaffaqiyatsiz tugasa, mijoz bir xil order_id bo'yicha to'lovni qayta urinish imkoniyatiga ega bo'ladi
N — to'lov muvaffaqiyatsiz bo'lgandan so'ng order_id mijoz buyurtmani qayta yaratish uchun sotuvchining saytiga yo'naltiriladi. Bu holda faqat bitta callback yuboriladiserver_callback_url
Standart qiymat: Y
lang string(2) ixtiyoriy To'lov sahifasi tili. Qo'llab-quvvatlanadigan qiymatlar:
az – Ozarbayjon
da – Daniya
nl – Gollandiya
fi – Finlyandiya
ka – Gruziya
ko – Koreya
ru – Rossiya
zh – Xitoy
uk – Ukraina
en – Ingliz
lv – Latvian
fr – French
cs – Czech
ro – Romanian
it – Italian
sk – Slovak
pl – Polish
es – Spanish
hu – Hungarian
de – German
product_id string(1024) ixtiyoriy Savdogar mahsuloti yoki xizmati identifikatori
required_rectoken string(1) ixtiyoriy Javobda karta tokeni qaytarilishini ko'rsatadigan bayroq. Qarang: Takroriy to'lov
Standart qiymat: N
verification string(1) ixtiyoriy Agar Y yuborilsa, buyurtma muvaffaqiyatli tasdiqlangach avtomatik bekor qilinadi
O'rnatilgan qiymat: N
rectoken string(40) ixtiyoriy Takroriy tranzaksiyalar uchun karta tokeni.
receiver_rectoken string(40) ixtiyoriy To'lov tranzaksiyalari uchun karta tokeni.
design_id string(6) ixtiyoriy Savdo portali sozlamalarida belgilangan buyurtma formasining dizayn IDsi
subscription string(1) ixtiyoriy Y – rejalashtirilgan to'lovlarni yoqish
N – rejalashtirilgan to'lovlarni standart bo'yicha o'chirish
subscription_callback_url string(2048) ixtiyoriy Rejalashtirilgan to'lov yakunlangach host-to-host callback yuboriladigan savdogarning veb-sayt URL manzili
chargeback_callback_url string(2048) ixtiyoriy To'lovni qaytarish bo'yicha chaqiruvlar uchun URL
cancel_url string(2048) ixtiyoriy Mijoz to'lov sahifasida 'Bekor qilish' tugmasini bosganda yo'naltiriladigan URL
reservation_data string(10000) ixtiyoriy JSON ma'lumotlari BASE64 kodlashda; batafsil ma'lumot uchun Qo'shimcha ma'lumotlar ni 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.
amount butun son(12) Summani ajratuvchi bo'lmagan holda sentlarda ko'rsating
currency string(3) Buyurtma valyutasi. Qo'llab-quvvatlanadigan qiymatlar: Valyutalar manziliga qarang.
order_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 yaqin 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.
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.
tran_type string(50) Qo'llab-quvvatlanadigan qiymatlar:
purchase
verification
p2p credit
p2p transfer
settlement — bo'linadigan to'lovlar
reverse
sender_cell_phone string(16) Mijozning mobil telefon raqami
sender_account string(16) Mijozning to'lov hisobvarog'i
masked_card string(19) Yashirilgan karta raqami
card_bin butun son(6) Karta raqami — odatda birinchi 6 raqam 444444r
card_type string(50) Qo'llab-quvvatlanadigan qiymatlar:
, VISA, MasterCard, Humo, UzCard
rrn string(50) Odatda bank tomonidan qaytarilgan noyob bo'lmagan tranzaksiya identifikatori.
approval_code string(6) Odatda bank tomonidan qaytarilgan noyob bo'lmagan avtorizatsiya kodi.
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.
reversal_amount butun son(12) Joriy buyurtma bo'yicha barcha bekor qilishlarning umumiy summasi
settlement_amount butun son(12) Joriy buyurtma uchun umumiy summa
settlement_currency string(3) Buyurtma to'lov valyutasi
order_time string(19) Buyurtma yaratish dateDD.MM.YYYY hh:mm:ss
settlement_date string(10) Hisob-kitob sanasi DD.MM.YYYY formatida
eci butun son(2) E-tijorat indikatori — bu parametr 3DSecure autentifikatsiyasi yakunlanganligini ko'rsatadi. Qo'llab-quvvatlanadigan qiymatlar:
5 — to'liq 3DSecure autentifikatsiyasi yakunlandi
6 — savdogar 3DSecure-ni qo'llab-quvvatlaydi, lekin chiqaruvchi bank qo'llab-quvvatlamaydi
7 — na savdogar, na chiqaruvchi bank 3DSecure-ni qo'llab-quvvatlamaydi
fee butun son(12) Payme tomonidan olinadigan komissiya
payment_system string(50) Transaksiya uchun ishlatiladigan to'lov tizimi. Qo'llab-quvvatlanadigan to'lov tizimlari ro'yxati uchun Qo'llab-quvvatlanadigan to'lov tizimlari manziliga qarang.
sender_email string(254) Mijoz elektron pochtasi
payment_id butun son(19) Payme to'lov darvozasi tomonidan yaratilgan noyob to'lov identifikatori
actual_amount butun son(12) Kartadan aslida yechib olingan yoki debet qilingan summa.
actual_currency string(3) Kartadan ruxsat etilgan haqiqiy valyuta
product_id string(1024) Savdogar mahsuloti yoki xizmati identifikatori
merchant_data string(2048) Savdogar so'rovda yuboradigan istalgan ma'lumotlar to'plami
verification_status string(50) Kodni tekshirish natijasi.
Qabul qilinadigan qiymatlar:
verified — kod yordamida karta muvaffaqiyatli tasdiqlandi
incorrect — noto'g'ri kod kiritildi, lekin limit hali to'ldirilmagan
failed — noto'g'ri kod kiritish bo'yicha maksimal urinishlar soni oshdi
created — tekshirish kodi yaratildi, lekin hali kiritilmagan
rectoken string(40) Payme karta tokenini qaytarishi kerakligini ko'rsatadigan bayroq — bu karta egasi bilan o'zaro aloqaga kirmay turib kartadagi mablag'larga kirish uchun token
rectoken_lifetime string(19) Tokenning amal qilish muddati DD.MM.YYYY hh:mm:ss formatida
additional_info string(20480) JSON formatidagi qo'shimcha maydon
{
"bank_name": "AQShdagi ba'zi bank",
"bank_country": "US",
"bank_response_code": "decln_1000",
"card_product": "DEBIT",
"card_category": "CLASSIC",
"settlement_fee": 0.2,
"capture_status": "captured",
"client_fee": 0.3,
"ipaddress_v4": "8.8.8.8",
"capture_amount": 200,
"card_type": "VISA",
"reservation_data": null,
"bank_response_description": "General decline",
"transaction_id": 1058755083,
"timeend":"10.01.2018 11:21:30",
"payment_method": "apple" yoki "googlepay" yoki "card",
"schemeid":"M11111111111111",
"masked_iban":"GE40XB**8712"
}

Misollar

{
  "request": {
    "version": "1.0.1",
    "order_id": "TestOrder2",
    "merchant_id": 4056281,
    "order_desc": "Test payment",
    "amount": 1000,
    "currency": "UZS",
    "response_url": "http://myshop/thank_you_page",
    "server_callback_url": "http://myshop/callback/",
    "signature": "91ea7da493a8367410fe3d7f877fb5e0ed666490"
  }
}
{
  "response": {
    "rrn": "111111111111",
    "masked_card": "444455XXXXXX1111",
    "sender_cell_phone": "",
    "sender_account": "",
    "currency": "UZS",
    "fee": "",
    "reversal_amount": "0",
    "settlement_amount": "0",
    "actual_amount": "200",
    "response_description": "",
    "sender_email": "test@test.com",
    "order_status": "approved",
    "response_status": "success",
    "order_time": "13.07.2024 01:23:59",
    "actual_currency": "UZS",
    "order_id": "test33694502191",
    "tran_type": "purchase",
    "eci": "5",
    "settlement_date": "",
    "payment_system": "card",
    "approval_code": "123456",
    "merchant_id": 4056281,
    "settlement_currency": "",
    "payment_id": 805243692,
    "card_bin": 444455,
    "response_code": "",
    "card_type": "VISA",
    "amount": "200",
    "signature": "b7884b5c4906956fbac4d20390388d913a78c0b0",
    "product_id": "",
    "merchant_data": "Test merchant data",
    "rectoken": "",
    "rectoken_lifetime": "",
    "verification_status": "",
    "parent_order_id": "",
    "fee_oplata": "0",
    "additional_info": "{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": \"{}\", \"transaction_id\": 1994930931, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"13.07.2024 01:24:08\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"version_3ds\": 1, \"is_test\": true}",
    "response_signature_string": "**********|200|UZS|{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": \"{}\", \"transaction_id\": 1994930931, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"13.07.2024 01:24:08\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"version_3ds\": 1, \"is_**********\": true}|200|123456|444455|VISA|UZS|5|0|444455XXXXXX1111|Test merchant data|4056281|**********33694502191|approved|13.07.2024 01:23:59|805243692|card|success|0|111111111111|**********@**********.com|0|purchase"
  }
}
{
    "response": {
        "error_code": 1011,
        "error_message": "Parameter `amount` is missing",
        "request_id": "5htKi0wf7zEHn",
        "response_status": "failure"
    }
}