GetState

https://{Environment}.payture.com/apim/GetState

Команда GetState используется для получения актуального статуса платежа.

Запрос

curl https://sandbox3.payture.com/apim/GetState \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea \
Получить ссылку

В запросах наименования параметров чувствительны к регистру

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

Ответ

XML строка с элементом GetState

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

<GetState Success="True" OrderId="5f63838d-fb03-00c6-c890-c67cfc1c54ea" State="Refunded" Forwarded="False" MerchantContract="Merchant" Amount="12480" RRN="003770024290"/>
ПараметрОписаниеФормат
SuccessПризнак успешности операции (получения статуса). Принимает значения:
True — заказ найден и статус получен
False — не удалось выполнить запрос статуса
String
Mandatory
OrderIdИдентификатор платежа в системе Продавца
Соответствует переданному в запросе
String [1..50]
Mandatory
ForwardedПризнак перенаправления платежа на другой ТерминалBoolean
Mandatory
StateСтатус платежа. См. статусы транзакций
Передается, если «Success=True»
String
Optional
MerchantContractНаименование платежного Терминала
Соответствует переданному в запросе. Передается, если «Success=True»
String [1..50]
Optional
FinalTerminalКонечный Терминал, на котором был выполнен платеж
Передается, если «Forwarded=True»
String
Optional
AmountСумма платежа в копейках (или другая минимальная единица валюты терминала)
Передается, если «Success=True»
Integer
Optional
RRNУникальный номер транзакции, присвоенный банком-эквайером (Retrieval Reference Number)
Передается, если «Success=True»
String [12]
Optional
AddInfoДополнительные параметры транзакции, которые могут быть переданы в ответе платежного шлюза по согласованию со службой поддержки Payture
Описание формата и возможных параметров доступно здесь
Object
Optional
ErrCodeКод ошибки. См. коды ошибок
Передается, если:«Success=True» + «Status=Rejected» – будет указан код ошибки платежа«Success=False» – будет указан код ошибки самого запроса статуса.
String
Optional

Содержание