3. Интерфейс запроса статуса платежа

Этот XML-интерфейс позволяет Продавцу в любой момент выяснить состояние платежа.

Action - https://api.paysoft.solutions/merchants/get-transaction

Method - POST

Формат XML-запроса:

<?xml version="1.0" encoding="UTF-8"?>
<Command>
    <LMI_MERCHANT_ID></LMI_MERCHANT_ID>
    <LMI_PAYMENT_NO></LMI_PAYMENT_NO>
    <LMI_SYS_PAYMENT_ID></LMI_SYS_PAYMENT_ID>
    <LMI_HASH></LMI_HASH>
</Command>
Название Поле в XML Описание
Идентификатор продавца LMI_MERCHANT_ID Идентификатор магазина. Идентификатор Продавец может получить в Кабинете(https://merchant.paysoft.solutions).
Идентификатор заказа LMI_PAYMENT_NO Должен быть указан или номер заказа в системе продавца - (LMI_PAYMENT_NO), или номер платежа в системе PaySoft (LMI_SYS_PAYMENT_ID)
LMI_SYS_PAYMENT_ID
Контрольная подпись LMI_HASH Контрольная подпись запроса. Для формирования подписи исходный текст XML-запроса с пустым значением LMI_HASH конкатенируется с секретным ключом SecretKey (без разделителя). От полученной строки формируется хеш сумма с помощью алгоритма, указанного в настройках магазина в Кабинете Продавца. Полученная подпись передается в теге LMI_HASH. Рекомендованный алгоритм хеширования SHA256.Пример формирования подписи

Формат XML-ответа:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Retval></Retval>
<Retdesc></Retdesc>
<Retdata>
<Transaction>
    <LMI_MERCHANT_ID></LMI_MERCHANT_ID>
    <LMI_PAYMENT_AMOUNT></LMI_PAYMENT_AMOUNT>
    <LMI_PAYMENT_NO></LMI_PAYMENT_NO>
    <LMI_PAYMENT_SYSTEM></LMI_PAYMENT_SYSTEM>
    <LMI_MODE></LMI_MODE>
    <LMI_PAYMENT_DESC></LMI_PAYMENT_DESC>
    <LMI_SYS_PAYMENT_ID></LMI_SYS_PAYMENT_ID>
    <LMI_SYS_PAYMENT_DATE></LMI_SYS_PAYMENT_DATE>
    <LMI_PAID_AMOUNT></LMI_PAID_AMOUNT>
    <LMI_PAYER_IDENTIFIER></LMI_PAYER_IDENTIFIER>
    <LMI_PAYER_PHONE_NUMBER></LMI_PAYER_PHONE_NUMBER>
    <LMI_PAYER_EMAIL></LMI_PAYER_EMAIL>
    <LMI_HOLD_REFUND_AMOUNT></LMI_HOLD_REFUND_AMOUNT>
    <LMI_HASH></LMI_HASH>
    <State></State>
    <ErrorCode></ErrorCode>
    <ErrorMessageEN></ErrorMessageEN>
    <ErrorMessageUK></ErrorMessageUK>
    <ErrorMessageRU></ErrorMessageRU>
    <Refunds>
        <Refund>
            <RefundId></RefundId>
            <RefundAmount></RefundAmount>
            <Created></Created>
            <State></State>
            <Type></Type>
        </Refund>
    </Refunds>
</Transaction>
</Retdata>
</Response>
Название Поле в XML Описание
Код выполнения запроса Retval 1 - успешное выполнение команды
2 - некорректный тип запроса (ожидается POST)
-1 - общая ошибка
-2 - некорректные авторизационные данные
-3 - некорректная подпись
-4 - некорректный идентификатор заказ
-5 - транзакция с указанным идентификатором не найдена
Описание кода выполнения Retdesc
Retdata / Transaction Данные о платеже, который был указан в запросе
Идентификатор продавца LMI_MERCHANT_ID
Сумма платежа LMI_PAYMENT_AMOUNT
Внутренний номер заказа в системе учета Продавца LMI_PAYMENT_NO
Идентификатор платежного инструмента LMI_PAYMENT_SYSTEM
Признак тестового режима LMI_MODE Указывает, в каком режиме было принято платеж: 0 - рабочий режим; 1 - тестовый режим.
Назначение платежа LMI_PAYMENT_DESC
Внутренний номер платежа в системе PaySoft LMI_SYS_PAYMENT_ID
Дата и время приема платежа LMI_SYS_PAYMENT_DATE
Общая сумма LMI_PAID_AMOUNT Общая уплаченная сумма с учетом дополнительных комиссий Финансового учреждения.
Реквизит Клиента LMI_PAYER_IDENTIFIER Платежная информация о Клиенте (например, маскируемый номер банковской карты). Формат зависит от платежного инструмента, с помощью которого был осуществлен платеж.
Номер телефона Клиента LMI_PAYER_PHONE_NUMBER Номер телефона Клиента в формате 380xxxxxxxxx.
Электронный адрес Клиента LMI_PAYER_EMAIL Электронный адрес Клиента.
Сумма возмещения Hold LMI_HOLD_REFUND_AMOUNT Сумма возмещения, что было возвращено клиенту при подтверждении транзакции в статусе Hold (в случае подтверждения суммы меньшей за начальную)
Контрольная подпись LMI_HASH Контрольная подпись формируется так же, как в «Форме оповещения о платеже»
Статус платежа State 0 - ожидается оплата
1 - платеж успешно принят
2 - платеж отменен (средства возвращены Клиенту)
3 - платеж обрабатывается
4 - платеж находится на проверке
6 - платеж в статусе Hold, ожидается подтверждение или отмена
7 - истек срок отведенный на оплату
8 - платеж неуспешный
Код ошибки ErrorCode Код ошибки
Описание ошибки ErrorMessageEN,ErrorMessageUK,ErrorMessageRU Описание ошибки
Refunds Список возвратов, которые проводились по данной транзакции
Номер заявки на возврат RefundId
Сумма возврата RefundAmount
Дата создания заявки Created
Статус заявки State 0 - новая заявка
1 - заявка обрабатывается
2 - возврат выполнен
Тип заявки Type 1 - быстрое возмещение - выполнено с помощью интерфейса возврата
2 - банковское возмещения - выполнено с помощью банковского перевода)

results matching ""

    No results matching ""