3.10. /api/v2/status
Введение
Получение статуса транзакции осуществляется через запрос методом HTTPS POST на указанный ниже URL с использованием указанных параметров. Для аутентификации запроса используется SHA-1. См. Статусы транзакций.
API URL
Примечание
Интеграционная среда |
Производственная среда |
|---|---|
https://sandbox.payneteasy.ru/paynet/api/v2/status/ENDPOINTID |
https://gate.payneteasy.ru/paynet/api/v2/status/ENDPOINTID |
https://sandbox.payneteasy.ru/paynet/api/v2/status/group/ENDPOINTGROUPID |
https://gate.payneteasy.ru/paynet/api/v2/status/group/ENDPOINTGROUPID |
Параметры запроса
Примечание
Название параметра |
Описание параметра |
Необходимость |
|---|---|---|
login |
Логин Присоединяющейся Стороны в Платёжном Шлюзе. |
Обязательно |
client_orderid |
Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. |
Обязательно |
orderid |
Идентификатор заказа на стороне Платёжного Шлюза. |
Условно |
by-request-sn |
Серийный номер, присвоенный Payneteasy конкретному API-запросу. Если параметр присутствует в запросе статуса, ответ на запрос будет возвращён только для той стадии транзакции, на которой она находилась в момент совершения запроса с таким серийным номером. Параметр может быть включён в запрос для получения такой стадии в специальных случаях. Для получения наиболее актуального статуса транзакции, не следует включать этот параметр в запрос. |
Опционально |
control |
Контрольная сумма, сгенерированная SHA-1. Строка для подписи представляет собой объединение следующих параметров:
1. Параметр запроса: login,
2. Параметр запроса: client_orderid,
3. Параметр запроса: orderid,
4. merchant_control (Контрольный ключ Присоединяющейся Стороны в Платёжном Шлюзе Payneteasy).
|
Обязательно |
Параметры ответа
Примечание
Параметры ответа на запрос статуса |
Описание параметра |
|---|---|
type |
Тип ответа. Может быть status-response. |
status |
Для подпробностей см. Список статусов. |
amount |
Фактическая сумма транзакции. Данное значение может быть изменено в ходе транзакции. |
currency |
Валюта, в которой взимается транзакция (трехбуквенный код валюты). Примеры допустимых значений параметров: USD для доллара США EUR для евро. |
paynet-order-id |
Идентификатор заказа на стороне Платёжного Шлюза. |
merchant-order-id |
Идентификатор заказа Присоединяющейся Стороны. |
phone |
Полный международный номер телефона плательщика, включая код страны. |
html |
HTML-код формы авторизации 3DS, закодированный в формате MIME application/x-www-form-urlencoded. Торговец должен декодировать этот параметр перед показом формы Плательщику. Система gate.payneteasy.ru возвращает следующие параметры ответа, когда получает форму авторизации 3DS от Банка-эмитента. Он содержит HTML-код формы авторизации, который должен быть передан без каких-либо изменений в браузер клиента. Этот параметр существует и имеет значение только тогда, когда HTML перенаправления уже доступен. Для не-3DS этого никогда не происходит. Для 3DS HTML имеет значение через некоторое короткое время после начала обработки. |
redirect-to |
Для авторизации 3DS Торговец может перенаправить плательщика на URL, указанный в данном параметре, вместо отображения страницы, указанной в параметре html. Параметр redirect-to возвращается только в том случае, если возвращается параметр html. Для перенаправления Торговец должен использовать метод HTTP GET. Данный параметр должен использоваться для работы с 3DS 2.0. |
serial-number |
Уникальный номер, присваиваемый сервером gate.payneteasy.ru конкретному запросу от присоединяющейся стороны. |
last-four-digits |
Последние четыре цифры номера банковской карты Плательщика. |
dest-last-four-digits |
Последние четыре цифры номера кредитной карты клиента. Относится только к транзакциям перевода. |
bin |
BIN банка или номер банковской карты плательщика. |
card-type |
Тип банковской карты Плательщика (VISA, MASTERCARD и т.д.). |
gate-partial-reversal |
Шлюз обработки поддерживает частичный возврат (включено или выключено). |
gate-partial-capture |
Шлюз обработки поддерживает частичное списание (включено или выключено). |
transaction-type |
Тип тпанзакции (продажа, возврат, списание, преавторизация). |
processor-rrn |
Регистрационный номер банка-получателя. |
processor-tx-id |
Идентификатор транзакции эквайера. |
receipt-id |
Электронная ссылка на квитанцию https://gate.payneteasy.ru/paynet/view-receipt/ENDPOINTID/receipt-id/. |
name |
Имя плательщика |
card-ref-id |
Ссылочный идентификатор, используемый в последующих повторяющихся платежах. Актуально только в том случае, если card-ref-id был создан для первоначальной транзакции. |
cardholder-name |
Имя владельца карты. |
card-exp-month |
Месяц истечения срока действия банковской карты. |
card-exp-year |
Год истечения срока действия банковской карты. |
card-hash-id |
Уникальный идентификатор карты для использования в программах лояльности или проверках на мошенничество. |
card-country-alpha-three-code |
Трехбуквенный код страны эмитента карты отправителя. Подробности см. в Коды стран и штатов. |
destination-card-country-alpha-three-code |
Трехбуквенный код страны эмитента карты получателя. Подробности см. в Коды стран и штатов. |
dest-bin |
Банковский BIN кредитной карты клиента. |
dest-card-type |
Тип кредитной карты клиента (VISA, MASTERCARD и т.д.). |
dest-bank-name |
Наименование банка по BIN карты клиента. |
destination-hash-id |
Уникальный идентификатор карты для использования в программах лояльности или проверках на мошенничество. Актуально только для транзакций переводов. |
destination-card-hash-id |
Уникальный идентификатор карты для использования в программах лояльности или проверках на мошенничество. |
first-name |
Имя плательщика. |
last-name |
Фамилия плательщика. |
Электронная почта плательщика. |
|
country * |
Страна плательщика (двухбуквенный код страны). Список допустимых кодов стран см. в Коды стран и штатов. |
state * |
Штат плательщика. Список допустимых кодов штатов см. в Коды стран и штатов. Обязательно для США, Канады и Австралии. |
city * |
Город плательщика. |
zip_code * |
Почтовый индекс плательщика. |
address1 * |
Адрес Плательщика 1. |
purpose |
Место назначения платежа. Это полезно для продавцов, которые позволяют своим плательщикам пополнять свои счета с помощью банковских карт (счета мобильных телефонов, игровые счета и т. д.). Примеры значений: +9999999999; mail@example.com и т. д. Данное значение может использоваться системой мониторинга мошенничества. |
bank-name |
Наименование банка по BIN карты плательщика. |
terminal-id |
Идентификатор терминала эквайера, который будет указан в чеке. |
paynet-processing-date |
Дата обработки транзакции эквайером. |
approval-code |
Код одобрения банка. |
order-stage |
Текущая стадия обработки транзакции. Подробности см. в Стадии транзакции. |
total-reversal-amount |
Сумма последнего обработанного возврата. Актуально только для транзакций возврата. |
reversal-amount |
Сумма последнего обработанного возврата. Актуально только для транзакций возврата. |
auth-response-code |
Код ответа, используемый в протоколе Iso8583. Возвращается только в определенных случаях. |
acquirer-processing-date |
Дата обработки транзакции эквайером. |
processor-auth-credit-code |
Код одобрения кредита. Возвращается только в определенных случаях. |
processor-credit-rrn |
Номер ссылки извлечения для кредитной транзакции. |
processor-credit-arn |
Ссылочный номер карты-эквайера для кредитной транзакции. |
processor-debit-arn |
Ссылочный номер карты-эквайера для дебитной транзакции. |
loyalty-balance |
Текущий баланс бонусов программы лояльности для текущей операции. если доступно. |
loyalty-message |
Сообщение от программы лояльности. если доступно. |
loyalty-bonus |
Бонусная стоимость программы лояльности для текущей операции если доступно. |
loyalty-program |
Название программы лояльности для текущей операции если доступно. |
descriptor |
Банковский идентификатор получателя платежа. |
original-gate-descriptor |
Дескриптор, который устанавливается на уровне шлюза в системе. |
error-message |
Если статус declined, error, filtered этот параметр содержит причину отказа. |
error-code |
Код ошибки для транзакций в статусе declined, error, filtered. |
by-request-sn |
Серийный номер, назначенный конкретному запросу gate.payneteasy.ru. Если это поле существует в запросе статуса, ответ статуса возвращается для этого конкретного запроса. |
verified-3d-status |
Подробную информацию см. Список статусов 3D Secure. |
verified-rsc-status |
Возвращается, если была выполнена проверка случайной суммы. См. Alternative cardholder authentication |
eci |
Индикатор электронной коммерции (Visa). |
ips-src-payment-product-code |
Код карты, установленный международной финансовой службой (Visa/Mastercard). |
ips-src-payment-product-name |
Расшифрованный код для карты, установленный международной финансовой службой (Visa/Mastercard). |
ips-src-payment-type-code |
Код типа карты, установленный международной финансовой службой (Visa/Mastercard). |
ips-src-payment-type-name |
Расшифрованный код типа карты, установленный международной финансовой службой (Visa/Mastercard). |
merchantdata |
Если параметр merchant_data и его значение указаны в первоначальном запросе, они будут включены в ответ о статусе. |
initial-amount |
Сумма, установленная при инициировании транзакции, без каких-либо сборов или комиссий. Это значение не может измениться в ходе транзакции. |
seller-commission |
Общая комиссия за обработанную транзакцию. Это необязательный параметр. Пожалуйста, свяжитесь с вашим менеджером в Payneteasy, если вы хотите его получить. |
acquirer-commission |
Комиссия эквайера за обработанную транзакцию. Это необязательный параметр. Обратитесь к своему менеджеру в Payneteasy, если хотите его получить. |
motivational-message |
Это необязательное сообщение, которое содержит расширенную информацию о причине отклонения транзакции. |
transaction-date |
Дата присвоения окончательного статуса транзакции. |
orig-amount |
Содержит исходную сумму запроса, если она была преобразована на вспомогательном терминале в интеграции с параллельной формой. Актуально только для транзакций Payment Cashier. |
orig-currency |
Содержит исходную валюту запроса, если она была преобразована на вспомогательном терминале в интеграции с параллельной формой. Актуально только для транзакций Payment Cashier. |
Параметры ответа на запрос статуса PaReqForm
Название |
Описание параметра |
|---|---|
tds-pareq-form-pareq |
Данные ACS 3DS PaReq, полученные Присоединяющейся Стороной. |
tds-pareq-form-acs-url |
ACS URL для перенаправления Плательщика в рамках сценария аутентификации 3DS 1.0.2. |
Параметры ответа на запрос статуса CReqForm
Название |
Описание параметра |
|---|---|
tds-creq-form-creq |
Сообщение CReq инициирует взаимодействие держателя карты в полной проверке 3DS (Challenge) и используется для передачи аутентификационных данных. Формируется сервером 3DS торговцем через браузер держателя карты в адрес ACS URL. |
tds-creq-form-acs-url |
ACS URL для перенаправления Плательщика для полной проверки 3DS (Challenge). |
Параметры ответа на запрос статуса MethodUrlFrame
Название |
Описание параметра |
|---|---|
tds-method-url-frame-3ds-server-trans-id |
Универсально уникальный идентификатор транзакции, присвоенный сервером 3DS для идентификации одной транзакции. |
tds-method-url-frame-3ds-method-url |
URL 3DS Метода используется в форме iframe, передающейся от торговца к Плательщику. |
Правила создания HTML формы.
Пример запроса
POST /paynet/api/v2/status/37211 HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.77.0
Accept: */*
Content-Length: 99
Content-Type: application/x-www-form-urlencoded
Connection: close
login=TestYujik
&client_orderid=123
&orderid=6863082
&control=647f0581bbceb804a73e98d9ea7e78640a75bf1c
Пример успешного ответа
HTTP/1.1 200 OK
Server: server
Date: Mon, 12 Sep 2022 09:02:42 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
X-Cached: EXPIRED
Content-Length: 1275
type=status-response
&serial-number=00000000-0000-0000-0000-000002ddb056
&merchant-order-id=123
&processor-tx-id=PNTEST-6863082
&paynet-order-id=6863082
&status=approved
&amount=555.00
¤cy=USD
&descriptor=XXXX
&original-gate-descriptor=XXXX
&gate-partial-reversal=enabled
&gate-partial-capture=enabled
&transaction-type=sale
&receipt-id=081c0c0b-0dd1-3083-b251-e624ac8e57b4
&name=CARD+HOLDER
&cardholder-name=CARD+HOLDER
&card-exp-month=12
&card-exp-year=2099
&email=john.smith%40gmail.com
&last-name=Smith
&first-name=John
&processor-rrn=0225083062885
&approval-code=979249
&order-stage=sale_approved
&merchantdata=VIP+customer
&last-four-digits=2063
&bin=410002
&card-type=VISA
&phone=12063582043
&bank-name=BANCO+ITAUCARD+S.A.
&auth-response-code=00
&terminal-id=12345678
&paynet-processing-date=2022-09-07+13%3A22%3A39+MSK
&acquirer-processing-date=2022-09-07+13%3A22%3A39+MSK
&processor-auth-credit-code=206551
&card-hash-id=2639503
&card-country-alpha-three-code=BRA
&verified-3d-status=NOT_AUTHENTICATED
&processor-credit-rrn=0225060914211
&processor-credit-arn=809124106
&processor-debit-arn=601904020
&purpose=user_account1
&ips-src-payment-product-code=F
&ips-src-payment-product-name=Visa+Classic
&ips-src-payment-type-code=Credit
&ips-src-payment-type-name=VISA+Credit
&initial-amount=555.00
Пример неуспешного ответа
HTTP/1.1 200 OK
Server: server
Date: Mon, 12 Sep 2022 09:08:02 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
X-Cached: MISS
Content-Length: 137
type=validation-error
&serial-number=00000000-0000-0000-0000-000002ddb057
&error-message=End+point+with+id+372118+not+found
&error-code=3
Коллекция Postman
Конструктор запросов
| String to sign |
|---|
| Signature |
|---|
|