Node.js utilities to integrate Yandex.Kassa with your app

Usage no npm install needed!

<script type="module">
  import nodeYandexKassa from '';



NPM Version Build Status

by Zero One

JavaScript utilities to integrate Yandex.Kassa payment API with your app


npm install --save node-yandex-kassa


Example usage with Express in route handler:

import { checkMD5, buildResponse } from 'node-yandex-kassa';
const { KASSA_SHOP_PASSWORD } = process.env; // ... if you store such things there'/payments/check_order', (req, res, next) => {
  const { body } = req;
  const { invoiceId, shopId } = body;

  if (!checkMD5(body, KASSA_SHOP_PASSWORD)) {
    return res.status(400).send('Validation of MD5 failed');

  // ...
  // Here you might validate request params (orderNumber of customerNumber, for example)
  // if these parameters were passed to payment form
  // ...

  res.set('Content-Type', 'text/xml');
  res.send(buildResponse('checkOrder', 0, shopId, invoiceId));


checkMD5(requestBody, shopPassword)

Returns boolean.

Checks request body for valid md5 param.

Requests are being made by Yandex.Kassa service and have standart format (with sample data):

Key Value
requestDatetime 2011-05-04T20:38:00.000+04:00
action checkOrder
md5 8256D2A032A35709EAF156270C9EFE2E
shopId 13
shopArticleId 456
invoiceId 1234567
customerNumber 8123294469
orderCreatedDatetime 2011-05-04T20:38:00.000+04:00
orderSumAmount 87.10
orderSumCurrencyPaycash 643
orderSumBankPaycash 1001
shopSumAmount 86.23
shopSumCurrencyPaycash 643
shopSumBankPaycash 1001
paymentPayerCode 42007148320
paymentType AC

buildResponse(action, statusCode, shopId, invoiceId, message = null)

Returns string.

Generates string with valid XML required by Yandex.Kassa API.

Example of successful response:

<?xml version="1.0" encoding="UTF-8"?>
<checkOrderResponse performedDatetime="2011-05-04T20:38:01.000+04:00"
code="0" invoiceId="1234567"

Example of response with error:

<?xml version="1.0" encoding="UTF-8"?>
<checkOrderResponse performedDatetime="2011-05-04T20:38:01.000+04:00"
code="100" invoiceId="1234567"
message="Given customerNumber does not exist"
techMessage="Wrong phone number"/>

More docs coming soon

For now, for more info on usage and itegration refer to official integration guide and API spec.


This project rocks and uses MIT License

Copyright (c) 2015 Zero One