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 yaratilgan |
order_desc |
string(1024) | majburiy | Buyurtma tavsifi. Har doim savdogar tomonidan UTF-8 kodlashda yaratilgan |
amount |
butun son(12) | majburiy | Ajratuvchi bo'lmagan holda buyurtma miqdori. 100020 (UZS) 1000 so'm va 20 tiyinlar demakdir. |
currency |
string(3) | majburiy | Buyurtma valyutasi. Qo'llab-quvvatlanadigan qiymatlar: EUR — yevro USD — AQSh dollari GBP — funt sterling (majburiy) CZK — chex koruna GEL — gruzin larisi UZS — o'zbek som Qo'llab-quvvatlanadigan valyutalar to'liq ro'yxati |
card_number |
string(19) | ixtiyoriy | To'lovchining karta raqami |
cvv2 |
string(4) | ixtiyoriy | Karta CVV2/CVC2 kodi |
expiry_date |
string(4) | ixtiyoriy | Karta amal qilish muddati YYMMDD formatida |
client_ip |
string(4) | ixtiyoriy | Mijoz IP |
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 Callbacklar manziliga murojaat qiling. |
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. |
lifetime |
butun son(9) | ixtiyoriy | Buyurtmaning amal qilish muddati soniyalarda. Ushbu muddat tugagach, agar mijoz to'lovni amalga oshirmagan bo'lsa, 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 savdogar 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 sotuvchining hisobiga o'tkaziladi. Y — mablag' mijozning karta hisobida ushlab turiladi va sotuvchi tasdiqlash uchun capture so'rovini yubormaguncha yechilmaydi. Standart qiymat: N |
sender_email |
string(256) | ixtiyoriy | Mijozning elektron pochta manzili |
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 uchun 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 – Rusiya 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'zgarmas qiymat: N |
rectoken |
string(40) | ixtiyoriy | Takroriy tranzaksiyalar uchun karta tokeni. |
cavv |
string(2048) | ixtiyoriy | 3D Secure karta autentifikatsiya natijasi CAVV qiymati |
eci |
string(2048) | ixtiyoriy | 3D Secure karta autentifikatsiya natijasi ECI qiymati |
wallet |
string(2048) | ixtiyoriy | Hamyon turi: applepay yoki googlepay |
schemeid |
string(2048) | ixtiyoriy | CIT identifikatori — mijoz tomonidan tashabbus qilingan tranzaksiya, dastlabki xaridda 'additional_info->schemeid' maydonida qaytariladi; javob parametrlarini javob parametrlari manzilida ko'ring. |
Qarang Javob parametrlari
Misollar
Misol so'rov:
{
"request": {
"order_id": "test_12343242",
"merchant_id": "4056281",
"order_desc": "Test order",
"amount": 1000,
"currency": "UZS",
"card_number": "4444555566661111",
"cvv2": "111",
"expiry_date": "1125",
"client_ip": "8.8.8.8",
"server_callback_url": "https://myserver.com/callback",
"signature": "0c0c2374c73267e7be560d80834e4ba28ccda7aa"
}
}
Standart yakuniy javob: Qarang Sinov kartalari ro'yxati
{
"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"
}
}
Agar 3DSecure talab qilinsa, standart javob: Qarang 3D Secure test kartalari ro'yxati
{
"response": {
"response_status": "success",
"acs_url": "https://pay.payme.uz/test/testacs/",
"pareq": "eJxtU21vgjAQ/u6vIP4A+gJRNKVJHUvUiRpwS/aRYYNsgljA6b8fLTpFuISE5+5pe/fcHdnsBOeOz8NScNrTKiMuz/Mg4lq8tfuDyqxRv46o6Jp5/HjHynfiIo8PKUU61DEBN9gkuVyEuyAtmm4VCsLjZLakpjUyDUTAFbZ5CRczhxpDDCsjoIZtWhoknC7Y5mM2Z762Zv6GaRO2fGMEqFD7RHgo00JcqIktAm6gTSvFnu6KIsvHQD6uysn1ffal708EyGizZNBdM1mX0p13ZXKOt9R12O/Th5ffn3jl/NgESEb73DYoOMUQmdDCloaGY4jGaECA8nconsgiKdYh1F7fvUrz2tFmZjJXdqVL1R8dHUqWQvA0vNDRUEp5Q20iP2eHlMtLCfj/f5KvWyfyMu2cobCopsFNVsZ8yhdHL1rNkedH0Ev8yLblVClCZyZx1W4DozqV+Ln3BDy+WKV1XwHZYrUttEdAY5f+AHcC0ak=",
"md": "2001876637"
}
}
Xato bo'lgan taqdirda javob:
{
"response": {
"error_code": 1011,
"error_message": "Parameter `amount` is missing",
"request_id": "5htKi0wf7zEHn",
"response_status": "failure"
}
}