7. Привязка банковской карты для вывода средств с ЭСП "МОНЕТА.РУ"

  • createholdedinvoice Отправить запрос на создание invoice для последующей привязки карты самозанятого. Запрос нужно отправить перед привязкой новой банковской карты.

  • Отправить на форму MONETA.Assistant по ссылке https://moneta.ru/assistant.widget?operationId= для оплаты invoice. Id пользователя в учетной системе площадки передать в параметре MNT_SUBSCRIBER_ID.

  • Получить url уведомление authorisetoken с элементами cardnumber, MNT_SUBSCRIBER_ID и MNT_OPERATION_ID. Найти по MNT_SUBSCRIBER_ID пользователя площадки и сохранить ему токен 0 + MNT_OPERATION_ID (здесь + - это конкатенация) и маскированный номер карты cardnumber.

После получения номера ЭСП "МОНЕТА.РУ", маркетплейсу необходимо направить запрос на создание операции для последующей привязки банковской карты самозанятого.

https://my.payanyway.ru/npdapi/createholdedinvoice

Принимаемые параметры:

  • 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 операции, созданной в Системе МОНЕТА.РУ для оплаты созданной операции.

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

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

После успешной оплаты маркетплейс получит 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 для выплат самозанятому на привязанную банковскую карту.

Last updated