Гид по подключению к ecommerce liqpay com v1 2 9 by Petro Irkovich

STRICTLY CONFIDENTIAL

Центр электронного бизнеса

Руководство

по подключению к платежному шлюзу интернет-эквайринга ecommerce.liqpay.com версия 1.2.9

Для разработчиков интернет-магазина

NOTICE: The information furnished herein by PrivatBank is CONFIDENTIAL and is distributed to merchants for their exclusive use in operation with their e-commerce activity, and shell not be duplicated, published, or disclosed in whole or in part the prior written permission of PrivatBank

STRICTLY CONFIDENTIAL

Список последних изменений Дата

Версия

Описание изменений

06.03.2012

1.2.8

Добавлен тип платежа: Direct debit. Оплата для юрлиц с расчетного счета через Приват24

06.03.2012

1.2.8

Актуализирован п.7 Перечень кодов ответа авторизации

STRICTLY CONFIDENTIAL

Оглавление 1 Тип транзакции 3D-Secure purchase (покупка по протоколу 3D-Secure)..............................4 1.1 Запрос от торговца к серверу ............................................................................................4 1.2 Ответ от сервера торговцу ................................................................................................6 1.3 Пример программного кода...............................................................................................7 2 Тип транзакции Reversal (отмена покупки).............................................................................8 2.1 Запрос от торговца к серверу ............................................................................................8 2.2 Ответ от сервера торговцу ................................................................................................8 2.3 Пример программного кода...............................................................................................9 3 Тип транзакции Order status (статус покупки).......................................................................10 3.1 Запрос от торговца к серверу ..........................................................................................10 3.2 Ответ от сервера торговцу ..............................................................................................10 3.3 Пример программного кода.............................................................................................10 4 Тип транзакции Settlement (выписка по возмещениям)........................................................12 4.1 Запрос от торговца к серверу ..........................................................................................12 4.2 Ответ от сервера торговцу ..............................................................................................12 5 Direct debit. Оплата для юрлиц с расчетного счета через Приват24....................................15 6 Параметры тестового мерчанта...............................................................................................16 7 Перечень кодов ответа авторизации.......................................................................................17 8 Список изменений относительно протокола Sentry (для быстрого перехода на новый протокол ecommerce.liqpay.com).................................................................................................23

STRICTLY CONFIDENTIAL

1 Тип транзакции 3D-Secure purchase (покупка по протоколу 3DSecure) 1.1 Запрос от торговца к серверу Мерчант передает методом POST набор параметров на адрес: https://ecommerce.liqpay.com/ecommerce/CheckOutPagen (русский интерфейс) или https://ecommerce.liqpay.com/ecommerce/CheckOutPagen?lang=en (английский интерфейс) Название поля

обязательное Формат [S/N]XXX S – строка N – число XXX - длина

Описание поля

version

да

S10

1.0.0

acqid

да

Acquirer ID: 414963 – Украина 469584 – Россия

merid

да

S15

Номер вашего предприятия, выданный ПриватБанком при регистрации

orderid

да

S128

Уникальный номер заказа в вашей системе

merrespurl

да

S1024

URL, на который система должна перенаправлять клиента с результатом платежа. Этот URL является основным и обязательным каналом доставки ответа от банка.

merrespurl2

нет

S1024

URL, на который система должна отправлять ответ с результатом платежа напрямую, параллельно отправке через браузер клиента. Этот URL является дублирующим каналом доставки ответа от банка.

purchaseamt

да

N12

Окончательная сумма покупки, 12 знаков. Поле дополняется нулями слева до длины 12. Последние 2 знака в сумме означают копейки. Например 000000001020 = 10грн 20коп

purchasecurrency

да

Валюта покупки: 980 — украинская гривна 643 — российский рубль

purchaseamt2

нет

N12

Альтернативная сумма покупки, 12 знаков

purchasecurrency2

нет

Альтернативная валюта покупки 840 — доллар США 643 — российский рубль 978 — евро и т.д. в соответствии со стандартом ISO

purchasecurrencyexponent

да

2, экспонента суммы покупки (количество знаков, выделяемое под дробную часть)

signature

да

S28

Уникальная подпись транзакции. Результат функции SHA1.

orderdescription

да

S1000

Описание покупки в кодировке UTF-8

Поле signature формируется по следующему правилу:

STRICTLY CONFIDENTIAL signature =base64_encode (hexbin( SHA1(password+merid+acqid+orderid+purchaseamt+purchasecurrency+purchaseamt2+purchas ecurrency2+orderdescription))) где hexbin – функция перевода шестнадцатеричной строки в бинарную в случае, если результатом работы функции SHA1 в данном языке программирования есть шестнадцатеричная строка, например: «f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0 » base64_encode — функция перевода строки в формат base64 SHA1 – функция вычисления sha1 хеша на основании полученной строки

STRICTLY CONFIDENTIAL 1.2 Ответ от сервера торговцу Ответ от сервера будет передан на страницы merrespurl и merrespurl2 методом POST. На адрес merrespurl ответ будет передан через браузер посредством редиректа клиента. На адрес merrespurl2 ответ будет передан посредством прямого соединения сервер-сервер. Список параметров в ответе: Название поля

Формат [S/N]XXX S – строка N – число XXX - длина

Описание поля

acqid

Acquirer ID: 414963 – Украина 469584 – Россия

merid

S15

номер вашего предприятия, выданный ПриватБанком при регистрации

orderid

S128

уникальный номер заказа из запроса

signature

S28

основная подпись транзакции. Результат функции SHA1.

countrybin

страна банка-эмитента карты

countryip

страна провайдера, выдавшего клиенту IP-адрес

onus

0 – карта не ПриватБанка 1 – карта ПриватБанка

time

S19

время получения запроса от мерчанта в формате DD/MM/YYYY HH24:MI:SS , где DD – день MM – месяц YYYY – год HH24 – часы в формате от 00 до 23 MI – минуты SS - секунды

phone

N13

номер телефона, который клиент вводит для получения разового (OTP) пароля

countryphone

страна оператора мобильного телефона

S15

IP-адрес клиента

responsecode

код ответа

reasoncode

код причины отказа

reasoncodedesc

S50

описание ответа

paddedcardno

S16

последние 4 цифры номера карты

authcode

авторизационный код транзакции

eci

Electronic Commerce Indicator ECI=5 – транзакция с полной 3D-Secure аутентификацией, пароль клиента был проверен эмитентом ECI=6 – попытка проведения 3D-Secure транзакция, эмитент проверил валидность карты, но клиент не аутентифицирован по паролю, так как не вводил его по одной из причин: а) карта не активирована в сервисе 3D-Secure б) эмитент не поддерживает полную 3D-Secure аутентификацию ECI=7 – 3D-Secure аутентификация невозможна по одной из причин: а) сервер эмитента на данный момент недоступен б) карта бизнес, корпоративная или предоплаченная

signature2

S28

подпись для второстепенных параметров транзакции. Результат функции SHA1.

STRICTLY CONFIDENTIAL

Поле signature формируется по следующему правилу: signature =base64_encode (hexbin( SHA1(password+merid+acqid+orderid+responsecode+reasoncode+reasoncodedesc))) где hexbin – функция перевода шестнадцетиричной строки в бинарную в случае, если результатом работы функции SHA1 в данном языке программирования есть шестнадцетиричная строка, например: «f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0 » base64_encode — фунция перевода строки в формат base64 SHA1 – функция вычисления sha1 хеша на основании полученной строки Поле signature2 формируется по следующему правилу: signature2 =base64_encode (hexbin( SHA1(password+eci+ip+countryip+countrybin+onus+time+phone+сountryphone))) Все параметры передаются в кодировке UTF-8 Транзакция считается успешной, если ResponseCode=1 и ReasonCode=1 и параметр Signature является валидным.

1.3 Пример программного кода PHP:

<?php function hexbin($temp) { $data=""; $len = strlen($temp); for ($i=0;$i<$len;$i+=2) $data.=chr(hexdec(substr($temp,$i,2))); return $data; } $Version='1.0.0'; $Password='34074xhjqmwf8gs'; $MerID='I0110020'; $AcqID='414963'; $OrderID="test".time().rand(1,9999); $PurchaseAmt='000000000001'; $PurchaseCurrency='980'; $PurchaseCurrencyExponent='2'; $OrderDescription='Тестовый платеж'; $str = $Password.$MerID.$AcqID.$OrderID.$PurchaseAmt.$PurchaseCurrency.$OrderDescription; $Signature=sha1($str); $Signature=hexbin($Signature); $Signature = base64_encode($Signature); $post=' <form method="post" action="https://ecommerce.liqpay.com/ecommerce/CheckOutPagen"> <input name="version" value="'.$Version.'" type="hidden"> <input name="orderid" value="'.$OrderID.'" type="hidden"> <input name="merrespurl" value="https://ecommerce.liqpay.com/ecommerce/responsepage" type="hidden"> <input name="merid" value="'.$MerID.'" type="hidden"> <input name="acqid" value="'.$AcqID.'" type="hidden"> <input name="purchaseamt" value="'.$PurchaseAmt.'" type="hidden"> <input name="purchasecurrencyexponent" value="'.$PurchaseCurrencyExponent.'" type="hidden"> <input name="purchasecurrency" value="'.$PurchaseCurrency.'" type="hidden">

STRICTLY CONFIDENTIAL <input name="orderdescription" value="'.$OrderDescription.'" type="hidden"> <input name="signature" value="'.$Signature.'" type="hidden"> <input type="submit"> </form>'; ?>

Тип транзакции Reversal (отмена покупки)

2.1 Запрос от торговца к серверу Мерчант передает методом POST набор параметров на адрес: https://ecommerce.liqpay.com/reverse/reverse Название поля

обязательное Формат [S/N]XXX S – строка N – число XXX - длина

Описание поля

version

да

S10

1.0.0

merid

да

Номер вашего предприятия, выданный ПриватБанком при регистрации

acqid

да

Acquirer ID: 414963 – Украина 469584 – Россия

purchaseamt

да

N12

Окончательная сумма покупки, 12 знаков

purchasecurrency

да

Валюта покупки: 980 — украинская гривна 643 — российский рубль

orderid

да

S128

Номер заказа в вашей системе

reversal

да

purchasecurrencyexponent

да

2, экспонента суммы покупки (количество знаков, выделяемое под дробную часть)

signature

да

S28

Уникальная подпись транзакции. Результат функции SHA1() от строки: Password+MerID+AcqID+OrderID+PurchaseA mt+PurchaseCurrency+ Reversal

2.2 Ответ от сервера торговцу Ответом сервера будет строка формата, где параметры разделены знаком амперсанд: ResponseCode=1&ReasonCode=1&ReasonCodeDesc=Reversal+is+approved&MerID=I0DN0XSH&Ord erID=test000000001&AcqID=414963&Signature=s%2FYJ%2BexcCxjPNObObRNzheBxNnU%3D К каждому значению, полученному в ответе, нужно применить функцию Url decode. Например, строка Reversal+is+approved после декодирования примет вид Reversal is approved Параметр Signature присутствует во всех ответах и является результатом шифрования строки Password + MerID + AcqId + OrderID + ResponseCode + ReasonCode + ReasonCodeDesc NOTICE: The information furnished herein by PrivatBank is CONFIDENTIAL and is distributed to merchants for their exclusive use in operation with their e-commerce activity, and shell not be duplicated, published, or disclosed in whole or in part the prior written permission of PrivatBank

STRICTLY CONFIDENTIAL Транзакция считается успешной, если ResponseCode=1 и ReasonCode=1 и параметр Signature является валидным

2.3 Пример программного кода PHP:

<?php function hexbin($temp) { $data=""; $len = strlen($temp); for ($i=0;$i<$len;$i+=2) $data.=chr(hexdec(substr($temp,$i,2))); return $data; } $url="https://ecommerce.liqpay.com/reverse/reverse"; $Password='34074xhjqmwf8gs'; $MerID='I0110020'; $AcqID='414963'; $PurchaseCurrency='980'; $OrderID='test000000001'; $PurchaseAmt='000000000001'; $str = $Password.$MerID.$AcqID.$OrderID.$PurchaseAmt.$PurchaseCurrency."1"; $sign=sha1($str); $sign=hexbin($sign); $sign = base64_encode($sign); $post='reversal=1&version=1.0.0&orderid='.urlencode($OrderID).'&purchaseamt='. $PurchaseAmt.'&purchasecurrencyexponent=2&merid='.$MerID.'&acqid=414963&purchasecurrency='. $PurchaseCurrency.'&signature='.urlencode($sign); $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST ,1); curl_setopt($ch, CURLOPT_POSTFIELDS ,$post); curl_setopt($ch, CURLOPT_FOLLOWLOCATION ,0); curl_setopt($ch, CURLOPT_HEADER ,0); curl_setopt($ch, CURLOPT_COOKIEFILE, $user_cookie_file); curl_setopt($ch, CURLOPT_COOKIEJAR, $user_cookie_file); curl_setopt($ch, CURLOPT_RETURNTRANSFER ,1); curl_setopt( $ch , CURLOPT_SSL_VERIFYPEER , false ); curl_setopt( $ch , CURLOPT_SSL_VERIFYHOST , false ); $resp = curl_exec($ch); echo $resp; ?>

STRICTLY CONFIDENTIAL

Тип транзакции Order status (статус покупки)

3.1

Запрос от торговца к серверу

Мерчант передает методом POST набор параметров на адрес: https://ecommerce.liqpay.com/ecomapi/action Название поля

обязательное Формат [S/N]XXX S – строка N – число XXX - длина

Описание поля

merid

да

S15

Номер вашего предприятия, выданный ПриватБанком при регистрации

orderid

да

S128

Номер заказа в вашей системе

action

да

S50

status

signature

да

s28

Уникальная подпись транзакции. Результат функции SHA1() от строки: Password+MerID+OrderID+Action

3.2

Ответ от сервера торговцу

Ответом сервера будет строка формата, где параметры разделены знаком амперсанд: ResponseCode=3&ReasonCode=11&ReasonCodeDesc=Invalid+signature&Signature=bH85BomKOunP XvgSdmIjBzgRV1Y%3d &MerID=100000000918471&OrderID=test123456789 К каждому значению, полученному в ответе, нужно применить функцию Url decode. Например, строка Invalid+signature после декодирования примет вид Invalid signature Если во время обработки запроса возникла ошибка, ответ будет иметь следующий ответ: Error=Invalid parameter Параметр Signature присутствует во всех ответах и является результатом шифрования строки Password + MerID + OrderID + ResponseCode + ReasonCode + ReasonCodeDesc + Action Транзакция считается успешной, если ResponseCode=1 и ReasonCode=1 и параметр Signature является валидным. Если ResponseCode=9 и ReasonCode=9, транзакция считается еще не завершенной. В таком случае необходимо повторять запросы статуса (например с периодичностью 1 минута) на протяжении 15 мин, пока ответ не изменится. Если по истечению 15 мин транзакция по-прежнему не завершена ,необходимо прекратить последующие запросы статуса для этой транзакции и считать ее отклоненной.

3.3

Пример программного кода

PHP:

<?php function hexbin($temp) {

STRICTLY CONFIDENTIAL $data=""; $len = strlen($temp); for ($i=0;$i<$len;$i+=2) $data.=chr(hexdec(substr($temp,$i,2))); return $data; } $url="https://ecommerce.liqpay.com/ecomapi/action"; $Password='34074xhjqmwf8gs'; $MerID='I0110020'; $OrderID='test000000001'; $str = $Password.$MerID.$OrderID.'status'; $sign=sha1($str); $sign=hexbin($sign); $sign = base64_encode($sign); $post='orderid='.urlencode($OrderID).'&merid='.$MerID.'&action=status&signature='.urlencode($sign); $time_start = microtime(true); $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST ,1); curl_setopt($ch, CURLOPT_POSTFIELDS ,$post); curl_setopt($ch, CURLOPT_FOLLOWLOCATION ,0); curl_setopt($ch, CURLOPT_HEADER ,0); curl_setopt($ch, CURLOPT_COOKIEFILE, $user_cookie_file); curl_setopt($ch, CURLOPT_COOKIEJAR, $user_cookie_file); curl_setopt($ch, CURLOPT_RETURNTRANSFER ,1); curl_setopt( $ch , CURLOPT_SSL_VERIFYPEER , false ); curl_setopt( $ch , CURLOPT_SSL_VERIFYHOST , false ); $resp = curl_exec($ch); echo $resp; ?>

STRICTLY CONFIDENTIAL

Тип транзакции Settlement (выписка по возмещениям)

4.1

Запрос от торговца к серверу

Мерчант передает методом POST набор параметров на адрес: https://eapi.privatbank.ua/settlement/xml Название поля

обязательное Формат [S/N]XXX S – строка N – число XXX - длина

Описание поля

merchid

да

S15

Номер вашего предприятия, выданный ПриватБанком при регистрации

date

да

S10

Дата возмещения в формате YYYY-MM-DD, например 2011-11-14 — 14 Ноября 2011 г.

signature

да

S28

Уникальная подпись транзакции. Результат функции SHA1() от строки: Password+MerchID+Date

4.2

Ответ от сервера торговцу

Ответом сервера будет xml вида: <?xml version="1.0" encoding="UTF-8"?><xml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://eapi.privatbank.ua/settlement/resources/settlement-schema.xsd"> <settlement orderid="test_2917_10"> <timestamp>2011-11-11 12:24:28</timestamp> <sum>0.5</sum> <comission>0.1</comission> <currency>UAH</currency> <responsecode>1</responsecode> <reasoncode>1</reasoncode> <reasoncodedescr>Одобрено</reasoncodedescr> <merchdate>2011-11-14</merchdate> <cardnumber>4***********6377</cardnumber> <typecarddesc>Приватбанк</typecarddesc> <typetransdesc>Транзакция авторизации</typetransdesc> <phone>380682520302</phone> <merchid>I0110020</merchid> <merchname>Testing merchant</merchname> <odbref>COA1B1111GFP90</odbref> <authcode>582564</authcode> <orderdescr>Тестовая оплата</orderdescr> </settlement> <settlement orderid="test_2917_11"> <timestamp>2011-11-11 12:25:28</timestamp> <sum>1.1</sum> <comission>0.2</comission> <currency>UAH</currency> <responsecode>1</responsecode> <reasoncode>1</reasoncode> <reasoncodedescr>Одобрено</reasoncodedescr> <merchdate>2011-11-14</merchdate>

STRICTLY CONFIDENTIAL <cardnumber>4***********1243</cardnumber> <typecarddesc>Приватбанк</typecarddesc> <typetransdesc>Транзакция авторизации</typetransdesc> <phone>380661234567</phone> <merchid>I0110020</merchid> <merchname>Testing merchant</merchname> <odbref>COA1B1111GFP90</odbref> <authcode>877688</authcode> <orderdescr>Тестовая оплата</orderdescr> </settlement> </xml>

XML схема находится по адрессу: https://eapi.privatbank.ua/settlement/resources/settlement-schema.xsd

STRICTLY CONFIDENTIAL

Direct debit. Оплата для юрлиц с расчетного счета через Приват24

Мерчант передает методом POST набор параметров на адрес:

https://ecommerce.liqpay.com:443/ecommerce/ecomToP24 список передаваемых и возвращаемых параметров идентичны п. 1. Тип транзакции 3D-Secure purchase (покупка по протоколу 3D-Secure)

STRICTLY CONFIDENTIAL

Параметры тестового мерчанта

Параметры тестового мерчанта (только для тестов, транзакции не списываются с карты и не возмещаются): merchantid, пароль на транзакци

Украина I0110020, 34074xhjqmwf8gs Россия I0MO0A98, i35361y272ywp5l

purchasecurrency

Валюта покупки: 980 — украинская гривна 643 — российский рубль

purchaseamt

000000000100

orderid TEST_<Название Мерчанта>_<Дата>_<время>_<произвольный номер> Помните, что каждый Order ID должен быть уникальным!

Средства на Вашей карте, будут заблокированы, но по истечении месяца со дня теста, сумма тестовой транзакции будет возвращена Вам на карту.

Перечень кодов ответа авторизации

responsecode

reasoncode (Ответ ecommerce)

reasoncodedesc (Описание причины ответа)

Approved, balances available

050

Transaction declined by issuer

Описание

Пояснения для администратора магазина

Одобрено

Платеж проведен.

успешно

Финансовую транзакцию выполнить не удалось

Отказ эмитента транзакции.

по

Expired card

Карта клиента просрочена

Нормальный статус отказа, который возвращает банкэмитент.

055

Invalid transaction

Транзакция имеет некорректные атрибуты или данная операция на данном терминале не разрешена

Отказ эмитента транзакции.

057

Lost card

058

Invalid

051

stolen card

Карта клиента имеет статус «потеряна» или «украдена» Неверный номер карты

по

Нормальный статус отказа, который возвращает банкэмитент. Отказ эмитента по

Рекомендуемый текст сообщения для клиента

(на русском языке)

(на английском языке)

Ваш Платеж завершен!

успешно

Your payment successful!

Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент. Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент. Проверьте возможные причины: неверный ввод реквизитов Вашей карты, недостаточно средств на счете или по Вашей карте не разрешены расчеты в Интернет

Payment is declined. Please, contact Your Issuing Bank.

Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент.

Payment is declined. Please, contact Your Issuing Bank.

Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент.

Payment is declined. Please, contact Your Issuing Bank.

Платеж

Payment

отклонен.

Payment is declined. Please, contact Your Issuing Bank. In addition, please check possible decline reasons: incorrect card details entrance, Not sufficient funds, tranzactions in Internet are not permitted to card

declined.

responsecode

reasoncode (Ответ ecommerce)

reasoncodedesc (Описание причины ответа)

Пояснения для администратора магазина

Описание

status 2

059

Restricted status

060

Account found

074

Unable authorize

транзакции.

not

Карта клиента ограниченные возможности

Отказ эмитента транзакции.

по

Не найден вендор с указанным номером счета

Нормальный статус отказа, который возвращает банкэмитент.

Невозможно авторизовать

Отказ эмитента транзакции.

076

Insufficient funds

На счете клиента хватает средств

095

Amount maximum

Превышение сумме

over

имеет

лимита

не

по

Нормальный статус отказа, который возвращает банкэмитент.

Рекомендуемый текст сообщения для клиента

(на русском языке)

(на английском языке)

Пожалуйста, обратитесь в Ваш банк-эмитент. Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент. Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент. Проверьте возможные причины: неверный ввод реквизитов Вашей карты, недостаточно средств на счете или по Вашей карте не разрешены расчеты в Интернет

Please, contact Your Issuing Bank. Payment is declined. Please, contact Your Issuing Bank.

Payment is declined. Please, contact Your Issuing Bank.

Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент.

Payment is declined. Please, contact Your Issuing Bank.

responsecode

reasoncode (Ответ ecommerce)

reasoncodedesc (Описание причины ответа)

Пояснения для администратора магазина

Описание

Неправильный клиента

счет

200

Invalid account

205

Invalid advance amount

Некорректная сумма

210

Bad CAVV

Неверное значение CAVV

211

Bad CVV2

Неверное значение CVV2

800

Format error

Ошибка формата

811

System error

Системная ошибка

Нормальный статус отказа, который возвращает банкэмитент.

Нормальный статус отказа, который возвращает банкэмитент. Нормальный статус отказа, который возвращает банкэмитент.

Нормальный статус отказа, который возвращает банкэмитент.

Ошибка формата авторизационного сообщения. Ошибка

Рекомендуемый текст сообщения для клиента

(на русском языке)

(на английском языке)

Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент. Проверьте возможные причины: неверный ввод реквизитов Вашей карты, недостаточно средств на счете или по Вашей карте не разрешены расчеты в Интернет

Платеж отклонен. По Вашей карте запрещена транзакция на данную сумму.

Payment is declined. Please, contact Your Issuing Bank.

Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент.

Payment is declined. Please, contact Your Issuing Bank.

Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент. Платеж отклонен.

Payment is declined. Please, contact Your Issuing Bank. Payment is declined.

responsecode

reasoncode (Ответ ecommerce)

reasoncodedesc (Описание причины ответа)

Пояснения для администратора магазина

Описание

авторизационного сообщения .

901

2900

Expired Card

Bin Block

Карта просрочена, требуется захват карты.

Нормальный статус отказа, который возвращает банкэмитент.

Transaction declined

Карта клиента внесена в стоп лист.

Invalid Signature

Не правильная мерчанта.

2903

Card Usage Limit has bean reached

Превышен лимит попыток по данной карте

2905

Antifraud checkup failed

подпись

Номер телефона не привязан к данной карте

Ошибка появляется в случае, когда подпись транзакции сформирована неверно Превышено количество использования карты (суточное). Введенные данные клиента не совпадают с базой банка (только карты ПриватБанка).

Рекомендуемый текст сообщения для клиента

(на русском языке)

(на английском языке)

Пожалуйста, обратитесь в Ваш банк-эмитент. Платеж отклонен. Пожалуйста, обратитесь в Ваш банк-эмитент. Проверьте возможные причины: неверный ввод реквизитов Вашей карты, недостаточно средств на счете или по Вашей карте не разрешены расчеты в Интернет

Please, contact Issuing Bank.

Your

Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина.

Transaction is declined. Please, contact Your Online-shop administrator.

Проведение платежей временно недоступно, попробуйте позже

Sorry. processing unavailable. again later.

Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина. Пожалуйста, ознакомьтесь с инструкцией по подключению своей карты: https://docs.google.com/a/pri vatbank.ua/document/d/1Ux JeMAi3skaKsYyIx_CqxGW dspZYjEkz2Ey5yHoJk40/ed it

Transaction temporarily Please try

Transaction is declined. Please, contact Your Online-shop administrator. Please reffer https://docs.google.com/a/p rivatbank.ua/document/d/1 UxJeMAi3skaKsYyIx_Cqx GWdspZYjEkz2Ey5yHoJk 40/edit

responsecode

reasoncode (Ответ ecommerce)

reasoncodedesc (Описание причины ответа)

Пояснения для администратора магазина

Описание

2907

Card country does not match phone country

Страна эмитента не совпадает со страной мобильного оператора

2910

Transaction declined by antifraud ettings (EKB)

Транзакция отклонена по настройкам безопасности (EKB).

2913

Cardholder not allowed

Платеж отклонен соображениям безопасности.

по

Платеж отклонен соображениям безопасности.

по

2914

Phone Usage Limit has bean reached

2915

Duplicate Order ID Not Allowed

Дублирующий платежа

2916

Card country do not match IP country

Страна эмитента не совпадает со страной провайдера

2917

Amount for test merchant must be less then 2 UAH

Сумма транзакции по тестовому мерчанту не должна превышать 2 грн.

2918

Card country not allowed

Платежи для данной страны запрещены

bin

orderid

Сочетание страны карты и телефона не разрешены при авторизации. Клиент внесен в список неблагонадежных клиентов. Карта клиента поддерживается мерчанте

не в

Достигнуто суточное количество использования телефона Задвоенный Order ID (код заказа, передаваемый со стороны Магазина, должен быть уникальным) Сочетание страны карты и провайдера не разрешены при авторизации. Не правильно введен OTP пароль.Сумма транзакции по тестовому мерчанту не должна превышать 2 грн. Платежи для данной страны запрещены

Рекомендуемый текст сообщения для клиента

(на русском языке)

(на английском языке)

Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина. Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина. Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина. Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина.

Transaction is declined. Please, contact Your Online-shop administrator. Transaction is declined. Please, contact Your Online-shop administrator. Transaction is declined. Please, contact Your Online-shop administrator. Transaction is declined. Please, contact Your Online-shop administrator.

Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина.

Transaction is declined. Please, contact Your Online-shop administrator.

Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина.

Transaction is declined. Please, contact Your Online-shop administrator.

Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина.

Transaction is declined. Please, contact Your Online-shop administrator.

Транзакция Обратитесь

Transaction is declined. Please, contact Your

отклонена. к

responsecode

reasoncode (Ответ ecommerce)

reasoncodedesc (Описание причины ответа)

2919

Card blocked

Cardholder canceled request

General error during processing

country

the

Пояснения для администратора магазина

Описание

Платежи для данной страны запрещены Пользователь платеж Общая ошибка.

отменил

Страна карты клиента не поддерживается в мерчанте Пользователь нажал кнопку «Отмена»/«Cancel» Непредвиденная ошибка. Обратитесть в банк для расследования причин

Рекомендуемый текст сообщения для клиента

(на русском языке)

(на английском языке)

администратору Вашего Интернет-магазина. Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина.

Online-shop administrator. Transaction is declined. Please, contact Your Online-shop administrator.

Транзакция отменена

Transaction is canceled

Транзакция отклонена. Обратитесь к администратору Вашего Интернет-магазина.

Transaction is declined. Please, contact Your Online-shop administrator.

8 Список изменений относительно протокола Sentry (для быстрого перехода на новый протокол ecommerce.liqpay.com) 1. Параметр captureflag не используется. Транзакции всегда списываются в автоматическом режиме. Есть возможность настроить отложенное списание. 2. Параметр signaturemethod не используется. Алгоритм всегда SHA1 3. Добавлен обязательный параметр orderdescription. Строка подписи изменилась соответственно 4. Параметр merrespurl может быть http:// (не обязательно https://) 5. Все имена параметров в ответе от сервера банка к мерчанту на страницы merrespurl и merrespurl2 передаются в нижнем регистре 6. Изменен алгоритм формирования сигнатуры в ответе (см. п. 1.2) 7. Ответ на запрос статуса транзакции responsecode=9, reasoncode=9 означает, что транзакция еще в процессе обработки и может изменить свой статус (см. п. 3.2) По техническим вопросам:

Козырь Юрий Контакты: Телефон: +38 (056) 716 35 19 Skype Name: shamani21 e-mail: Jurij.Kozyr@privatbank.ua

(регистрация номера Мерчанта, вопросы подключения)

Обратите внимание, что перед предоставлением консультации, Вас могут запросить информацию о статусе подписания Вашего договора Интернет-эквайринга с Банком, а также информацию о Вашей компании. Либо направляйте вопросы по e-mail: e-commerce@privatbank.ua или задавайте в Skype: наш логин e.privatbank.ua