Zwróć płatności na zablokowany adres

post
https://api.cryptomus.com/v1/wallet/blocked-address-refund
KOPIUJ

Możesz dokonać zwrotu pieniędzy tylko raz.

Wniosek

Parametry zapytania

NazwaTyp parametruDefinicja
uuidstringuuidrequired_without: order_idUUID statycznego portfela
order_idstringmin:1max:32alpha_dashrequired_without: uuidZamów identyfikator statycznego portfela
address*stringmin:10max:128alpha_dashZwróć wszystkie zablokowane fundusze na ten adres

Typ parametru

stringuuidrequired_without: order_id

Definicja

UUID statycznego portfela

Typ parametru

stringmin:1max:32alpha_dashrequired_without: uuid

Definicja

Zamów identyfikator statycznego portfela

Typ parametru

stringmin:10max:128alpha_dash

Definicja

Zwróć wszystkie zablokowane fundusze na ten adres

* - obowiązkowy parametr

Aby zwrócić płatności, musisz przekazać uuid lub order_id , jeśli zdasz oba, portfel statyczny zostanie zidentyfikowany przez uuid

Przykład żądania


curl https://api.cryptomus.com/v1/wallet/blocked-address-refund \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
    "order_id": "1",
      "address": "TK8..."
}'
KOPIUJ

Odpowiedź

Parametry odpowiedzi

NazwaDefinicja
commissionKomisja zwrotu
amountKwota zwrotu

Definicja

Komisja zwrotu

Definicja

Kwota zwrotu

Przykład odpowiedzi


1{
2    "state": 0,
3    "result": {
4        "commission": "0.50",
5        "amount": "9.50"
6    }
7}
KOPIUJ

Możliwe błędy

Błędy walidacji

kod : 422

Przykładowe odpowiedzi:

Jeśli nie zdasz uuid i order_id , otrzymasz tę wiadomość. Oznacza to, że wymagane jest przynajmniej jeden z parametrów.


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}
KOPIUJ

Jeśli nie znaleziono statycznego portfela:


1{
2    "state": 1,
3    "message": "Not found"
4}
KOPIUJ

AL, gdy wycofanie jest dozwolone tylko raz z zablokowanego portfela statycznego, jeśli wycofanie zostało już dokonane, otrzymasz ten komunikat o błędzie:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
KOPIUJ

AL, gdy wycofanie jest dozwolone tylko raz z zablokowanego portfela statycznego, jeśli zablokowałeś statyczny portfel z parametrem is_force_refund = true , wypłata została już wykonana i otrzymasz ten komunikat o błędzie:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
KOPIUJ

Jeśli zwrot jest już w toku:


1{
2    "state": 1,
3    "message": "Refund is in process"
4}
KOPIUJ

Jeśli wypłata zostanie zablokowana na sprzedawcy lub użytkowniku, otrzymasz ten komunikat o błędzie. Dzieje się tak na przykład po zmianie hasła, a wypłaty są blokowane na 24 godziny.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
KOPIUJ

Jeśli nie dokonano płatności na statyczny portfel:


1{
2    "state": 1,
3    "message": "Nothing to withdraw"
4}
KOPIUJ

Jeśli kwota wypłaty jest mniejsza niż minimalna obsługiwana kwota kryptowaluty, otrzymasz ten komunikat o błędzie:


1{
2    "state": 1,
3    "message": "The amount is too small"
4}
KOPIUJ

Jeśli nastąpi praca techniczna lub wypłata jest tymczasowo niedostępna, otrzymasz te komunikaty o błędach:


1{
2    "state": 1,
3    "message": "Server error"
4}
KOPIUJ


1{
2    "state": 1,
3    "message": "The service was not found"
4}
KOPIUJ

Wewnętrzny błąd serwera

kod : 500

Przykładowe odpowiedzi:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}
KOPIUJ