Redsys-api-js

A module for the online Redsys payment system.

Installation

$ npm install redsys-api

Usage

Create payment form

const RedsysAPI = require('redsys-api');

var redsys = new RedsysAPI();
// Add some Parameters
redsys.setParameter('DS_MERCHANT_AMOUNT', 945);
redsys.setParameter('DS_MERCHANT_ORDER', '123456789101');
redsys.setParameter('DS_MERCHANT_MERCHANTCODE', '343801064');
redsys.setParameter('DS_MERCHANT_CURRENCY', '978');
redsys.setParameter('DS_MERCHANT_TRANSACTIONTYPE', data['transactionType']);
redsys.setParameter('DS_MERCHANT_TERMINAL', '1');
redsys.setParameter('DS_MERCHANT_MERCHANTURL', 'http://some_url.com');
redsys.setParameter('DS_MERCHANT_URLOK', 'http://some_other_url.com');
redsys.setParameter('DS_MERCHANT_URLKO', 'http://another_url.com');
redsys.setParameter('DS_MERCHANT_CONSUMERLANGUAGE', '002');
redsys.setParameter('DS_MERCHANT_PRODUCTDESCRIPTION', 'Some description');

var key = 'sq7HjrUOBfKmC576ILgskD5srU870gJ7';

var params = redsys.createMerchantParameters();
var signature = redsys.createMerchantSignature(key);

return `
		<!DOCTYPE html>
		<html>

		<head>
		    <title>Test</title>
		</head>

		<body>
		    <form action="https://sis-t.redsys.es:25443/sis/realizarPago" method="POST" accept-charset="UTF-8">
		        <div>
		        	<input type="text" name="Ds_SignatureVersion" value="HMAC_SHA256_V1" />
		    	</div>
		    	<div>
		        	<input type="text" name="Ds_MerchantParameters" value="${params}" />
		        </div>
		        <div>
		        	<input type="text" name="Ds_Signature" value="${signature}" />
		        </div>
		        <input type="submit" value="Submit" />
		    </form>
		</body>

		</html>`;

Verify signature

// let data be the data from the notification request. then
const RedsysAPI = require('redsys-api');

var redsys = new RedsysAPI();
var encoded = data['Ds_MerchantParameters'];
var signature = data['Ds_Signature'];
var key = 'sq7HjrUOBfKmC576ILgskD5srU870gJ7';
if (redsys.checkMerchantSignatureNotif(key, encoded, signature)){
  var decoded = redsys.decodeMerchantParameters(encoded);
  // do something with the decoded data
} else {
  // do something else
}

Notes on createMerchantSignatureNotif(key, encoded, __ )

createMerchantSignatureNotif() is an overloaded method with two declarations. The following declaration, which takes a Signature as an argument, is recommended:

redsys.checkMerchantSignatureNotif(key, encoded, signature)

The method returns a base64 signature to be compared with the original signature. When the other declaration is used, the original signature should be converted to base64 as well.

Buffer.from(signature, 'base64').toString('base64'); // to convert the original signiture to base64

redsys.createMerchantSignatureNotif(key, encoded); // the alternative declaration of the function

License

MIT