Описание API

Добавление чека с одной товарной позицией. 

POST: api.itkassa.ru/api/add 

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

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключ в настройках магазина 

custom_email — email плательщика 

payment_id — id транзакции магазина 

payment_name — название платежа(например: Покупка карандашей)(максимальная длина строки:100 символов) 

payment_price — сумма платежа 

payment_amount — кол-во покупаемого 

payment_trans — id транзакции в платежной системе 

*Требования к наименованию товаров и услуг
Поле payment_name не должно содержать спец. символов (например  #,%,nbsp). 

Response: id чека в системе itkassa 

 

Регистрация нескольких позиций в чеке: 

POST:api.itkassa.ru/api/add 

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

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключ в настройках магазина 

custom_email — email плательщика 

payment_id — id транзакции магазина 

payment_param— json строка, содержащая в себе параметры (по каждой позиции в чеке): 

  • payment_name — название операции(напримерПокупка карандашей)(максимальная длина строки:100 символов), 
  • payment_price — сумма товара 
  • payment_amount — колво покупаемого 

 

*Требования к наименованию товаров и услуг
Поле payment_name не должно содержать спец. символов (например  #,%,nbsp). 

Response: id чека в системе itkassa 

 

Статус платежа: 

GET: api.itkassa.ru/api/paystatus 

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

numbercheck — id чека в системе itkassa 

Response: status* чека в системе itkassa 

  • 1-Выполнено, 2-В процессе, 0-Ошибка (обратитесь к администрации) 

 

Возврат всего чека: 

POST:api.itkassa.ru/api/chargeback 

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключь в настройках магазина 

custom_email — email плательщика 

payment_id — id транзакции магазина 

payment_name — название платежа(например: Покупка крандашей) 

payment_price — сумма платежа 

payment_amount — кол-во покупаемого указанного в чеке 

payment_trans — id транзакции в платежной системе 

numbercheck — id чека в системе itkassa 

payment_desc — причина возврата(текст максимум 100 символов) 

Response: status* 

* 1-Выполнено, 2-В процессе, 0-Ошибка (обратитесь к администрации) 

Возврат позиции в чеке: 

POST: api.itkassa.ru/api/checkposreject 

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключь в настройках магазина 

custom_email — email плательщика 

payment_id — id транзакции магазина 

payment_name — название платежа(например: Покупка крандашей) 

payment_price — сумма платежа 

payment_amount — кол-во покупаемого указанного в позиции чека 

payment_trans — id транзакции в платежной системе 

numbercheck — id чека в системе itkassa 

payment_desc — причина возврата(текст максимум 100 символов) 

Response: status* 

  • 1-Выполнено, 2-В процессе, 0-Ошибка (обратитесь к администрации) 

 

Получение данных по чеку: 

POST:api.itkassa.ru/api/checkinfo 

shop_id — Идентификатор магазина в системе, 

sec_key — секретный ключь в настройках магазина, 

numbercheck — номер чека в системе(itkassa) 

Response в json: 

numbercheck-номер чека, 

session-номер смены, 

fis_cal-Фискальный признак, 

time_add-время поступления чека в систему(в формате  гггг-месяц-день час:минут:секунда. Например: 1970-01-06 12:08:14), 

time_end-время когда касса выбила чек(в формате  гггг-месяц-день час:минут:секунда. Например: 1970-01-06 12:08:22) 

**** 

если у чека выполнялся возврат то будет добавлено поле 

reason_return-причина возврата  

 

 Ошибки  
“Error:Not find sec_key or shop”- не указан магазин или секретный код магазина 

“Error:Not find shop”-не указан магазин 

“Error:Not find number”-не найден чек при запросе статуса 

“0-Ошибка (обратитесь к администрации)”-  ошибка, которая выпадает в случае проблем с кассой при запросе статуса.