Add receiptOptions & additionalSearchTerms to createInvoice & Add includeSensitive & onlyAccountedPayments to getPaymentMethods

src/Client/Invoice.php

@@ -19,7 +19,9 @@ public function createInvoice(
         ?string $orderId = null,
         ?string $buyerEmail = null,
         ?array $metaData = null,
-        ?InvoiceCheckoutOptions $checkoutOptions = null
+        ?InvoiceCheckoutOptions $checkoutOptions = null,
+        ?InvoiceReceiptOptions $receiptOptions = null,
+        ?array $additionalSearchTerms = null
     ): ResultInvoice {
         $url = $this->getApiUrl() . 'stores/' . urlencode(
             $storeId
@@ -55,7 +57,9 @@ public function createInvoice(
                 'amount' => $amount !== null ? $amount->__toString() : null,
                 'currency' => $currency,
                 'metadata' => !empty($metaDataMerged) ? $metaDataMerged : null,
-                'checkout' => $checkoutOptions ? $checkoutOptions->toArray() : null
+                'checkout' => $checkoutOptions ? $checkoutOptions->toArray() : null,
+                'receipt' => $receiptOptions ? $receiptOptions->toArray() : null,
+                'additionalSearchTerms' => $additionalSearchTerms
             ],
             JSON_THROW_ON_ERROR
         );
@@ -229,11 +233,17 @@ public function getAllInvoicesWithFilter(
     /**
      * @return InvoicePaymentMethod[]
      */
-    public function getPaymentMethods(string $storeId, string $invoiceId): array
-    {
+    public function getPaymentMethods(
+        string $storeId,
+        string $invoiceId,
+        bool $includeSensitive = false,
+        bool $onlyAccountedPayments = true
+    ): array {
         $method = 'GET';
         $url = $this->getApiUrl() . 'stores/' . urlencode($storeId) . '/invoices/'
             . urlencode($invoiceId) . '/payment-methods';
+        $url .= '?includeSensitive=' . ($includeSensitive ? 'true' : 'false');
+        $url .= '&onlyAccountedPayments=' . ($onlyAccountedPayments ? 'true' : 'false');
         $headers = $this->getRequestHeaders();
         $response = $this->getHttpClient()->request($method, $url, $headers);
 

src/Client/InvoiceReceiptOptions.php

@@ -0,0 +1,87 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BTCPayServer\Client;
+
+/**
+ * Additional settings to customize the public receipt
+ */
+class InvoiceReceiptOptions
+{
+    /** @var bool */
+    protected $enabled;
+
+    /** @var bool */
+    protected $showQR;
+
+    /** @var bool */
+    protected $showPayments;
+
+    public static function create(
+        ?bool $enabled,
+        ?bool $showQR,
+        ?bool $showPayments,
+    ) {
+        $options = new InvoiceReceiptOptions();
+        $options->enabled = $enabled;
+        $options->showQR = $showQR ?? null;
+        $options->showPayments = $showPayments;
+        return $options;
+    }
+
+    public function isEnabled(): ?bool
+    {
+        return $this->enabled;
+    }
+
+
+    public function setEnabled(?bool $enabled): self
+    {
+        $this->enabled = $enabled;
+        return $this;
+    }
+
+    public function showsQR(): ?bool
+    {
+        return $this->showQR;
+    }
+
+    public function setShowQR(?bool $showQR): self
+    {
+        $this->showQR = $showQR;
+        return $this;
+    }
+
+    public function showsPayments(): ?bool
+    {
+        return $this->showPayments;
+    }
+
+    public function setShowPayments(?bool $showPayments): self
+    {
+        $this->showPayments = $showPayments;
+        return $this;
+    }
+
+    /**
+     * Converts the whole object incl. protected and private properties to an array.
+     */
+    public function toArray(): array
+    {
+        $array = [];
+        $objAsArray = (array) $this;
+        foreach ($objAsArray as $k => $v) {
+            $separator = "\0";
+            $k = rtrim($k, $separator);
+
+            $lastIndex = strrpos($k, $separator);
+            if ($lastIndex !== false) {
+                $k = substr($k, $lastIndex + 1);
+            }
+            $array[$k] = $v;
+        }
+
+        return $array;
+    }
+}