PHPackages hairacless/sephpa - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. hairacless/sephpa ActiveLibrary[Parsing & Serialization](/categories/parsing) hairacless/sephpa ================= Generates Sepa files for credit transfers (pain.001.001.03, pain.001.002.03, pain.001.003.03) and direct debit (pain.008.001.02, pain.008.002.02, pain.008.003.02) 1.3.0(11y ago)0938LGPL-3.0PHPPHP >=5.3.0 Since Oct 18Pushed 5y agoCompare [ Source](https://github.com/hairacless/Sephpa)[ Packagist](https://packagist.org/packages/hairacless/sephpa)[ Docs](https://github.com/AbcAeffchen/Sephpa)[ RSS](/packages/hairacless-sephpa/feed)WikiDiscussions master Synced today READMEChangelogDependencies (2)Versions (10)Used By (0) Sephpa - A PHP class to export SEPA files ========================================= [](#sephpa---a-php-class-to-export-sepa-files) [![Build Status](https://camo.githubusercontent.com/8a2a0b75815ab3ee17995c2f2b5a69cfb0cc79b2b1a577ba05cf2ccfc1c90792/68747470733a2f2f7472617669732d63692e6f72672f416263416566666368656e2f5365706870612e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/AbcAeffchen/Sephpa)[![Latest Stable Version](https://camo.githubusercontent.com/75d3ac1cebe7ed3fa98d9329e1de612f0071c17fbcf38b25897d67e8e9f7dd01/68747470733a2f2f706f7365722e707567782e6f72672f616263616566666368656e2f7365706870612f762f737461626c652e737667)](https://packagist.org/packages/abcaeffchen/sephpa)[![Total Downloads](https://camo.githubusercontent.com/38eae9e0041fb1eeed00ed249887cf50f985793f04b42b72c4be98b2beada3a2/68747470733a2f2f706f7365722e707567782e6f72672f616263616566666368656e2f7365706870612f646f776e6c6f6164732e737667)](https://packagist.org/packages/abcaeffchen/sephpa)[![License](https://camo.githubusercontent.com/c4b2a8d645550f7d84239fe7722529ddf23628f90ec28f6f30b0193d48b85231/68747470733a2f2f706f7365722e707567782e6f72672f616263616566666368656e2f7365706870612f6c6963656e73652e737667)](https://packagist.org/packages/abcaeffchen/sephpa)[![Gitter](https://camo.githubusercontent.com/abe08b740a4156153736f791393ec4da6619c4be73212e75769f52edacc0e2b5/68747470733a2f2f6261646765732e6769747465722e696d2f4a6f696e253230436861742e737667)](https://gitter.im/AbcAeffchen/Sephpa?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) General ------- [](#general) **Sephpa** \[sefa\] is a PHP class that creates SEPA XML files. The created XML files fulfill the specifications of Electronic Banking Internet Communication Standard (EBICS). Supported file versions ----------------------- [](#supported-file-versions) - SEPA Credit Transfer - pain.001.001.03 - pain.001.002.03 - pain.001.003.03 - SEPA Direct Debit - pain.008.001.02 - pain.008.001.02.austrian.003 - pain.008.002.02 - pain.008.003.02 Requirements ------------ [](#requirements) Sephpa was created for PHP 5.6, 7.0, 7.1, 7.2 and HHVM and requires [SepaUtilities 1.2.4+](https://github.com/AbcAeffchen/SepaUtilities) and [SimpleXML](http://php.net/manual/en/book.simplexml.php). Sephpa should also work with PHP <5.6, but since this versions are very old and don't get any security updates, it is strongly recommended not to use PHP older than 5.6. If you want to download correctly sorted files, you also need the zip library and for documentation files you need [SepaDocumentor](https://github.com/AbcAeffchen/SepaDocumentor). Installation ------------ [](#installation) ### Composer [](#composer) Just add ``` { "require": { "abcaeffchen/sephpa": "~2.0.0" } } ``` to your `composer.json` and include the Composer autoloader to your script. ### Direct download [](#direct-download) You can download Sephpa from this GitHub page. Make sure you also download [SepaUtilities](https://github.com/AbcAeffchen/SepaUtilities). You should store the files in a structure that looks like this: ``` your project root ├── your_code │ └── ... └── vendor ├── Sephpa (the Sephpa project go here) ├── SepaUtilities (the SepaUtilities files go here) └── ... ``` In your code you can include the Sephpa autoloader by including the file ``` vendor/Sephpa/src/autoloader.php ``` You also need to include the SepaUtilities file which should be ``` vendor/SepaUtilities/src/SepaUtilities.php ``` In total your code should look something like this: ``` require PROJECT_ROOT . '/vendor/Sephpa/src/autoloader.php'; require PROJECT_ROOT . '/vendor/abcaeffchen/sepa-utilities/src/SepaUtilities.php'; ``` You need to define `PROJECT_ROOT` by yourself. ### Documentation Module [](#documentation-module) Sephpa uses [SepaDocumentor](https://github.com/AbcAeffchen/SepaDocumentor) to create File Routing Slips and Control Lists. If you are interested in this files you need to add ``` { "require": { "abcaeffchen/sepa-documentor": "~1.0.0" } } ``` to your composer file or download it from the website and make it available to Sephpa. Creating a new SEPA file ------------------------ [](#creating-a-new-sepa-file) **Note:** This is not meant to teach you SEPA. If you want to learn more about SEPA or SEPA files, you should ask your bank for help. You use this library at your own risk and I assume no liability if anything goes wrong. You are supposed to check the files **before** handing them to your bank. ### Credit Transfer [](#credit-transfer) You can create a new Sephpa object by using: ``` $creditTransferFile = new SephpaCreditTransfer('Initiator Name', 'MessageID-1234', SephpaCreditTransfer::SEPA_PAIN_001_002_03); ``` You have to input the initiator name, the unique message id and the version of the file. The message id have to be unique for all sepa files you hand over to your bank. This is one of the things Sephpa will not check for you. Currently supported credit transfer versions are: - `SEPA_PAIN_001_002_03`: Credit transfer version pain.001.002.03 - `SEPA_PAIN_001_003_03`: Credit transfer version pain.001.003.03 If you don't know which version to choose, ask your bank which versions they do accept. Normally banks are not the fastest and so they will most likely accept the older one. By default `checkAndSanitize` is set to true, which means that Sephpa will check and sanitize every input it self and throw exceptions if something can not be sanitized. This sounds nagging but if you turn off this checks and just ignore the exceptions your bank will not accept the files. But it is **recommended** to check all inputs at input time (using [SepaUtilities](https://github.com/AbcAeffchen/SepaUtilities)) and then only add valid data. Then you can turn off `checkAndSanitize` to prevent double checking everything. Once you created the SephpaCreditTransfer object, you can add a payment collection. You can add as many payment collections as you like. ``` $creditTransferCollection = $creditTransferFile->addCollection([ // required information about the debtor 'pmtInfId' => 'PaymentID-1234', // ID of the payment collection 'dbtr' => 'Name of Debtor', // (max 70 characters) 'iban' => 'DE21500500001234567897',// IBAN of the Debtor 'bic' => 'SPUEDE2UXXX', // BIC of the Debtor // optional 'ccy' => 'EUR', // Currency. Default is 'EUR' 'btchBookg' => 'true', // BatchBooking, only 'true' or 'false' //'ctgyPurp' => , // Category Purpose. Do not use this if you do not know how. For further information read the SEPA documentation 'reqdExctnDt' => '2013-11-25', // Requested Execution Date: YYYY-MM-DD 'ultmtDebtr' => 'Ultimate Debtor Name' // just an information, this do not affect the payment (max 70 characters) ]); ``` You can add as many payments as you want to each collection. ``` $creditTransferCollection->addPayment([ // required information about the creditor 'pmtId' => 'TransferID-1234-1', // ID of the payment (EndToEndId) 'instdAmt' => 0.42, // amount, 'iban' => 'DE21500500009876543210',// IBAN of the Creditor 'bic' => 'SPUEDE2UXXX', // BIC of the Creditor (only required for pain.001.002.03) 'cdtr' => 'Name of Creditor', // (max 70 characters) // optional 'ultmtCdrt' => 'Ultimate Creditor Name',// just an information, this do not affect the payment (max 70 characters) //'purp' => , // Do not use this if you do not know how. For further information read the SEPA documentation 'rmtInf' => 'Remittance Information' // unstructured information about the remittance (max 140 characters) ]); ``` ### Direct Debits [](#direct-debits) Direct debits work the same way as credit transfers, but they have little different inputs. ``` $directDebitFile = new SephpaDirectDebit('Initiator Name', 'MessageID-1235', SephpaDirectDebit::SEPA_PAIN_008_002_02); $directDebitCollection = $directDebitFile->addCollection([ // required information about the creditor 'pmtInfId' => 'PaymentID-1235', // ID of the payment collection 'lclInstrm' => SepaUtilities::LOCAL_INSTRUMENT_CORE_DIRECT_DEBIT, 'seqTp' => SepaUtilities::SEQUENCE_TYPE_RECURRING, 'cdtr' => 'Name of Creditor', // (max 70 characters) 'iban' => 'DE87200500001234567890',// IBAN of the Creditor 'bic' => 'BELADEBEXXX', // BIC of the Creditor 'ci' => 'DE98ZZZ09999999999', // Creditor-Identifier // optional 'ccy' => 'EUR', // Currency. Default is 'EUR' 'btchBookg' => 'true', // BatchBooking, only 'true' or 'false' //'ctgyPurp' => , // Do not use this if you not know how. For further information read the SEPA documentation 'ultmtCdtr' => 'Ultimate Creditor Name',// just an information, this do not affect the payment (max 70 characters) 'reqdColltnDt' => '2013-11-25' // Requested Collection Date: YYYY-MM-DD ]); $directDebitCollection->addPayment([ // required information about the debtor 'pmtId' => 'TransferID-1235-1', // ID of the payment (EndToEndId) 'instdAmt' => 2.34, // amount 'mndtId' => 'Mandate-Id', // Mandate ID 'dtOfSgntr' => '2010-04-12', // Date of signature 'bic' => 'BELADEBEXXX', // BIC of the Debtor 'dbtr' => 'Name of Debtor', // (max 70 characters) 'iban' => 'DE87200500001234567890',// IBAN of the Debtor // optional 'amdmntInd' => 'false', // Did the mandate change 'elctrncSgntr' => 'test', // do not use this if there is a paper-based mandate 'ultmtDbtr' => 'Ultimate Debtor Name', // just an information, this do not affect the payment (max 70 characters) //'purp' => , // Do not use this if you not know how. For further information read the SEPA documentation 'rmtInf' => 'Remittance Information',// unstructured information about the remittance (max 140 characters) // only use this if 'amdmntInd' is 'true'. at least one must be used 'orgnlMndtId' => 'Original-Mandat-ID', 'orgnlCdtrSchmeId_nm' => 'Creditor-Identifier Name', 'orgnlCdtrSchmeId_id' => 'DE98AAA09999999999', 'orgnlDbtrAcct_iban' => 'DE87200500001234567890',// Original Debtor Account 'orgnlDbtrAgt' => 'SMNDA' // only 'SMNDA' allowed if used ]); ``` Note: With pain.008.001.02 the key `orgnlDbtrAgt` is no longer available. It got replaced with `orgnlDbtrAgt_bic` and you can input the old BIC. But in general it looks like you just can omit both `orgnlDbtrAcct_iban` and `orgnlDbtrAgt_bic` and it should work. ### Get the SEPA and documentation file(s) [](#get-the-sepa-and-documentation-files) After you have added some payments to your payment collection you can save the finished file by ``` $creditTransferFile->store(); ``` or get it directly without saving it on the server by ``` $creditTransferFile->download(); ``` Notice that you can hand over a filename you like, but you should only use the file extension `.xml`. You can also use an array of options to include file routing slips and control lists. You need libzip to be installed if you want to store or download multiple files at once. Credits ------- [](#credits) Thanks to [Hermann Herz](https://github.com/Heart1010) who supported me debugging and with great ideas to improve Sephpa and SepaUtilities. License ------- [](#license) Licensed under the LGPL v3.0 License. ### Health Score 30 — LowBetter than 64% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community9 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor1 Top contributor holds 88.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~213 days Recently: every ~320 days Total 7 Last Release 2941d ago Major Versions 1.3.0 → 2.0.0-beta12018-04-22 PHP version history (2 changes)1.2.0PHP >=5.3.0 2.0.0-beta1PHP >=5.6.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/3370996925f8450cd933e6f34a5d2bee3c2cb3d15c1a7880d136b86ccc4f1b0e?d=identicon)[bytesystems](/maintainers/bytesystems) --- Top Contributors [![AbcAeffchen](https://avatars.githubusercontent.com/u/5396140?v=4)](https://github.com/AbcAeffchen "AbcAeffchen (127 commits)")[![das-heimchen](https://avatars.githubusercontent.com/u/54495454?v=4)](https://github.com/das-heimchen "das-heimchen (15 commits)")[![markcoenradie](https://avatars.githubusercontent.com/u/2177198?v=4)](https://github.com/markcoenradie "markcoenradie (1 commits)") --- Tags xmlfilessepadirect debitxsdfinanceBankingcredit transfer ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/hairacless-sephpa/health.svg) ``` [![Health](https://phpackages.com/badges/hairacless-sephpa/health.svg)](https://phpackages.com/packages/hairacless-sephpa) ``` ### Alternatives [abcaeffchen/sephpa Generates SEPA files for credit transfers (pain.001.001.03, pain.001.002.03, pain.001.003.03, pain.001.001.09) and direct debit (pain.008.001.02, pain.008.002.02, pain.008.003.02, pain.008.001.08) 711.7M](/packages/abcaeffchen-sephpa)[digitick/sepa-xml Creates Single Euro Payments Area (SEPA) XML files for the Direct Debit and Credit Transfer operations. 2836.0M12](/packages/digitick-sepa-xml)[goetas-webservices/xsd2php-runtime Convert XSD (XML Schema) definitions into PHP classes 4910.9M36](/packages/goetas-webservices-xsd2php-runtime)[dmitrirussu/php-sepa-xml-generator Creates an XML file for a Single Euro Payments Area (SEPA) Direct Debit Payment. 5644.0k](/packages/dmitrirussu-php-sepa-xml-generator)[perryfaro/sepa Creates an XML file for a Single Euro Payments Area (SEPA) Credit Transfer. 1148.7k](/packages/perryfaro-sepa) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)