Повернути

post
https://api.cryptomus.com/v1/payment/refund
Копіювати

Прохання

Параметри запиту

НазваТип параметраВизначення
address*stringАдреса, до якої слід повернути кошти
is_subtract*booleanЧи приймати комісію з балансу торговця чи від суми повернення коштів true - Візьміть комісію з балансу торговців false - зменшити повернені суми на суму комісії
uuid*uuidrequired_without: order_idРахунок -фактура UUID
order_id*stringmin:1max:128alpha_dashrequired_without: uuidІдентифікатор замовлення рахунків -фактур

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

string

Визначення

Адреса, до якої слід повернути кошти

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

boolean

Визначення

Чи приймати комісію з балансу торговця чи від суми повернення коштів true - Візьміть комісію з балансу торговців false - зменшити повернені суми на суму комісії

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

uuidrequired_without: order_id

Визначення

Рахунок -фактура UUID

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

stringmin:1max:128alpha_dashrequired_without: uuid

Визначення

Ідентифікатор замовлення рахунків -фактур

* - обов'язковий параметр

Рахунок -фактура ідентифікується order_id або uuid, якщо ви пройдете обидва, рахунок буде ідентифікований UUID

Приклад запиту


curl https://api.cryptomus.com/v1/payment/refund \
    -X POST \
    -H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
            "uuid": "8b03432e-385b-4670-8d06-064591096795",
            "address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm", 
            "is_subtract": "true"
        }'
Копіювати

Реакція

Приклад відповіді


1{
2  "state": 0,
3  "result": []
4}
Копіювати

Можливі помилки

Помилки перевірки

кодування : 422

Приклад відповіді:

Якщо рахунок -фактура з uuid або order_id, який ви надали, не існує:


1{
2    "state": 1,
3    "message": "Payment was not found"
4} 
Копіювати

Якщо ви не передасте uuid і order_id , ви отримаєте це повідомлення. Це означає, що потрібен принаймні один із параметрів.


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

Якщо виплата заблокована на вашому торговцям, ви отримаєте це повідомлення про помилку. Це відбувається, наприклад, коли ви змінюєте пароль, а виплати заблоковані протягом 24 годин.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
5
Копіювати

Якщо торговий гаманець, який підключений до рахунку -фактури, не існує:


1{
2    "state": 1,
3    "message": "Undefined merchant wallet"
4}
Копіювати

Якщо рахунок -фактура не доопрацьована чи не сплачена.


1{
2    "state": 1,
3    "message": "Refunds are made only for completed payments"
4}
Копіювати

Якщо сума, яку потрібно повернути, перевищує суму платежу рахунку -фактури:


1{
2    "state": 1,
3    "message": "The refund amount should not be more than the amount paid"
4}
Копіювати

Якщо відбувається технічна робота і платіж тимчасово недоступний, ви можете отримати це повідомлення про помилку:


1{
2    "state": 1,
3    "message": "Server error"
4}
Копіювати