Version 3.0.0

Please note that there is no major change between 2.x and 3.0. The later was required because the team had to do a BC change in BaseTransferInformation removing some elements in #215

What's Changed

• Make the UETR element NULL by default. by @BorislavSabev in #219
• HotFix always include the Creditor Agent element by @BorislavSabev in #218
• Hotfix pmnt tp inf on the transaction level by @BorislavSabev in #217

These were done in response to:
#212
#214
#215

Full Changelog: 2.3.2...3.0.0

What's Changed

• Update docs by @BorislavSabev in #203
• Fix purpose code usage example by @BorislavSabev in #204
• Allow id in $paymentInformation to be a string by @derrabus in #205
• Allow debtorAdrLine in $transferInformation to be an array by @derrabus in #206

New Contributors

• @derrabus made their first contribution in #205

Full Changelog: 2.3.1...2.3.2

Full Changelog

Full Changelog

Fixed

• HotFix ramsey/uuid version constraint definition which was preventing v2.3.0 from installing on platforms with php >= 8.1 as explained in #200

Changelog

Fixed

• HotFix ramsey/uuid version constraint definition which was preventing v2.3.0 from installing on platforms with php >= 8.1 as explained in #200

Full Changelog

Added

• Added support for pain.001.001.09, pain.001.001.10, pain.001.001.12
• Added retrofitted support for pain.001.001.04,pain.001.001.05, pain.001.001.06, pain.001.001.07, pain.001.001.08 (Provided as "should work")
• Added support for pain.008.001.09, pain.008.001.10, pain.008.001.11
• Added retrofitted support for pain.008.001.03, pain.008.001.04,pain.008.001.05, pain.008.001.06, pain.008.001.07, pain.008.001.08 (Provided as "should work")
• Added MessageFormat class that eases checking the exact format version used
• Added support for Purpose Code to Customer Credit Transfers (CdtTrfTxInf->Purp) when using pain.001.xxx.nn
• Added Flr (floor) in Customer addresses for DirectDebit & CreditTransfer (standards' version support varies)
• Added StrtNm, BldgNb, PstCd and TwnNm in Customer addresses for CreditTransfer (standards' version support varies)
• Added UETR (UUIDv4) in the PaymentIdentification. The UUID is automatically generated or can be set externally. A getter and a setter are available.
• Added localInstrumentProprietary support in SCTs
• Added setCategoryPurposeCode() & getCategoryPurposeCode() to be able to pass the payment category in TransferInformation
• Added an asDom() method in the DomBuilder allowing to get the built DomDocument object for further manipulation
• Added a Sanitizer class with the capability to replace the default sanitization logic or fully disable it. Check the docs for more info
• Added Dependabot support
• Added phpfaker/faker as a dev dependency. We are going to migrate all tests to use Faker data in the future.

Changed

• Changed the default format to pain.001.001.09 for CreditTransfers (was pain.001.002.03) and pain.008.001.09 for DirectDebits (was pain.008.002.02)
• Changed the way we check which element should exist in what standards' version
• Updated most test cases to run against all supported pain format versions

Fixed

• Fixed XML file placement order for LocalInstrumentCode
• Converted all interfaces using DateTime to use DateTimeInterface
• Switched from using DateTime instances internally to DateTimeImmutable instances
• Fixed PHPUnit config file
• Fixed PHPUnit deprecations
• Small changes in PHPUnit Fixtures
• Updated GitHub actions -- Run phpstan, phpunit on PR against master -- Prepare to automatically run rector, check for changes and commit them
• Updated all dependencies to their latest versions -- Updated rector/rector and phpstan/phpstan to version 2.x -- Updated phpunit/phpunit to version 10.x
• Ran rector/rector manually and integrated the changes
• Fixed all PHPStan errors up to level 4

Special thanks to our new contributors @mkszepp, @larsiinger & @fidelodz for their submissions!

Full Changelog

Closed issues:

• Add apostrophe to StringHelper.php as per the Extended Character Set #162

Full Changelog

Closed issues:

• Add apostrophe to StringHelper.php as per the Extended Character Set #162

Full Changelog

Closed issues:

• PaymentInformation::getLocalInstrumentCode() must be of the type int or null, string returned #105

Full Changelog

Closed issues:

• PaymentInformation::getLocalInstrumentCode() must be of the type int or null, string returned #105

Full Changelog

Merged pull requests:

• Add additional pain format for PstlAdr #89 (monofone)
• remove php 5.4 and 5.5 #87 (dakira)

Full Changelog

Merged pull requests:

• Add additional pain format for PstlAdr #89 (monofone)
• remove php 5.4 and 5.5 #87 (dakira)

Full Changelog

Closed issues:

• Batch Booking #81
• [PAIN.008.001.02] Dutch validation issues #72

Merged pull requests:

• Init $paymentInformations value #86 (VincentLanglet)

Full Changelog

Closed issues:

• Batch Booking #81
• [PAIN.008.001.02] Dutch validation issues #72

Merged pull requests:

• Init $paymentInformations value #86 (VincentLanglet)

Full Changelog

Closed issues:

• Version bump? #80
• PHP 5.1 #79

Merged pull requests:

• Update CustomerDirectDebitFacade.php #82 (ouraios)

Full Changelog

Closed issues:

• Version bump? #80
• PHP 5.1 #79

Merged pull requests:

• Update CustomerDirectDebitFacade.php #82 (ouraios)

Full Changelog

Merged pull requests:

• Update StringHelper.php #78 (mrgarry)
• Small additions for Finnish banks compatibility #77 (joosev)
• Add unstructured creditor address to credit transfer xml. #76 (ghrichrist)

Full Changelog

Merged pull requests:

• Update StringHelper.php #78 (mrgarry)
• Small additions for Finnish banks compatibility #77 (joosev)
• Add unstructured creditor address to credit transfer xml. #76 (ghrichrist)

Full Changelog

Closed issues:

• Amount is always divided by 100 #73
• CreDtTm bad string length #70
• BIC optional #69
• Output is not ISO 20022 XSD comliant #65
• Add pain.008.003.02 support #59
• Make sure <ReqdColltnDt> is a TARGET2 day #58

Merged pull requests:

• Add option to set due date for credit transfer #74 (aquariuz)
• Add instruction priority to payment information #71 (mludvik)

Full Changelog

Closed issues:

• Amount is always divided by 100 #73
• CreDtTm bad string length #70
• BIC optional #69
• Output is not ISO 20022 XSD comliant #65
• Add pain.008.003.02 support #59
• Make sure <ReqdColltnDt> is a TARGET2 day #58

Merged pull requests:

• Add option to set due date for credit transfer #74 (aquariuz)
• Add instruction priority to payment information #71 (mludvik)

Full Changelog

Closed issues:

• Not working with PHP 5.6, debian 8 #56

Merged pull requests:

• ability to set instructionId in "CreditTransfer with Factory" #62 (mwenghi)
• Added support for pain.008.003.02 #61 (monofone)
• Readme improvements #57 (ArneTR)

Full Changelog

Closed issues:

• Not working with PHP 5.6, debian 8 #56

Merged pull requests:

• ability to set instructionId in "CreditTransfer with Factory" #62 (mwenghi)
• Added support for pain.008.003.02 #61 (monofone)
• Readme improvements #57 (ArneTR)

Full Changelog

Closed issues:

• Format of PaymentInformation->getDueDate() #54
• Is the BIC required? #32

Full Changelog

Closed issues:

• Format of PaymentInformation->getDueDate() #54
• Is the BIC required? #32

Full Changelog

Closed issues:

• Filter out characters like _ #43
• Support for pain.001.003.03? #27

Merged pull requests:

• Allow common slashes in sanitized strings #60 (keltuo)
• Setters for organization id and identification scheme #53 (Jontsa)
• Better headers formatting #51 (caseycs)
• Update README.md #50 (BorislavSabev)
• Update Util\StringHelper - add some more chars #48 (BorislavSabev)
• Update string helper #46 (monofone)
• Directdebit bic optional #45 (monofone)
• Fix #43 #44 (amenk)
• Don't add RemittanceElement when there is no RemittanceInformation #41 (gertvr)
• Update amendments with compliance to SDD Rulebook v9 #39 (jarnovanleeuwen)

Full Changelog

Closed issues:

• Filter out characters like _ #43
• Support for pain.001.003.03? #27

Merged pull requests:

• Allow common slashes in sanitized strings #60 (keltuo)
• Setters for organization id and identification scheme #53 (Jontsa)
• Better headers formatting #51 (caseycs)
• Update README.md #50 (BorislavSabev)
• Update Util\StringHelper - add some more chars #48 (BorislavSabev)
• Update string helper #46 (monofone)
• Directdebit bic optional #45 (monofone)
• Fix #43 #44 (amenk)
• Don't add RemittanceElement when there is no RemittanceInformation #41 (gertvr)
• Update amendments with compliance to SDD Rulebook v9 #39 (jarnovanleeuwen)

Full Changelog

Closed issues:

• BtchBookg element #36

Merged pull requests:

• Update PaymentInformation.php #38 (andreasschroth)

Full Changelog

Closed issues:

• BtchBookg element #36

Merged pull requests:

• Update PaymentInformation.php #38 (andreasschroth)

Full Changelog

Closed issues:

• How to set <ReqdColltnDt> #35

Merged pull requests:

• Check for value to be not null #37 (monofone)

Full Changelog

Closed issues:

• How to set <ReqdColltnDt> #35

Merged pull requests:

• Check for value to be not null #37 (monofone)

Full Changelog

Closed issues:

• No luck getting diaeresis/trema in the XML #30
• CustomerCreditFacade missing from current stable #25
• Actual status? #13
• Referenced XSD version should be updated to 008.003.02 for direct debit #12

Merged pull requests:

• Fixed amounts with decimals #31 (vaites)
• Extended string sanitizer with many characters #29 (naitsirch)

Full Changelog

Closed issues:

• No luck getting diaeresis/trema in the XML #30
• CustomerCreditFacade missing from current stable #25
• Actual status? #13
• Referenced XSD version should be updated to 008.003.02 for direct debit #12

Merged pull requests:

• Fixed amounts with decimals #31 (vaites)
• Extended string sanitizer with many characters #29 (naitsirch)

Full Changelog

Implemented enhancements:

• Improved Jarnovanleeuwen amendments #20 (monofone)

Fixed bugs:

• Add: Missing CustomerCreditFacade #16 (BenjaminPaap)

Closed issues:

• Refactor Documentation #21
• Missing class CustomerCreditFacade #14
• Excess data in pain.008.001.02 #10

Merged pull requests:

• Install compatible PHPUnit version and use it on Travis CI #24 (xabbuh)
• Tests for all schemas #23 (BenjaminPaap)
• Split the docs into two parts to get a better overview #22 (monofone)
• Updated README with CreditTransfer facade example #19 (monofone)
• Remove PHP7 from allow_failures #17 (soullivaneuh)

Full Changelog

Implemented enhancements:

• Improved Jarnovanleeuwen amendments #20 (monofone)

Fixed bugs:

• Add: Missing CustomerCreditFacade #16 (BenjaminPaap)

Closed issues:

• Refactor Documentation #21
• Missing class CustomerCreditFacade #14
• Excess data in pain.008.001.02 #10

Merged pull requests:

• Install compatible PHPUnit version and use it on Travis CI #24 (xabbuh)
• Tests for all schemas #23 (BenjaminPaap)
• Split the docs into two parts to get a better overview #22 (monofone)
• Updated README with CreditTransfer facade example #19 (monofone)
• Remove PHP7 from allow_failures #17 (soullivaneuh)

Full Changelog

Closed issues:

• Documentation #9
• New release tag #8
• Travis build state "unknown" #7

Merged pull requests:

• Added DirectDebit and Credit from custom GroupHeader #11 (eusonlito)

Full Changelog

Closed issues:

• Documentation #9
• New release tag #8
• Travis build state "unknown" #7

Merged pull requests:

• Added DirectDebit and Credit from custom GroupHeader #11 (eusonlito)

Full Changelog

Merged pull requests:

• Fixed: Custom EndToEndId in DirectDebits #6 (BenjaminPaap)
• [TASK] Fixed travis build state #5 (monofone)
• [TASK] Changed the order for creating the timestamp #3 (monofone)
• Allow setting an optional EndToEndId #1 (BenjaminPaap)

Full Changelog

Merged pull requests:

• Fixed: Custom EndToEndId in DirectDebits #6 (BenjaminPaap)
• [TASK] Fixed travis build state #5 (monofone)
• [TASK] Changed the order for creating the timestamp #3 (monofone)
• Allow setting an optional EndToEndId #1 (BenjaminPaap)

Full Changelog

Full Changelog

Full Changelog

Full Changelog

Full Changelog

Full Changelog

Closed issues:

• Question about this project #103

Merged pull requests:

• fix local instrument code return type #106 (monofone)
• Added support for creditorReferenceType to CustomerCreditFacade #104 (ttaelman)
• Rebase of pull request #66 #102 (mogilvie)

Full Changelog

Closed issues:

• Question about this project #103

Merged pull requests:

• fix local instrument code return type #106 (monofone)
• Added support for creditorReferenceType to CustomerCreditFacade #104 (ttaelman)
• Rebase of pull request #66 #102 (mogilvie)

Full Changelog

Closed issues:

• Payment Info CIF/NIF (id) Required #98
• [Question] Schema pain.008.002.02 is inofficial? #91
• Debitor name and end-to-end id not sanitized #90
• Impossible to add PstlAdr in format pain.008.001.02 #88

Merged pull requests:

• Php 7.2 / Phpunit 9 / PSR-4 / Refacto tests #101 (VincentLanglet)
• Add throws tag #100 (VincentLanglet)
• Increase php versions to run tests for #97 (monofone)

Important changes:

• The direct debit transfer amount has been changed from string to int. You must add the amount as integer cent values, otherwise the SEPA export may contain wrong amounts.

Full Changelog

Closed issues:

• Payment Info CIF/NIF (id) Required #98
• [Question] Schema pain.008.002.02 is inofficial? #91
• Debitor name and end-to-end id not sanitized #90
• Impossible to add PstlAdr in format pain.008.001.02 #88

Merged pull requests:

• Php 7.2 / Phpunit 9 / PSR-4 / Refacto tests #101 (VincentLanglet)
• Add throws tag #100 (VincentLanglet)
• Increase php versions to run tests for #97 (monofone)

Important changes:

• The direct debit transfer amount has been changed from string to int. You must add the amount as integer cent values, otherwise the SEPA export may contain wrong amounts.