Skip to content

Release v0.0.7

Choose a tag to compare

@github-actions github-actions released this 09 Jan 08:56
· 293 commits to main since this release

Release v0.0.7: Additional fields support for DirectDebit transactions

  • Add debtorBic field support
  • Add additionalData for custom fields
  • Add DEPRECATED_FIELDS.md documentation
  • Add comprehensive test coverage
  • Fix PHP 8.2 compatibility issues

Changelog

Added

  • Additional Fields Support for DirectDebit Transactions:

    • Added debtorBic field support in DirectDebitTransaction (optional BIC for debtor)
    • Added additionalData array for storing custom fields internally
    • Added methods: setDebtorBic(), getDebtorBic(), setAdditionalData(), getAdditionalData(), setAdditionalField(), getAdditionalField()
    • debtorBic is included in generated XML when provided
    • additionalData is stored internally but not included in XML (for internal use only)
    • Support for debtorBic and additional fields in generateFromArray() method
  • Snake_case Field Name Support:

    • DirectDebitGenerator::generateFromArray() now supports both camelCase and snake_case field names
    • Automatic field name normalization for maximum flexibility
    • Supports common snake_case formats: message_id, initiating_party_name, payment_name, due_date, creditor_name, creditor_iban, creditor_bic, sequence_type, creditor_id, instrument_code, items, instruction_id, debtor_iban, debtor_name, debtor_mandate, debtor_mandate_signature_date, information
    • Backward compatible: existing camelCase code continues to work
  • Documentation:

    • Added DEPRECATED_FIELDS.md documenting fields that are no longer allowed in SEPA Direct Debit transactions
    • Documented that postal addresses and contact information cannot be included in transactions (only in mandates)
    • Added examples of correct and incorrect usage
    • Updated README with snake_case examples
  • Test Coverage:

    • Added 5 new tests for DirectDebitTransaction covering debtorBic and additionalData functionality
    • Added 5 new tests for DirectDebitGenerator verifying BIC inclusion in XML and additional data handling
    • Added 2 new tests for snake_case format support
    • Tests verify that additional data is stored but not included in generated XML
  • Demo Applications:

    • Added /demo-direct-debit-snake-case endpoint to all demo applications (Symfony 6, 7, 8)
    • Demonstrates usage of snake_case format with real-world example

Fixed

  • Fixed constant type declarations for PHP 8.2 compatibility
    • Removed const string type declarations that caused syntax errors in PHP 8.2
    • Changed to untyped constants with literal string values
    • Fixed in Configuration::ALIAS, DirectDebitGenerator::SERVICE_NAME, RemesaGenerator::SERVICE_NAME, IdentifierGenerator::SERVICE_NAME