Осуществление возврата если кошелек заблокирован

post
https://api.cryptomus.com/v1/wallet/blocked-address-refund
копировать

Вы можете вернуть деньги только один раз.

Запрос

Параметры запроса

ИмяТип параметраОписание
uuidstringuuidrequired_without: order_iduuid статического кошелька
order_idstringmin:1max:32alpha_dashrequired_without: uuidИдентификатор заказа статического кошелька
address*stringmin:10max:128alpha_dashВернуть все заблокированные средства на этот адрес

Тип параметра

stringuuidrequired_without: order_id

Описание

uuid статического кошелька

Тип параметра

stringmin:1max:32alpha_dashrequired_without: uuid

Описание

Идентификатор заказа статического кошелька

Тип параметра

stringmin:10max:128alpha_dash

Описание

Вернуть все заблокированные средства на этот адрес

* - обязательный параметр

Для возврата платежей вам необходимо передать либо uuid, либо order_id, если вы передадите оба, статический кошелек будет идентифицирован с помощью uuid

Пример запроса


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..."
}'
копировать

Ответ

Параметры отклика

ИмяОписание
commissionКомиссия за возврат
amountСумма возврата

Описание

Комиссия за возврат

Описание

Сумма возврата

Пример ответа


1{
2    "state": 0,
3    "result": {
4        "commission": "0.50",
5        "amount": "9.50"
6    }
7}
копировать

Возможные ошибки

Ошибки проверки

код : 422

Примеры ответов:

Если вы не передадите uuid и order_id, вы получите это сообщение. Это означает, что требуется хотя бы один из параметров.


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}
копировать

Если статический кошелек не был найден:


1{
2    "state": 1,
3    "message": "Not found"
4}
копировать

До тех пор, пока вывод средств разрешен только один раз с заблокированного статического кошелька, если вывод средств уже был произведен, вы получите это сообщение об ошибке:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
копировать

Поскольку вывод средств разрешен только один раз с заблокированного статического кошелька, если вы заблокировали статический кошелек с параметром is_force_refund=true, вывод средств уже был произведен, и вы получите это сообщение об ошибке:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
копировать

Если возврат средств уже осуществляется:


1{
2    "state": 1,
3    "message": "Refund is in process"
4}
копировать

Если выплата заблокирована у вашего продавца или пользователя, вы получите это сообщение об ошибке. Это происходит, например, когда вы меняете свой пароль и выплаты блокируются на 24 часа.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
копировать

Если на статический кошелек не было произведено никаких платежей:


1{
2    "state": 1,
3    "message": "Nothing to withdraw"
4}
копировать

Если сумма выплаты меньше минимальной поддерживаемой суммы для криптовалюты, вы получите это сообщение об ошибке:


1{
2    "state": 1,
3    "message": "The amount is too small"
4}
копировать

Если возникнут технические неполадки или выплата будет временно недоступна, вы получите следующее сообщение об ошибке:


1{
2    "state": 1,
3    "message": "Server error"
4}
копировать


1{
2    "state": 1,
3    "message": "The service was not found"
4}
копировать

Внутренняя ошибка сервера

код : 500

Примеры ответов:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}
копировать