Asosiy
/To'lovlar
/Qaytarmoq
| Ism | Parametr turi | Standart qiymat | Ta'rif |
|---|---|---|---|
| address* | string | To'lovni qaytarish kerak bo'lgan manzil | |
| is_subtract* | boolean | Savdogarning muvozanatidan yoki qaytarib berish miqdoridan komissiya olish kerakmi true - Komissiyani savdogar balansidan olib boring false - komissiya miqdoridan qaytarilgan miqdorni kamaytiring | |
| uuid* | uuidrequired_without: order_id | Uuid hisob-fakturasi | |
| order_id* | stringmin:1max:128alpha_dashrequired_without: uuid | Hisob-fakturaning buyurtmasi identifikatori | |
| amount | stringmax:40null | null | Qaytariladigan summa |
Parametr turi
stringTa'rif
To'lovni qaytarish kerak bo'lgan manzilParametr turi
booleanTa'rif
Savdogarning muvozanatidan yoki qaytarib berish miqdoridan komissiya olish kerakmi true - Komissiyani savdogar balansidan olib boring false - komissiya miqdoridan qaytarilgan miqdorni kamaytiringParametr turi
uuidrequired_without: order_idTa'rif
Uuid hisob-fakturasiParametr turi
stringmin:1max:128alpha_dashrequired_without: uuidTa'rif
Hisob-fakturaning buyurtmasi identifikatoriParametr turi
stringmax:40nullTa'rif
Qaytariladigan summa* - Majburiy parametr
curl https://api.heleket.com/v1/payment/refund \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"uuid": "8b03432e-385b-4670-8d06-064591096795",
"address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm",
"is_subtract": "true",
}'
1{
2 "state": 0,
3 "result": []
4}kod : 422
Misol javoblar:
Agar siz taqdim etgan uuid yoki order_id bilan schyot-faktura mavjud bo'lmasa:
1{
2 "state": 1,
3 "message": "Payment was not found"
4} Agar siz uuid va order_id, siz ushbu xabarni olasiz. Bu shuni anglatadiki, kamida parametrlardan biri talab qilinadi.
1{
2 "state": 1,
3 "errors": {
4 "uuid": ["validation.required_without"],
5 "order_id": ["validation.required_without"]
6 }
7}Agar savdogaringizdagi to'lovlar bloklangan bo'lsa, siz ushbu xato xabarini olasiz. Bu, masalan, parolingizni o'zgartirganingizda sodir bo'ladi va to'lovlar 24 soat davomida bloklanadi.
1{
2 "state": 1,
3 "message": "You are forbidden"
4}
5Agar hisob-fakturaga ulangan savdo yoki hamyon mavjud bo'lmasa:
1{
2 "state": 1,
3 "message": "Undefined merchant wallet"
4}Hisob-faktura yakunlanmasa yoki to'lanmasa.
1{
2 "state": 1,
3 "message": "Refunds are made only for completed payments"
4}Agar mablag 'qaytarilishi kerak bo'lsa, faktura to'lovi miqdoridan oshsa:
1{
2 "state": 1,
3 "message": "The refund amount should not be more than the amount paid"
4}Agar texnik ish sodir bo'lsa va to'lov vaqtincha mavjud bo'lmasa, ushbu xato xabarini olishingiz mumkin:
1{
2 "state": 1,
3 "message": "Server error"
4}