yoomoney
v1.0.0
Published
Yoomoney Api
Downloads
13
Readme
qiwi
NodeJS Yoomoney API SDK
Получаем токен https://yoomoney.ru/docs/wallet/using-api/authorization/obtain-access-token
import Yoomoney from "@kiyasov/yoomoney";
const api = new Yoomoney(); // Токен кошелька https://yoomoney.ru/docs/wallet/using-api/authorization/obtain-access-token
Метод account-info
Получение информации о состоянии счета пользователя.
Требуемые права токена: account-info
api.accountInfo().then(data => console.log(data));
Ответ
{
"account": "4100123456789",
"balance": 1000.00,
"currency": "643",
"account_status": "anonymous",
"account_type": "personal",
"cards_linked": [
{
"pan_fragment": "510000******9999",
"type": "MasterCard"
}
]
}
Метод operation-history
Метод позволяет просматривать историю операций (полностью или частично) в постраничном режиме. Записи истории выдаются в обратном хронологическом порядке: от последних к более ранним.
Требуемые права токена: operation-history.
api.operationHistory(params).then(data => console.log(data));
Параметры запроса https://yoomoney.ru/docs/wallet/user-account/operation-history#request
Ответ
{
"next_record": "4",
"operations": [
{
"operation_id": "1234567",
"status": "success",
"pattern_id": "2904",
"direction": "out",
"amount": 500.00,
"datetime": "2011-07-11T20:43:00.000+03:00",
"title": "Оплата ADSL-доступа компании XXX",
"type": "payment-shop"
},
{
"operation_id": "1234568",
"status": "success",
"pattern_id": "2901",
"direction": "out",
"amount": 300.00,
"datetime": "2011-07-10T20:43:00.000+03:00",
"title": "Прямое пополнение счета телефона YYY",
"type": "payment-shop"
},
{
"operation_id": "1234569",
"status": "success",
"direction": "in",
"amount": 1000.00,
"datetime": "2011-07-10T20:40:00.000+03:00",
"title": "Банк ZZZ, пополнение",
"type": "deposit"
}
]
}
Метод operation-details
Позволяет получить детальную информацию об операции из истории. Требуемые права токена: operation-details.
Параметры запроса https://yoomoney.ru/docs/wallet/user-account/operation-details#request
api
.operationDetails({
operation_id: "" //Идентификатор операции. Значение параметра следует указывать как значение параметра operation_id ответа метода operation-history или значение поля payment_id ответа метода process-payment, если запрашивается история счета плательщика.
})
.then(data => console.log(data));
Ответ
{
"operation_id": "1234567",
"status": "success",
"pattern_id": "2904",
"amount": 500.00,
"direction": "out",
"datetime": "2011-07-11T20:43:00.000+04:00",
"title": "Оплата ADSL-доступа компании Мой-Провайдер",
"details": "Предоплата услуг ADSL-доступа в интернет компании ООО \"XXX\"\nНомер лицевого счета абонента: \n1234567/89\nЗачисленная сумма: 500.00\nНомер транзакции: 2000002967767",
"type": "payment-shop"
}
Метод request-payment
Создание платежа, проверка параметров и возможности приема платежа магазином или перевода средств на счет пользователя ЮMoney. Требуемые права токена: для платежа в магазин: payment.to-pattern («шаблон платежа») или payment-shop. для перевода средств на счета других пользователей: payment.to-account («идентификатор получателя», «тип идентификатора») или payment-p2p.
Параметры запроса https://yoomoney.ru/docs/wallet/process-payments/request-payment#request
api.requestPayment(params).then(data => console.log(data));
Ответ https://yoomoney.ru/docs/wallet/process-payments/request-payment#response
Метод process-payment
Подтверждение платежа, ранее созданного методом request-payment. Указание метода проведения платежа.
Параметры запроса https://yoomoney.ru/docs/wallet/process-payments/process-payment#request
api.processPayment(params).then(data => console.log(data));
Ответ https://yoomoney.ru/docs/wallet/process-payments/process-payment#response