Girocode - create EPC QR codes for SEPA bank transfers

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

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