Qaytarmoq

post

https://api.cryptomus.com/v1/payment/refund

Nusxa ko'chirmoq

Talab qilmoq

So'rov parametrlari

Ism	Parametr turi	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

Parametr turi

string

Ta'rif

To'lovni qaytarish kerak bo'lgan manzil

Parametr turi

boolean

Ta'rif

Savdogarning muvozanatidan yoki qaytarib berish miqdoridan komissiya olish kerakmi true - Komissiyani savdogar balansidan olib boring false - komissiya miqdoridan qaytarilgan miqdorni kamaytiring

Parametr turi

uuidrequired_without: order_id

Ta'rif

Uuid hisob-fakturasi

Parametr turi

stringmin:1max:128alpha_dashrequired_without: uuid

Ta'rif

Hisob-fakturaning buyurtmasi identifikatori

* - Majburiy parametr

Hisob-faktura aniqlanadi order_id yoki uuid, agar siz ikkalasini olsangiz, hisob uuid tomonidan aniqlanadi

Misolga misol


curl https://api.cryptomus.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"
        }'

Nusxa ko'chirmoq

Javob

Javob namunasi


1{
2  "state": 0,
3  "result": []
4}

Nusxa ko'chirmoq

Mumkin bo'lgan xatolar

Tasdiqlash xatolari

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}

Nusxa ko'chirmoq

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}

Nusxa ko'chirmoq

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

Nusxa ko'chirmoq

Agar hisob-fakturaga ulangan savdo yoki hamyon mavjud bo'lmasa:


1{
2    "state": 1,
3    "message": "Undefined merchant wallet"
4}

Nusxa ko'chirmoq

Hisob-faktura yakunlanmasa yoki to'lanmasa.


1{
2    "state": 1,
3    "message": "Refunds are made only for completed payments"
4}

Nusxa ko'chirmoq

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}

Nusxa ko'chirmoq

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}

Nusxa ko'chirmoq