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. Платежные запросы

3. Прием платежей с холдированием

Авторизация денежных средств

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

  1. Маркетплейс создает операцию методом InvoiceRequest с атрибутом AUTHORIZEONLY установленном в 1 (единицу). В ответ Система "МОНЕТА.РУ" сообщит маркетплейсу номер созданной операции.

Запрос на создание операции:
{  
   "Envelope":{  
      "Header":{  
         "Security":{  
            "UsernameToken":{  
               "Username":"Username",
               "Password":"Password"
            }
         }
      },
      "Body":{  
         "InvoiceRequest":{  
            "payer":"НОМЕР СЧЕТА ПЛАТЕЛЬЩИКА",
            "payee":"НОМЕР СЧЕТА ПОЛУЧАТЕЛЯ",
            "amount":100,
            "clientTransaction":"ТЕСТ",
            "description":"МАРКЕТПЛЕЙС",
            "operationInfo":{  
               "attribute":[  
                  {  
                     "key":"AUTHORIZEONLY",
                     "value":"1"
                  }
               ]
            }
         }
      }
   }
}

Ответ:
{  
   "Envelope":{  
      "Body":{  
         "InvoiceResponse":{  
            "dateTime":"YYYY-MM-DD12:35:12.000+03:00",
            "clientTransaction":"ТЕСТ",
            "transaction":12345678,
            "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 = '10.00';

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

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

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

    //параметр говорит о том, что деньги нужно зарезервировать(авторизовать), а не списывать.
    $attribute = new \Moneta\Types\KeyValueAttribute();
    $attribute->key = 'AUTHORIZEONLY';
    $attribute->value = '1';
    $operation->addAttribute($attribute);

    //номер инвойса в учётной системе магазина/маркетплейса (вариант 2). Опционально.
    $attribute = new \Moneta\Types\KeyValueAttribute();
    $attribute->key = 'clienttransaction';
    $attribute->value = 'my-order-id';
    $operation->addAttribute($attribute);

    //произвольный параметр. Опционально.
    $attribute = new \Moneta\Types\KeyValueAttribute();
    $attribute->key = 'customfield:myParam1';
    $attribute->value = 'myValue1';
    $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>";
}

2. Маркетплейс переводит покупателя по ссылке на платежную форму MONETA.Assistant для оплаты созданной операции:

https://www.moneta.ru/assistant.widget?operationId=номер созданной операции.

3. Маркетплейс сохраняет номер операции и детали операции в своей базе данных. 4. После успешной авторизации покупатель будет переведен на InProgressURL - адрес маркетплейса, указанный в настройках расширенного счета в личном кабинете на сайте www.moneta.ru 5. После успешной авторизации Система "МОНЕТА.РУ" отправит URL - уведомление на адрес маркетплейса, указанный в настройках расширенного счета в личном кабинете на сайте www.moneta.ru в разделе Действия при зачислении/списании средств в поле Вызвать URL после авторизации средств. В этом скрипте по параметру MNT_OPERATION_ID маркетплейсу необходимо отметить запись в базе данных по строке с operationId, как активную (готовую к обработке). По активной операции денежные средства авторизованы на банковской карте покупателя.

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

Подтвердить операцию можно методом ConfirmTransactionRequest или вручную в личном кабинете на сайте www.moneta.ru.

Запрос:
{  
   "Envelope":{  
      "Header":{  
         "Security":{  
            "UsernameToken":{  
               "Username":"Username",
               "Password":"Password"
            }
         }
      },
      "Body":{  
         "ConfirmTransactionRequest":{  
            "transactionId":12345678,
            "paymentPassword":*****
         }
      }
   }
}
Ответ: 
{  
   "Envelope":{  
      "Body":{  
         "ConfirmTransactionResponse": {
            "id": 12345678,
            "attribute": [
...
               {
                  "value": "SUCCEED",
                  "key": "statusid"
               }
...
            ]
         }
      }
   }
}
<?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 = '10.00';

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

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

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

    //параметр говорит о том, что деньги нужно зарезервировать(авторизовать), а не списывать.
    $attribute = new \Moneta\Types\KeyValueAttribute();
    $attribute->key = 'AUTHORIZEONLY';
    $attribute->value = '1';
    $operation->addAttribute($attribute);

    //номер инвойса в учётной системе магазина/маркетплейса (вариант 2). Опционально.
    $attribute = new \Moneta\Types\KeyValueAttribute();
    $attribute->key = 'clienttransaction';
    $attribute->value = 'my-order-id';
    $operation->addAttribute($attribute);

    //произвольный параметр. Опционально.
    $attribute = new \Moneta\Types\KeyValueAttribute();
    $attribute->key = 'customfield:myParam1';
    $attribute->value = 'myValue1';
    $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>";
}

После подтверждения операции Система "МОНЕТА.РУ" отправит уведомление о проведенной оплате на "Pay URL" - Адрес обработчика в системе учета маркетплейса для уведомлений о проведенной оплате.

7. Если заказ не может быть выполнен, маркептлейс отменяет операцию методом CancelTransactionRequest или вручную в личном кабинете на сайте www.moneta.ru.

Запрос:
{  
   "Envelope":{  
      "Header":{  
         "Security":{  
            "UsernameToken":{  
               "Username":"Username",
               "Password":"Password"
            }
         }
      },
      "Body":{  
         "CancelTransactionRequest":{  
            "transactionId":12345678
         }
      }
   }
}



Ответ: 
{  
   "Envelope":{  
      "Body":{  
         "CancelTransactionResponse": {
            "id": 12345678,
            "attribute": [
...
               {
                  "value": "SUCCEED",
                  "key": "statusid"
               }
...
            ]
         }
      }
   }
}
<?php

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

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

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

    //номер операции, по которой было сделано резервирование(авторизация) средств
    $request->transactionId = '';

    //отмена операции холдирования
    $result = $monetaSdk->monetaService->CancelTransaction($request);

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

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

    echo "Операция отменена. Резерв средств снят.";

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

Максимальный срок авторизации денежных средств на банковской карте - 7 дней.

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

Для получения URL - уведомлений о статусах операций с холдированием необходимо заполнить раздел Действия при зачислении/списании денежных средств. Данный раздел находится в настройках транзитного счета маркетплейса.

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

Last updated 5 months ago

Was this helpful?

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

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

MONETA.Assistant
MONETA.MerchantAPI
(WSDL)