https://github.com/alexxandergrib/yoomoney-sdk
:bank: YooMoney (formerly Yandex.Money) (yoomoney.ru) API SDK for node JS. Fully Typed
https://github.com/alexxandergrib/yoomoney-sdk
api-sdk javascript js nodejs ts typescript yandex-money yoomoney
Last synced: about 1 month ago
JSON representation
:bank: YooMoney (formerly Yandex.Money) (yoomoney.ru) API SDK for node JS. Fully Typed
- Host: GitHub
- URL: https://github.com/alexxandergrib/yoomoney-sdk
- Owner: AlexXanderGrib
- License: mit
- Created: 2021-04-14T01:44:01.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-05-10T15:13:29.000Z (about 1 month ago)
- Last Synced: 2025-05-10T16:24:56.747Z (about 1 month ago)
- Topics: api-sdk, javascript, js, nodejs, ts, typescript, yandex-money, yoomoney
- Language: TypeScript
- Homepage: https://npmjs.com/package/yoomoney-sdk
- Size: 3.82 MB
- Stars: 37
- Watchers: 3
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# YooMoney SDK
> Типизированный SDK для API YooMoney для NodeJS
[](https://github.com/AlexXanderGrib/yoomoney-sdk)
[](https://npmjs.com/package/yoomoney-sdk)
[](https://github.com/AlexXanderGrib/yoomoney-sdk)
[](https://codecov.io/gh/AlexXanderGrib/yoomoney-sdk)
[](https://github.com/AlexXanderGrib/yoomoney-sdk)
[](https://snyk.io/advisor/npm-package/yoomoney-sdk)
[](https://snyk.io/test/npm/yoomoney-sdk)
[](https://npms.io/search?q=yoomoney-sdk)
[](https://npmjs.com/package/yoomoney-sdk)
[](https://github.com/AlexXanderGrib/yoomoney-sdk/blob/main/LICENSE.txt)
[](https://bundlephobia.com/package/yoomoney-sdk)
[](https://www.codacy.com/gh/AlexXanderGrib/yoomoney-sdk/dashboard?utm_source=github.com&utm_medium=referral&utm_content=AlexXanderGrib/yoomoney-sdk&utm_campaign=Badge_Grade)
## 🍬 Почему именно эта библиотека?
1. **Полная.** Покрывает следующие API:
- [Авторизации приложения](https://yoomoney.ru/docs/wallet/using-api/authorization/basics)
- [API пользователя](https://yoomoney.ru/docs/wallet)
- [Создание форм оплаты](https://yoomoney.ru/docs/payment-buttons/using-api/forms)
- [Проверка уведомлений об оплате](https://yoomoney.ru/docs/payment-buttons/using-api/notifications)
2. **Простая.** на каждое API всего 1 класс
- **Много [примеров](./examples/README.md)**.
3. **Надёжная.** Библиотека написана на **TypeScript** и покрыта тестами.
4. [**Безопасная.**](./SECURITY.md) У библиотеки всего 2 зависимости, и она постоянно сканируется Code QL и [Snyk](https://snyk.io/advisor/npm-package/yoomoney-sdk) на наличие уязвимостей.
## 📦 Установка
- **Используя `npm`**
```shell
npm i yoomoney-sdk
```
- **Используя `Yarn`**
```shell
yarn add yoomoney-sdk
```
- **Используя `pnpm`**
```shell
pnpm add yoomoney-sdk
```
## 🛠️ Использование
1. [⚙️ Список методов](./docs/api/modules.md)
2. [🦄 Примеры](./examples/README.md)
3. 🧑⚖️ Лицензия - [**MIT**](./LICENSE)
### Обработка ошибок
Если вызов метода API возвращает ошибку (то-есть есть поле `error` в ответе), то библиотека кидает ошибку `YMApiError`, которая содержит поля:
- `code` - Значение поля `error` в ответе
- `response` - Ответ полностью
### Получение личного токена
```bash
# Клонируем репозиторий
git clone https://github.com/AlexXanderGrib/yoomoney-sdk.git
# Заходим в папку
cd yoomoney-sdk
# Устанавливаем зависимости
npm install
# Собираем библиотеку
npm run build
# Запускаем скрипт
node examples/4-get-token.js
```
#### Использование
```bash
# .env
YOOMONEY_TOKEN=4100117723869225.C277E77...
```
```javascript
// index.js
const { API } = require("yoomoney-sdk");
const { config } = require("dotenv");
// Подгружаем файл .env
config();
const api = new API(process.env.YOOMONEY_TOKEN);
api.accountInfo().then((info) => console.log(info));
```
## Лицензия
Проект распространяется под лицензией MIT. Смотрите [LICENSE.txt](./LICENSE.txt)
[](https://app.fossa.com/projects/git%2Bgithub.com%2FAlexXanderGrib%2Fyoomoney-sdk?ref=badge_large)
## ❤️ Содействие (Contributing)
_Что делаем?_:
1. ⁉️ Не стесняемся писать [Issue](https://github.com/AlexXanderGrib/yoomoney-sdk/issues/new)
2. 🛠️ Если хотите что-то поправить следуйте гайду [`CONTRIBUTING.md`](./CONTRIBUTING.md)
3. 💸 Донатим 👉 https://sobe.ru/na/yoomoney_sdk
4. 🌟 Ставим [звёздочки](https://github.com/AlexXanderGrib/yoomoney-sdk/stargazers), если библиотека понравилась.
## 🙋 Поддержка
Библиотека - маленькая, я отвечаю быстро. Не стесняйтесь писать Issue, даже если кажется что они глупые. Если что, можете писать в
**Telegram: [@AlexXanderGrib](https://t.me/AlexXanderGrib)**
## Интересует приём и отправка P2P платежей по РФ на NodeJS?
У нас есть точно такое-же типизированное SDK для QIWI 👉 [github.com/AlexXanderGrib/node-qiwi-sdk](https://github.com/AlexXanderGrib/node-qiwi-sdk)