Skip to content
HALOWERK

Bildwerk

girocode generate

Assembles the EPC069-12 v3.1 (19 March 2024) payload: service tag BCD, version 001/002, character set 1–8 (UTF-8 or ISO 8859-1/-2/-4/-5/-7/-10/-15), SCT, BIC (mandatory in 001), name ≤70, IBAN (structure and check digits), amount "EUR" 0.01–999999999.99 with at most two decimals, purpose code, either an ISO 11649 RF reference or unstructured text ≤140, information ≤70; trailing empty elements are omitted. Rejects payloads above 331 bytes and characters the chosen set cannot encode. The QR.

POST https://bild.halowerk.com/v1/girocode-generate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
namestringYesBeneficiary name.
ibanstringYesBeneficiary IBAN; spaces are removed.
bicstringNoBIC (8 or 11 characters); mandatory for version 001, optional for 002.
amountnumberNoAmount in EUR with at most two decimals.
purposestringNoISO 20022 purpose code, e.g. CHAR or GDDS.
referencestringNoStructured creditor reference, ISO 11649 RF recommended. Excludes text.
textstringNoUnstructured remittance information. Excludes reference.
informationstringNoBeneficiary-to-originator information shown to the payer.
versionstringNo
character_setintegerNo1 UTF-8, 2 ISO-8859-1, 3 ISO-8859-2, 4 ISO-8859-4, 5 ISO-8859-5, 6 ISO-8859-7, 7 ISO-8859-10, 8 ISO-8859-15.
line_endingstringNo
outputstringNo
module_pxintegerNoPNG pixels per module.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "name",
    "iban"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 70,
      "description": "Beneficiary name."
    },
    "iban": {
      "type": "string",
      "minLength": 15,
      "maxLength": 42,
      "description": "Beneficiary IBAN; spaces are removed."
    },
    "bic": {
      "type": "string",
      "minLength": 8,
      "maxLength": 14,
      "description": "BIC (8 or 11 characters); mandatory for version 001, optional for 002."
    },
    "amount": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 999999999.99,
      "description": "Amount in EUR with at most two decimals."
    },
    "purpose": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4,
      "description": "ISO 20022 purpose code, e.g. CHAR or GDDS."
    },
    "reference": {
      "type": "string",
      "minLength": 1,
      "maxLength": 35,
      "description": "Structured creditor reference, ISO 11649 RF recommended. Excludes text."
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 140,
      "description": "Unstructured remittance information. Excludes reference."
    },
    "information": {
      "type": "string",
      "minLength": 1,
      "maxLength": 70,
      "description": "Beneficiary-to-originator information shown to the payer."
    },
    "version": {
      "type": "string",
      "enum": [
        "001",
        "002"
      ],
      "default": "002"
    },
    "character_set": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "default": 1,
      "description": "1 UTF-8, 2 ISO-8859-1, 3 ISO-8859-2, 4 ISO-8859-4, 5 ISO-8859-5, 6 ISO-8859-7, 7 ISO-8859-10, 8 ISO-8859-15."
    },
    "line_ending": {
      "type": "string",
      "enum": [
        "LF",
        "CRLF"
      ],
      "default": "LF"
    },
    "output": {
      "type": "string",
      "enum": [
        "svg",
        "png",
        "both",
        "payload"
      ],
      "default": "both"
    },
    "module_px": {
      "type": "integer",
      "minimum": 2,
      "maximum": 30,
      "default": 8,
      "description": "PNG pixels per module."
    }
  }
}

Open original schema

Published input example

{
  "name": "Warehouse purchasing department",
  "iban": "DE79000000001234567890",
  "amount": 12.3,
  "purpose": "GDDS",
  "reference": "RF18539007547034",
  "version": "002",
  "output": "svg"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →