Повернення платежів за заблокованою адресою
Ви можете повернути кошти лише один раз.
Прохання
Параметри запиту
Назва | Тип параметра | Визначення |
---|---|---|
uuid | stringuuidrequired_without: order_id | uuid статичного гаманця |
order_id | stringmin: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Визначення
Повернути всі заблоковані кошти на цю адресу
* - обов'язковий параметр
Приклад запиту
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}
КопіюватиAl довгий час, коли виведення дозволено лише один раз із заблокованого статичного гаманця, якщо виведення вже було зроблено, ви отримаєте це повідомлення про помилку:
1{
2 "state": 1,
3 "message": "You can withdraw only once"
4}
КопіюватиAl довгий час, коли виведення дозволено лише один раз із заблокованого статичного гаманця, якщо ви заблокували статичний гаманець із параметром 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}
Копіювати