Транзакции

Возврат по АПИ

Lifepay позволяет по АПИ вызвать метод для полного или частичного возврата по транзакции. Для включения функционала необходимо предварительно связаться со службой поддержки по телефону 8 800 555 23 62.

Тип запроса:

POST

Адрес URL:

https://api.life-pay.ru/v1/transactions/refund

Описание полей

Параметр	Тип	Описание	Обязательный
apikey	Строка	АПИ-ключ компании в системе Lifepay. Узнать свой АПИ-ключ можно в личном кабинете Lifepay.	Да
login	Строка	Логин пользователя от имени которого осуществляется возврат.	Да
number	Строка	14-ти значный номер транзакции (платежа) по которому осуществляется возврат.	Да
uuid	Строка	Уникальный идентификатор запроса на возврат. Запросы с одинаковым UUID не будут обрабатываться повторно.	Нет
items	Item[]	Список позиций на возврат для частичного возврата.	Нет

Описание Item

Параметр	Тип	Описание	Обязательный
name	Строка	Наименование позиции.	Да
price	Число	Цена за единицу товара	Да
quantity	Число	Количество товаров в позиции к возврату. В случае с весовыми товарами данное значение может быть дробным (до трех знаков после запятой, разделитель - точка)	Да
tax	Строка	НДС позиции (none - НДС не облагается / vat0 - НДС 0% / vat10 - НДС 10% / vat20 - НДС 20%). По умолчанию none	Нет

Пример запроса на полный возврат:

curl -X POST -d '
{
  "apikey": "579b9838cf4973699a7yqy7d37562a3f",
  "login": "79263431379",
  "number": "16966885891041"
}
' https://api.life-pay.ru/v1/transactions/refund

Пример запроса на частичный возврат:

curl -X POST -d '
{
  "apikey": "579b9838cf4973699a7yqy7d37562a3f",
  "login": "79263431379",
  "number": "14209818121071",
  "items": [
    {
      "name": "Масло сливочное 82%",
      "price": 103.59,
      "quantity": 2,
      "tax": "vat10"
    },
    {
      "name": "Яблоки сезонные (кг)",
      "price": 60,
      "quantity": 1.592,
      "tax": "vat20"
    }
  ]
}
' https://api.life-pay.ru/v1/transactions/refund

Пример успешного ответа:

{
    "code": 0,
    "message": "",
    "data": {
        "number": "20793945173071",
        "type": 2,
        "amount": 302.7,
        "rrn": "000328414070",
        "created": 1636053512,
        "approval": "c94868",
        "cardLabel": null,
        "aid": null,
        "pan": "2200241822",
        "code": "00",
        "termid": "TEST_002",
        "cardholder": " /",
        "companyName": "Life4PSB3",
        "inn": "7729724371",
        "ps": "MIR",
        "operationType": "reversal"
    }
}

Пример неуспешного ответа:

{
    "code": 5319,
    "message": "Операция не прошла. Сумма возврата больше, чем был платеж. Измените её и повторите попытку.",
    "data": {}
}