Интерфейс проведения оплаты через ApplePay
Этот XML-интерфейс позволяет выполнить оплату через ApplePay
Action - https://card.paysoft.solutions/api/xml/applepay
Method - POST
Формат XML-запроса:
<Command>
<LMI_MERCHANT_ID></LMI_MERCHANT_ID>
<LMI_PAYMENT_NO></LMI_PAYMENT_NO>
<LMI_PAYMENT_AMOUNT></LMI_PAYMENT_AMOUNT>
<LMI_PAYMENT_DESC></LMI_PAYMENT_DESC>
<LMI_CARDNUMBER></LMI_CARDNUMBER>
<LMI_EXPIRE_YEAR></LMI_EXPIRE_YEAR>
<LMI_EXPIRE_MONTH></LMI_EXPIRE_MONTH>
<LMI_CAVV></LMI_CAVV>
<LMI_PAYER_IP></LMI_PAYER_IP>
<LMI_MERCHANT_URL></LMI_MERCHANT_URL>
<LMI_HASH></LMI_HASH>
</Command>
| Название | XML параметр | Обязательный? | Описание |
|---|---|---|---|
| Идентификатор Продавца | LMI_MERCHANT_ID | Да | Идентификатор торговой точки, на который будет принят платеж. Идентификатор Продавец может получить в Кабинете. |
| Сумма платежа | LMI_PAYMENT_AMOUNT | Да | Сумма платежа, которую Продавец желает получить от Клиента. Сумма должна быть больше нуля, дробная часть отделяется точкой. |
| Внутренний номер заказа в системе учета Продавца | LMI_PAYMENT_NO | Нет | В этом поле Продавец определяет номер заказа в соответствии со своей системой учета. Несмотря на то, что параметр не является обязательным, рекомендуется всегда задавать его, поскольку он нужен для корректной работы других интерфейсов. Желательно использовать уникальный номер для каждого платежа. Номер может содержать буквы английского алфавита, цифры и знак дефиса «-». Максимальная длина - 64 символов. |
| Назначение платежа | LMI_PAYMENT_DESC | Да | Описание товара / работы / услуги, которые оплачиваются. Максимальная длина - 255 символов. Кодирование - UTF8. |
| Контрольная подпись | LMI_HASH | Да | Контрольная подпись запроса формируется путем шифрования исходного текста XML-запроса с пустым значением LMI_HASH и секретного ключа SecretKey с помощью алгоритма, указанного в Кабинете продавца. Полученная подпись передается в теге LMI_HASH. Рекомендованным алгоритмом шифрования есть SHA256. |
| applicationPrimaryAccountNumber | LMI_CARDNUMBER | Да | applicationPrimaryAccountNumber |
| Срок действия карты, год | LMI_EXPIRE_YEAR | Да | Год из параметра applicationExpirationDate, 2 цифры (YY из YYMMDD) |
| Срок действия карты, месяц | LMI_EXPIRE_MONTH | Да | Месяц из параметр Год из параметра applicationExpirationDate, 2 цифры (MM из YYMMDD) |
| onlinePaymentCryptogram | LMI_CAVV | Да | Параметр onlinePaymentCryptogram |
| IP плательщика | LMI_PAYER_IP | Нет | IP адрес плательщика |
| URL сайта | LMI_MERCHANT_URL | Нет | URL сайта, на котором производился платеж |
Формат XML-ответа:
<Response>
<Retval></Retval>
<Retdesc></Retdesc>
<Retdata>
<retval></retval>
<LMI_SYS_PAYMENT_ID></LMI_SYS_PAYMENT_ID>
<ErrorMessage></ErrorMessage>
<code></code>
</Retdata>
</Response>
| Название | Поле в XML | Описание |
|---|---|---|
| Код выполнения запроса | Retval | 0 - успешное выполнение команды; 1 - Некорректная подпись (HASH); 2 – некорректные параметры; 3 – Карта данного типа не может быть спроцессирована; 4,5,6,7 – внутренняя ошибка; 8 - в процессе віполнения |
| Описание кода виполнения | Retdesc | |
| Состояние платежа | Retdata/retval | списаны ли средства с карты (значения: success – списаны, fail – не списаны, process – транзакция в процессе выполнения). |
| Внутренний номер платежа в системе PaySoft | Retdata/LMI_SYS_PAYMENT_ID | Номер принятого платежа в системе PaySoft. |
| Сообщение об ошибке | Retdata/ErrorMessage | рекомендуемый текст для отображения клиенту в случае Retdata/retval = fail |
Коды ошибок
| Код | Текст рекомендуемый для отображения | Пояснение |
|---|---|---|
| 1 | Платеж отклонен по врeменным техническим причинам. Пожалуйста, повторите оплату позже | Техническая проблема |
| 2 | Платеж отклонен. Попробуйте оплатить другой картой или повторите оплату позже | Антифрод PaySoft |
| 3 | Платеж отклонен. На данной карте недостаточно средств для совершения транзакции. | Недостаточно средств на карте |
| 6 | Платеж отклонен. Проверьте правильность введённых реквизитов карты или укажите номер другой карты | Отказ банка эмитента |
| 9 | Платеж отклонен. Проверьте правильность введенных реквизитов карты. | Неправильно введен CVV |
| 11 | Платеж отклонен. Попробуйте оплатить другой картой или повторите оплату позже. | Антифрод банка эквайера |
| 12 | Платеж отклонен. Срок действия Вашей карты истек. Обратитесь в банк. | |
| 13 | Платеж отклонен. Превышен суточный лимит количества операций по карте. Пожалуйста, обратитесь в Ваш банк. | |
| 14 | Платеж отклонен. Карта не поддерживает дополнительный уровень безопасности 3DSecure. Просьба обратиться в Ваш банк для подключения функции. | |
| 18 | Платеж отклонен. Проверьте правильность введеных реквизитов карты или укажите номер другой карты или обратитесь в банк, выдавший Вашу карту. | Карта заблокирована эмитентом |
| 19 | Платеж отклонен. Вы отказались от оплаты платежа | |
| 22 | Лимит оплат в интернете по Вашей карте превышен. Пожалуйста, обратитесь в Ваш банк. | |
| 27 | Платеж отклонен. Страна карты отличается от страны сетевого адреса компьютерной сети (IP). | |
| 42 | Истекло время отведенное на оплату | |
| 61 | Операция по Вашей карте в Интернете была отклонена из-за недостаточного интернет-лимита по сумме операций. Рекомендуем Вам увеличить интернет-лимит в Приват24 (меню «Мои счета» > «Управление картой/счетом» > «Оплата в Интернете») и повторить операцию немного позже. | |
| 62 | Ваш банк (Ощадбанк) отказал в проведении операции. Для проведения платежей с Вашей карты за пополнение электронных кошельков или участия в азартных играх - обратитесь в поддержку Ощадбанка для снятия ограничений. | |
| 63 | Проверка 3D-Secure не выполнена. Просьба обратиться в Ваш банк для уточнения информации. | |
| 64 | По транзакции не получен запрос payment-confirm | |
| 66 | Только карты украинских банков | |
| 67 | Только карты стран СНГ | |
| 68 | Оплата картами данного типа не поддерживается. Укажите другую карту | Запрет корпоративных карт у данного продавца |
| 69 | Платеж отклонен. Проверьте правильность введенных реквизитов карты. | Бин карты не найден в нашей базе |