BTI-719 Add Banking payment method

example/transactions/banking.php

@@ -0,0 +1,30 @@
+<?php
+
+require_once '../bootstrap.php';
+
+use Buckaroo\BuckarooClient;
+
+$buckaroo = new BuckarooClient($_ENV['BPE_WEBSITE_KEY'], $_ENV['BPE_SECRET_KEY']);
+
+// PaymentOrder
+$response = $buckaroo->method('banking')->paymentOrder([
+    'amountCredit' => 0.1,
+    'invoice' => uniqid(),
+    'description' => 'Banking PaymentOrder Test',
+    'accountHolderName' => 'John Smith',
+    'iban' => 'NL44RABO0123456789',
+    'processingDate' => '12/12/2026',
+    'bic' => 'PAYMINBBXXX',
+    'purpose' => 'Testing',
+    'structuredIssuerType' => 'ISO',
+    'structuredReference' => 'RF18539007547034',
+]);
+
+// InstantPaymentOrder
+$instantResponse = $buckaroo->method('banking')->instantPaymentOrder([
+    'amountCredit' => 0.1,
+    'invoice' => uniqid(),
+    'description' => 'Banking Instant PaymentOrder Test',
+    'accountHolderName' => 'John Smith',
+    'iban' => 'NL44RABO0123456789',
+]);

src/PaymentMethods/Banking/Banking.php

@@ -0,0 +1,67 @@
+<?php
+/*
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the MIT License
+ * It is available through the world-wide-web at this URL:
+ * https://tldrlegal.com/license/mit-license
+ * If you are unable to obtain it through the world-wide-web, please send an email
+ * to support@buckaroo.nl so we can send you a copy immediately.
+ *
+ * DISCLAIMER
+ *
+ * Do not edit or add to this file if you wish to upgrade this module to newer
+ * versions in the future. If you wish to customize this module for your
+ * needs please contact support@buckaroo.nl for more information.
+ *
+ * @copyright Copyright (c) Buckaroo B.V.
+ * @license   https://tldrlegal.com/license/mit-license
+ */
+
+declare(strict_types=1);
+
+namespace Buckaroo\PaymentMethods\Banking;
+
+use Buckaroo\Models\Model;
+use Buckaroo\PaymentMethods\Banking\Models\InstantPaymentOrder;
+use Buckaroo\PaymentMethods\Banking\Models\PaymentOrder;
+use Buckaroo\PaymentMethods\Banking\Models\PaymentOrderPayload;
+use Buckaroo\PaymentMethods\Banking\Service\ParameterKeys\PaymentOrderAdapter;
+use Buckaroo\PaymentMethods\PayablePaymentMethod;
+use Buckaroo\Transaction\Response\TransactionResponse;
+
+class Banking extends PayablePaymentMethod
+{
+    /**
+     * @var string
+     */
+    protected string $paymentName = 'Banking';
+
+    /**
+     * @return TransactionResponse
+     */
+    public function paymentOrder(?Model $model = null): TransactionResponse
+    {
+        $paymentOrderPayload = new PaymentOrderPayload($this->payload);
+
+        $this->request->setPayload($paymentOrderPayload);
+
+        $this->setServiceList('PaymentOrder', $model ?? new PaymentOrderAdapter(new PaymentOrder($this->payload)));
+
+        return $this->postRequest();
+    }
+
+    /**
+     * @return TransactionResponse
+     */
+    public function instantPaymentOrder(?Model $model = null): TransactionResponse
+    {
+        $paymentOrderPayload = new PaymentOrderPayload($this->payload);
+
+        $this->request->setPayload($paymentOrderPayload);
+
+        $this->setServiceList('InstantPaymentOrder', $model ?? new PaymentOrderAdapter(new InstantPaymentOrder($this->payload)));
+
+        return $this->postRequest();
+    }
+}

src/PaymentMethods/Banking/Models/InstantPaymentOrder.php

@@ -0,0 +1,36 @@
+<?php
+/*
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the MIT License
+ * It is available through the world-wide-web at this URL:
+ * https://tldrlegal.com/license/mit-license
+ * If you are unable to obtain it through the world-wide-web, please send an email
+ * to support@buckaroo.nl so we can send you a copy immediately.
+ *
+ * DISCLAIMER
+ *
+ * Do not edit or add to this file if you wish to upgrade this module to newer
+ * versions in the future. If you wish to customize this module for your
+ * needs please contact support@buckaroo.nl for more information.
+ *
+ * @copyright Copyright (c) Buckaroo B.V.
+ * @license   https://tldrlegal.com/license/mit-license
+ */
+
+namespace Buckaroo\PaymentMethods\Banking\Models;
+
+use Buckaroo\Models\ServiceParameter;
+
+class InstantPaymentOrder extends ServiceParameter
+{
+    /**
+     * @var string
+     */
+    protected string $accountHolderName;
+
+    /**
+     * @var string
+     */
+    protected string $iban;
+}

src/PaymentMethods/Banking/Models/PaymentOrder.php

@@ -0,0 +1,61 @@
+<?php
+/*
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the MIT License
+ * It is available through the world-wide-web at this URL:
+ * https://tldrlegal.com/license/mit-license
+ * If you are unable to obtain it through the world-wide-web, please send an email
+ * to support@buckaroo.nl so we can send you a copy immediately.
+ *
+ * DISCLAIMER
+ *
+ * Do not edit or add to this file if you wish to upgrade this module to newer
+ * versions in the future. If you wish to customize this module for your
+ * needs please contact support@buckaroo.nl for more information.
+ *
+ * @copyright Copyright (c) Buckaroo B.V.
+ * @license   https://tldrlegal.com/license/mit-license
+ */
+
+namespace Buckaroo\PaymentMethods\Banking\Models;
+
+use Buckaroo\Models\ServiceParameter;
+
+class PaymentOrder extends ServiceParameter
+{
+    /**
+     * @var string
+     */
+    protected string $accountHolderName;
+
+    /**
+     * @var string
+     */
+    protected string $iban;
+
+    /**
+     * @var string|null
+     */
+    protected ?string $processingDate;
+
+    /**
+     * @var string|null
+     */
+    protected ?string $bic;
+
+    /**
+     * @var string|null
+     */
+    protected ?string $purpose;
+
+    /**
+     * @var string|null
+     */
+    protected ?string $structuredIssuerType;
+
+    /**
+     * @var string|null
+     */
+    protected ?string $structuredReference;
+}

src/PaymentMethods/Banking/Models/PaymentOrderPayload.php

@@ -0,0 +1,31 @@
+<?php
+/*
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the MIT License
+ * It is available through the world-wide-web at this URL:
+ * https://tldrlegal.com/license/mit-license
+ * If you are unable to obtain it through the world-wide-web, please send an email
+ * to support@buckaroo.nl so we can send you a copy immediately.
+ *
+ * DISCLAIMER
+ *
+ * Do not edit or add to this file if you wish to upgrade this module to newer
+ * versions in the future. If you wish to customize this module for your
+ * needs please contact support@buckaroo.nl for more information.
+ *
+ * @copyright Copyright (c) Buckaroo B.V.
+ * @license   https://tldrlegal.com/license/mit-license
+ */
+
+namespace Buckaroo\PaymentMethods\Banking\Models;
+
+use Buckaroo\Models\Payload\Payload;
+
+class PaymentOrderPayload extends Payload
+{
+    /**
+     * @var float
+     */
+    protected float $amountCredit;
+}

src/PaymentMethods/Banking/Service/ParameterKeys/PaymentOrderAdapter.php

@@ -0,0 +1,36 @@
+<?php
+/*
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the MIT License
+ * It is available through the world-wide-web at this URL:
+ * https://tldrlegal.com/license/mit-license
+ * If you are unable to obtain it through the world-wide-web, please send an email
+ * to support@buckaroo.nl so we can send you a copy immediately.
+ *
+ * DISCLAIMER
+ *
+ * Do not edit or add to this file if you wish to upgrade this module to newer
+ * versions in the future. If you wish to customize this module for your
+ * needs please contact support@buckaroo.nl for more information.
+ *
+ * @copyright Copyright (c) Buckaroo B.V.
+ * @license   https://tldrlegal.com/license/mit-license
+ */
+
+namespace Buckaroo\PaymentMethods\Banking\Service\ParameterKeys;
+
+use Buckaroo\Models\Adapters\ServiceParametersKeysAdapter;
+
+class PaymentOrderAdapter extends ServiceParametersKeysAdapter
+{
+    protected array $keys = [
+        'accountHolderName' => 'AccountHolderName',
+        'iban' => 'IBAN',
+        'processingDate' => 'ProcessingDate',
+        'bic' => 'BIC',
+        'purpose' => 'Purpose',
+        'structuredIssuerType' => 'StructuredIssuerType',
+        'structuredReference' => 'StructuredReference',
+    ];
+}

src/PaymentMethods/PaymentMethodFactory.php

@@ -26,6 +26,7 @@
 use Buckaroo\PaymentMethods\Alipay\Alipay;
 use Buckaroo\PaymentMethods\ApplePay\ApplePay;
 use Buckaroo\PaymentMethods\Bancontact\Bancontact;
+use Buckaroo\PaymentMethods\Banking\Banking;
 use Buckaroo\PaymentMethods\BankTransfer\BankTransfer;
 use Buckaroo\PaymentMethods\Belfius\Belfius;
 use Buckaroo\PaymentMethods\Billink\Billink;
@@ -84,6 +85,7 @@ class PaymentMethodFactory
         Afterpay::class => ['afterpay'],
         AfterpayDigiAccept::class => ['afterpaydigiaccept'],
         Bancontact::class => ['bancontact', 'bancontactmrcash'],
+        Banking::class => ['banking'],
         Bizum::class => ['bizum'],
         Billink::class => ['billink'],
         Blik::class => ['blik'],