Saqlangan karta yordamida to'lovlarni 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 belgisiz 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 — Chexiya koruna GEL — Gruziya lari UZS — O'zbek sum Qo'llab-quvvatlanadigan valyutalar to'liq ro'yxati |
rectoken |
string(40) | majburiy | Takroriy tranzaksiyalar uchun karta tokeni. |
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. |
cvv2 |
string(4) | ixtiyoriy | Karta CVV2/CVC2 kodi |
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. |
lifetime |
butun son(9) | ixtiyoriy | Buyurtmaning amal qilish muddati soniyalarda. Ushbu muddat tugagach, agar mijoz buyurtma uchun to'lov qilmasa, buyurtma holati 'muddatdan 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 | Mijozning elektron pochta manzili |
product_id |
string(1024) | ixtiyoriy | Savdogar mahsuloti yoki xizmati identifikatori |
Qarang Javob parametrlari
Misollar
Misol so'rov:
{
"request": {
"order_id": "test_12343242",
"merchant_id": "4056281",
"order_desc": "Test order",
"amount": 1000,
"currency": "UZS",
"rectoken": "JcZoqYNosx1HjDoHXWlFU0avVnzYsFAbLBbA",
"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": "1000",
"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": "test_12343242",
"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": "1000",
"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"
}
}
Xato bo'lgan taqdirda javob:
{
"response": {
"error_code": 1011,
"error_message": "Parameter `amount` is missing",
"request_id": "5htKi0wf7zEHn",
"response_status": "failure"
}
}