Рекуррентный платеж

Метод вызова рекуррентного платежа без присутствия клиента.

При проведении первой транзакции (родительской транзакции) мерчант создаёт платёж. Далее при наступлении начисления на стороне клиента, мерчант вызывает данный метод, передаёт номер транзакции parent_transaction первого платежа. Списание происходит без участия плательщика.

URL

Метод: POST

Production: https://api.pay.kvell.group/v1/orders/rebill
Stage: https://api.pay.stage.kvell.group/v1/orders/rebill

Параметры запроса

Название	Тип данных	Обязательно	Описание
`parent_transaction`	string	Да	Номер транзакции родительского платежа `transaction` - указанный при совершении родительского платежа
`transaction`	string	Да	Уникальный номер транзакции на стороне мерчанта
`amount`	string	Да	Сумма в копейках
`description`	string	Да	Описание к транзакции
`fiscal_data`	json	Нет	Фискализация чека по Ф3-54
`extra_data`	json	Нет	Дополнительные параметры переданные мерчантом

Заголовки запроса

Название	Тип данных	Обязательно	Описание
`X-Api-Key`	string	Да	Уникальный идентификатор магазина
`X-Signature`	string	Да	Подпись

Формирование подписи

Подпись X-Signature формируется конкатенацией X-Api-Key, transaction, amount и secret_key. Формируется sha256 от полученной строки:

sha256({x-api-key}{transaction}{amount}{secret_key})

где secret_key - секретный ключ, который находится в настройках магазина мерчанта.

Ответ запроса

Пример ответа

200: OK422: Validation error

{
  "id": "b13e1610-f26a-4c49-84e8-0edf1650a026",
  "status": "completed",
  "transaction": "436b4ed3-fc6d-431e-963e-a958a730119c",
  "amount": 100,
  "commission": 1000,
  "inner_commission": 500,
  "description": "TEST Invoice",
  "success_url": "https://success.url",
  "fail_url": "https://fail.url",
  "redirect_url": "https://redirect.url",
  "extra_data": {},
  "fiscal_data": {},
  "additional_data": {},
  "error_code": null,
  "error_message": null,
  "created_at": "2024-05-20T12:55:00.951753+00:00",
  "refund_amount": 0,
  "reverse_amount": 0,
  "confirm_amount": 0
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}

Рекуррент через сторонний магазин

Этот метод применяется для осуществления рекуррентного платежа через сторонний магазин с использованием родительской транзакции. Его используют, когда требуется безакцептное списание через другой терминал, который настраивается в банке. Для получения детальной информации обратитесь к менеджеру.

URL

Метод: POST

Production: https://api.pay.kvell.group/v1/orders/rebill-from-profile
Stage: https://api.pay.stage.kvell.group/v1/orders/rebill-from-profile

Параметры запроса

Название	Тип данных	Обязательно	Описание
`parent_transaction`	string	Да	Номер транзакции родительского платежа `transaction` из стороннего магазина
`transaction`	string	Да	Уникальный номер транзакции на стороне мерчанта
`amount`	string	Да	Сумма в копейках
`description`	string	Да	Описание к транзакции
`fiscal_data`	json	Нет	Фискализация чека по Ф3-54
`extra_data`	json	Нет	Дополнительные параметры переданные мерчантом

Заголовки запроса

Название	Тип данных	Обязательно	Описание
`X-Api-Key`	string	Да	Уникальный идентификатор магазина
`X-Signature`	string	Да	Подпись, формируется аналогично методу рекуррентного платежа

Ответ запроса

Аналогичен методу рекуррентного платежа ответа запроса.