Blokuj statyczny portfel
post
https://api.cryptomus.com/v1/wallet/block-address
Kiedy musisz zablokować statyczny portfel swoich klientów, wszystkie dalsze płatności nie zostaną przypisane do jego równowagi. Możesz zwrócić ten fundusze tylko raz. Fundusze zostaną zwrócone na adresy, z których przybyły.
Wniosek
Parametry zapytania
| Nazwa | Typ parametru | Domyślna wartość | Definicja |
|---|---|---|---|
| uuid | stringuuidrequired_without: order_id | UUID statycznego portfela | |
| order_id | stringmin:1max:32alpha_dashrequired_without: uuid | Zamów identyfikator statycznego portfela | |
| is_force_refund | boolean | false | Zwróć wszystkie przychodzące płatności na adres nadawcy |
Typ parametru
stringuuidrequired_without: order_idDefinicja
UUID statycznego portfelaTyp parametru
stringmin:1max:32alpha_dashrequired_without: uuidDefinicja
Zamów identyfikator statycznego portfelaTyp parametru
booleanDefinicja
Zwróć wszystkie przychodzące płatności na adres nadawcy
Musisz przekazać jeden z wymaganych parametrów, jeśli zdasz oba, konto zostanie zidentyfikowane przez order_id
Przykład żądania
curl https://api.cryptomus.com/v1/wallet/block-address \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"order_id": "1"
}'Odpowiedź
Parametry odpowiedzi
| Nazwa | Definicja |
|---|---|
| uuid | UUID z portfela statycznego |
| status | Status statycznego portfela.Dostępne opcje:• blocked• active• in_active |
Definicja
UUID z portfela statycznegoDefinicja
Status statycznego portfela.Dostępne opcje:- blocked- active- in_active
Przykład odpowiedzi
1{
2 "state": 0,
3 "result": {
4 "uuid": "fcc40793-39f9-4fa9-85b2-93148039a72b",
5 "status": "blocked"
6 }
7}Możliwe błędy
Błędy walidacji
kod : 422
Przykładowe odpowiedzi:
1{
2 "state": 1
3}
1{
2 "state": 1,
3 "errors": {
4 "uuid": ["validation.required_without"],
5 "order_id": ["validation.required_without"]
6 }
7}Wewnętrzny błąd serwera
kod : 500
Przykładowe odpowiedzi:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}