Skip to content
HALOWERK

Formatwerk

sepa credit transfer xml

Generate mode builds pain.001.001.09 (ISO 20022 2019, current DK version) with xmlbuilder2: group and payment level NbOfTxs/CtrlSum, SvcLvl SEPA, optional INST for instant transfers, ChrgBr SLEV, structured or hybrid addresses, unstructured (max 140) or ISO 11649 structured remittance; texts are converted to the DK or EPC character set and every change is listed. Validate mode parses pain.001.001.09 or the legacy pain.001.001.03 with fast-xml-parser and checks namespace, BOM and prefixes,.

POST https://format.halowerk.com/v1/sepa-credit-transfer-xml

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
xmlstringNoExisting pain.001 file to validate. If given, the generation fields are ignored.
debtorobjectNoOrdering party (generate mode).
execution_datestringNoRequested execution date (generate mode).
transactionsarrayNoCredit transfers (generate mode).
message_idstringNoMessage id; default derived from the content.
payment_information_idstringNoPayment information id; default derived from the content.
created_atstringNoCreation timestamp; default now.
initiating_partystringNoInitiating party name; default debtor name.
ultimate_debtorstringNoUltimate debtor for the whole batch.
batch_bookingbooleanNotrue = one batch booking, false = single bookings.
instantbooleanNoSEPA instant credit transfer (LclInstrm INST).
category_purposestringNoCategory purpose code, e.g. SALA.
charsetstringNodk = Latin set plus Ä Ö Ü ä ö ü ß & * $ % (German banks, DK Appendix 3); epc = EPC basic Latin set only.
reference_datestringNoReference date for date checks (submission date), default today (UTC).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "xml": {
      "type": "string",
      "maxLength": 5000000,
      "description": "Existing pain.001 file to validate. If given, the generation fields are ignored."
    },
    "debtor": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "iban"
      ],
      "description": "Ordering party (generate mode).",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 140,
          "description": "Debtor name (max 70 after cleaning)."
        },
        "iban": {
          "type": "string",
          "minLength": 1,
          "maxLength": 42,
          "description": "Debtor IBAN."
        },
        "bic": {
          "type": "string",
          "minLength": 1,
          "maxLength": 11,
          "description": "Debtor bank BIC (optional, NOTPROVIDED otherwise)."
        },
        "address": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "town",
            "country"
          ],
          "description": "Structured or hybrid postal address (town and country mandatory since 5 October 2025).",
          "properties": {
            "street": {
              "type": "string",
              "minLength": 1,
              "maxLength": 70,
              "description": "Street name."
            },
            "building_number": {
              "type": "string",
              "minLength": 1,
              "maxLength": 16,
              "description": "Building number."
            },
            "postal_code": {
              "type": "string",
              "minLength": 1,
              "maxLength": 16,
              "description": "Postal code."
            },
            "town": {
              "type": "string",
              "minLength": 1,
              "maxLength": 35,
              "description": "Town."
            },
            "country": {
              "type": "string",
              "pattern": "^[A-Z]{2}$",
              "description": "ISO 3166 country code."
            },
            "address_lines": {
              "type": "array",
              "maxItems": 2,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 70,
                "description": "Free address line."
              },
              "description": "At most two free lines (hybrid address)."
            }
          }
        }
      }
    },
    "execution_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Requested execution date (generate mode)."
    },
    "transactions": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5000,
      "description": "Credit transfers (generate mode).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "amount",
          "creditor"
        ],
        "properties": {
          "amount": {
            "type": [
              "number",
              "string"
            ],
            "description": "Amount in EUR, positive, at most two decimal places (number or string such as \"100.50\")."
          },
          "end_to_end_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "End-to-end reference; default NOTPROVIDED."
          },
          "instruction_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "Optional instruction id."
          },
          "creditor": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "name",
              "iban"
            ],
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 140,
                "description": "Creditor name (max 70 after cleaning)."
              },
              "iban": {
                "type": "string",
                "minLength": 1,
                "maxLength": 42,
                "description": "Creditor IBAN."
              },
              "bic": {
                "type": "string",
                "minLength": 1,
                "maxLength": 11,
                "description": "Creditor bank BIC (optional)."
              },
              "address": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "town",
                  "country"
                ],
                "description": "Structured or hybrid postal address (town and country mandatory since 5 October 2025).",
                "properties": {
                  "street": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 70,
                    "description": "Street name."
                  },
                  "building_number": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 16,
                    "description": "Building number."
                  },
                  "postal_code": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 16,
                    "description": "Postal code."
                  },
                  "town": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 35,
                    "description": "Town."
                  },
                  "country": {
                    "type": "string",
                    "pattern": "^[A-Z]{2}$",
                    "description": "ISO 3166 country code."
                  },
                  "address_lines": {
                    "type": "array",
                    "maxItems": 2,
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 70,
                      "description": "Free address line."
                    },
                    "description": "At most two free lines (hybrid address)."
                  }
                }
              }
            }
          },
          "remittance_information": {
            "type": "string",
            "minLength": 1,
            "maxLength": 400,
            "description": "Unstructured remittance information, max 140 after cleaning."
          },
          "creditor_reference": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "Structured creditor reference, e.g. ISO 11649 RF reference (instead of remittance_information)."
          },
          "purpose_code": {
            "type": "string",
            "pattern": "^[A-Z0-9]{4}$",
            "description": "ISO 20022 purpose code, e.g. SALA, SUPP."
          },
          "ultimate_debtor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 140,
            "description": "Ultimate debtor name."
          },
          "ultimate_creditor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 140,
            "description": "Ultimate creditor name."
          }
        }
      }
    },
    "message_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 35,
      "description": "Message id; default derived from the content."
    },
    "payment_information_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 35,
      "description": "Payment information id; default derived from the content."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Creation timestamp; default now."
    },
    "initiating_party": {
      "type": "string",
      "minLength": 1,
      "maxLength": 140,
      "description": "Initiating party name; default debtor name."
    },
    "ultimate_debtor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 140,
      "description": "Ultimate debtor for the whole batch."
    },
    "batch_booking": {
      "type": "boolean",
      "description": "true = one batch booking, false = single bookings."
    },
    "instant": {
      "type": "boolean",
      "default": false,
      "description": "SEPA instant credit transfer (LclInstrm INST)."
    },
    "category_purpose": {
      "type": "string",
      "pattern": "^[A-Z0-9]{4}$",
      "description": "Category purpose code, e.g. SALA."
    },
    "charset": {
      "type": "string",
      "enum": [
        "dk",
        "epc"
      ],
      "default": "dk",
      "description": "dk = Latin set plus Ä Ö Ü ä ö ü ß & * $ % (German banks, DK Appendix 3); epc = EPC basic Latin set only."
    },
    "reference_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Reference date for date checks (submission date), default today (UTC)."
    }
  }
}

Open original schema

Published input example

{
  "debtor": {
    "name": "Beispiel Handels GmbH",
    "iban": "DE79000000001234567890",
    "bic": "COBADEFFXXX"
  },
  "execution_date": "2026-11-05",
  "transactions": [
    {
      "amount": "100.00",
      "end_to_end_id": "RE-2026-0042",
      "creditor": {
        "name": "Muster Bürobedarf KG",
        "iban": "DE16000000002345678901"
      },
      "remittance_information": "Rechnung RE-2026-0042"
    }
  ],
  "reference_date": "2026-11-02"
}

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 →