Skip to content

Submit a SEPA direct debit batch from a JSON file.

Synopsis

gln [global-options] direct-debits batch --file <path> [--dry-run]

Options

Argument or flagTypeRequiredDefaultDescription
--filepathyes-Direct debit batch JSON file.
--dry-runflagnofalseValidate the request file and print a deterministic aggregate preview without opening a backend.

Request file

Required top-level string fields: creditor_iban, creditor_bic, creditor_name, creditor_id, and local_instrument. collection_date is optional.

items is a required array. Each item requires debtor_iban, debtor_bic, debtor_name, amount, currency, purpose, mandate_id, mandate_date, and sequence_type. end_to_end_reference and amendment are optional.

The success result uses the same direct-debit submission view as direct-debits create; no per-item result rows are emitted.

FinTS and EBICS profiles are supported. Revolut and Wise profiles are rejected before the request file is read.

Status and exit codes

StatusExitMeaningContinuation
ok0Request accepted, dry-run preview emitted, or provider accepted the submission.-
action_required10TAN or follow-up action is required.Save and resume with tan resume.
rejected1The provider rejected the request.-
error1Validation, backend open, or provider error.-

See also