#node-yandex-kassa

by Zero One

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

Installation

npm install --save node-yandex-kassa

Usage

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

app.post('/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));
});

Functions

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"
shopId="13"/>

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"
shopId="13"
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.

License

This project rocks and uses MIT License

Copyright (c) 2015 Zero One