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'ladiN — 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_urlStandart 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 { |
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"
}
}