Tarkibga o'tish

Buyurtmani tasdiqlang

Buyurtma to'liq yoki qisman tasdiqlanishi mumkin. Agar debetni to'liq tasdiqlash talab qilinsa, amount parametrini talabni ushlash ga uzatib, uni actual_amount yoki buyurtma ga o'rnating. buyurtma actual_amount to'liq qamrab olish talab qilinsa, qiymat.

E'tibor bering

Bir nechta ma'lumot olish operatsiyalari ruxsat etilmaydi.

Capture tranzaktsiyasi uchun bosqichlarning to'g'ri ketma-ketligi

Capture tranzaktsiyasi kartada oldin bloklangan summani hisobdan yechishga mo'ljallangan.

Blok oldindan to'lov so'rovi parametr preauth = Y bilan oldindan avtorizatsiya so'rovi orqali bajarilishi kerak.

Ushbu to'lov jarayoni ikki bosqichda amalga oshiriladi. Birinchi bosqich – bu summa vaqtinchalik ushlab turilgan to'lov tranzaktsiyasidir. Ikkinchi bosqich — ushlab qolingan summani bron qilishdir.

Tranzaksiya to'liq yoki qisman miqdorda qayta ishlanishi mumkin.

Note

Oldindan avtorizatsiya va debetni tasdiqlash tranzaksiyalari faqat karta to'lovlari uchun mavjud. Boshqa to'lov usullari bu amaliyotlarni qo'llab-quvvatlamaydi va to'liq summa bir bosqichli jarayon doirasida avtomatik ravishda yechib olinadi:

Oldindan avtorizatsiyani bekor qilish

Agar tranzaksiya hali yakunlanmagan bo'lsa, oluvchining to'lovi oldindan avtorizatsiya va bekor qilish tranzaksiyalari uchun olinmaydi.

Oldindan to'lov bo'yicha qaytarish amalga oshirilganda ushlab turilgan summa darhol qaytariladi.

Agar tranzaksiya hali yakunlanmagan bo'lsa, faqat ushlab turilgan summaning to'liq qaytarilishi mumkin. Oldindan to'lovlar uchun qisman qaytarishga ruxsat berilmaydi.

Agar qisman debet tranzaktsiyasi amalga oshirilsa, qolgan summa avtomatik ravishda to'lovchining kartasiga qaytariladi va bekor qilish tranzaktsiyasi talab qilinmaydi.

Misol

Masalan, agar oldindan to'lov miqdori 1000 bo'lsa va 200 bekor qilinishi kerak bo'lsa, to'lov 800 deb qayd etilishi kerak. 200 qoldiq summasi bekor qilinmasligi kerak, aks holda 200 summasi ikki marta bekor qilinadi.

Oldindan avtorizatsiya tranzaktsiyasi uchun faqat bitta to'liq yoki qisman debet amalga oshirilishi mumkin. Belgilangan miqdordagi tranzaksiyalar uchun ketma-ket bir nechta qisman bekor qilishlar mavjud.

Noto'g'ri capture kaliti

Capture operatsiyasi vaqtinchalik kalitni talab qilmaydi, chunki capture xavfsiz ravishda takrorlanishi mumkin. amount bilan bir xil usulda yana ushlashga urinayotganda, capture_status qaytariladi.

Buyurtmani tasdiqlash uchun API manzili

To'lovni capture qilish

POST /api/capture/order_id

Ushbu API manzili POST so'rovini JSON formatida va so'rov parametrlari bilan kutadi.

Oddiy javob capture_status parametrini o'z ichiga oladi, u debet tasdig'ining muvaffaqiyatli yoki muvaffaqiyatsiz bo'lganini ko'rsatadi.

So'rov/javob misollari

curl -L 'https://pay.payme.uz/api/capture/order_id' \
-H 'Content-Type: application/json' \
-d '{
  "request": {
    "version": "1.0.1",
    "order_id": "test_12343242113",
    "currency": "UZS",
    "merchant_id": 4056281,
    "amount": 100,
    "signature": "1efcb015c89da38977ae1e734aade413b95ca900"
  }
}'
{
    "response": {
        "capture_status": "captured",
        "order_id": "test_12343242113",
        "response_description": "",
        "response_code": "",
        "merchant_id": 4056281,
        "response_status": "success"
    }
}
{
    "response": {
        "error_code": 1007,
        "error_message": "Parameter `signature` is incorrect",
        "request_id": "HGh7ami3WN0ci",
        "response_status": "failure"
    }
}