API кошелька

Как получать деньги на банковский счёт

Через API кошелька нельзя принимать деньги на банковский счёт, только в сам кошелёк.

Но вы можете подключить ЮKassa — это платёжный сервис для ИП, юрлиц и самозанятых. Есть разные способы оплаты, готовая интеграция с сайтами и удобный API.

Как начать пользоваться API

1. Проверьте статус своего кошелька

Он должен быть именной или идентифицированный (с анонимным не получится принимать платежи и отправлять переводы).

Если кошелька нет, создайте его (но он будет анонимный, поэтому не забудьте пройти идентификацию).

2. Зарегистрируйте своё приложение на сайте ЮMoney

Советуем сгенерировать секретное слово, чтобы дополнительно защитить токен (см. Что такое client_id).

3. Отправьте запрос на сервер ЮMoney для авторизации приложения

Чтобы отправить запрос, рекомендуем использовать:

  • метод POST — эквивалент HTML form submit,

  • кодировку UTF‑8.

4. Получите токен и права на выполнение операций

Соблюдайте требования безопасности — токен позволяет списывать деньги со счёта пользователя и запрашивать о счёте данные.

Что такое client_id

Это уникальный идентификатор приложения. Он появится в настройках кошелька, когда вы зарегистрируете своё приложение.

Не публикуйте client_id в открытом доступе — это может привести к фишинговым атакам. Мошенник может воспользоваться данными и направлять запросы на получение токена от вашего имени.

Советуем дополнительно защитить client_id — понадобится секретное слово. Чтобы его сгенерировать, при регистрации приложения поставьте галочку на строке «Проверять подлинность приложения (OAuth2 client_secret)».

Как заполнить Redirect URI

Заполните поле «Redirect URI» так же, как и поле «Адрес сайта» — они должны совпадать.

Не удаётся получить токен

Проверьте заново параметры из документации:

  1. Запрос авторизации

  2. Получение токена

Если ошибок нет, то повторите всё с начала — с нового запроса авторизации.

Как начать принимать переводы

Вам нужно только один раз получить у пользователя разрешение на доступ к кошельку (стандартный OAuth).

Как это происходит:

  1. Приложение запрашивает права, которые вам нужны. Например, проводить регулярные безакцептные платежи.

  2. Пользователь попадает на наш сайт и подтверждает доступ для приложения.

Готово: можно списывать деньги и запрашивать данные без участия пользователя.

Что делать, если нужна помощь

Если что-то не получается, не работает или просто есть вопросы — заполните форму ниже: