Заключен договор с Яндексом, заплатили, а подключить не можем.
Кто что знает, кто может взяться сделать?
Вот все, что нам дали:
ПРОТОКОЛ ВЗАИМОДЕЙСТВИЯ МАГАЗИНА И ЦЕНТРА ПРИЕМА ПЛАТЕЖЕЙ «ЯНДЕКС.ДЕНЬГИ», E-MAIL УВЕДОМЛЕНИЯ.
ВЕРСИЯ 2.01
1 Общие сведения
Центр приема платежей (ЦПП) поддерживает ряд протоколов, позволяющих магазинам получать уведомления о принятых в их пользу платежах. Обрабатывая эти уведомления в своей информационной системе (ИС), магазины могут сократить время между платежом и предоставлением клиенту оплаченной услуги или товара.
Далее приводится описание взаимодействия между магазином и ЦПП с помощью E-mail уведомлений.
2 Взаимодействие магазина и ЦПП
На веб-странице, где Покупатель может инициировать платеж, Магазин должен расположить «платежную форму» с данными, характеризующими покупку (сумма платежа, ID Магазина и пр.). Платежная форма в минимальном варианте представляет собой статический HTML, возможно, с заполняемыми Покупателем полями. Например, для пополнения счета в он-лайн игре, это может быть «номер игрового счета» и «сумма».
Упрощенно можно считать, что веб-браузер Покупателя передает заполненную форму в ЦПП. Реальный способ передачи зависит от типа Кошелька «Яндекс.Денег» и всегда подразумевает шифрование передаваемых данных.
После того, как покупатель получит запрос на платеж («Контракт») от ЦПП и подтвердит платеж, ЦПП снимает деньги со счета Покупателя и, Покупатель получает от ЦПП веб-страницу (в дизайне портала «Яндекс.Деньги»), где говорится об успехе или неуспехе платежа.
ЦПП отправляет в ИС «Уведомление об оплате» (E-mail).
Раз в сутки ЦПП отправляет в ИС список платежей («реестр», отправляется по E-Mail). ИС должна сверять реестр с полученными ей «Уведомлениями об оплате». Формат реестра описан в отдельном документе.
3 Платежная форма
Платежная форма определяет параметры заказа, а ее отправка инициирует формирование и обработку платежа.
Параметры платежной формы могут быть двух типов:
• Служебные, значения этих параметров Магазин получает в процессе подключения к ЦПП;
• Пользовательские, то есть определяемые самим Магазином и позволяющие ему в дальнейшем опознавать платежи.
Следует учитывать, что платежная форма проходит через компьютер покупателя и поэтому все ее поля видны Покупателю и могут быть модифицированы недобросовестным покупателем.
Это не всегда является проблемой. Например, если в платежной форме указаны «номер игрового счета» и «сумма», то ИС зачислит на указанный счет уплаченную Покупателем сумму. Как бы Покупатель ни модифицировал платежную форму, он не сможет сделать это в ущерб Магазину.
Но, например, если в платежной форме указывается код заказа и сумма, то недобросовестный Покупатель может оставить неизменным код, а сумму изменить, скажем, с 30000 на 30.
Поэтому, в зависимости от специфики Магазина, ИС следует осуществлять проверки после платежа (скажем, если уплачено меньше, чем стоит заказ, то не отгружать товар, а потребовать доплаты у Покупателя.
Таблица 1. Поля платежной формы
Название Содержание Обязательное
поле
ShopId Номер магазина в ЦПП. Выдается ЦПП. Да
scid Номер витрины магазина в ЦПП. Выдается ЦПП. Да
Sum Сумма заказа (десятичный разделитель – точка, разделители тысяч недопустимы) Да
customerNumber Идентификатор Покупателя, любая строка не более 64 символов.
Номер оплачиваемого мобильного телефона, договора и т.п., специфично для Магазина. Нет
CustName Ф.И.О. плательщика Нет
CustAddr Адрес доставки заказа или адрес проживания плательщика Нет
CustEMail E-mail плательщика Нет
OrderDetails Детали заказа, количество товара и т.д. Нет
4 Настройки Магазина
Для начала работы Магазин должен определить и предоставить администратору ЦПП описанные ниже настройки.
Таблица 2. Настройки Магазина в ЦПП
Название Содержание
shopName Название Магазина, отображается в контракте платежной системы.
listEMail E-mail, на который отправляются уведомления об оплате.
listEMailRegistry E-mail, на который каждый день отправляются реестры платежей за предыдущие сутки.
listParam Список пользовательских полей, которые магазин будет использовать на платежной форме,
помимо обязательных полей (см. Таблица 2). В виде: название поля [текст для отображения].
Например: custName [Ф.И.О. плательщика], custAddr [адрес доставки].
5 Уведомления о платеже
Уведомление о платеже предоставляется в теле электронного сообщения (e-mail).
Отправляется на e-mail адрес Интернет Магазина, указанный в технической анкете.
Уведомление о платеже приходит подписанным сертификатом Центра Приема Платежей, S/MIME подпись (detach, тип сертификата PKCS#7).
6 Приложения
Приложение 1. Поля e-mail уведомления о платеже.
Таблица 3. Поля e-mail уведомления о платеже
Название Содержание
Извещение № Номер e-mail уведомления о платеже в адрес магазина.
Получатель Наименование юридического лица магазина.
Время платежа Дата и время платежа в формате dd.mm.yyyy hh:nn:ss.
Сумма Сумма платежа. Разделитель дробной части – точка, всегда ровно два знака после запятой, разделитель тысяч отсутствует.
Номер транзакции Уникальный идентификатор транзакции, по которому идентифицируется платеж как на стороне Магазина, так и на стороне ПС Яндекс.Деньги.
Идентификатор клиента Номер оплачиваемого мобильного телефона, договора и т.п. Передается с платежной формы Магазина.
Номер в магазине Номер заказа на стороне Магазина. Если не заполнен, подставляется значение из «Номер транзакции».
Ф.И.О. Фамилия, имя и отчество плательщика. Заполняется плательщиком на платежной форме Магазина.
Адрес доставки Адрес плательщика. Заполняется плательщиком на платежной форме Магазина.
E-mail Электронный адрес плательщика. Заполняется плательщиком на платежной форме Магазина.
Содержание заказа Список приобретенных товаров, другие детали заказа. Заполняется плательщиком на платежной форме Магазина.
Приложение 2. Пример платежного уведомления.
Subject: Yandex.Dengi payment for Интернет Магазин #87
Извещение № 87
Получатель: ООО «Интернет Магазин»
Время платежа: 18.01.2008 16:32:37
Сумма: 12.00 RUB
Номер транзакции: 1099511628638
Идентификатор клиента: 4637937
Номер в магазине: 1099511628638
Заполнено плательщиком в платежной форме магазина:
Ф.И.О.: Иванов Иван Иванович
Адрес доставки: г.Москва, ул. Московская 3-45
E-mail: ivanovii@mail.ru
Содержание заказа:
яблоки, груши, виноград
13.07.2021, 17:36:09