Возврат средств
Операция полностью или частично возвращает деньги на счет клиента в случае полной или частичной отмены заказа или возврата товара.
Запрос
Для возврата средств отправьте POST
запрос на https://api.bepaid.by/beyag/transactions/refunds
со следующими параметрами:
Параметр | Тип | Описание |
---|---|---|
request | object | |
parent_uid * обязательный |
string | UID родительской транзакции. |
reason * обязательный |
string | Причина возврата. |
amount | integer | Сумма возврата в минимальных денежных единицах, например 1000 для $10.00 |
tracking_id | string | ID транзакции или заказа в вашей системе. В параметре может быть отправлено несколько значений, разделенных символом ; . Например: "cbe59142-90af-4aea-b5a5-5bf3f66cf3da;f7883cb9-0e26-43a7-beb7-4027cb55d1a6;4a6a89d5-6950-400f" . Если в запросе было передано более одного значения tracking_id , поиск транзакции в личном кабинете может быть осуществлен по любому из них. |
Пример запроса
{
"request":{
"parent_uid":"1-310b0da80b",
"reason":"reason",
"amount": 50
}
}
Ответ
Параметр | Тип | Описание |
---|---|---|
transaction | object | |
uid * обязательный |
string | UID обработанной транзакции. |
parent_uid | string | UID родительской транзакции. |
type * обязательный |
string | Тип транзакции. |
status * обязательный |
string | Статус обработанной транзакции. |
created_at | string | Время создания транзакции в ISO 8601 формате. |
updated_at | string | Время обновления транзакции в ISO 8601 формате. |
message | string | Сообщение с результатом запроса |
amount | integer | Сумма списания. |
currency * обязательный |
string | Валюта транзакции в формате ISO-4217 alpha-3 code. Например, USD . |
tracking_id | string | ID транзакции или заказа в вашей системе. |
test | boolean | true или false . Транзакция будет тестовой при true |
language | string | Значение параметра language из запроса. |
paid_at | string | Дата проведения транзакции. |
method_type | string | Имя платёжной системы или определённый способ оплаты, поддерживаемый подключенной платёжной системой |
receipt_url * обязательный |
string | Ссылка на квитанцию обработанной транзакции. |
refund | object | |
status * обязательный |
string | Статус обработанной транзакции. |
ref_id | string | Номер операции в платёжной системе. |
message | string | Сообщение от платёжной системы |
Пример ответа
{
"transaction": {
"uid": "2-310b0da80b",
"parent_uid": "1-310b0da80b",
"type": "refund",
"status": "successful",
"message": "The operation was successfully processed",
"created_at": "2014-06-11T12:04:59+03:00",
"updated_at": "2014-06-11T12:04:59+03:00",
"amount": 50,
"currency": "USD",
"test": false,
"method_type": ":method_name",
"receipt_url": "https://merchant.bepaid.by/customer/transactions/2-310b0da80b/11443f39ae75aa1f955a9c9283cd5045bfb0413b65d666f834a9da4e7d3926b5",
"refund": {
"message": "The operation was successfully processed",
"ref_id": "8889999",
"status": "successful"
}
}
}