Merge pull request #213 from bigwhoop/credit-transfer-charge-bearer

Support for different charge bearer values in customer credit transfers

Author: andrew-svirin

src/Builders/CustomerCreditTransfer/CustomerCreditTransferBuilder.php

@@ -45,6 +45,7 @@ public function __construct()
      * least for 15 days. Used for rejecting duplicated transactions (max length: 35 characters)
      * @param string|null $paymentReference Overwrite default payment reference -
      * visible on creditors bank statement (max length: 35 characters)
+     * @param string|null $chargeBearer Overwrite default charge bearer (one of SLEV, CRED, DEBT, SHAR)
      *
      * @return $this
      */
@@ -56,7 +57,8 @@ public function createInstance(
         ?DateTime $executionDate = null,
         bool $batchBooking = true,
         ?string $msgId = null,
-        ?string $paymentReference = null
+        ?string $paymentReference = null,
+        ?string $chargeBearer = null
     ): CustomerCreditTransferBuilder {
         $this->instance = new CustomerCreditTransfer();
         $now = new DateTime();
@@ -183,7 +185,11 @@ public function createInstance(
         $xmlFinInstnId->appendChild($xmlBIC);
 
         $xmlChrgBr = $this->instance->createElement('ChrgBr');
-        $xmlChrgBr->nodeValue = 'SLEV';
+        if ($chargeBearer) {
+            $xmlChrgBr->nodeValue = $chargeBearer;
+        } else {
+            $xmlChrgBr->nodeValue = 'SLEV';
+        }
         $xmlPmtInf->appendChild($xmlChrgBr);
 
         return $this;
@@ -334,7 +340,8 @@ public function addSEPATransaction(
         ?PostalAddressInterface $postalAddress,
         float $amount,
         string $currency,
-        ?string $purpose = null
+        ?string $purpose = null,
+        ?string $chargeBearer = null
     ): CustomerCreditTransferBuilder {
         if ($currency !== 'EUR') {
             throw new InvalidArgumentException('The SEPA transaction is restricted to EUR currency.');
@@ -356,7 +363,11 @@ public function addSEPATransaction(
         $this->addAmountElement($xmlCdtTrfTxInf, $amount, $currency);
 
         $xmlChrgBr = $this->instance->createElement('ChrgBr');
-        $xmlChrgBr->nodeValue = 'SLEV';
+        if ($chargeBearer) {
+            $xmlChrgBr->nodeValue = $chargeBearer;
+        } else {
+            $xmlChrgBr->nodeValue = 'SLEV';
+        }
         $xmlCdtTrfTxInf->appendChild($xmlChrgBr);
 
         $this->addCreditor(