For Marketplace
  • Для Маркетплейсов
  • Платежные запросы
    • Платежные запросы
    • 1. Прием платежей с банковской карты на маркетплейсе или в виджете
      • 1.1 Перевод покупателя на платежную форму с помощью ссылки
      • 1.2 Перевод покупателя на платежную форму с помощью HTML - формы
      • 1.3 Создание операции с индивидуальными параметрами с помощью MONETA.MerchantAPI
    • 2. Уведомление о проведенной оплате
    • 3. Прием платежей с холдированием
    • 4. Запоминание банковской карты и прием платежей с сохраненной картой.
    • 5. Перевод денежных средств после подтверждения сделки (Безопасная сделка)
    • 6. Приём платежей в пользу разных продавцов одной операцией (Мультикорзина)
    • 7. Управление размером комиссии маркетплейса
    • 8. Выплаты продавцу на банковскую карту
  • ПОДКЛЮЧЕНИЕ ИНДИВИДУАЛЬНЫХ ПРЕДПРИНИМАТЕЛЕЙ И ЮРИДИЧЕСКИХ ЛИЦ К СИСТЕМЕ МОНЕТА.РУ
    • Личный кабинет маркетплейса
    • Уведомления E-mail при редактировании профиля продавца
    • Уведомления URL при редактировании профиля продавца
    • Варианты подключения к Системе МОНЕТА.РУ
      • ‌Вариант 1. Клиент маркетплейса подключается самостоятельно
      • ‌Вариант 2. Маркетплейс подключает клиента
        • Основные понятия
        • Набор полей в личном кабинете клиента
        • CreateProfileRequest
        • CheckProfileRequest
        • EditProfileRequest базового профиля
        • EditProfileRequest подпрофиля руководителя
        • FindProfileDocumentsRequest документа руководителя
        • EditProfileDocumentRequest документа руководителя
        • EditProfileRequest подпрофиля учредителя
        • EditProfileRequest подпрофиля бенефициарного владельца
        • FindProfileDocumentsRequest документа бенефициарного владельца
        • EditProfileDocumentRequest паспорта бенефициарного владельца
        • CreateBankAccountRequest
        • FindLegalInformationRequest подпрофиля юридических реквизитов
        • EditLegalInformationRequest
        • EditProfileRequest базового профиля с атрибутом CONDITIONS_CORRECT_DATA
        • CreateAccountRequest
        • FindProfileDocumentFilesRequest
  • РЕГИСТРАЦИЯ ФИЗИЧЕСКОГО ЛИЦА
    • Создание электронного кошелька
      • Пример 1. Последовательность запросов.
        • CreateProfileRequest
        • CreateProfileDocumentRequest
        • ApprovePhoneSendConfirmationRequest
        • ApprovePhoneApplyCodeRequest
        • SimplifiedIdentificationRequest
        • AsyncRequest
        • CreateAccountRequest
      • Пример 2. Последовательность запросов.
        • CreateProfileRequest
        • ApprovePhoneSendConfirmationRequest
        • ApprovePhoneApplyCodeRequest
        • SimplifiedIdentificationRequest
        • AsyncRequest
        • CreateAccountRequest
      • Актуализация данных клиента
    • Идентификация с помощью MonetaId
      • Схема взаимодействия
      • Стенды
      • Регистрация маркетплейса
      • Установление доверия
      • Аутентификация
      • Встраивание в iframe
      • Проверка возможности полной идентификации
      • Уведомления о статусе идентификации
  • САМОЗАНЯТЫЕ
    • Самозанятые
    • Защита маркетплейса в ФНС РФ
    • Сценарии использования MonetaNPD
      • 1. Регистрация самозанятого в Системе МОНЕТА.РУ
      • 2. Привязка самозанятого к маркетплейсу по номеру телефона
      • 3. Привязка самозанятого к маркетплейсу по ИНН
      • 4. Уведомление маркетплейса о статусе привязки
      • 5. Проведение упрощенной идентификации самозанятого
      • 6. Смена номера телефона самозанятого
      • 7. Привязка банковской карты для вывода средств с ЭСП "МОНЕТА.РУ"
      • 8. Выплата в пользу самозанятого от юридического лица
      • 9. Регистрация дохода самозанятого в ФНС и отправка чека
      • 10. Регистрацию дохода самозанятого в ФНС (offline режим)
      • 11. Вывод с ЭСП "МОНЕТА.РУ" на банковскую карту
      • 12. Выплата самозанятому через СБП
      • 13. Получение сообщений от ФНС
      • 14. Отметка о прочтении сообщений от ФНС
      • 15. Ежедневная проверка статуса привязки к маркетплейсу с контролем прав
      • 16. Установка прав для маркетплейса
    • Дополнительные возможности MonetaNPD
      • 17. Отвязка от маркетплейса
      • 18. Запрос баланса ЭСП "МОНЕТА.РУ" самозанятого
      • 19. Запрос статуса самозанятого
      • 20. Запрос суммы дохода, отмененного дохода и налога самозанятого за текущий год
      • 21. Запрос на сторнирование чека
      • 22. Регистрация статического QR-кода
      • 23. Регистрация и обновление Кассовой ссылки
      • 24. Получение ссылки на пополнение ЭСП самозанятого
      • 25. Получение статуса операции из Системы МОНЕТА.РУ
      • 26. Получение данных о самозанятом в Системе МОНЕТА.РУ
      • 27. Получение паспортных данных самозанятого в Системе МОНЕТА.РУ
      • 28. Получение состояния лицевого счета НП НПД
      • 29. Возврат по операции
      • 30. Получение истории операций
      • 31. Получить данные по начислению и уплате налога
      • 32. Получить реквизиты для уплаты налогов и пеней
      • 33. Оплата налога
    • Сценарий выплат самозанятым без открытия ЭСП
  • Управление денежными средствами на расчетных счетах клиентов
    • Управление расчетными счетами клиентов маркетплейса
  • Перевод денежных средств клиентов в Федеральное Казначейство
    • Перевод денежных средств в Федеральное Казначейство
  • 54-ФЗ
    • Применение контрольно-кассовой техники при осуществлении расчетов
      • Формирование чека в ККТ продавца
      • Формирование чека в ККТ маркетплейса
      • Формирование чека в ККТ ООО "ПЭЙ ЭНИ ВЭЙ"
        • Создание invoice
        • Оплата invoice
        • Рекуррентный платеж
        • Операции возврата
        • Получить данные операции
  • СБП
    • Система быстрых платежей
    • Описание полей для переводов СБП
    • Получение списка участников СБП
    • Протокол С2С. Сценарий C2C/Me2Me Push
    • Протокол С2С.Сценарий Me2Me Pull
    • Протокол C2B. Оплата товаров и услуг по QR
    • Протокол C2B. Многоразовые QR
    • Протокол C2B. Выставление счёта (InvoiceRequest) для оплаты по Кассовой ссылке СБП
    • Протокол C2B. Выставление счёта (InvoiceRequest) для оплаты по динамическому QR
    • Протокол C2B. Привязка счёта Плательщика (подписка)
      • Привязка счёта без оплаты
      • Оплата с привязкой счёта
      • Оплата с привязанного счёта
    • Протокол C2B. Возврат ранее принятых QR-платежей (C2B refund)
    • Протокол B2C «Прочие выплаты физическому лицу»
    • Получение статуса операции перевода СБП
    • Сервис Widget SBP/FPS
      • Схема взаимодействия
      • Регистрация маркетплейса
      • Установление доверия
      • Аутентификация
      • Встраивание в iframe
      • Уведомления о событиях
      • Пример запроса PaymentRequest
      • Просмотр истории транзакций
Powered by GitBook
On this page

Was this helpful?

  1. Платежные запросы

4. Запоминание банковской карты и прием платежей с сохраненной картой.

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

Покупатель на платежной форме будет указывать только CVV-код.

Последовательность действий, при приеме платежей с запоминанием карты:

1. Маркетплейс создает базовую операцию методом InvoiceRequest с помощью интерфейса MONETA.MerchantAPI без дополнительных параметров.

Запрос:
{  
   "Envelope":{  
      "Header":{  
         "Security":{  
            "UsernameToken":{  
               "Username":"Username",
               "Password":"Password"
            }
         }
      },
      "Body":{  
         "InvoiceRequest":{  
            "payer":НОМЕР СЧЕТА ПЛАТЕЛЬЩИКА,
            "payee":НОМЕР СЧЕТА ПОЛУЧАТЕЛЯ,
            "amount":1000,
            "clientTransaction":"TEST",
            "description":"TEST"
         }
      }
   }
}

Ответ: 

{  
   "Envelope":{  
      "Body":{  
         "InvoiceResponse":{  
            "dateTime":" YYYY-MM-DDT08:55:03.000+03:00",
            "clientTransaction":"TEST",
            "transaction":номер базовой операции,
            "status":"CREATED"
         }
      }
   }
}
<?php

$sdkAppFileName = __DIR__ . "/../moneta-sdk-lib/autoload.php";
include_once($sdkAppFileName);

try {
    $monetaSdk = new \Moneta\MonetaSdk();
    $monetaSdk->checkMonetaServiceConnection();

    $request = new \Moneta\Types\InvoiceRequest();

    //номер счёта плательщика (счёт для списания средств).
    $request->payer = '';

    //номер счёта получателя (счёт для зачисления средств)
    $request->payee = '';

    //сумма инвойса
    $request->amount = '11.00';

    //описание инвойса
    $request->description = 'Краткое описание';

    //номер инвойса в учётной системе магазина/маркетплейса.
    $request->clientTransaction = 'my-order-id-11';

    //создание нового инвойса
    $result = $monetaSdk->monetaService->Invoice($request);

    if (!$result['transaction']) {
        throw new Exception(print_r($result, true));
    }

    //номер операции: необходим для предоставления формы оплаты покупателю
    echo "Номер операции: " . $result['transaction'];

} catch (Exception $e) {
    echo "Ошибка:<br />";
    echo "<pre>" . $e->getMessage() . "</pre>";
}

2. Маркетплейс переводит покупателя на платежную форму MONETA.Assistant с параметром operationId, равным значению operationId базовой операции и с обязательным параметром MNT_SUBSCRIBER_ID: https://www.moneta.ru/assistant.htm?operationId=номер базовой операции&MNT_SUBSCRIBER_ID=12345

https://www.moneta.ru/assistant.widget?operationId=номер базовой операции&MNT_SUBSCRIBER_ID=12345

3. Маркетплейс создает операцию платежа методом InvoiceRequest с помощью интерфейса MONETA.MerchantAPI с параметром PAYMENTTOKEN, равным значению operationId базовой операции с ведущим нулем.

{  
   "Envelope":{  
      "Header":{  
         "Security":{  
            "UsernameToken":{  
               "Username":"Username",
               "Password":"Password"
            }
         }
      },
      "Body":{  
         "InvoiceRequest":{  
            "payer":НОМЕР СЧЕТА ПЛАТЕЛЬЩИКА,
            "payee":НОМЕР СЧЕТА ПОЛУЧАТЕЛЯ,
            "amount":10,
            "clientTransaction":"test",
            "description":"test",
            "operationInfo":{  
               "attribute":[  
                  {  
                     "key":"PAYMENTTOKEN",
                     "value":"0НОМЕР БАЗОВОЙ ОПЕРАЦИИ"
                  }
               ]
            }
         }
      }
   }
}

Ответ:

{  
   "Envelope":{  
      "Body":{  
         "InvoiceResponse":{  
            "dateTime":"YYYY-MM-DDT08:55:03.000+03:00",
            "clientTransaction":"test",
            "transaction":98765432,
            "status":"CREATED"
         }
      }
   }
}
<?php

$sdkAppFileName = __DIR__ . "/../moneta-sdk-lib/autoload.php";
include_once($sdkAppFileName);

try {
    $monetaSdk = new \Moneta\MonetaSdk();
    $monetaSdk->checkMonetaServiceConnection();

    $request = new \Moneta\Types\InvoiceRequest();

    //номер счёта плательщика (счёт для списания средств) в системе МОНЕТА.РУ.
    $request->payer = '';

    //номер счёта получателя (счёт для зачисления средств) в системе МОНЕТА.РУ.
    $request->payee = '';

    //сумма инвойса
    $request->amount = '12.00';

    //описание инвойса
    $request->description = 'Инвойс только с вводом контрольных цифр';

    //номер инвойса в учётной системе магазина/маркетплейса.
    $request->clientTransaction = 'my-order-id-12';

    $operation = new \Moneta\Types\OperationInfo();

    //параметр должен содержать значение transaction базовой операции с добавлением ноля в начало строки
    $attribute = new \Moneta\Types\KeyValueAttribute();
    $attribute->key = 'PAYMENTTOKEN';
    $attribute->value = '';
    $operation->addAttribute($attribute);

    $request->operationInfo = $operation;

    //создание нового инвойса
    $result = $monetaSdk->monetaService->Invoice($request);

    if (!$result['transaction']) {
        throw new Exception(print_r($result, true));
    }

    //номер операции: необходим для предоставления формы оплаты покупателю
    echo "Номер операции: " . $result['transaction'];

} catch (Exception $e) {
    echo "Ошибка:<br />";
    echo "<pre>" . $e->getMessage() . "</pre>";
}

4. Маркептлейс переводит покупателя на платежную форму MONETA.Assistant с параметром operationId, который был получен на третьем шаге и с обязательным параметром MNT_SUBSCRIBER_ID: https://www.moneta.ru/assistant.widget?operationId=98765432&MNT_SUBSCRIBER_ID=12345. Параметр MNT_SUBSCRIBER_ID должен совпадать с аналогичным параметром в базовой операции, иначе оплата будет запрещена.

https://www.moneta.ru/assistant.widget?operationId=98765432&MNT_SUBSCRIBER_ID=12345. 

После перехода на платежную форму покупателю необходимо ввести CVV-код.

Запросы маркетплейс отправляет в рамках интерфейса MONETA.MerchantAPI.

Previous3. Прием платежей с холдированиемNext5. Перевод денежных средств после подтверждения сделки (Безопасная сделка)

Last updated 5 months ago

Was this helpful?

Интерфейс представляет собой Web-сервис, описанный по спецификации Web Services Description Language , использующий протокол Simple Object Access Protocol (SOAP) для передачи информации.

MONETA.MerchantAPI
(WSDL)