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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payanyway.ru/marketplace/samozanyatye/scenarii-ispolzovaniya-npd-api/5.-privyazka-bankovskoi-karty-dlya-vyvoda-sredstv-s-esp-fizlica.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.