Tartibni o'zgartiring¶
Buyurtma to'liq yoki qisman bekor qilinishi mumkin. Agar buyurtmani to'liq bekor qilish zarur bo'lsa, amount parametri bekor qilish so'rovi ga uzatilishi va actual_amount yoki buyurtma ga o'rnatilishi kerak.
buyurtma actual_amount qiymat, agar to'liq bekor qilish talab qilinsa.
actual_amount.
Noto'g'ri bekor qilish kaliti¶
Bekor qilish so'rovi teskari so'rov dagi noto'g'ri bekor qilish kaliti reverse_id bekor qilishni xavfsiz qayta urinishlarini ta'minlash uchun ishlatiladi. Bu odatda to'liq bekor qilish uchun talab etilmaydi.
Qisman bekor qilish holatida idempotent kalit xato yuz berganda bir nechta qayta urinishlardan himoya qilishi mumkin.
Masalan, agar buyurtma summasi 1 000 lari bo'lsa va 100 lariga qisman bekor qilish yuborilgan bo'lsa, lekin tarmoq xatosi tufayli muvaffaqiyatsiz tugasa,
100 lari uchun yana bir bekor qilish urinishining natijasida ikki marta qisman bekor qilish emas, balki bitta qisman bekor qilish bo'lishini ta'minlash (100 + 100 = 200 lari),
Har bir urinish reverse_id parametrining bir xil qiymati bilan yuborilishi kerak.
Buyurtmani bekor qilish uchun API manzili
Reverse the order
POST /api/reverse/order_id
Ushbu API manzili POST so'rovini JSON formatida va so'rov parametrlari bilan kutadi.
Oddiy javobda bekor qilish muvaffaqiyatli bo'lgan yoki bo'lmaganini ko'rsatadigan reverse_status parametri bo'ladi.
So'rov/javob misollari
curl -L 'https://pay.payme.uz/api/reverse/order_id' \
-H 'Content-Type: application/json' \
-d '{
"request": {
"order_id": "test_12343242111",
"currency": "UZS",
"amount": "1",
"signature": "29a569275265925c2ec356d3adada1929fd8bb8c",
"merchant_id": "4056281"
}
}'
{
"response": {
"reverse_status": "approved",
"order_id": "test_12343242111",
"response_description": "",
"response_code": "",
"merchant_id": 4056281,
"response_status": "success",
"signature": "c703b3ce82aecfd2de633319685223347140717d",
"reverse_id": "",
"reversal_amount": "1",
"transaction_id": "2011273408"
}
}
{
"response": {
"error_code": 1007,
"error_message": "Parameter `signature` is incorrect",
"request_id": "HGh7ami3WN0ci",
"response_status": "failure"
}
}