Получение статуса

https://{Environment}.payture.com/apicheque/Status/

Запрос Status используется для получения актуального статуса чека и информации о чеке.

Запрос

ПараметрОписаниеФормат
KeyНаименование Терминала
Предоставляется с параметрами тестового/рабочего доступа
String
Mandatory
PasswordПароль для выполнения запросов apiecheque
Предоставляется с параметрами тестового/рабочего доступа
String
Mandatory
IdИдентификатор чека, переданный в запросе или полученный из нотификацииString [1..64]
Optional*
OrderIdИдентификатор платежа в системе Продавца
Может использоваться, если чек был передан с платежом
Рекомендуемый формат: GUID/UUID или Alphanumeric. Другие форматы могут вызвать сбои в работе банковских сервисов.
String [1..50]
Optional*

Пример тела запроса JSON:

{ 
  "Key":"Merchant",
  "Password":"1234",
  "Id":"6363737176995117182",
  "OrderId":""
}

*Должен быть задан хотя бы один из опциональных параметров. Если задан Id, поиск будет выполняться по этому параметру.

Ответ

ПараметрОписаниеФормат
SuccessПризнак успешности выполнения операции в платежном шлюзе. Принимает значения:
true — операция успешна
false — операция неуспешна
Boolean
Mandatory
ErrCodeКод ошибки платежного шлюзаString
Mandatory
ChequesСписок чеков по данному запросу
Передается, если «Success=True»
Описание элемента Cheques см. ниже
Array of objects
Optional

Пример ответа [JSON]:

{
  "Success":true,
  "ErrCode":null,
  "Cheques":[
    {
      "Sended":false,
      "Cheque":{
        "Content":{
          ...
        },
        "Id":"1568707129",
        "DeviceSN":"0578050005001542",
        "DeviceRN":"0000000400054952",
        "FSNumber":"9999078900001341",
        "OFDName":"ООО \"Ярус\" (\"ОФД-Я\")",
        "OFDWebsite":"www.ofd-ya.ru",
        "OFDINN":"7728699517",
        "FNSWebsite":"www.nalog.ru",
        "CompanyINN":"7710140677",
        "CompanyName":"ООО «Ромашка»",
        "DocumentNumber":8750,
        "ShiftNumber":3420,
        "DocumentIndex":945,
        "ProcessedAt":"2019-09-17T10:58:00",
        "Change":0.0,
        "FP":"671302447"
      },
      "ErrCode":null,
      "Link":"https://sandbox3.payture.com/c/?i=brBv&h=t9FlDSndYcqI0sU8+NnyaA",
      "Status":"Created"
    }
  ]
}

Состав элемента массива Cheques

ПараметрОписаниеФормат
SendedПризнак отправки чека
Отправка не всегда означает доставку чека Покупателю
Boolean
Mandatory
StatusСтатус чека. См. статусы чековString
Mandatory
ChequeФискальные данные чека
Передается, если «Status=Created»
Описание структуры Cheque см. ниже
Object
Optional
LinkСсылка на чек
Передается, если «Status=Created»
String
Optional
ErrCodeПередается, если возникла внутренняя ошибка при добавлении данных текущего чека в ответ этого запросаString
Optional

Состав Cheques.Cheque

ПараметрОписаниеФормат
ContentДанные чека. Соответствует параметру Content в запросах на создание чека.
Различается в зависимости от типа чека:
для обычного чека — параметр Cheque.Content из запроса Create
для чека коррекции — параметр Body.Content из запроса CreateCorrection
Object
Mandatory
IdИдентификатор чека
Соответствует переданному в запросе
String [1..64]
Mandatory
DeviceSNСерийный номер устройства, пробившего чекString [1..20]
Mandatory
DeviceRNРегистрационный номер устройства, пробившего чекString [1..20]
Mandatory
FSNumberНомер фискального накопителяString [1..16]
Mandatory
OFDNameНаименование ОФДString [1..256]
Mandatory
OFDWebsiteВеб-сайт ОФДString [1..58]
Mandatory
OFDINNИНН ОФДString [1..12]
Mandatory
FNSWebsiteВеб-сайт ФНСString [1..256]
Mandatory
CompanyINNИНН компанииString [1..12]
Mandatory
CompanyNameНазвание компанииString [1..256]
Mandatory
DocumentNumberНомер фискального документаInteger
Mandatory
ShiftNumberНомер сменыInteger
Mandatory
DocumentIndexНомер чекаInteger
Mandatory
ProcessedAtВремя регистрации фискального документа в ФН
Строка в формате ISO8601
String
Mandatory
ChangeСдача в рублях
Десятичное число с точностью до 2 цифр после точки
Float
Mandatory
FPФискальный признакString [1..10]
Mandatory