/girocode

Generate EPC QR codes for SEPA credit transfers

Primary LanguageRubyMIT LicenseMIT

Gem Version build

Girocode - create EPC QR codes for SEPA bank transfers

Pure Ruby library to generate EPC QR codes in SVG, PNG, HTML or ASCII format

Girocode

Installation

Add this line to your application's Gemfile:

gem 'girocode'

Usage

code = Girocode.new(iban: 'DE02100500000054540402',
                    name: 'Beispiel AG',
                    currency: 'EUR', amount: 123.45,
                    reference: 'RE 2019/05/445 744507')
code.to_svg
code.to_png
code.to_html
code.to_ascii

# in your console
puts code.to_ansi

Supported attributes

Codes can be generated with the following attributes:

Attribute Description required max size
bic Bank Identifier Code 11
name Name of beneficiary 70
iban IBAN 34
currency ISO-4217 currency code if amount given 3
amount Money amount 12
purpose SEPA purpose code 4
creditor_reference ISO-11649 creditor reference 35
reference Unstructured reference 140
bto_info Beneficiary to originator info 70

Limitations

Codes are generated as EPC-QR Version 2 in UTF-8 format only.

Specification

European Payments Council: Quick Response Code

Guidelines to enable data capture for the initiation of a SEPA credit transfer