Повернення платежів за заблокованою адресою

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}
Копіювати

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}
Копіювати