AnyPay SDK

Универсальная библиотека для работы с AnyPay API, позволяющая управлять платежами, выплатами и балансом напрямую из Node.js; TypeScript.

Содержание

• Установка
• Инициализация клиента
• Сервисы
  • AccountService
  • PaymentService
  • PayoutService
  • ApiService
• Обработка ошибок
• Примеры
• Типы

Установка

npm install anypay-ts
# или
yarn add anypay-ts

Инициализация клиента

import { AnyPayClient } from 'anypay-ts';

const client = new AnyPayClient('API_ID', 'API_KEY');

API_ID и API_KEY выдаются в панели управления AnyPay.

Сервисы

AccountService

Для работы с аккаунтом, балансом, комиссиями и курсами валют.

const balance = await client.account.getBalance();
console.log(balance.result.balance); // Баланс в рублях

const rates = await client.account.getRates();
console.log(rates.result.in.usd); // Курс USD на прием

const commissions = await client.account.getCommissions(projectId);
console.log(commissions.result.qiwi); // Комиссия по Qiwi

PaymentService

Для создания и получения платежей.

// Создание платежа
const payment = await client.payment.createPayment({
    project_id: 123,
    pay_id: 456,
    amount: 1000,
    currency: 'rub',
    desc: 'Товар',
    method: 'qiwi',
});
console.log(payment.result.transaction_id);

// Получение списка платежей
const paymentsList = await client.payment.getPayments({ project_id: 123 });
console.log(paymentsList.result.total);

PayoutService

Для создания выплат и получения их списка.

// Создание выплаты
const payout = await client.payout.createPayout({
    payout_id: 10001,
    payout_type: 'qiwi',
    amount: 500,
    wallet: '79990001122',
});
console.log(payout.result.status);

// Получение списка выплат
const payouts = await client.payout.getPayouts();
console.log(payouts.result.total);

ApiService

Для получения актуальных IP адресов сервиса AnyPay:

const ips = await client.api.getIpNotification();
console.log(ips.result.ip);

Обработка ошибок

Все методы библиотеки выбрасывают AnyPayError с полями:

try {
    const balance = await client.account.getBalance();
} catch (err) {
    console.error(err.message);
    console.error(err.status); // HTTP статус
    console.error(err.code); // Код ошибки AnyPay
}

Примеры

import { AnyPayClient } from 'anypay-ts';

const client = new AnyPayClient('API_ID', 'API_KEY');

async function main() {
    const balance = await client.account.getBalance();
    console.log(balance.result.balance);

    const payments = await client.payment.getPayments({ project_id: 123 });
    console.log(payments.result.total);
}

main();

Типы

Типы данных находятся в src/types:

• account.ts — баланс, комиссии, курсы
• payment.ts — создание и получение платежей
• payout.ts — создание и получение выплат
• api.ts — IP нотификации

Лицензия

MIT © 2025