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 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'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 – 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.

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"
    }
}