7. Привязка банковской карты для вывода средств с ЭСП "МОНЕТА.РУ"
Previous6. Смена номера телефона самозанятогоNext8. Выплата в пользу самозанятого от юридического лица
Last updated
Was this helpful?
Last updated
Was this helpful?
createholdedinvoice Отправить запрос на создание invoice для последующей привязки карты самозанятого. Запрос нужно отправить перед привязкой новой банковской карты.
Отправить на форму MONETA.Assistant по ссылке для оплаты invoice. Id пользователя в учетной системе площадки передать в параметре MNT_SUBSCRIBER_ID.
Получить url уведомление authorisetoken с элементами cardnumber, MNT_SUBSCRIBER_ID и MNT_OPERATION_ID. Найти по MNT_SUBSCRIBER_ID пользователя площадки и сохранить ему токен 0 + MNT_OPERATION_ID (здесь + - это конкатенация) и маскированный номер карты cardnumber.
После получения номера ЭСП "МОНЕТА.РУ", маркетплейсу необходимо направить запрос на создание операции для последующей привязки банковской карты самозанятого.
Принимаемые параметры:
key - security_key
transaction - внешний идентификатор транзакции - строка 100.
phone - номер телефона в формате: код страны, код оператора, номер
signature - подпись запроса, формируется как md5 хэш от значений передаваемых параметров (кроме параметра key), отсортированных в алфавитном порядке ключей, конкатенированных с secret_key. Например, для запроса /sendsms подпись будет проверяться по формуле: md5(phone_value + transaction + secret_key_value), где знак “+” - конкатенация строк.
Варианты ответа на запрос:
{"error":"no parthner"} - партнер по security_key не найден, либо был отключен.
{"error":"wrong signature"} - сигнатура запроса не прошла проверку.
{"error":"no user found"} - самозанятый по указанному номеру телефона не найден, отправьте смс с кодом заново и создайте профайл в Системе МОНЕТА.РУ
{"error":"no user unitId"} - профайл самозанятого не найден в Системе МОНЕТА.РУ.
{"error":"no user inn"} - самозанятый не привязан к маркетплейсу, следует сначала привязать самозанятого.
{"error": true} - invoice не был создан.
{"success": operationId} - BigInt 20 - id операции, созданной в Системе МОНЕТА.РУ для оплаты созданной операции.
Далее маркетплейсу необходимо перевести самозанятого на платежную форму для оплаты созданной операции. Ссылка на платежную форму может иметь следующий вид:
После успешной оплаты маркетплейс получит url - уведомление об успешной привязке карты со следующими json параметрами:
requestId - ID запроса - нужен для идентификации url уведомлений, которые придут в ответ на данный запрос (число, до 11-ти знаков)
methodName - имя запроса (строка, до 32-х символов)
requestStatus - статус запроса - может иметь одно из значений: NEW (создан новый запрос), ACTIVE - запрос сработал, DONE - запрос завершен и NO_MESSAGE_ID (не был получен ID сообщения от АИС “Налог-3” - в этом случае запрос до АИС “Налог-3” будет повторяться автоматически до получения ID сообщения от АИС “Налог-3”, но не более 300-т раз) (строка, до 32-х символов)
MNT_ID - BigInt 20 - номер кошелька физ. лица, поскольку номер ранее был сохранен в базе данных проекта, по нему, а так же по MNT_SUBSCRIBER_ID и MNT_OPERATION_ID - BigInt 20 - можно однозначно определить физ. лицо, привязывающее банковскую карту карту.
MNT_TRANSACTION_ID - строка 100 - внешний идентификатор операции.
MNT_SUBSCRIBER_ID - строка 100 - номер операции, соответствует ID ранее сформированному invoice.
cardnumber - маскированный номер банковской карты - строка 20.
После привязки карты, ID операции с ведущим нулем можно использовать в качестве paymenttoken для выплат самозанятому на привязанную банковскую карту.