Интерфейс проведения оплаты через 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>
Если передаются зашифрованные платежные данные в параметре LMI_PAYMENT_TOKEN, параметры LMI_CARDNUMBER,LMI_EXPIRE_YEAR,LMI_EXPIRE_MONTH,LMI_CAVV не должны передаваться. Если платежные данные передаются в расшифрованном виде необходимо передать LMI_CARDNUMBER,LMI_EXPIRE_YEAR,LMI_EXPIRE_MONTH,LMI_CAVV, параметр LMI_PAYMENT_TOKEN в этом случае передавать не нужно.
| Название | 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 |
| Зашифрованные платежные данные, полученные от Applepay | LMI_PAYMENT_TOKEN | Нет | Значение event.payment.token.paymentData в формате JSON полученное в session.onpaymentauthorized = function(event) {} |
| PAN | LMI_CARDNUMBER | Да | paymentMethodDetails.pan |
| IP плательщика | LMI_PAYER_IP | Нет | IP адрес плательщика |
| URL сайта | LMI_MERCHANT_URL | Нет | URL сайта, на котором производился платеж |
| Идентификатор клиента на стороне Продавца | LMI_PAYER_ID | Нет | Может содержать буквы английского алфавита, цифры и знак дефиса «-». Максимальная длина 50 символов. |
| Фамилия Клиента | LMI_PAYER_SURNAME | Нет*** | Фамилия Клиента |
| Имя Клиента | LMI_PAYER_FIRSTNAME | Нет*** | Имя Клиента |
| Отчество Клиента | LMI_PAYER_PATRONYMIC | Нет*** | Отчество Клиента |
| Дата рождения Клиента | LMI_PAYER_BIRTHDAY | Нет*** | Дата рождения Клиента в формате ГГГГ-ММ-ДД |
| ИНН Клиента | LMI_PAYER_TAX_ID | Нет*** | ИНН |
| Номер телефона Клиента | LMI_PAYER_PHONE_NUMBER | Нет** | Номер телефона Клиента в формате 380xxxxxxxxx. |
| Страна Клиента | LMI_PAYER_COUNTRY | Нет** | ISO 3166-1 alpha-2 |
| Штат (только для США и Канады) | LMI_PAYER_STATE | Нет** | аббревиатура штата |
| Город | LMI_PAYER_CITY | Нет** | Город |
| Адрес | LMI_PAYER_ADDRESS | Нет** | Адрес |
Формат 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 | Платеж отклонен. Проверьте правильность введенных реквизитов карты. | Бин карты не найден в нашей базе |