From 4311e942972a24401b7d8492c32879554abb50bf Mon Sep 17 00:00:00 2001
From: Philipp Stracker <p.stracker@syde.com>
Date: Thu, 8 Aug 2024 17:55:49 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=9A=A7=20Allow=20updating=20transaction?=
 =?UTF-8?q?=20details?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../resources/js/GooglepayButton.js           | 38 ++++++++++++++++++-
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/modules/ppcp-googlepay/resources/js/GooglepayButton.js b/modules/ppcp-googlepay/resources/js/GooglepayButton.js
index bd588307e..65803d800 100644
--- a/modules/ppcp-googlepay/resources/js/GooglepayButton.js
+++ b/modules/ppcp-googlepay/resources/js/GooglepayButton.js
@@ -46,6 +46,21 @@ import { PaymentMethods } from '../../../ppcp-button/resources/js/modules/Helper
  * @property {Function} onPaymentDataChanged - This method handles payment data changes in the payment sheet such as shipping address and shipping options.
  */
 
+/**
+ * This object describes the transaction details.
+ *
+ * @see https://developers.google.com/pay/api/web/reference/request-objects#TransactionInfo
+ * @typedef {Object} TransactionInfo
+ * @property {string} currencyCode     - Required. The ISO 4217 alphabetic currency code.
+ * @property {string} countryCode      - Optional. required for EEA countries,
+ * @property {string} transactionId    - Optional. A unique ID that identifies a facilitation attempt. Highly encouraged for troubleshooting.
+ * @property {string} totalPriceStatus - Required. [ESTIMATED|FINAL] The status of the total price used:
+ * @property {string} totalPrice       - Required. Total monetary value of the transaction with an optional decimal precision of two decimal places.
+ * @property {Array}  displayItems     - Optional. A list of cart items shown in the payment sheet (e.g. subtotals, sales taxes, shipping charges, discounts etc.).
+ * @property {string} totalPriceLabel  - Optional. Custom label for the total price within the display items.
+ * @property {string} checkoutOption   - Optional. Affects the submit button text displayed in the Google Pay payment sheet.
+ */
+
 class GooglepayButton extends PaymentButton {
 	/**
 	 * @inheritDoc
@@ -62,6 +77,13 @@ class GooglepayButton extends PaymentButton {
 	 */
 	#paymentsClient = null;
 
+	/**
+	 * Details about the processed transaction.
+	 *
+	 * @type {?TransactionInfo}
+	 */
+	#transactionInfo = null;
+
 	/**
 	 * @inheritDoc
 	 */
@@ -173,6 +195,18 @@ class GooglepayButton extends PaymentButton {
 		return this.#paymentsClient;
 	}
 
+	/**
+	 * Details about the processed transaction.
+	 *
+	 * This object defines the price that is charged, and text that is displayed inside the
+	 * payment sheet.
+	 *
+	 * @return {?TransactionInfo} The TransactionInfo object.
+	 */
+	get transactionInfo() {
+		return this.#transactionInfo;
+	}
+
 	/**
 	 * Configures the button instance. Must be called before the initial `init()`.
 	 *
@@ -181,11 +215,11 @@ class GooglepayButton extends PaymentButton {
 	 */
 	configure( apiConfig, transactionInfo ) {
 		this.googlePayConfig = apiConfig;
-			this.transactionInfo = transactionInfo;
+		this.#transactionInfo = transactionInfo;
 
 		this.allowedPaymentMethods = this.googlePayConfig.allowedPaymentMethods;
 		this.baseCardPaymentMethod = this.allowedPaymentMethods[ 0 ];
-		}
+	}
 
 	init() {
 		// Stop, if the button is already initialized.