spayd-js

An implementation of Short-Payment-Descriptor library in JavaScript/TypeScript. Primarily used for generating QR-Payments.

Installation

# yarn
yarn add spayd

# npm
npm install spayd --save

Usage

import spayd from 'spayd';

const payment = {
  acc: 'CZ2806000000000168540115',
  am: '450.00',
  cc: 'CZK',
  msg: 'Payment for some stuff',
  xvs: '1234567890'
};

// print just the SPAYD string
console.log(spayd(payment));

import qrcode from 'qrcode';
import spayd from 'spayd';

const qrCodeEl = document.getElementById('qr');

const payment = {
  acc: 'CZ2806000000000168540115',
  am: '450.00',
  cc: 'CZK',
  msg: 'Payment for some stuff',
  xvs: '1234567890'
};

const spaydString = spayd(payment);

// generate and assign qr-payment to an image element
qrcode.toDataURL(spaydString)
  .then((url) => {
    qrCodeEl.setAttribute('src', url);
  })
  .catch(console.error);

Options

| Required | Descriptor | Format | Description | Example | | --- | --- | --- | --- | --- | | ☑ | acc | string | account number in IBAN format or IBAN+BIC format | "CZ5855000000001265098001+RZBCCZPP" | | ☐ | altAcc | string[] | array of alternative accounts (usage of these accounts depends on the bank app implementation) | [ "CZ5855000000001265098001+RZBCCZPP", "CZ5855000000001265098001" ] | | ☑ | am | string | amount of money to transfer in floating point number string | "480.55" | | ☐ | cc | string | currency in ISO 4217 format | "CZK" | | ☐ | rf | number | payment identifier for the receiver | 1234567890123456 | | ☐ | rn | string | receiver's name | "PETR DVORAK" | ☐ | dt | Date | due date | new Date(2018, 3, 20) | | ☐ | pt | string | payment type | "P2P" | | ☐ | msg | string | message for receiver | "Payment for some stuff" | | ☐ | crc32 | string | CRC32 hashsum of this SPAYD payment | "1234ABCD" | | ☐ | xper | string | number of days to retry the payment | "7" | | ☐ | xvs | string | variable symbol | "1234567890" | | ☐ | xss | string | specific symbol | "1234567890" | | ☐ | xks | string | constant symbol | "1234567890" | | ☐ | xid | string | payment identifier for the payer | "ABCDEFGHIJ1234567890" |

For more info about SPAYD descriptors, see:

• Ofiicial SPAYD website (CZ)
• SPAYD on Wikipedia (EN)

Package variants

As of version >=3.0, the default export is in the UMD format. This enables you to use the package both in the browser and in nodejs. Plus, it allows it to target legacy browsers, like IE11. If you encounter no troubles with the default export, feel free to keep using it.

If you wanted import specifically an ES6 or CommonJS version of spayd, use the "/esm" or "/cjs" subpath respectively.

// pure ES6 version
import spayd from "spayd/esm";

// CommonJS version
const spayd = require("spayd/cjs");