> For the complete documentation index, see [llms.txt](https://docs.payanyway.ru/marketplace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payanyway.ru/marketplace/samozanyatye/scenarii-ispolzovaniya-npd-api/5.-privyazka-bankovskoi-karty-dlya-vyvoda-sredstv-s-esp-fizlica.md).

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

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

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