steplix-emv-qrcps

v0.0.8

Published

2 years ago

Project to generate QRCode in EMV specification formmat.

Downloads

5,730

0High
0Medium
0Low

EMV QRCPS QRcode Payment

This library was made to help people that are using NodeJS to generate and parse EMV QRcode according with the specifications:

Merchant Specification
Consumer Specification

It is a fork of Emmanuel Kiametis library.

This version fixes the CRC generated in cases where the resulting code is less than 4 digits long.

Installing

npm install steplix-emv-qrcps

Modules

There are 2 modules in this library.

Merchant - To work with QRCode according with the Merchant Specification.
Consumer - To work with QRCode according with the Consumer Specification.

Merchant Module

You can use this Module by importing:

const { Merchant } = require('steplix-emv-qrcps');

Methods

buildTLV

const TLV = Merchant.buildTLV(tag, length, value);

| Parameter | Description | Type | | ------ | ------ | ------ | | tag | Payload Format Indicator | string | | length | Point of Initiation Method | number | | value | Merchant Account Information | string |

| Return Type | Description | | ------ | ------ | | TLV | It means an object that stores a Tag + Lenght + Value. |

buildEMVQR

const EMVQR = Merchant.buildEMVQR();

// ... OR

const EMVQR = Merchant.buildEMVQR(
    payloadFormatIndicator,
    pointOfInitiationMethod,
    merchantAccountInformation,
    merchantCategoryCode,
    transactionCurrency,
    transactionAmount,
    tipOrConvenienceIndicator,
    valueOfConvenienceFeeFixed,
    valueOfConvenienceFeePercentage,
    countryCode,
    merchantName,
    merchantCity,
    postalCode,
    additionalDataFieldTemplate,
    crc,
    merchantInformationLanguageTemplate,
    rfuForEMVCo,
    unreservedTemplates,
);

| Parameter | Description | Type | | ------ | ------ | ------ | | payloadFormatIndicator | Payload Format Indicator | TLV | | pointOfInitiationMethod | Point of Initiation Method | TLV | | merchantAccountInformation | Merchant Account Information | map [ id(string) : MerchantAccountInformation ] | | merchantCategoryCode | Merchant Category Code | TLV | | transactionCurrency | Transaction Currency | TLV | | transactionAmount | Transaction Amount | TLV | | tipOrConvenienceIndicator | Tip or Convenience Indicator | TLV | | valueOfConvenienceFeeFixed | Value of Convenience Fee Fixed | TLV | | valueOfConvenienceFeePercentage | Value of Convenience Fee Percentage | TLV | | countryCode | Country Code | TLV | | merchantName | Merchant Name | TLV | | merchantCity | Merchant City | TLV | | postalCode | Postal Code | TLV | | additionalDataFieldTemplate | Additional Data Field Template | AdditionalDataFieldTemplate | | crc | CRC | TLV | | merchantInformationLanguageTemplate | Merchant Information - Language Template | MerchantInformationLanguageTemplate | | rfuForEMVCo | RFU for EMVCo | array [ TLV ] | | unreservedTemplates | Unreserved Templates | map [ id(string) : UnreservedTemplate ] |

| Return Type | Description | | ------ | ------ | | EMVQR | It means an object that represents an EMV QRCode. |

buildAdditionalDataFieldTemplate

const additionalDataFieldTemplate = Merchant.buildAdditionalDataFieldTemplate();

// ... OR

const additionalDataFieldTemplate = Merchant.buildAdditionalDataFieldTemplate(
    billNumber,
    mobileNumber,
    storeLabel,
    loyaltyNumber,
    referenceLabel,
    customerLabel,
    terminalLabel,
    purposeTransaction,
    additionalConsumerDataRequest,
    rfuForEMVCo,
    paymentSystemSpecific
);

| Parameter | Description | Type | | ------ | ------ | ------ | | billNumber | Bill Number | TLV | | mobileNumber | Country Code | TLV | | storeLabel | Store Label | TLV | | loyaltyNumber | Loyalty Number | TLV | | referenceLabel | Reference Label | TLV | | customerLabel | Customer Label | TLV | | terminalLabel | Terminal Label | TLV | | purposeTransaction | Purpose of Transaction | TLV | | additionalConsumerDataRequest | Additional Consumer Data Request | TLV | | rfuForEMVCo | RFU for EMVCo | array [ TLV ] | | paymentSystemSpecific | Payment System specific templates | map [ id(string) : PaymentSystemSpecific ] |

| Return Type | Description | | ------ | ------ | | AdditionalDataFieldTemplate | It means an object that represents an additional data field template. |

buildMerchantInformationLanguageTemplate

const merchantInformationLanguageTemplate = Merchant.buildMerchantInformationLanguageTemplate();

// ... OR

const merchantInformationLanguageTemplate = Merchant.buildMerchantInformationLanguageTemplate(
    languagePreference,
    merchantName,
    merchantCity,
    rfuForEMVCo,
);

| Parameter | Description | Type | | ------ | ------ | ------ | | languagePreference | Language Preference | TLV | | merchantName | Name of the merchant | TLV | | merchantCity | Name of the marchant city | TLV | | rfuForEMVCo | RFU for EMVCo | array [ TLV ] |

| Return Type | Description | | ------ | ------ | | MerchantInformationLanguageTemplate | It means an object that represents a merchant information language template. |

buildMerchantAccountInformation

const merchantAccountInformation = Merchant.buildMerchantAccountInformation();

// ... OR

const merchantAccountInformation = Merchant.buildMerchantAccountInformation(
    globallyUniqueIdentifier,
    paymentNetworkSpecific,
);

| Parameter | Description | Type | | ------ | ------ | ------ | | globallyUniqueIdentifier | Globally unique identifier | TLV | | paymentNetworkSpecific | Array of payment network specific | array [ TLV ] |

| Return Type | Description | | ------ | ------ | | MerchantAccountInformation | It means an object that represents a merchant account information. |

buildUnreservedTemplate

const unreservedTemplate = Merchant.buildUnreservedTemplate();

// ... OR

const unreservedTemplate = Merchant.buildUnreservedTemplate(
    globallyUniqueIdentifier,
    paymentNetworkSpecific,
);

| Parameter | Description | Type | | ------ | ------ | ------ | | globallyUniqueIdentifier | Globally unique identifier | TLV | | contextSpecificData | Array of context of specific data | array [ TLV ] |

| Return Type | Description | | ------ | ------ | | UnreservedTemplate | It means an object that represents an unreserved template. |

Object Types

TLV

Represents a TAG + Length + Value.

const { Merchant } = require('steplix-emv-qrcps');
const { Constants } = Merchant;

const tag = "01";
const value = "Example";
const length = value.length;

const TLV = Merchant.buildTLV(tag, length, value);

Methods

toString

const tlvStringFormat = TLV.toString();

| Return Type | Description | | ------ | ------ | | string | TLV in string format |

dataWithType

const tlvBinaryFormat = TLV.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const tlvRawFormat = TLV.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Parameters | Description | Type | | ------ | ------ | ------ | | dataType | Data type value | Constants.DATA_TYPE.BINARY | Constants.DATA_TYPE.RAW | | indent | Indent character (Ex.: ' ') | string |

| Return Type | Description | | ------ | ------ | | string | TLV in binary OR raw data format |

MerchantAccountInformation

Represents a merchant account information.

const { Merchant } = require('steplix-emv-qrcps');
const { Constants } = Merchant;

const merchantAccountInformation = Merchant.buildMerchantAccountInformation();

Methods

toString

const merchantAccountInformationStringFormat = merchantAccountInformation.toString();

| Return Type | Description | | ------ | ------ | | string | MerchantAccountInformation in TLV string format |

dataWithType

const merchantAccountInformationBinaryFormat = merchantAccountInformation.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const merchantAccountInformationRawFormat = merchantAccountInformation.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | MerchantAccountInformation in TLV binary OR TLV raw data format |

setGloballyUniqueIdentifier

const value = "15600000000";

merchantAccountInformation.setGloballyUniqueIdentifier(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

addPaymentNetworkSpecific

const id = "03";
const value = "12345678";

merchantAccountInformation.addPaymentNetworkSpecific(id, value);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some value | string |

MerchantInformationLanguageTemplate

Represents a merchant information language template.

const { Merchant } = require('steplix-emv-qrcps');
const { Constants } = Merchant;

const merchantInformationLanguageTemplate = Merchant.buildMerchantInformationLanguageTemplate();

Methods

toString

const merchantInformationLanguageTemplateStringFormat = merchantInformationLanguageTemplate.toString();

| Return Type | Description | | ------ | ------ | | string | MerchantInformationLanguageTemplate in TLV string format |

dataWithType

const merchantInformationLanguageTemplateBinaryFormat = merchantInformationLanguageTemplate.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const merchantInformationLanguageTemplateRawFormat = merchantInformationLanguageTemplate.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | MerchantInformationLanguageTemplate in TLV binary OR TLV raw data format |

validate

const isValid = merchantInformationLanguageTemplate.validate();

| Return Type | Description | | ------ | ------ | | boolean | True if required properties is valid otherwise throw an Error |

setLanguagePreference

const value = "PT";

merchantInformationLanguageTemplate.setLanguagePreference(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setMerchantName

const value = "Merchant Organization";

merchantInformationLanguageTemplate.setMerchantName(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setMerchantCity

const value = "Brasilia";

merchantInformationLanguageTemplate.setMerchantCity(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

addRFUforEMVCo

const id = "03";
const value = "12345678";

merchantInformationLanguageTemplate.addRFUforEMVCo(id, value);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some value | string |

UnreservedTemplate

Represents a merchant account information.

const { Merchant } = require('steplix-emv-qrcps');
const { Constants } = Merchant;

const unreservedTemplate = Merchant.buildUnreservedTemplate();

Methods

toString

const unreservedTemplateStringFormat = unreservedTemplate.toString();

| Return Type | Description | | ------ | ------ | | string | UnreservedTemplate in TLV string format |

dataWithType

const unreservedTemplateBinaryFormat = unreservedTemplate.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const unreservedTemplateRawFormat = unreservedTemplate.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | UnreservedTemplate in TLV binary OR TLV raw data format |

setGloballyUniqueIdentifier

const value = "15600000000";

unreservedTemplate.setGloballyUniqueIdentifier(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

addContextSpecificData

const id = "03";
const value = "12345678";

unreservedTemplate.addContextSpecificData(id, value);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some value | string |

PaymentSystemSpecific

Represents a payment system specific.

const { Merchant } = require('steplix-emv-qrcps');
const { Constants } = Merchant;

const paymentSystemSpecific = Merchant.buildPaymentSystemSpecific();

Methods

toString

const paymentSystemSpecificStringFormat = paymentSystemSpecific.toString();

| Return Type | Description | | ------ | ------ | | string | PaymentSystemSpecific in TLV string format |

dataWithType

const paymentSystemSpecificBinaryFormat = paymentSystemSpecific.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const paymentSystemSpecificRawFormat = paymentSystemSpecific.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | PaymentSystemSpecific in TLV binary OR TLV raw data format |

setGloballyUniqueIdentifier

const value = "15600000000";

paymentSystemSpecific.setGloballyUniqueIdentifier(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

addPaymentSystemSpecific

const id = "03";
const value = "12345678";

paymentSystemSpecific.addPaymentSystemSpecific(id, value);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some value | string |

AdditionalDataFieldTemplate

Represents an additional data field template.

const { Merchant } = require('steplix-emv-qrcps');
const { Constants } = Merchant;

const additionalDataFieldTemplate = Merchant.buildAdditionalDataFieldTemplate();

Methods

toString

const additionalDataFieldTemplateStringFormat = additionalDataFieldTemplate.toString();

| Return Type | Description | | ------ | ------ | | string | AdditionalDataFieldTemplate in TLV string format |

dataWithType

const additionalDataFieldTemplateBinaryFormat = additionalDataFieldTemplate.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const additionalDataFieldTemplateRawFormat = additionalDataFieldTemplate.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | AdditionalDataFieldTemplate in TLV binary OR TLV raw data format |

setBillNumber

const value = "34250";

additionalDataFieldTemplate.setBillNumber(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setMobileNumber

const value = "+5561991112222";

additionalDataFieldTemplate.setMobileNumber(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setStoreLabel

const value = "1234";

additionalDataFieldTemplate.setStoreLabel(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setLoyaltyNumber

const value = "12345";

additionalDataFieldTemplate.setLoyaltyNumber(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setReferenceLabel

const value = "example";

additionalDataFieldTemplate.setReferenceLabel(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setCustomerLabel

const value = "***";

additionalDataFieldTemplate.setCustomerLabel(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setTerminalLabel

const value = "A6008667";

additionalDataFieldTemplate.setTerminalLabel(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setPurposeTransaction

const value = "Some purpose";

additionalDataFieldTemplate.setPurposeTransaction(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setAdditionalConsumerDataRequest

const value = "ME";

additionalDataFieldTemplate.setAdditionalConsumerDataRequest(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

addRFUforEMVCo

const id = "03";
const value = "12345678";

additionalDataFieldTemplate.addRFUforEMVCo(id, value);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some value | string |

addPaymentSystemSpecific

const id = "03";
const value = Merchant.buildPaymentSystemSpecific();
value.setGloballyUniqueIdentifier("15600000000");
value.addPaymentSystemSpecific("03", "12345678");

additionalDataFieldTemplate.addPaymentSystemSpecific(id, value);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some value | string |

EMVQR

Represents an EMV QRCode.

const { Merchant } = require('steplix-emv-qrcps');
const { Constants } = Merchant;

const emvqr = Merchant.buildEMVQR();

Methods

generatePayload

const emvqrStringFormat = emvqr.generatePayload();

| Return Type | Description | | ------ | ------ | | string | EMV QRCode payload in string format. |

dataWithType

const emvqrBinaryFormat = emvqr.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const emvqrRawFormat = emvqr.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | EMV QRCode in binary OR raw data format |

toBinary

const emvqrBinaryFormat = emvqr.toBinary(); // Binary Data (shown as hex bytes)

| Return Type | Description | | ------ | ------ | | string | EMV QRCode in binary format |

rawData

const emvqrBinaryFormat = emvqr.rawData(); // Raw Data

| Return Type | Description | | ------ | ------ | | string | EMV QRCode in raw data format |

validate

const isValid = emvqr.validate();

| Return Type | Description | | ------ | ------ | | boolean | True if required properties is valid otherwise throw an Error |

setPayloadFormatIndicator

const value = "01";

emvqr.setPayloadFormatIndicator(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setPointOfInitiationMethod

const value = "00";

emvqr.setPointOfInitiationMethod(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setMerchantCategoryCode

const value = "Technology";

emvqr.setMerchantCategoryCode(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setTransactionCurrency

const value = "BRL";

emvqr.setTransactionCurrency(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setTransactionAmount

const value = "20.5";

emvqr.setTransactionAmount(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setTipOrConvenienceIndicator

const value = "2";

emvqr.setTipOrConvenienceIndicator(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setValueOfConvenienceFeeFixed

const value = "2.00";

emvqr.setValueOfConvenienceFeeFixed(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setValueOfConvenienceFeePercentage

const value = "0.90";

emvqr.setValueOfConvenienceFeePercentage(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setCountryCode

const value = "55";

emvqr.setCountryCode(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setMerchantName

const value = "Merchant Organization";

emvqr.setMerchantName(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setMerchantCity

const value = "Brasilia";

emvqr.setMerchantCity(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setPostalCode

const value = "71715-000";

emvqr.setPostalCode(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setCRC

const value = "AF35";

emvqr.setCRC(value);

| Parameters | Description | Type | | ------ | ------ | ------ | | value | Some value | string |

setAdditionalDataFieldTemplate

const additionalDataFieldTemplate = Merchant.buildAdditionalDataFieldTemplate();
additionalDataFieldTemplate.setStoreLabel("1234");
additionalDataFieldTemplate.setCustomerLabel("***");
additionalDataFieldTemplate.setTerminalLabel("A6008667");
additionalDataFieldTemplate.setAdditionalConsumerDataRequest("ME");

emvqr.setAdditionalDataFieldTemplate(additionalDataFieldTemplate);

| Parameters | Description | Type | | ------ | ------ | ------ | | additionalDataFieldTemplate | Some additional data field template | AdditionalDataFieldTemplate |

setMerchantInformationLanguageTemplate

let merchantInformationLanguageTemplate = Merchant.buildMerchantInformationLanguageTemplate();
merchantInformationLanguageTemplate.setLanguagePreference("PT");
merchantInformationLanguageTemplate.setMerchantName("Merchant Organization");
merchantInformationLanguageTemplate.setMerchantCity("Brasilia");
emvqr.setMerchantInformationLanguageTemplate(merchantInformationLanguageTemplate);

| Parameters | Description | Type | | ------ | ------ | ------ | | merchantInformationLanguageTemplate | Some merchant information language template | MerchantInformationLanguageTemplate |

addMerchantAccountInformation

const id = "27";

const merchantAccountInformation = Merchant.buildMerchantAccountInformation();
merchantAccountInformation.setGloballyUniqueIdentifier("com.p2pqrpay");
merchantAccountInformation.addPaymentNetworkSpecific("01", "PAPHPHM1XXX");
merchantAccountInformation.addPaymentNetworkSpecific("02", "99964403");
merchantAccountInformation.addPaymentNetworkSpecific("04", "09985903943");
merchantAccountInformation.addPaymentNetworkSpecific("05", "+639985903943");

emvqr.addMerchantAccountInformation(id, merchantAccountInformation);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some merchant account information | string |

addUnreservedTemplates

const id = "80";

const unreservedTemplate = Merchant.buildUnreservedTemplate();
unreservedTemplate.setGloballyUniqueIdentifier("A011223344998877");
unreservedTemplate.addContextSpecificData("07", "12345678");

emvqr.addUnreservedTemplates(id, unreservedTemplate);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some unreserved template | string |

addRFUforEMVCo

const id = "03";
const value = "12345678";

emvqr.addRFUforEMVCo(id, value);

| Parameters | Description | Type | | ------ | ------ | ------ | | id | Tag ID | string | | value | Some value | string |

Consumer Module

You can use this Module by importing:

const { Consumer } = require('steplix-emv-qrcps')

Methods

buildBERTLV

const berTLV = Consumer.buildBERTLV();

// ... OR

const berTLV = Consumer.buildBERTLV(
    dataApplicationDefinitionFileName,
    dataApplicationLabel,
    dataTrack2EquivalentData,
    dataApplicationPAN,
    dataCardholderName,
    dataLanguagePreference,
    dataIssuerURL,
    dataApplicationVersionNumber,
    dataIssuerApplicationData,
    dataTokenRequestorID,
    dataPaymentAccountReference,
    dataLast4DigitsOfPAN,
    dataApplicationCryptogram,
    dataApplicationTransactionCounter,
    dataUnpredictableNumber
);

| Parameter | Description | Type | | ------ | ------ | ------ | | dataApplicationDefinitionFileName | Application Definition Name | string(in-hex-decimal-format) | | dataApplicationLabel | Application Label | string | | dataTrack2EquivalentData | Track to equivalent data | string(in-hex-decimal-format) | | dataApplicationPAN | Application PAN | string(in-hex-decimal-format) | | dataCardholderName | Cardholder Name | string | | dataLanguagePreference | Language Preference | string | | dataIssuerURL | Issuer URL | string | | dataApplicationVersionNumber | Application Version Number | string(in-hex-decimal-format) | | dataIssuerApplicationData | Issuer Application Data | string(in-hex-decimal-format) | | dataTokenRequestorID | Token Requestor ID | string(in-hex-decimal-format) | | dataPaymentAccountReference | Payment Account Reference | string(in-hex-decimal-format) | | dataLast4DigitsOfPAN | Last 4 digits of PAN | string(in-hex-decimal-format) | | dataApplicationCryptogram | Application Cryptogram | string(in-hex-decimal-format) | | dataApplicationTransactionCounter | Application Transaction Counter | string(in-hex-decimal-format) | | dataUnpredictableNumber | Unpredictable Number | string(in-hex-decimal-format) |

| Return Type | Description | | ------ | ------ | | BERTLV | It means the TLV Object of the consumer module. |

buildApplicationSpecificTransparentTemplate

const applicationSpecificTransparentTemplate = Consumer.buildApplicationSpecificTransparentTemplate();

// ... OR

const applicationSpecificTransparentTemplate = Consumer.buildApplicationSpecificTransparentTemplate(
	berTLV = BERTLV()
);

| Parameter | Description | Type | | ------ | ------ | ------ | | berTLV | BERTLV Object | BERTLV |

| Return Type | Description | | ------ | ------ | | ApplicationSpecificTransparentTemplate | It means an object that stores an application specific transparent template. |

buildApplicationTemplate

const applicationTemplate = Consumer.buildApplicationTemplate();

// ... OR

const applicationTemplate = Consumer.buildApplicationTemplate(
	berTLV = BERTLV(),
	applicationSpecificTransparentTemplates = []
);

| Parameter | Description | Type | | ------ | ------ | ------ | | berTLV | BERTLV Object | BERTLV | | applicationSpecificTransparentTemplates | Application specific transparent templates | array (ApplicationSpecificTransparentTemplate) |

| Return Type | Description | | ------ | ------ | | ApplicationTemplate | It means an object that stores an application template. |

buildCommonDataTransparentTemplate

const commonDataTransparentTemplate = Consumer.buildCommonDataTransparentTemplate();

// ... OR

const commonDataTransparentTemplate = Consumer.buildCommonDataTransparentTemplate(
    berTLV = BERTLV()
);

| Parameter | Description | Type | | ------ | ------ | ------ | | berTLV | BERTLV Object | BERTLV |

| Return Type | Description | | ------ | ------ | | CommonDataTransparentTemplate | It means an object that stores a common data transparent template. |

buildCommonDataTemplate

const commonDataTemplate = Consumer.buildCommonDataTemplate();

// ... OR

const commonDataTemplate = Consumer.buildCommonDataTemplate(
    berTLV = BERTLV(),
	commonDataTransparentTemplates = [] 
);

| Parameter | Description | Type | | ------ | ------ | ------ | | berTLV | BERTLV Object | BERTLV | | commonDataTransparentTemplates | Common data transparent templates | array (CommonDataTransparentTemplate) |

| Return Type | Description | | ------ | ------ | | CommonDataTemplate | It means an object that stores a common data template. |

buildEMVQR

const EMVQR = Consumer.buildEMVQR();

// ... OR

const EMVQR = Consumer.buildEMVQR(
    dataPayloadFormatIndicator,
    applicationTemplates,
    commonDataTemplates
);

| Parameter | Description | Type | | ------ | ------ | ------ | | dataPayloadFormatIndicator | Payload Format Indicator | string | | applicationTemplates | Application Templates | array [ ApplicationTemplate ] | | commonDataTemplates | Common Data templates | array [ CommonDataTemplate ] |

| Return Type | Description | | ------ | ------ | | EMVQR | It means an object that represents an EMV QRCode. |

Object Types

BERTLV

Represents a Basic Encoding Rules TAG + Length + Value.

const { Consumer } = require('steplix-emv-qrcps');
const { Constants } = Merchant;

const berTLV = Merchant.buildBERTLV();

Methods

setDataApplicationDefinitionFileName

berTLV.setDataApplicationDefinitionFileName("A0000000555555");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataApplicationDefinitionFileName | Application Definition File (ADF) Name | string(in-hex-decimal-format) |

setDataApplicationLabel

berTLV.setDataApplicationLabel("Product1");

| Parameters | Description | Type | | ------ | ------ | ------ | | setDataApplicationLabel | Application Label | string |

setDataTrack2EquivalentData

berTLV.setDataTrack2EquivalentData("AABBCCDD");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataTrack2EquivalentData | Track 2 Equivalent Data | string(in-hex-decimal-format) |

setDataApplicationPAN

berTLV.setDataApplicationPAN("1234567890123458");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataApplicationPAN | Application PAN | string(in-hex-decimal-format) |

setDataCardholderName

berTLV.setDataCardholderName("CARDHOLDER/EMV");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataCardholderName | Cardholder Name | string |

setDataLanguagePreference

berTLV.setDataLanguagePreference("ruesdeen");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataLanguagePreference | Language Preference | string |

setDataIssuerURL

berTLV.setDataIssuerURL("http://someuri.com");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataIssuerURL | Issuer URL | string |

setDataApplicationVersionNumber

berTLV.setDataApplicationVersionNumber("04");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataApplicationVersionNumber | Application Version Number | string(in-hex-decimal-format) |

setDataIssuerApplicationData

berTLV.setDataIssuerApplicationData("06010A03000000");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataIssuerApplicationData | Issuer application data | string(in-hex-decimal-format) |

setDataTokenRequestorID

berTLV.setDataTokenRequestorID("0601AABBCC");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataTokenRequestorID | Token Requestor ID | string(in-hex-decimal-format) |

setDataPaymentAccountReference

berTLV.setDataPaymentAccountReference("0708AABBCCDD");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataPaymentAccountReference | Payment Account Reference | string(in-hex-decimal-format) |

setDataLast4DigitsOfPAN

berTLV.setDataLast4DigitsOfPAN("07080201");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataLast4DigitsOfPAN | Last 4 Digits of PAN | string(in-hex-decimal-format) |

setDataApplicationCryptogram

berTLV.setDataApplicationCryptogram("584FD385FA234BCC");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataApplicationCryptogram | Application Cryptogram | string(in-hex-decimal-format) |

setDataApplicationTransactionCounter

berTLV.setDataApplicationTransactionCounter("0001");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataApplicationTransactionCounter | Application Transaction Counter | string(in-hex-decimal-format) |

setDataUnpredictableNumber

berTLV.setDataUnpredictableNumber("6D58EF13");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataUnpredictableNumber | Unpredictable Number | string(in-hex-decimal-format) |

format

berTLV.format();

| Return Type | Description | | ------ | ------ | | string | BERTLV in string format |

dataWithType

const berTlvBinaryFormat = berTLV.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const berTlvRawFormat = berTLV.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | BERTLV in binary OR raw data format |

ApplicationSpecificTransparentTemplate

Represents an application specific transparent template.

const { Consumer } = require('steplix-emv-qrcps');
const { Constants } = Consumer;

const applicationSpecificTransparentTemplate = Consumer.buildApplicationSpecificTransparentTemplate();

Methods

setBERTLV

const berTLV = Consumer.buildBERTLV();

// Setters assignments in berTLV

applicationSpecificTransparentTemplate.setBERTLV(berTLV);

| Parameters | Description | Type | | ------ | ------ | ------ | | berTLV | BERTLV Object | BERTLV |

format

applicationSpecificTransparentTemplate.format();

| Return Type | Description | | ------ | ------ | | string | ApplicationSpecificTransparentTemplate in string format |

dataWithType

const binaryFormat = applicationSpecificTransparentTemplate.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const rawFormat = applicationSpecificTransparentTemplate.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | Application specific transparent template in binary OR raw data format |

CommonDataTransparentTemplate

Represents a common data transparent template.

const { Consumer } = require('steplix-emv-qrcps');
const { Constants } = Consumer;

const commonDataTransparentTemplate = Consumer.buildCommonDataTransparentTemplate();

Methods

setBERTLV

const berTLV = Consumer.buildBERTLV();

// Setters assignments in berTLV

commonDataTransparentTemplate.setBERTLV(berTLV);

| Parameters | Description | Type | | ------ | ------ | ------ | | berTLV | BERTLV Object | BERTLV |

format

commonDataTransparentTemplate.format();

| Return Type | Description | | ------ | ------ | | string | CommonDataTransparentTemplate in string format |

dataWithType

const binaryFormat = commonDataTransparentTemplate.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const rawFormat = commonDataTransparentTemplate.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | Common data transparent template in binary OR raw data format |

ApplicationTemplate

Represents an application template.

const { Consumer } = require('steplix-emv-qrcps');
const { Constants } = Consumer;

const applicationTemplate = Consumer.buildApplicationTemplate();

Methods

setBERTLV

const berTLV = Consumer.buildBERTLV();

// Setters assignments in berTLV

applicationTemplate.setBERTLV(berTLV);

| Parameters | Description | Type | | ------ | ------ | ------ | | berTLV | BERTLV Object | BERTLV |

addApplicationSpecificTransparentTemplate

const applicationSpecificTransparentTemplate = Consumer.buildApplicationSpecificTransparentTemplate();

const berTLV1 = Consumer.buildBERTLV();
berTLV1.setDataApplicationDefinitionFileName("A0000000555555");
berTLV1.setDataApplicationLabel("Product1");
applicationSpecificTransparentTemplate.setBERTLV(berTLV1);

applicationTemplate.addApplicationSpecificTransparentTemplate(applicationSpecificTransparentTemplate);

| Parameters | Description | Type | | ------ | ------ | ------ | | applicationSpecificTransparentTemplate | An application specific transparent template | ApplicationSpecificTransparentTemplate |

format

applicationTemplate.format();

| Return Type | Description | | ------ | ------ | | string | ApplicationTemplate in string format |

dataWithType

const binaryFormat = applicationTemplate.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const rawFormat = applicationTemplate.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | Common data transparent template in binary OR raw data format |

CommonDataTemplate

Represents a common data template.

const { Consumer } = require('steplix-emv-qrcps');
const { Constants } = Consumer;

const commonDataTemplate = Consumer.buildCommonDataTemplate();

Methods

setBERTLV

const berTLV = Consumer.buildBERTLV();

// Setters assignments in berTLV

commonDataTemplate.setBERTLV(berTLV);

| Parameters | Description | Type | | ------ | ------ | ------ | | berTLV | BERTLV Object | BERTLV |

addCommonDataTransparentTemplate

const commonDataTransparentTemplate = Consumer.buildCommonDataTransparentTemplate();

const berTLV = Consumer.buildBERTLV();
berTLV.setDataIssuerApplicationData("06010A03000000");
berTLV.setDataApplicationCryptogram("584FD385FA234BCC");
berTLV.setDataApplicationTransactionCounter("0001");
berTLV.setDataUnpredictableNumber("6D58EF13");
commonDataTransparentTemplate.setBERTLV(berTLV);

commonDataTemplate.addCommonDataTransparentTemplate(commonDataTransparentTemplate);

| Parameters | Description | Type | | ------ | ------ | ------ | | commonDataTransparentTemplate | A common data transparent template | CommonDataTransparentTemplate |

format

commonDataTemplate.format();

| Return Type | Description | | ------ | ------ | | string | CommonDataTemplate in string format |

dataWithType

const binaryFormat = commonDataTemplate.dataWithType(Constants.DATA_TYPE.BINARY, ' '); // Binary Data (shown as hex bytes)

// OR

const rawFormat = commonDataTemplate.dataWithType(Constants.DATA_TYPE.RAW, ' '); // Raw Data

| Return Type | Description | | ------ | ------ | | string | Common data transparent template in binary OR raw data format |

EMVQR

Represents an EMV QRCode.

const { Consumer } = require('steplix-emv-qrcps');
const { Constants } = Consumer;

const emvqr = Consumer.buildEMVQR();

Methods

setDataPayloadFormatIndicator

emvqr.setDataPayloadFormatIndicator("CPV01");

| Parameters | Description | Type | | ------ | ------ | ------ | | dataPayloadFormatIndicator | Payload Format Indicator | string |

addApplicationTemplate

const applicationTemplate1 = Consumer.buildApplicationTemplate();
const berTLV1 = Consumer.buildBERTLV();
berTLV1.setDataApplicationDefinitionFileName("A0000000555555");
berTLV1.setDataApplicationLabel("Product1");
applicationTemplate1.setBERTLV(berTLV1);

emvqr.addApplicationTemplate(applicationTemplate1);

const applicationTemplate2 = Consumer.buildApplicationTemplate();
const berTLV2 = Consumer.buildBERTLV();
berTLV2.setDataApplicationDefinitionFileName("A0000000666666");
berTLV2.setDataApplicationLabel("Product2");
applicationTemplate2.setBERTLV(berTLV2);

emvqr.addApplicationTemplate(applicationTemplate2);

| Parameters | Description | Type | | ------ | ------ | ------ | | applicationTemplate | An application template | ApplicationTemplate |

addCommonDataTemplate

const commonDataTemplate = Consumer.buildCommonDataTemplate();

const berTLV1 = Consumer.buildBERTLV();
berTLV1.setDataApplicationPAN("1234567890123458");
berTLV1.setDataCardholderName("CARDHOLDER/EMV");
berTLV1.setDataLanguagePreference("ruesdeen");
commonDataTemplate.setBERTLV(berTLV1);

const commonDataTransparentTemplate = Consumer.buildCommonDataTransparentTemplate();

const berTLV2 = Consumer.buildBERTLV();
berTLV2.setDataIssuerApplicationData("06010A03000000");
berTLV2.setDataApplicationCryptogram("584FD385FA234BCC");
berTLV2.setDataApplicationTransactionCounter("0001");
berTLV2.setDataUnpredictableNumber("6D58EF13");
commonDataTransparentTemplate.setBERTLV(berTLV2);

commonDataTemplate.addCommonDataTransparentTemplate(commonDataTransparentTemplate);

emvqr.addCommonDataTemplate(commonDataTemplate);

| Parameters | Description | Type | | ------ | ------ | ------ | | commonDataTemplate | A common data template | CommonDataTemplate |

generatePayload

commonDataTemplate.generatePayload();

| Return Type | Description | | ------ | ------ | | string | EMVQR in base64 string format |

toBinary

const emvqrBinaryFormat = emvqr.toBinary(); // Binary Data (shown as hex bytes)

| Return Type | Description | | ------ | ------ | | string | EMV QRCode in binary format |

rawData

const emvqrBinaryFormat = emvqr.rawData(); // Raw Data

| Return Type | Description | | ------ | ------ | | string | EMV QRCode in raw data format |

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

Installing

Modules

Merchant Module

Methods

buildTLV

buildEMVQR

buildAdditionalDataFieldTemplate

buildMerchantInformationLanguageTemplate

buildMerchantAccountInformation

buildUnreservedTemplate

Object Types

TLV

Methods

toString

dataWithType

MerchantAccountInformation

Methods

toString

dataWithType

setGloballyUniqueIdentifier

addPaymentNetworkSpecific

MerchantInformationLanguageTemplate

Methods

toString

dataWithType

validate

setLanguagePreference

setMerchantName

setMerchantCity

addRFUforEMVCo

UnreservedTemplate

Methods

toString

dataWithType

setGloballyUniqueIdentifier

addContextSpecificData

PaymentSystemSpecific

Methods

toString

dataWithType

setGloballyUniqueIdentifier

addPaymentSystemSpecific

AdditionalDataFieldTemplate

Methods

toString

dataWithType

setBillNumber

setMobileNumber

setStoreLabel

setLoyaltyNumber

setReferenceLabel

setCustomerLabel

setTerminalLabel

setPurposeTransaction

setAdditionalConsumerDataRequest

addRFUforEMVCo

addPaymentSystemSpecific

EMVQR

Methods

generatePayload

dataWithType

toBinary

rawData

validate

setPayloadFormatIndicator

setPointOfInitiationMethod

setMerchantCategoryCode

setTransactionCurrency

setTransactionAmount

setTipOrConvenienceIndicator

setValueOfConvenienceFeeFixed

setValueOfConvenienceFeePercentage

setCountryCode

setMerchantName