' + response.data.message + '
' + + '' + certificateLink[0].outerHTML + privateKeyLink[0].outerHTML + '
') + .show(); + + // Trigger downloads after a short delay + setTimeout(function() { + certificateLink[0].click(); + setTimeout(function() { + privateKeyLink[0].click(); + }, 500); + }, 100); + + // Clean up object URLs after downloads + setTimeout(function() { + URL.revokeObjectURL(certificateUrl); + URL.revokeObjectURL(privateKeyUrl); + }, 1000); + } else { + // Show error message + let errorMessage = ckoMerchantCertificateData.i18n.error + ' '; + if (response.data && response.data.message) { + errorMessage += response.data.message; + } else { + errorMessage += 'Unknown error occurred.'; + } + + // Show detailed error if available + if (response.data && response.data.error_codes) { + errorMessage += 'Error codes: ' + response.data.error_codes.join(', '); + } + if (response.data && response.data.error_type) { + errorMessage += '
Error type: ' + response.data.error_type; + } + if (response.data && response.data.debug_info) { + errorMessage += '
Debug: ' + JSON.stringify(response.data.debug_info); + } + + $statusDiv + .addClass('cko-status-message notice notice-error') + .html('
' + errorMessage + '
') + .show(); + } + }, + error: function(xhr, status, error) { + let errorMessage = ckoMerchantCertificateData.i18n.error + ' '; + if (xhr.responseJSON && xhr.responseJSON.data && xhr.responseJSON.data.message) { + errorMessage += xhr.responseJSON.data.message; + } else { + errorMessage += error || 'Network error occurred.'; + } + + $statusDiv + .addClass('notice notice-error') + .html('' + errorMessage + '
') + .show(); + }, + complete: function() { + // Re-enable button + $button.prop('disabled', false).text(originalButtonText); + } + }); + }); + }); +})(jQuery); diff --git a/checkout-com-unified-payments-api/assets/js/admin-apple-pay-merchant-identity-certificate.js b/checkout-com-unified-payments-api/assets/js/admin-apple-pay-merchant-identity-certificate.js new file mode 100644 index 00000000..2813e6f1 --- /dev/null +++ b/checkout-com-unified-payments-api/assets/js/admin-apple-pay-merchant-identity-certificate.js @@ -0,0 +1,147 @@ +/** + * Admin Apple Pay Merchant Identity Certificate Upload + * + * Handles merchant identity certificate upload and conversion from the WordPress admin interface. + */ +(function($) { + 'use strict'; + + $(document).ready(function() { + const $uploadButton = $('#cko-upload-merchant-identity-certificate-button'); + const $fileInput = $('#cko-merchant-identity-certificate-upload'); + const $statusDiv = $('#cko-merchant-identity-certificate-status'); + + if (!$uploadButton.length) { + return; // Exit if not on the right page + } + + $uploadButton.on('click', function(e) { + e.preventDefault(); + + const file = $fileInput[0].files[0]; + + if (!file) { + $statusDiv + .removeClass('notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoMerchantIdentityCertificateData.i18n.error + ' ' + ckoMerchantIdentityCertificateData.i18n.noFile + '
') + .show(); + return; + } + + // Validate file type + if (!file.name.toLowerCase().endsWith('.cer')) { + $statusDiv + .removeClass('notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoMerchantIdentityCertificateData.i18n.error + ' Please select a valid .cer certificate file.' + '
') + .show(); + return; + } + + const $button = $(this); + const originalText = $button.text(); + + // Disable button and show loading state + $button.prop('disabled', true).text(ckoMerchantIdentityCertificateData.i18n.uploading); + $statusDiv.hide().removeClass('notice notice-success notice-error'); + + // Read file as base64 + const reader = new FileReader(); + reader.onload = function(e) { + // Convert to base64 + const base64Content = e.target.result.split(',')[1]; // Remove data:application/x-x509-ca-cert;base64, prefix + + // Make AJAX request + $.ajax({ + url: ckoMerchantIdentityCertificateData.ajaxUrl, + type: 'POST', + dataType: 'json', + data: { + action: 'cko_upload_apple_pay_merchant_identity_certificate', + nonce: ckoMerchantIdentityCertificateData.nonce, + certificate: base64Content, + filename: file.name + }, + beforeSend: function(xhr) { + xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest'); + }, + success: function(response) { + if (response.success) { + // Show success message with absolute paths + let successMsg = '' + ckoMerchantIdentityCertificateData.i18n.success + '
'; + if (response.data && response.data.certificate_path) { + successMsg += 'Certificate (.pem) saved to: ' + response.data.certificate_path + '
Private Key (.key) saved to: ' + response.data.key_path + '
Configure these paths:
'; + successMsg += '- ';
+ successMsg += '
- Merchant Certificate Path:
' + response.data.certificate_path + '';
+ successMsg += ' - Merchant Certificate Key Path:
' + response.data.key_path + '';
+ successMsg += '
Certificate (.pem) saved to: ' + response.data.certificate_path + '
Note: Make sure the key file (certificate_sandbox.key) from Step 1 is also saved on your server.
'; + } + + $statusDiv + .removeClass('notice-error') + .addClass('cko-status-message notice notice-success') + .html(successMsg) + .show(); + + // Reset button and file input after 2 seconds + setTimeout(function() { + $button.prop('disabled', false).text(originalText); + $fileInput.val(''); + }, 2000); + } else { + // Show error message + let errorMsg = ''; + if (response.data && response.data.message) { + errorMsg = response.data.message; + } else if (response.data) { + errorMsg = JSON.stringify(response.data); + } else { + errorMsg = 'Unknown error'; + } + + $statusDiv + .removeClass('notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoMerchantIdentityCertificateData.i18n.error + ' ' + errorMsg + '
') + .show(); + + $button.prop('disabled', false).text(originalText); + } + }, + error: function(xhr, status, error) { + // Show error message + $statusDiv + .removeClass('notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoMerchantIdentityCertificateData.i18n.error + ' ' + error + '
') + .show(); + + $button.prop('disabled', false).text(originalText); + } + }); + }; + + reader.onerror = function() { + $statusDiv + .removeClass('notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoMerchantIdentityCertificateData.i18n.error + ' Failed to read certificate file.' + '
') + .show(); + + $button.prop('disabled', false).text(originalText); + }; + + // Read file as data URL (base64) + reader.readAsDataURL(file); + }); + }); +})(jQuery); + diff --git a/checkout-com-unified-payments-api/assets/js/admin-apple-pay-merchant-identity-csr.js b/checkout-com-unified-payments-api/assets/js/admin-apple-pay-merchant-identity-csr.js new file mode 100644 index 00000000..f95b0f16 --- /dev/null +++ b/checkout-com-unified-payments-api/assets/js/admin-apple-pay-merchant-identity-csr.js @@ -0,0 +1,134 @@ +/** + * Admin Apple Pay Merchant Identity CSR Generation + * + * Handles Merchant Identity CSR generation from the WordPress admin interface. + */ +(function($) { + 'use strict'; + + $(document).ready(function() { + const $generateButton = $('#cko-generate-merchant-identity-csr-button'); + const $statusDiv = $('#cko-merchant-identity-csr-status'); + const $instructionsDiv = $('#cko-merchant-identity-csr-instructions'); + + if (!$generateButton.length) { + return; // Exit if not on the right page + } + + $generateButton.on('click', function(e) { + e.preventDefault(); + + const $button = $(this); + const originalText = $button.text(); + + // Disable button and show loading state + $button.prop('disabled', true).text(ckoMerchantIdentityCsrData.i18n.generating); + $statusDiv.hide().removeClass('cko-status-message notice notice-success notice-error'); + + // Make AJAX request + $.ajax({ + url: ckoMerchantIdentityCsrData.ajaxUrl, + type: 'POST', + dataType: 'json', + data: { + action: 'cko_generate_apple_pay_merchant_identity_csr', + nonce: ckoMerchantIdentityCsrData.nonce + }, + beforeSend: function(xhr) { + xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest'); + }, + success: function(response) { + if (response.success && response.data) { + // Download CSR file + downloadFile( + atob(response.data.csr), + response.data.csr_filename || 'uploadMe.csr', + 'text/plain' + ); + + // Download private key file + downloadFile( + atob(response.data.private_key), + response.data.private_key_filename || 'certificate_sandbox.key', + 'text/plain' + ); + + // Show success message with server paths + let successMsg = '' + ckoMerchantIdentityCsrData.i18n.success + '
'; + if (response.data && response.data.key_file_path) { + successMsg += 'Private Key saved to: ' + response.data.key_file_path + '
Note: The CSR file (uploadMe.csr) has been downloaded. Upload it to Apple Developer to get your signed certificate.
'; + } + + $statusDiv + .removeClass('notice notice-error') + .addClass('cko-status-message notice notice-success') + .html(successMsg) + .show(); + + // Show instructions + $instructionsDiv.slideDown(); + + // Reset button after 2 seconds + setTimeout(function() { + $button.prop('disabled', false).text(originalText); + }, 2000); + } else { + // Show error message + let errorMsg = ''; + if (response.data && response.data.message) { + errorMsg = response.data.message; + } else if (response.data) { + errorMsg = JSON.stringify(response.data); + } else { + errorMsg = 'Unknown error'; + } + + $statusDiv + .removeClass('notice notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoMerchantIdentityCsrData.i18n.error + ' ' + errorMsg + '
') + .show(); + + $button.prop('disabled', false).text(originalText); + } + }, + error: function(xhr, status, error) { + // Show error message + $statusDiv + .removeClass('notice notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoMerchantIdentityCsrData.i18n.error + ' ' + error + '
') + .show(); + + $button.prop('disabled', false).text(originalText); + } + }); + }); + + /** + * Download file + * + * @param {string} content File content + * @param {string} filename Filename for download + * @param {string} mimeType MIME type + */ + function downloadFile(content, filename, mimeType) { + const blob = new Blob([content], { type: mimeType || 'text/plain' }); + const url = window.URL.createObjectURL(blob); + + const link = document.createElement('a'); + link.href = url; + link.download = filename; + document.body.appendChild(link); + link.click(); + + // Clean up + setTimeout(function() { + document.body.removeChild(link); + window.URL.revokeObjectURL(url); + }, 100); + } + }); +})(jQuery); + diff --git a/checkout-com-unified-payments-api/assets/js/admin-apple-pay-settings-ux.js b/checkout-com-unified-payments-api/assets/js/admin-apple-pay-settings-ux.js new file mode 100644 index 00000000..a698360e --- /dev/null +++ b/checkout-com-unified-payments-api/assets/js/admin-apple-pay-settings-ux.js @@ -0,0 +1,382 @@ +/** + * Apple Pay Settings UX Enhancements + * + * Features: + * - Progress tracking and status updates + * - Card state management + * - Setup completion detection + * - Visual feedback for user actions + * + * @package wc_checkout_com + */ + +(function($) { + 'use strict'; + + /** + * Apple Pay Settings UX Manager + */ + const ApplePaySettingsUX = { + + /** + * Initialize UX enhancements + */ + init: function() { + this.updateCardStates(); + this.setupProgressTracking(); + this.enhanceFileUploads(); + this.setupStatusUpdates(); + this.setupCollapsibleSections(); + this.addSecurityWarnings(); + }, + + /** + * Update card states based on field completion + */ + updateCardStates: function() { + $('.cko-settings-card').each(function() { + const $card = $(this); + const cardId = $card.data('card-id'); + + if (!cardId) return; + + let isCompleted = false; + let hasError = false; + let isInProgress = false; + + // Check completion based on card type + switch(cardId) { + case 'payment-processing-certificate': + isCompleted = ApplePaySettingsUX.checkPaymentProcessingCertificate(); + break; + case 'domain-association': + isCompleted = ApplePaySettingsUX.checkDomainAssociation(); + break; + case 'merchant-identity-certificate': + isCompleted = ApplePaySettingsUX.checkMerchantIdentityCertificate(); + break; + case 'apple-pay-configuration': + isCompleted = ApplePaySettingsUX.checkApplePayConfiguration(); + break; + case 'express-checkout': + isCompleted = ApplePaySettingsUX.checkExpressCheckout(); + break; + } + + // Update card classes + $card.removeClass('completed in-progress error required'); + + if (hasError) { + $card.addClass('error'); + } else if (isCompleted) { + $card.addClass('completed'); + } else if (isInProgress) { + $card.addClass('in-progress'); + } else { + $card.addClass('required'); + } + + // Update status badge + const $badge = $card.find('.cko-status-badge'); + if ($badge.length) { + $badge.removeClass('completed in-progress required error'); + if (hasError) { + $badge.addClass('error').text('Error'); + } else if (isCompleted) { + $badge.addClass('completed').text('Completed'); + } else if (isInProgress) { + $badge.addClass('in-progress').text('In Progress'); + } else { + $badge.addClass('required').text('Required'); + } + } + }); + }, + + /** + * Check if payment processing certificate is set up + */ + checkPaymentProcessingCertificate: function() { + // Check if certificate has been uploaded + const certificateUploaded = $('#cko-certificate-status').hasClass('notice-success') || + $('input[name="apple_pay_certificate"]').val() !== ''; + return certificateUploaded; + }, + + /** + * Check if domain association is set up + */ + checkDomainAssociation: function() { + // Check if domain association file has been uploaded + const domainFileUploaded = $('#cko-domain-association-status').hasClass('notice-success') || + $('input[name="apple_pay_domain_association"]').val() !== ''; + return domainFileUploaded; + }, + + /** + * Check if merchant identity certificate is set up + */ + checkMerchantIdentityCertificate: function() { + // Check if merchant identity certificate and key paths are configured + const certPath = $('input[name="ckocom_apple_certificate"]').val(); + const keyPath = $('input[name="ckocom_apple_key"]').val(); + return certPath !== '' && keyPath !== ''; + }, + + /** + * Check if Apple Pay configuration is complete + */ + checkApplePayConfiguration: function() { + const merchantId = $('input[name="ckocom_apple_mercahnt_id"]').val(); + const domainName = $('input[name="apple_pay_domain_name"]').val(); + const displayName = $('input[name="apple_pay_display_name"]').val(); + const certPath = $('input[name="ckocom_apple_certificate"]').val(); + const keyPath = $('input[name="ckocom_apple_key"]').val(); + + return merchantId !== '' && + domainName !== '' && + displayName !== '' && + certPath !== '' && + keyPath !== ''; + }, + + /** + * Check if express checkout is configured + */ + checkExpressCheckout: function() { + const expressEnabled = $('input[name="apple_pay_express"]').is(':checked'); + return expressEnabled; + }, + + /** + * Setup progress tracking + */ + setupProgressTracking: function() { + // Update progress steps based on completion + $('.cko-progress-step').each(function(index) { + const $step = $(this); + const stepNumber = index + 1; + + // Check if this step is completed + let isCompleted = false; + let isActive = false; + + switch(stepNumber) { + case 1: + isCompleted = ApplePaySettingsUX.checkPaymentProcessingCertificate(); + isActive = !isCompleted; + break; + case 2: + isCompleted = ApplePaySettingsUX.checkDomainAssociation(); + isActive = !isCompleted && ApplePaySettingsUX.checkPaymentProcessingCertificate(); + break; + case 3: + isCompleted = ApplePaySettingsUX.checkMerchantIdentityCertificate(); + isActive = !isCompleted && + ApplePaySettingsUX.checkPaymentProcessingCertificate() && + ApplePaySettingsUX.checkDomainAssociation(); + break; + } + + $step.removeClass('completed active'); + if (isCompleted) { + $step.addClass('completed'); + } else if (isActive) { + $step.addClass('active'); + } + }); + }, + + /** + * Enhance file upload areas with drag and drop + */ + enhanceFileUploads: function() { + $('.cko-file-upload-area').each(function() { + const $area = $(this); + const $input = $area.find('input[type="file"]'); + + // Drag and drop handlers + $area.on('dragover', function(e) { + e.preventDefault(); + e.stopPropagation(); + $area.addClass('drag-over'); + }); + + $area.on('dragleave', function(e) { + e.preventDefault(); + e.stopPropagation(); + $area.removeClass('drag-over'); + }); + + $area.on('drop', function(e) { + e.preventDefault(); + e.stopPropagation(); + $area.removeClass('drag-over'); + + const files = e.originalEvent.dataTransfer.files; + if (files.length > 0) { + $input[0].files = files; + $input.trigger('change'); + } + }); + + // File input change handler + $input.on('change', function() { + const fileName = $(this).val().split('\\').pop(); + if (fileName) { + $area.find('.file-name').remove(); + $area.append('Selected: ' + fileName + '
');
+ }
+ });
+ });
+ },
+
+ /**
+ * Setup status update listeners
+ */
+ setupStatusUpdates: function() {
+ // Listen for AJAX success/error events
+ $(document).on('ajaxSuccess', function(event, xhr, settings) {
+ if (settings.url && settings.url.indexOf('cko_upload') !== -1) {
+ setTimeout(function() {
+ ApplePaySettingsUX.updateCardStates();
+ ApplePaySettingsUX.setupProgressTracking();
+ }, 500);
+ }
+ });
+
+ // Listen for field changes
+ $('input[type="text"], input[type="checkbox"], select').on('change blur', function() {
+ setTimeout(function() {
+ ApplePaySettingsUX.updateCardStates();
+ ApplePaySettingsUX.setupProgressTracking();
+ }, 300);
+ });
+
+ // Listen for certificate generation
+ $(document).on('cko:certificate:generated', function() {
+ setTimeout(function() {
+ ApplePaySettingsUX.updateCardStates();
+ ApplePaySettingsUX.setupProgressTracking();
+ }, 500);
+ });
+ },
+
+ /**
+ * Show completion animation
+ */
+ showCompletionAnimation: function($card) {
+ $card.addClass('completed');
+ $card.find('.cko-card-title-icon').html('✓');
+
+ // Add a subtle animation
+ $card.css({
+ 'animation': 'pulse 0.5s ease'
+ });
+
+ setTimeout(function() {
+ $card.css('animation', '');
+ }, 500);
+ },
+
+ /**
+ * Show error state
+ */
+ showErrorState: function($card, message) {
+ $card.addClass('error');
+ const $status = $card.find('.cko-status-message');
+ if ($status.length) {
+ $status.removeClass('notice-success notice-warning')
+ .addClass('notice-error')
+ .html('Error: ' + message + '
') + .show(); + } + }, + + /** + * Setup collapsible sections for existing configuration + */ + setupCollapsibleSections: function() { + // Check if existing config banner is present or if sections have data-collapsible attribute + const $existingBanner = $('.cko-existing-config-banner'); + const $collapsibleSections = $('.cko-settings-card[data-collapsible="true"]'); + + // Setup toggle functionality for collapsible sections + $collapsibleSections.each(function() { + const $section = $(this); + const $content = $section.find('.cko-collapsible-content'); + const $toggleButton = $section.find('.cko-toggle-section'); + + // Only setup if content exists and toggle button exists + if ($content.length && $toggleButton.length) { + // Toggle functionality + $toggleButton.on('click', function(e) { + e.preventDefault(); + const $toggleText = $(this).find('.toggle-text'); + const $toggleIcon = $(this).find('.toggle-icon'); + + if ($content.is(':visible')) { + $content.slideUp(200); + $toggleText.text('Show'); + $toggleIcon.text('▼'); + } else { + $content.slideDown(200); + $toggleText.text('Hide'); + $toggleIcon.text('▲'); + } + }); + } + }); + }, + + /** + * Add security warnings for private key field + */ + addSecurityWarnings: function() { + // Find the private key field + const $keyField = $('input[name="woocommerce_wc_checkout_com_apple_pay[ckocom_apple_key]"]'); + + if ($keyField.length) { + // Add security warning after the field + const $fieldRow = $keyField.closest('tr'); + const $description = $fieldRow.find('.description'); + + if ($description.length) { + // Add security warning after description + const $warning = $('' +
+ '
');
+
+ $description.after($warning);
+ }
+ }
+ }
+};
+
+ /**
+ * Initialize on document ready
+ */
+ $(document).ready(function() {
+ // Only initialize on Apple Pay settings page
+ if ($('.woocommerce-settings-form').length &&
+ window.location.href.indexOf('wc_checkout_com_apple_pay') !== -1) {
+ ApplePaySettingsUX.init();
+ }
+ });
+
+ // Add pulse animation
+ const style = document.createElement('style');
+ style.textContent = `
+ @keyframes pulse {
+ 0% { transform: scale(1); }
+ 50% { transform: scale(1.02); }
+ 100% { transform: scale(1); }
+ }
+ `;
+ document.head.appendChild(style);
+
+})(jQuery);
+
diff --git a/checkout-com-unified-payments-api/assets/js/admin-apple-pay-test-certificate.js b/checkout-com-unified-payments-api/assets/js/admin-apple-pay-test-certificate.js
new file mode 100644
index 00000000..6a6ccd83
--- /dev/null
+++ b/checkout-com-unified-payments-api/assets/js/admin-apple-pay-test-certificate.js
@@ -0,0 +1,91 @@
+/**
+ * Admin Apple Pay Test Certificate
+ *
+ * Handles certificate and key testing from the WordPress admin interface.
+ */
+(function($) {
+ 'use strict';
+
+ $(document).ready(function() {
+ const $testButton = $('#cko-test-certificate-button');
+ const $statusDiv = $('#cko-test-certificate-status');
+
+ if (!$testButton.length) {
+ return; // Exit if not on the right page
+ }
+
+ $testButton.on('click', function(e) {
+ e.preventDefault();
+
+ const $button = $(this);
+ const originalText = $button.text();
+
+ // Disable button and show loading state
+ $button.prop('disabled', true).text(ckoTestCertificateData.i18n.testing);
+ $statusDiv.hide().removeClass('cko-status-message notice notice-success notice-error');
+
+ // Make AJAX request
+ $.ajax({
+ url: ckoTestCertificateData.ajaxUrl,
+ type: 'POST',
+ dataType: 'json',
+ data: {
+ action: 'cko_test_apple_pay_certificate',
+ nonce: ckoTestCertificateData.nonce
+ },
+ beforeSend: function(xhr) {
+ xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
+ },
+ success: function(response) {
+ if (response.success) {
+ // Show simplified success message
+ let successMsg = '' + + '⚠️ Security Warning: ' + + 'The private key (.key) file must be stored outside of your website\'s public access folder (web root). ' + + 'Never place it in a publicly accessible directory.
' + + '' + ckoTestCertificateData.i18n.success + '
'; + successMsg += '' + ckoTestCertificateData.i18n.successDetails + '
'; + + $statusDiv + .removeClass('notice notice-error') + .addClass('cko-status-message notice notice-success') + .html(successMsg) + .show(); + + // Reset button after 3 seconds + setTimeout(function() { + $button.prop('disabled', false).text(originalText); + }, 3000); + } else { + // Show simplified error message + let errorMsg = ''; + if (response.data && response.data.message) { + errorMsg = response.data.message; + } else { + errorMsg = ckoTestCertificateData.i18n.errorDefault; + } + + $statusDiv + .removeClass('notice notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoTestCertificateData.i18n.error + ' ' + errorMsg + '
') + .show(); + + $button.prop('disabled', false).text(originalText); + } + }, + error: function(xhr, status, error) { + // Show error message + $statusDiv + .removeClass('notice notice-success') + .addClass('cko-status-message notice notice-error') + .html('' + ckoTestCertificateData.i18n.error + ' ' + error + '
') + .show(); + + $button.prop('disabled', false).text(originalText); + } + }); + }); + }); +})(jQuery); + + + + + diff --git a/assets/js/admin.js b/checkout-com-unified-payments-api/assets/js/admin.js similarity index 82% rename from assets/js/admin.js rename to checkout-com-unified-payments-api/assets/js/admin.js index 3384f6bb..f3409f12 100644 --- a/assets/js/admin.js +++ b/checkout-com-unified-payments-api/assets/js/admin.js @@ -3,20 +3,39 @@ jQuery( function ( $ ) { var admin_functions = { hidePaymentMethods: function () { + const classicCheckout = $( '[data-gateway_id="wc_checkout_com_cards"]' ); const applePay = $( '[data-gateway_id="wc_checkout_com_apple_pay"]' ); const googlePay = $( '[data-gateway_id="wc_checkout_com_google_pay"]' ); + const payPal = $( '[data-gateway_id="wc_checkout_com_paypal"]' ); + const flowPay = $( '[data-gateway_id="wc_checkout_com_flow"]' ); const alternativePay = $( '[data-gateway_id*="wc_checkout_com_alternative_payments"]' ); if ( applePay.length > 0 ) { applePay.hide(); } - if ( googlePay.length > 0 ) { + // Google Pay is now available in Flow mode - don't hide it + // Only hide Google Pay in classic mode, show it in Flow mode + if ( googlePay.length > 0 && ! cko_admin_vars.flow_enabled ) { googlePay.hide(); } + if ( flowPay.length > 0 ) { + flowPay.hide(); + } + if ( alternativePay.length > 0 ) { alternativePay.hide(); } + + if( cko_admin_vars.flow_enabled ) { + classicCheckout.hide(); + payPal.hide(); + flowPay.show(); + // Show Google Pay when Flow mode is enabled + if ( googlePay.length > 0 ) { + googlePay.show(); + } + } }, disableRefundForZero: function () { @@ -307,6 +326,59 @@ jQuery( function ( $ ) { } ); } ); + }, + + toggleSecretKeyVisibility: function () { + const field = $('#woocommerce_wc_checkout_com_cards_ckocom_sk'); + if (!field.length) return; + + const wrapper = field.closest('td'); + + // Create the toggle button + const toggleBtn = $(''); + toggleBtn.on('click', function (e) { + e.preventDefault(); + const currentType = field.attr('type'); + if (currentType === 'password') { + field.attr('type', 'text'); + toggleBtn.text('Hide'); + } else { + field.attr('type', 'password'); + toggleBtn.text('View'); + } + }); + + // Append button after the input field + field.after(toggleBtn); + }, + + expressButtonSizeSettings: function () { + // Handle button size preset changes for all three payment methods + const paymentMethods = ['apple_pay', 'google_pay', 'paypal']; + + paymentMethods.forEach(function(paymentMethod) { + const presetField = $('#woocommerce_wc_checkout_com_' + paymentMethod + '_' + paymentMethod + '_express_button_size_preset'); + const customHeightField = $('#woocommerce_wc_checkout_com_' + paymentMethod + '_' + paymentMethod + '_express_button_custom_height'); + + if (!presetField.length || !customHeightField.length) { + return; + } + + // Show/hide custom height field based on preset + function toggleCustomHeight() { + if (presetField.val() === 'custom') { + customHeightField.closest('tr').show(); + } else { + customHeightField.closest('tr').hide(); + } + } + + // Initial state + toggleCustomHeight(); + + // On change + presetField.on('change', toggleCustomHeight); + }); } } @@ -329,4 +401,9 @@ jQuery( function ( $ ) { admin_functions.cardSettings(); admin_functions.webhookSettings(); + + admin_functions.toggleSecretKeyVisibility(); + + // Handle express button size settings + admin_functions.expressButtonSizeSettings(); } ); diff --git a/checkout-com-unified-payments-api/assets/js/blocks/cards-blocks.js b/checkout-com-unified-payments-api/assets/js/blocks/cards-blocks.js new file mode 100644 index 00000000..34d50ec1 --- /dev/null +++ b/checkout-com-unified-payments-api/assets/js/blocks/cards-blocks.js @@ -0,0 +1,25 @@ +/** + * External dependencies + */ +import { registerPaymentMethod } from '@woocommerce/blocks-registry'; +import { getSetting } from '@woocommerce/settings'; + +/** + * Internal dependencies + */ +import { CheckoutComCardsCheckout } from './checkout-com-cards-checkout'; + +const settings = getSetting( 'wc_checkout_com_cards_data', {} ); + +// Register Checkout.com Cards +registerPaymentMethod( { + name: 'wc_checkout_com_cards', + label: settings.title || 'Checkout.com Cards', + content:
+
+ );
+};
+
+/**
+ * Process payment with Checkout.com API
+ */
+const processCheckoutComPayment = async () => {
+ // This would integrate with your existing Checkout.com API
+ // For now, return a placeholder
+ return new Promise((resolve) => {
+ setTimeout(() => {
+ resolve({
+ success: true,
+ paymentData: {
+ paymentMethod: 'wc_checkout_com_cards',
+ timestamp: Date.now()
+ }
+ });
+ }, 1000);
+ });
+};
diff --git a/checkout-com-unified-payments-api/assets/js/blocks/checkout-com-cards-form.js b/checkout-com-unified-payments-api/assets/js/blocks/checkout-com-cards-form.js
new file mode 100644
index 00000000..3d48b5bf
--- /dev/null
+++ b/checkout-com-unified-payments-api/assets/js/blocks/checkout-com-cards-form.js
@@ -0,0 +1,126 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+import { useState } from '@wordpress/element';
+
+/**
+ * Checkout.com Cards Form Component
+ */
+export const CheckoutComCardsForm = ({
+ onSubmit,
+ isLoading,
+ error,
+ shouldSavePayment,
+ setShouldSavePayment
+}) => {
+ const [cardData, setCardData] = useState({
+ cardNumber: '',
+ expiryDate: '',
+ cvv: '',
+ cardholderName: ''
+ });
+
+ const handleInputChange = (field, value) => {
+ setCardData(prev => ({
+ ...prev,
+ [field]: value
+ }));
+ };
+
+ const handleSavePaymentChange = (event) => {
+ setShouldSavePayment(event.target.checked);
+ };
+
+ return (
+
+ );
+};
diff --git a/checkout-com-unified-payments-api/assets/js/blocks/paypal-blocks.js b/checkout-com-unified-payments-api/assets/js/blocks/paypal-blocks.js
new file mode 100644
index 00000000..3984ce8a
--- /dev/null
+++ b/checkout-com-unified-payments-api/assets/js/blocks/paypal-blocks.js
@@ -0,0 +1,25 @@
+/**
+ * External dependencies
+ */
+import { registerPaymentMethod } from '@woocommerce/blocks-registry';
+import { getSetting } from '@woocommerce/settings';
+
+/**
+ * Internal dependencies
+ */
+import { PayPalExpressCheckout } from './paypal-express-checkout';
+
+const settings = getSetting( 'wc_checkout_com_paypal_data', {} );
+
+// Register PayPal Express Checkout
+registerPaymentMethod( {
+ name: 'wc_checkout_com_paypal',
+ label: settings.title || 'PayPal',
+ content:
+
+ {isLoading && (
+
+ );
+};
diff --git a/checkout-com-unified-payments-api/assets/js/blocks/paypal-express-checkout.js b/checkout-com-unified-payments-api/assets/js/blocks/paypal-express-checkout.js
new file mode 100644
index 00000000..e4475301
--- /dev/null
+++ b/checkout-com-unified-payments-api/assets/js/blocks/paypal-express-checkout.js
@@ -0,0 +1,118 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+import { useState, useEffect } from '@wordpress/element';
+import { usePaymentMethodDataContext } from '@woocommerce/base-context';
+
+/**
+ * Internal dependencies
+ */
+import { PayPalButton } from './paypal-button';
+
+/**
+ * PayPal Express Checkout Component
+ */
+export const PayPalExpressCheckout = () => {
+ const {
+ paymentMethodData,
+ setPaymentMethodData
+ } = usePaymentMethodDataContext();
+
+ const [isLoading, setIsLoading] = useState(false);
+ const [error, setError] = useState(null);
+ const [paypalLoaded, setPaypalLoaded] = useState(false);
+
+ // Load PayPal SDK
+ useEffect(() => {
+ if (window.paypal) {
+ setPaypalLoaded(true);
+ return;
+ }
+
+ const script = document.createElement('script');
+ script.src = 'https://www.paypal.com/sdk/js?client-id=YOUR_CLIENT_ID¤cy=USD';
+ script.async = true;
+ script.onload = () => setPaypalLoaded(true);
+ document.head.appendChild(script);
+
+ return () => {
+ if (script.parentNode) {
+ script.parentNode.removeChild(script);
+ }
+ };
+ }, []);
+
+ const handlePayPalApprove = async (data) => {
+ setIsLoading(true);
+ setError(null);
+
+ try {
+ // Process PayPal payment
+ const result = await processPayPalPayment(data);
+
+ if (result.success) {
+ setPaymentMethodData({
+ ...paymentMethodData,
+ paymentMethod: 'wc_checkout_com_paypal',
+ paymentData: result.paymentData
+ });
+ } else {
+ setError(result.error || 'PayPal payment failed');
+ }
+ } catch (err) {
+ setError('An unexpected error occurred');
+ } finally {
+ setIsLoading(false);
+ }
+ };
+
+ const handlePayPalError = (err) => {
+ setError('PayPal payment failed');
+ setIsLoading(false);
+ };
+
+ if (!paypalLoaded) {
+ return (
+
+ {__('Processing PayPal payment...', 'checkout-com-unified-payments-api')}
+
+ )}
+
+ {__('Loading PayPal...', 'checkout-com-unified-payments-api')}
+
+ );
+ }
+
+ return (
+
+ {error && (
+
+ );
+};
+
+/**
+ * Process PayPal payment
+ */
+const processPayPalPayment = async (paypalData) => {
+ // This would integrate with your existing PayPal API
+ // For now, return a placeholder
+ return new Promise((resolve) => {
+ setTimeout(() => {
+ resolve({
+ success: true,
+ paymentData: {
+ paymentMethod: 'wc_checkout_com_paypal',
+ paypalOrderId: paypalData.orderID,
+ timestamp: Date.now()
+ }
+ });
+ }, 1000);
+ });
+};
diff --git a/checkout-com-unified-payments-api/assets/js/cko-apple-pay-express-integration.js b/checkout-com-unified-payments-api/assets/js/cko-apple-pay-express-integration.js
new file mode 100644
index 00000000..1cb9a977
--- /dev/null
+++ b/checkout-com-unified-payments-api/assets/js/cko-apple-pay-express-integration.js
@@ -0,0 +1,911 @@
+/* global cko_apple_pay_vars */
+
+jQuery( function ( $ ) {
+
+ const formSelector = 'form.cart';
+
+ const onFormChange = function ( e ) {
+ const form = document.querySelector( formSelector );
+
+ const addToCartButton = form ? form.querySelector('.single_add_to_cart_button') : null;
+
+ const isEnabled = ( null === addToCartButton ) || ! addToCartButton.classList.contains( 'disabled' );
+
+ const element = jQuery( cko_apple_pay_vars.apple_pay_button_selector );
+
+ if ( isEnabled ) {
+ jQuery(element)
+ .removeClass('cko-disabled')
+ .off('mouseup')
+ .find('> *')
+ .css('pointer-events', '');
+ } else {
+ jQuery(element)
+ .addClass('cko-disabled')
+ .on('mouseup', function(event) {
+ event.stopImmediatePropagation();
+ })
+ .find('> *')
+ .css('pointer-events', 'none');
+ }
+
+ };
+
+ const getAttributes = function() {
+ var select = $( '.variations_form' ).find( '.variations select' ),
+ data = {},
+ count = 0,
+ chosen = 0;
+
+ select.each( function() {
+ var attribute_name = $( this ).data( 'attribute_name' ) || $( this ).attr( 'name' );
+ var value = $( this ).val() || '';
+
+ if ( value.length > 0 ) {
+ chosen ++;
+ }
+
+ count ++;
+ data[ attribute_name ] = value;
+ });
+
+ return {
+ 'count' : count,
+ 'chosenCount': chosen,
+ 'data' : data
+ };
+ };
+
+ let showError = function ( error_message ) {
+
+ if ( 'string' === typeof error_message ) {
+ error_message = [ error_message ];
+ }
+
+ let ulWrapper = jQuery( '
+ {error}
+
+ )}
+
+ ' )
+ .addClass( 'woocommerce-NoticeGroup woocommerce-NoticeGroup-checkout' )
+ .append( ulWrapper );
+
+ let scrollTarget;
+
+ if ( jQuery('form.checkout').length ) {
+ jQuery('form.checkout .woocommerce-NoticeGroup').remove();
+ jQuery('form.checkout').prepend(wcNoticeDiv);
+ jQuery('.woocommerce, .form.checkout').removeClass('processing').unblock();
+ scrollTarget = jQuery('form.checkout');
+ } else if ( jQuery('.woocommerce-order-pay').length ) {
+ jQuery('.woocommerce-order-pay .woocommerce-NoticeGroup').remove();
+ jQuery('.woocommerce-order-pay').prepend(wcNoticeDiv);
+ jQuery('.woocommerce, .woocommerce-order-pay').removeClass('processing').unblock();
+ scrollTarget = jQuery('.woocommerce-order-pay');
+ }
+
+ if ( scrollTarget ) {
+ jQuery('html, body').animate({
+ scrollTop: (scrollTarget.offset().top - 100)
+ }, 1000);
+ }
+ };
+
+ const cko_express_add_to_cart = async function () {
+ var product_id = $( '.single_add_to_cart_button' ).val();
+
+ // Check if product is a variable product.
+ if ( $( '.single_variation_wrap' ).length ) {
+ product_id = $( '.single_variation_wrap' ).find( 'input[name="product_id"]' ).val();
+ }
+
+ var data = {
+ product_id: product_id,
+ qty: $( '.quantity .qty' ).val(),
+ attributes: $( '.variations_form' ).length ? getAttributes().data : [],
+ nonce: cko_apple_pay_vars.apple_pay_express_add_to_cart_nonce
+ };
+
+ return await $.ajax( {
+ url: cko_apple_pay_vars.add_to_cart_url,
+ type: 'POST',
+ async: false,
+ data: data
+ } ).done( function ( response ) {
+ cko_apple_pay_vars.debug && console.log( response );
+ } ).fail( function ( xhr, status, error ) {
+ console.error('[Apple Pay Express] Add to cart failed:', error);
+ cko_apple_pay_vars.debug && console.error('[Apple Pay Express] Response text:', xhr.responseText);
+ return { result: 'error', message: 'Failed to add product to cart' };
+ } )
+ }
+
+ const cko_express_add_to_cart_for_product = async function (productId) {
+ let data = {
+ product_id: productId,
+ quantity: 1,
+ nonce: cko_apple_pay_vars.apple_pay_express_add_to_cart_nonce
+ };
+
+ return await $.ajax( {
+ url: cko_apple_pay_vars.add_to_cart_url,
+ type: 'POST',
+ async: false,
+ data: data
+ } ).done( function ( response ) {
+ cko_apple_pay_vars.debug && console.log( 'Add to cart response for product ' + productId + ':', response );
+ } ).fail( function ( xhr, status, error ) {
+ console.error('[Apple Pay Express] Add to cart failed for product ' + productId + ':', error);
+ cko_apple_pay_vars.debug && console.error('[Apple Pay Express] Response text:', xhr.responseText);
+ return { result: 'error', message: 'Failed to add product to cart' };
+ } )
+ };
+
+ const getCartTotalFromAPI = async function() {
+ // Get cart total directly from WooCommerce API endpoint
+ try {
+ if (!cko_apple_pay_vars.get_cart_total_url) {
+ if (cko_apple_pay_vars.debug) {
+ console.log('[Apple Pay Express] get_cart_total_url not available');
+ }
+ return 0;
+ }
+
+ const response = await jQuery.ajax({
+ url: cko_apple_pay_vars.get_cart_total_url,
+ type: 'GET',
+ dataType: 'json'
+ });
+
+ if (response && response.success && response.data && response.data.total) {
+ const total = parseFloat(response.data.total) || 0;
+ if (cko_apple_pay_vars.debug) {
+ console.log('[Apple Pay Express] Cart total from API:', total, response.data);
+ }
+ if (total > 0) {
+ return total;
+ }
+ }
+
+ return 0;
+ } catch (error) {
+ if (cko_apple_pay_vars.debug) {
+ console.log('[Apple Pay Express] API call failed:', error);
+ }
+ return 0;
+ }
+ };
+
+ const getCartTotalFromServer = async function() {
+ // Get cart total from WooCommerce cart fragment
+ try {
+ let ajaxUrl = window.location.href;
+
+ if (typeof wc_add_to_cart_params !== 'undefined' && wc_add_to_cart_params.wc_ajax_url) {
+ ajaxUrl = wc_add_to_cart_params.wc_ajax_url.toString().replace('%%endpoint%%', 'get_refreshed_fragments');
+ } else if (typeof wc_cart_fragments_params !== 'undefined' && wc_cart_fragments_params.wc_ajax_url) {
+ ajaxUrl = wc_cart_fragments_params.wc_ajax_url.toString().replace('%%endpoint%%', 'get_refreshed_fragments');
+ } else {
+ ajaxUrl = window.location.origin + '/?wc-ajax=get_refreshed_fragments';
+ }
+
+ const response = await jQuery.ajax({
+ url: ajaxUrl,
+ type: 'POST',
+ data: {
+ 'wc-ajax': 'get_refreshed_fragments'
+ }
+ });
+
+ if (response && response.fragments) {
+ let cartTotalMatch = response.fragments['div.cart_totals']?.match(/total[^>]*>[\s\S]*?(\d+[.,]\d+)/i);
+ if (cartTotalMatch) {
+ const total = parseFloat(cartTotalMatch[1].replace(',', '.')) || 0;
+ if (total > 0) return total;
+ }
+
+ const fragmentKeys = Object.keys(response.fragments);
+ for (let key of fragmentKeys) {
+ const fragment = response.fragments[key];
+ if (fragment && typeof fragment === 'string') {
+ const blocksTotalMatch = fragment.match(/wc-block-components-totals__total-value[^>]*>[\s\S]*?(\d+[.,]\d+)/i) ||
+ fragment.match(/wc-block-components-totals__item-value[^>]*>[\s\S]*?(\d+[.,]\d+)/i);
+ if (blocksTotalMatch) {
+ const total = parseFloat(blocksTotalMatch[1].replace(',', '.')) || 0;
+ if (total > 0) return total;
+ }
+ }
+ }
+ }
+
+ const cartTotalElement = jQuery('.cart_totals .order-total .woocommerce-Price-amount, .wc-block-cart__totals .wc-block-components-totals__total-value, .wc-block-cart__totals .wc-block-components-totals__item-value');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ const total = parseFloat(totalText.replace(',', '.')) || 0;
+ return total;
+ }
+
+ return 0;
+ } catch (error) {
+ const cartTotalElement = jQuery('.cart_totals .order-total .woocommerce-Price-amount, .wc-block-cart__totals .wc-block-components-totals__total-value, .wc-block-cart__totals .wc-block-components-totals__item-value');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ const total = parseFloat(totalText.replace(',', '.')) || 0;
+ return total;
+ }
+ return 0;
+ }
+ };
+
+ const getCartTotal = function(context) {
+ let total = '0.00';
+
+ if (context === 'cart') {
+ let cartTotalElement = jQuery('.wc-block-cart__totals .wc-block-components-totals__item-value, .wc-block-cart__totals .wc-block-components-totals__total-value');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ total = totalText.replace(',', '.');
+ } else {
+ cartTotalElement = jQuery('.cart_totals .order-total .woocommerce-Price-amount, .cart_totals .woocommerce-Price-amount, .cart_totals .order-total td .amount');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ total = totalText.replace(',', '.');
+ } else {
+ cartTotalElement = jQuery('.wc-block-cart__totals .amount, .wc-block-cart__totals .woocommerce-Price-amount');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ total = totalText.replace(',', '.');
+ }
+ }
+ }
+ } else {
+ const priceElement = jQuery('.price .amount, .price .woocommerce-Price-amount, .woocommerce-Price-amount');
+ if (priceElement.length) {
+ const priceText = priceElement.first().text().replace(/[^\d.,]/g, '');
+ total = priceText.replace(',', '.');
+ }
+ }
+
+ return parseFloat(total) || 0.00;
+ };
+
+ const getCartItemsForDisplay = async function() {
+ const items = [];
+
+ try {
+ let hasItems = false;
+
+ // Try to get cart items from DOM
+ jQuery('.cart_item, .wc-block-cart-item').each(function() {
+ const $item = jQuery(this);
+ const productName = $item.find('.product-name a, .wc-block-cart-item__product-name a').text().trim();
+ const quantity = $item.find('.product-quantity .quantity input, .wc-block-cart-item__quantity input').val() ||
+ $item.find('.product-quantity, .wc-block-cart-item__quantity').text().match(/\d+/)?.[0] || '1';
+ const priceText = $item.find('.product-price .amount, .wc-block-cart-item__total .amount').text().replace(/[^\d.,]/g, '');
+ const price = parseFloat(priceText.replace(',', '.')) || 0;
+
+ if (productName && price > 0) {
+ items.push({
+ label: productName,
+ type: 'LINE_ITEM',
+ price: price.toFixed(2),
+ quantity: quantity
+ });
+ hasItems = true;
+ }
+ });
+
+ if (hasItems) {
+ return items;
+ }
+ } catch (error) {
+ cko_apple_pay_vars.debug && console.log('[Apple Pay Express] Error getting cart items:', error);
+ }
+
+ return items;
+ };
+
+ const performAppleUrlValidation = function(valURL, callback) {
+ jQuery.ajax({
+ type: 'POST',
+ url: cko_apple_pay_vars.session_url || window.location.origin + '/?wc-api=wc_checkoutcom_session',
+ data: {
+ url: valURL,
+ merchantId: cko_apple_pay_vars.merchant_id,
+ domain: window.location.host,
+ displayName: window.location.host,
+ },
+ success: function (outcome) {
+ var data = JSON.parse(outcome);
+ callback(data);
+ },
+ error: function() {
+ callback(null);
+ }
+ });
+ };
+
+ const generateCheckoutToken = function(token, callback) {
+ jQuery.ajax({
+ type: 'POST',
+ url: cko_apple_pay_vars.generate_token_url || window.location.origin + '/?wc-api=wc_checkoutcom_generate_token',
+ data: {
+ token: token
+ },
+ success: function (outcome) {
+ callback(outcome);
+ },
+ error: function () {
+ callback('');
+ }
+ });
+ };
+
+ const applePayButton = {
+ init: function () {
+ // Wait for Apple Pay API to load
+ this.waitForApplePayAPI();
+ },
+
+ waitForApplePayAPI: function() {
+ const self = this;
+ const checkInterval = setInterval(function() {
+ if (typeof ApplePaySession !== 'undefined') {
+ clearInterval(checkInterval);
+ setTimeout(function() {
+ self.initializeButtons();
+ }, 100);
+ }
+ }, 100);
+
+ setTimeout(function() {
+ clearInterval(checkInterval);
+ if (typeof ApplePaySession === 'undefined') {
+ cko_apple_pay_vars.debug && console.warn('[Apple Pay Express] Apple Pay API not loaded after 10 seconds');
+ } else {
+ setTimeout(function() {
+ self.initializeButtons();
+ }, 100);
+ }
+ }, 10000);
+ },
+
+ initializeButtons: function() {
+ const isProductPage = jQuery('#cko-apple-pay-button-wrapper').length > 0;
+ const isCartPageByWrapper = jQuery('#cko-apple-pay-button-wrapper-cart').length > 0;
+ const isCartPageByClass = jQuery('.wc-block-cart, .woocommerce-cart').length > 0;
+ const isCartPage = isCartPageByWrapper || isCartPageByClass;
+ const isShopPage = jQuery('[id^="cko-apple-pay-button-wrapper-"]').filter(function() {
+ return !jQuery(this).is('#cko-apple-pay-button-wrapper-cart') && !jQuery(this).is('#cko-apple-pay-button-wrapper');
+ }).length > 0;
+
+ if (isProductPage) {
+ this.initProductPageButton();
+ }
+
+ if (isShopPage) {
+ this.initShopPageButtons();
+ }
+
+ if (isCartPage) {
+ this.initCartPageButton();
+ }
+
+ this.updateButtonVisibility();
+
+ jQuery(document).on('change', formSelector, onFormChange );
+ },
+
+ initProductPageButton: function(retryCount) {
+ retryCount = retryCount || 0;
+ const maxRetries = 5;
+
+ const wrapper = jQuery('#cko-apple-pay-button-wrapper');
+ if (wrapper.length && typeof ApplePaySession !== 'undefined') {
+ if (!ApplePaySession.canMakePayments(cko_apple_pay_vars.merchant_id)) {
+ wrapper.hide();
+ return;
+ }
+
+ try {
+ const button = document.createElement('apple-pay-button');
+ button.setAttribute('id', 'cko-apple-pay-button');
+ button.setAttribute('type', 'plain');
+ button.setAttribute('buttonstyle', cko_apple_pay_vars.button_theme || 'black');
+ if (cko_apple_pay_vars.button_language) {
+ button.setAttribute('locale', cko_apple_pay_vars.button_language);
+ }
+ button.onclick = () => this.onApplePayButtonClick('product');
+
+ wrapper.html('');
+ wrapper.append(button);
+ wrapper.show();
+ } catch (error) {
+ console.error('[Apple Pay Express] Error initializing product page button:', error.message);
+ }
+ } else {
+ if (!wrapper.length && retryCount < maxRetries) {
+ setTimeout(() => this.initProductPageButton(retryCount + 1), 500);
+ } else if (!wrapper.length && retryCount >= maxRetries) {
+ console.warn('[Apple Pay Express] Product page button wrapper not found after ' + maxRetries + ' retries.');
+ }
+ }
+ },
+
+ initShopPageButtons: function() {
+ const self = this;
+
+ jQuery('[id^="cko-apple-pay-button-wrapper-"]').each(function() {
+ const $wrapper = jQuery(this);
+ const productId = $wrapper.data('product-id');
+
+ if (productId && $wrapper.attr('id') !== 'cko-apple-pay-button-wrapper' && typeof ApplePaySession !== 'undefined') {
+ if (!ApplePaySession.canMakePayments(cko_apple_pay_vars.merchant_id)) {
+ $wrapper.hide();
+ return;
+ }
+
+ try {
+ const button = document.createElement('apple-pay-button');
+ button.setAttribute('id', 'cko-apple-pay-button-' + productId);
+ button.setAttribute('type', 'plain');
+ button.setAttribute('buttonstyle', cko_apple_pay_vars.button_theme || 'black');
+ if (cko_apple_pay_vars.button_language) {
+ button.setAttribute('locale', cko_apple_pay_vars.button_language);
+ }
+ button.onclick = () => self.onApplePayButtonClick('shop', productId);
+
+ $wrapper.html('');
+ $wrapper.append(button);
+ $wrapper.show();
+ } catch (error) {
+ console.error('[Apple Pay Express] Error initializing shop page button for product ' + productId + ':', error.message);
+ }
+ }
+ });
+ },
+
+ initCartPageButton: function(retryCount) {
+ retryCount = retryCount || 0;
+ const maxRetries = 10;
+
+ const isBlocksCart = jQuery('.wc-block-cart').length > 0;
+ const isClassicCart = jQuery('.woocommerce-cart').length > 0 && !isBlocksCart;
+ const wrapperExists = jQuery('#cko-apple-pay-button-wrapper-cart').length > 0;
+
+ if (isBlocksCart && !wrapperExists) {
+ const paymentOptions = jQuery('.cko-express-checkout-buttons, .wc-block-cart__payment-options');
+ if (paymentOptions.length) {
+ if (!paymentOptions.find('#cko-apple-pay-button-wrapper-cart').length) {
+ paymentOptions.append('');
+ }
+ } else {
+ const proceedButton = jQuery('.wc-block-cart__submit, .wc-block-components-button--contained');
+ if (proceedButton.length) {
+ proceedButton.after('');
+ } else {
+ const cartTotals = jQuery('.wc-block-cart__totals');
+ if (cartTotals.length) {
+ cartTotals.before('');
+ } else {
+ const cartBlock = jQuery('.wc-block-cart');
+ if (cartBlock.length) {
+ cartBlock.append('');
+ }
+ }
+ }
+ }
+ } else if (isClassicCart && !wrapperExists) {
+ const proceedToCheckout = jQuery('.cko-express-checkout-buttons, .wc-proceed-to-checkout');
+ if (proceedToCheckout.length) {
+ proceedToCheckout.append('');
+ } else {
+ const cartTotals = jQuery('.cart_totals');
+ if (cartTotals.length) {
+ cartTotals.before('');
+ }
+ }
+ }
+
+ const wrapper = jQuery('#cko-apple-pay-button-wrapper-cart');
+ if (wrapper.length && typeof ApplePaySession !== 'undefined') {
+ if (!ApplePaySession.canMakePayments(cko_apple_pay_vars.merchant_id)) {
+ wrapper.hide();
+ return;
+ }
+
+ try {
+ const button = document.createElement('apple-pay-button');
+ button.setAttribute('id', 'cko-apple-pay-button-cart');
+ button.setAttribute('type', 'plain');
+ button.setAttribute('buttonstyle', cko_apple_pay_vars.button_theme || 'black');
+ if (cko_apple_pay_vars.button_language) {
+ button.setAttribute('locale', cko_apple_pay_vars.button_language);
+ }
+ button.onclick = () => this.onApplePayButtonClick('cart');
+
+ wrapper.html('');
+ wrapper.append(button);
+ wrapper.show();
+ } catch (error) {
+ console.error('[Apple Pay Express] Error initializing cart page button:', error.message);
+ }
+ } else {
+ if (!wrapper.length && retryCount < maxRetries) {
+ setTimeout(() => this.initCartPageButton(retryCount + 1), 500);
+ } else if (typeof ApplePaySession === 'undefined' && retryCount < maxRetries) {
+ setTimeout(() => this.initCartPageButton(retryCount + 1), 500);
+ }
+ }
+ },
+
+ onApplePayButtonClick: async function(context, productId) {
+ cko_apple_pay_vars.debug && console.log('[Apple Pay Express] Button clicked:', context, productId);
+
+ jQuery('body').addClass('apple-pay-processing');
+
+ let loadingContainer = '#cko-apple-pay-button-wrapper';
+ if (context === 'shop' && productId) {
+ loadingContainer = '#cko-apple-pay-button-wrapper-' + productId;
+ } else if (context === 'cart') {
+ loadingContainer = '#cko-apple-pay-button-wrapper-cart';
+ }
+
+ jQuery(loadingContainer).html('
Processing your payment...');
+
+ if (!jQuery('#apple-pay-spinner-css').length) {
+ jQuery('head').append('');
+ }
+
+ var timeoutFallback = setTimeout(function() {
+ jQuery('body').removeClass('apple-pay-processing');
+ jQuery(loadingContainer).html('');
+ showError('Payment processing is taking longer than expected. Please try again.');
+ }, 30000);
+
+ try {
+ let cartTotal = 0;
+ if (context === 'shop' && productId) {
+ let addToCartSuccess = await cko_express_add_to_cart_for_product(productId);
+ if (!addToCartSuccess || addToCartSuccess.result === 'error') {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('apple-pay-processing');
+ this.initShopPageButtons();
+ showError('Failed to add product to cart. Please try again.');
+ return;
+ }
+ cartTotal = parseFloat(addToCartSuccess.total || 0);
+ } else if (context === 'product') {
+ let addToCartSuccess = await cko_express_add_to_cart();
+ if (!addToCartSuccess || addToCartSuccess.result === 'error') {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('apple-pay-processing');
+ this.initProductPageButton();
+ showError('Failed to add product to cart. Please try again.');
+ return;
+ }
+ cartTotal = parseFloat(addToCartSuccess.total || 0);
+ } else {
+ cartTotal = await getCartTotalFromAPI();
+ if (cartTotal === 0 || isNaN(cartTotal)) {
+ cartTotal = await getCartTotalFromServer();
+ }
+ if (cartTotal === 0 || isNaN(cartTotal)) {
+ cartTotal = getCartTotal(context);
+ }
+ }
+
+ if (!cartTotal || cartTotal <= 0) {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('apple-pay-processing');
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+ console.error('[Apple Pay Express] Cart total is 0 or invalid:', cartTotal);
+ showError('Unable to calculate cart total. Please refresh the page and try again.');
+ return;
+ }
+
+ // Get cart items for display
+ let displayItems = await getCartItemsForDisplay();
+
+ // Get country code from customer data or default to store country
+ let countryCode = 'US';
+ if (typeof wc_customer_data !== 'undefined' && wc_customer_data.billing_country) {
+ countryCode = wc_customer_data.billing_country;
+ } else if (typeof wc_add_to_cart_params !== 'undefined' && wc_add_to_cart_params.base_location) {
+ countryCode = wc_add_to_cart_params.base_location;
+ }
+
+ // Get supported networks
+ let supportedNetworks = ['amex', 'masterCard', 'visa'];
+ if (cko_apple_pay_vars.enable_mada) {
+ supportedNetworks.push('mada');
+ countryCode = 'SA';
+ }
+
+ // Get merchant capabilities
+ let merchantCapabilities = ['supports3DS', 'supportsEMV', 'supportsCredit', 'supportsDebit'];
+ if (cko_apple_pay_vars.enable_mada) {
+ merchantCapabilities = merchantCapabilities.filter(cap => cap !== 'supportsEMV');
+ }
+
+ // Create Apple Pay payment request
+ const paymentRequest = {
+ countryCode: countryCode,
+ currencyCode: cko_apple_pay_vars.currency_code || 'USD',
+ supportedNetworks: supportedNetworks,
+ merchantCapabilities: merchantCapabilities,
+ total: {
+ label: window.location.host,
+ amount: cartTotal.toFixed(2),
+ type: 'final'
+ },
+ // REQUIRED: Request shipping contact fields (MANDATORY for express checkout)
+ requiredShippingContactFields: [
+ 'postalAddress',
+ 'name',
+ 'phone',
+ 'email'
+ ],
+ // REQUIRED: Request billing contact fields (for email and address)
+ requiredBillingContactFields: [
+ 'postalAddress',
+ 'name',
+ 'email'
+ ]
+ };
+
+ // Add line items if available
+ if (displayItems && displayItems.length > 0) {
+ paymentRequest.lineItems = displayItems.map(item => ({
+ label: item.label,
+ amount: item.price,
+ type: 'final'
+ }));
+ }
+
+ // Create Apple Pay session
+ const session = new ApplePaySession(3, paymentRequest);
+
+ // Handle merchant validation
+ session.onvalidatemerchant = (event) => {
+ performAppleUrlValidation(event.validationURL, (merchantSession) => {
+ if (merchantSession) {
+ session.completeMerchantValidation(merchantSession);
+ } else {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('apple-pay-processing');
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+ showError('Failed to validate merchant. Please try again.');
+ session.abort();
+ }
+ });
+ };
+
+ // Handle payment authorization
+ session.onpaymentauthorized = (event) => {
+ clearTimeout(timeoutFallback);
+
+ // Detect browser for debugging
+ const userAgent = navigator.userAgent || navigator.vendor || window.opera;
+ const isChrome = /Chrome/.test(userAgent) && /Google Inc/.test(navigator.vendor);
+ const isSafari = /^((?!chrome|android).)*safari/i.test(userAgent);
+ const browserName = isChrome ? 'Chrome' : (isSafari ? 'Safari' : 'Other');
+
+ // DEBUG: Log the full payment event to see what's available
+ if (cko_apple_pay_vars.debug) {
+ console.log('[Apple Pay Express] Browser:', browserName, userAgent);
+ console.log('[Apple Pay Express] Full payment event:', event);
+ console.log('[Apple Pay Express] event.payment:', event.payment);
+ console.log('[Apple Pay Express] event.payment.shippingContact:', event.payment.shippingContact);
+ console.log('[Apple Pay Express] event.payment.billingContact:', event.payment.billingContact);
+ console.log('[Apple Pay Express] event.payment.billingContact?.emailAddress:', event.payment.billingContact?.emailAddress);
+ console.log('[Apple Pay Express] event.payment.shippingContact?.emailAddress:', event.payment.shippingContact?.emailAddress);
+ }
+
+ // Generate Checkout.com token from Apple Pay token
+ generateCheckoutToken(event.payment.token.paymentData, (outcome) => {
+ if (outcome) {
+ // Store payment data for address extraction
+ // IMPORTANT: For guest users, email and address are MANDATORY from Apple Pay
+ // For logged-in users, email comes from account, but address from Apple Pay
+ // Collect email from billingContact first, fallback to shippingContact
+ const email = event.payment.billingContact?.emailAddress ||
+ event.payment.shippingContact?.emailAddress ||
+ '';
+
+ // Collect shipping contact (primary address source - MANDATORY)
+ // IMPORTANT: Apple Pay requires shipping contact for express checkout
+ // If shippingContact is not available, use billingContact as fallback
+ const shippingContact = event.payment.shippingContact || event.payment.billingContact;
+
+ // Collect billing contact if different from shipping
+ // If billingContact is not available, use shippingContact as fallback
+ const billingContact = event.payment.billingContact || event.payment.shippingContact;
+
+ // DEBUG: Log what we're collecting with browser info
+ if (cko_apple_pay_vars.debug) {
+ console.log('[Apple Pay Express] Browser:', browserName);
+ console.log('[Apple Pay Express] Collected email:', email);
+ console.log('[Apple Pay Express] Email source:', email ?
+ (event.payment.billingContact?.emailAddress ? 'billingContact' : 'shippingContact') : 'NONE');
+ console.log('[Apple Pay Express] Collected shippingContact:', shippingContact);
+ console.log('[Apple Pay Express] Collected billingContact:', billingContact);
+ }
+
+ // Validate that we have address data
+ if (!shippingContact && !billingContact) {
+ console.error('[Apple Pay Express] ERROR: No shipping or billing contact available!');
+ console.error('[Apple Pay Express] event.payment:', event.payment);
+ session.completePayment(ApplePaySession.STATUS_FAILURE);
+ showError('Address information is required but not provided by Apple Pay. Please try again.');
+ return;
+ }
+
+ // For guest users, email is mandatory - warn if missing (especially for Chrome)
+ // Note: We can't check if user is logged in from JavaScript, so we'll validate on server side
+ if (!email && browserName === 'Chrome') {
+ console.warn('[Apple Pay Express] WARNING: No email found in Apple Pay data for Chrome browser!');
+ console.warn('[Apple Pay Express] event.payment.billingContact:', event.payment.billingContact);
+ console.warn('[Apple Pay Express] event.payment.shippingContact:', event.payment.shippingContact);
+ console.warn('[Apple Pay Express] This may cause issues for guest users.');
+ }
+
+ const paymentData = {
+ email: email,
+ shippingContact: shippingContact,
+ billingContact: billingContact
+ };
+
+ if (cko_apple_pay_vars.debug) {
+ console.log('[Apple Pay Express] Browser:', browserName);
+ console.log('[Apple Pay Express] Payment data to send:', paymentData);
+ console.log('[Apple Pay Express] Email in paymentData:', paymentData.email);
+ console.log('[Apple Pay Express] Email source check:', {
+ 'billingContact.emailAddress': event.payment.billingContact?.emailAddress,
+ 'shippingContact.emailAddress': event.payment.shippingContact?.emailAddress,
+ 'final_email': email
+ });
+ }
+
+ // Process payment with token
+ this.processPayment(outcome, paymentData, loadingContainer, context, productId);
+
+ session.completePayment(ApplePaySession.STATUS_SUCCESS);
+ } else {
+ session.completePayment(ApplePaySession.STATUS_FAILURE);
+ jQuery('body').removeClass('apple-pay-processing');
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+ showError('Failed to generate payment token. Please try again.');
+ }
+ });
+ };
+
+ // Handle cancel
+ session.oncancel = () => {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('apple-pay-processing');
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+ };
+
+ // Begin Apple Pay session
+ session.begin();
+ } catch (error) {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('apple-pay-processing');
+
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+
+ showError('Payment failed: ' + (error.message || 'Unknown error. Please try again.'));
+ }
+ },
+
+ processPayment: async function(token, paymentData, loadingContainer, context, productId) {
+ try {
+ // Prepare payment data for backend
+ const postData = {
+ action: 'express_apple_pay_order_session',
+ 'cko-apple-card-token': token,
+ payment_data: JSON.stringify(paymentData),
+ woocommerce_process_checkout: cko_apple_pay_vars.woocommerce_process_checkout
+ };
+
+ const response = await jQuery.ajax({
+ url: cko_apple_pay_vars.apple_pay_order_session_url,
+ type: 'POST',
+ data: postData,
+ dataType: 'json'
+ });
+
+ if (response && response.success && response.data && response.data.redirect_url) {
+ window.location.href = response.data.redirect_url;
+ } else {
+ const errorMessage = response && response.data && response.data.messages
+ ? (Array.isArray(response.data.messages) ? response.data.messages.join(', ') : response.data.messages)
+ : 'Payment processing failed. Please try again.';
+
+ showError(errorMessage);
+ jQuery('body').removeClass('apple-pay-processing');
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+ }
+ } catch (error) {
+ console.error('[Apple Pay Express] Error processing payment:', error);
+ showError('Payment processing failed: ' + (error.message || 'Unknown error. Please try again.'));
+ jQuery('body').removeClass('apple-pay-processing');
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+ }
+ },
+
+ updateButtonVisibility: function() {
+ // Update button visibility based on form state
+ jQuery(document).on('change', formSelector, onFormChange);
+ },
+
+ };
+
+ // Initialize when DOM is ready
+ if (document.readyState === 'loading') {
+ document.addEventListener('DOMContentLoaded', function() {
+ applePayButton.init();
+ });
+ } else {
+ applePayButton.init();
+ }
+
+ // Re-initialize on cart updates
+ jQuery(document.body).on('updated_cart_totals', function() {
+ applePayButton.initCartPageButton();
+ });
+
+});
+
+
+
+
+
diff --git a/assets/js/cko-frames-integration.js b/checkout-com-unified-payments-api/assets/js/cko-frames-integration.js
similarity index 100%
rename from assets/js/cko-frames-integration.js
rename to checkout-com-unified-payments-api/assets/js/cko-frames-integration.js
diff --git a/checkout-com-unified-payments-api/assets/js/cko-google-pay-express-integration.js b/checkout-com-unified-payments-api/assets/js/cko-google-pay-express-integration.js
new file mode 100644
index 00000000..8d75523f
--- /dev/null
+++ b/checkout-com-unified-payments-api/assets/js/cko-google-pay-express-integration.js
@@ -0,0 +1,1215 @@
+/* global cko_google_pay_vars */
+
+jQuery( function ( $ ) {
+
+ const formSelector = 'form.cart';
+
+ const onFormChange = function ( e ) {
+ const form = document.querySelector( formSelector );
+
+ const addToCartButton = form ? form.querySelector('.single_add_to_cart_button') : null;
+
+ const isEnabled = ( null === addToCartButton ) || ! addToCartButton.classList.contains( 'disabled' );
+
+ const element = jQuery( cko_google_pay_vars.google_pay_button_selector );
+
+ if ( isEnabled ) {
+ jQuery(element)
+ .removeClass('cko-disabled')
+ .off('mouseup')
+ .find('> *')
+ .css('pointer-events', '');
+ } else {
+ jQuery(element)
+ .addClass('cko-disabled')
+ .on('mouseup', function(event) {
+ event.stopImmediatePropagation();
+ })
+ .find('> *')
+ .css('pointer-events', 'none');
+ }
+
+ };
+
+ const getAttributes = function() {
+ var select = $( '.variations_form' ).find( '.variations select' ),
+ data = {},
+ count = 0,
+ chosen = 0;
+
+ select.each( function() {
+ var attribute_name = $( this ).data( 'attribute_name' ) || $( this ).attr( 'name' );
+ var value = $( this ).val() || '';
+
+ if ( value.length > 0 ) {
+ chosen ++;
+ }
+
+ count ++;
+ data[ attribute_name ] = value;
+ });
+
+ return {
+ 'count' : count,
+ 'chosenCount': chosen,
+ 'data' : data
+ };
+ };
+
+ let showError = function ( error_message ) {
+
+ if ( 'string' === typeof error_message ) {
+ error_message = [ error_message ];
+ }
+
+ let ulWrapper = jQuery( '' ).html( value ) );
+ });
+ }
+
+ let wcNoticeDiv = jQuery( '
Processing your payment...
' )
+ .addClass( 'woocommerce-NoticeGroup woocommerce-NoticeGroup-checkout' )
+ .append( ulWrapper );
+
+ let scrollTarget;
+
+ if ( jQuery('form.checkout').length ) {
+ jQuery('form.checkout .woocommerce-NoticeGroup').remove();
+ jQuery('form.checkout').prepend(wcNoticeDiv);
+ jQuery('.woocommerce, .form.checkout').removeClass('processing').unblock();
+ scrollTarget = jQuery('form.checkout');
+ } else if ( jQuery('.woocommerce-order-pay').length ) {
+ jQuery('.woocommerce-order-pay .woocommerce-NoticeGroup').remove();
+ jQuery('.woocommerce-order-pay').prepend(wcNoticeDiv);
+ jQuery('.woocommerce, .woocommerce-order-pay').removeClass('processing').unblock();
+ scrollTarget = jQuery('.woocommerce-order-pay');
+ }
+
+ if ( scrollTarget ) {
+ jQuery('html, body').animate({
+ scrollTop: (scrollTarget.offset().top - 100)
+ }, 1000);
+ }
+ };
+
+ const cko_express_add_to_cart = async function () {
+ var product_id = $( '.single_add_to_cart_button' ).val();
+
+ // Check if product is a variable product.
+ if ( $( '.single_variation_wrap' ).length ) {
+ product_id = $( '.single_variation_wrap' ).find( 'input[name="product_id"]' ).val();
+ }
+
+ var data = {
+ product_id: product_id,
+ qty: $( '.quantity .qty' ).val(),
+ attributes: $( '.variations_form' ).length ? getAttributes().data : [],
+ nonce: cko_google_pay_vars.google_pay_express_add_to_cart_nonce
+ };
+
+ return await $.ajax( {
+ url: cko_google_pay_vars.add_to_cart_url,
+ type: 'POST',
+ async: false,
+ data: data
+ } ).done( function ( response ) {
+ cko_google_pay_vars.debug && console.log( response );
+ } ).fail( function ( xhr, status, error ) {
+ console.error('[Google Pay Express] Add to cart failed:', error);
+ cko_google_pay_vars.debug && console.error('[Google Pay Express] Response text:', xhr.responseText);
+ return { result: 'error', message: 'Failed to add product to cart' };
+ } )
+ }
+
+ const cko_express_add_to_cart_for_product = async function (productId) {
+ let data = {
+ product_id: productId,
+ quantity: 1,
+ nonce: cko_google_pay_vars.google_pay_express_add_to_cart_nonce
+ };
+
+ return await $.ajax( {
+ url: cko_google_pay_vars.add_to_cart_url,
+ type: 'POST',
+ async: false,
+ data: data
+ } ).done( function ( response ) {
+ cko_google_pay_vars.debug && console.log( 'Add to cart response for product ' + productId + ':', response );
+ } ).fail( function ( xhr, status, error ) {
+ console.error('[Google Pay Express] Add to cart failed for product ' + productId + ':', error);
+ cko_google_pay_vars.debug && console.error('[Google Pay Express] Response text:', xhr.responseText);
+ return { result: 'error', message: 'Failed to add product to cart' };
+ } )
+ };
+
+ const cko_express_create_payment_context_for_product = async function (productId) {
+ // Add product to cart first
+ let addToCartSuccess = await cko_express_add_to_cart_for_product(productId);
+
+ if (!addToCartSuccess || addToCartSuccess.result === 'error') {
+ console.error('[Google Pay Express] Add to cart failed for product:', productId);
+ showError('Failed to add product to cart. Please try again.');
+ return null;
+ }
+
+ let data = {
+ express_checkout: true,
+ add_to_cart: addToCartSuccess.result
+ }
+
+ return fetch( cko_google_pay_vars.create_payment_context_url, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/x-www-form-urlencoded'
+ },
+ body: jQuery.param( data )
+ }).then(function (res) {
+ if (!res.ok) {
+ throw new Error('Network response was not ok: ' + res.status);
+ }
+ return res.text().then(function(text) {
+ try {
+ return JSON.parse(text);
+ } catch (e) {
+ console.error('[Google Pay Express] Invalid JSON response:', e.message);
+ throw new Error('Invalid JSON response from server: ' + text.substring(0, 200));
+ }
+ });
+ }).then(function (data) {
+ if (typeof data.success !== 'undefined' && data.success === false) {
+ let messages = data.data && data.data.messages ? data.data.messages : data.data;
+ if ( 'string' === typeof messages || Array.isArray( messages ) ) {
+ showError( messages );
+ }
+ return null;
+ } else if (data.payment_context_id) {
+ return data.payment_context_id;
+ } else {
+ cko_google_pay_vars.debug && console.error('[Google Pay Express] Unexpected response format:', data);
+ showError('Unexpected response format from server');
+ return null;
+ }
+ }).catch(function(error) {
+ console.error('[Google Pay Express] Error in create_payment_context_for_product:', error.message);
+ showError('Failed to create payment context: ' + error.message);
+ return null;
+ });
+ };
+
+ const cko_express_create_payment_context_for_cart = async function () {
+ let data = {
+ express_checkout: true,
+ use_existing_cart: true
+ }
+
+ return fetch( cko_google_pay_vars.create_payment_context_url, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/x-www-form-urlencoded'
+ },
+ body: jQuery.param( data )
+ }).then(function (res) {
+ if (!res.ok) {
+ throw new Error('Network response was not ok: ' + res.status);
+ }
+ return res.text().then(function(text) {
+ try {
+ return JSON.parse(text);
+ } catch (e) {
+ console.error('[Google Pay Express] Invalid JSON response:', e.message);
+ throw new Error('Invalid JSON response from server: ' + text.substring(0, 200));
+ }
+ });
+ }).then(function (data) {
+ if (typeof data.success !== 'undefined' && data.success === false) {
+ let messages = data.data && data.data.messages ? data.data.messages : data.data;
+ if ( 'string' === typeof messages || Array.isArray( messages ) ) {
+ showError( messages );
+ }
+ return null;
+ } else if (data.payment_context_id) {
+ return data.payment_context_id;
+ } else {
+ cko_google_pay_vars.debug && console.error('[Google Pay Express] Unexpected response format:', data);
+ showError('Unexpected response format from server');
+ return null;
+ }
+ }).catch(function(error) {
+ console.error('[Google Pay Express] Error in create_payment_context_for_cart:', error.message);
+ showError('Failed to create payment context: ' + error.message);
+ return null;
+ });
+ };
+
+ const cko_express_create_payment_context = async function () {
+ let addToCartSuccess = await cko_express_add_to_cart()
+
+ // Check if add to cart was successful
+ if (!addToCartSuccess || addToCartSuccess.result === 'error') {
+ console.error('[Google Pay Express] Add to cart failed');
+ showError('Failed to add product to cart. Please try again.');
+ return null;
+ }
+
+ // Prepare add-to-cart for express checkout.
+ let data = {
+ express_checkout: true,
+ add_to_cart: addToCartSuccess.result
+ }
+
+ cko_google_pay_vars.debug && console.log( data );
+
+ // Get Payment Context ID from below endpoint.
+ return fetch( cko_google_pay_vars.create_payment_context_url, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/x-www-form-urlencoded'
+ },
+ body: jQuery.param( data )
+ }).then(function (res) {
+ // Check if response is ok
+ if (!res.ok) {
+ throw new Error('Network response was not ok: ' + res.status);
+ }
+
+ // Get response text first to handle malformed JSON
+ return res.text().then(function(text) {
+ try {
+ // Try to parse as JSON
+ return JSON.parse(text);
+ } catch (e) {
+ // If JSON parsing fails, log the raw response and throw error
+ console.error('[Google Pay Express] Invalid JSON response:', e.message);
+ throw new Error('Invalid JSON response from server: ' + text.substring(0, 200));
+ }
+ });
+ }).then(function (data) {
+ if (typeof data.success !== 'undefined' && data.success === false) {
+ let messages = data.data && data.data.messages ? data.data.messages : data.data;
+
+ if ( 'string' === typeof messages || Array.isArray( messages ) ) {
+ showError( messages );
+ }
+ return null;
+ } else if (data.payment_context_id) {
+ return data.payment_context_id;
+ } else {
+ cko_google_pay_vars.debug && console.error('[Google Pay Express] Unexpected response format:', data);
+ showError('Unexpected response format from server');
+ return null;
+ }
+ }).catch(function(error) {
+ console.error('[Google Pay Express] Error in create_payment_context:', error.message);
+ showError('Failed to create payment context: ' + error.message);
+ return null;
+ });
+ };
+
+ const googlePayButton = {
+ init: function () {
+ // Wait for Google Pay API to load
+ this.waitForGooglePayAPI();
+ },
+
+ waitForGooglePayAPI: function() {
+ const self = this;
+ const checkInterval = setInterval(function() {
+ if (typeof google !== 'undefined' && google.payments && google.payments.api) {
+ clearInterval(checkInterval);
+ // Wait a bit for DOM to be ready
+ setTimeout(function() {
+ self.initializeButtons();
+ }, 100);
+ }
+ }, 100);
+
+ // Timeout after 10 seconds
+ setTimeout(function() {
+ clearInterval(checkInterval);
+ if (typeof google === 'undefined' || !google.payments || !google.payments.api) {
+ cko_google_pay_vars.debug && console.warn('[Google Pay Express] Google Pay API not loaded after 10 seconds');
+ } else {
+ // If API is loaded but buttons weren't initialized, try now
+ setTimeout(function() {
+ self.initializeButtons();
+ }, 100);
+ }
+ }, 10000);
+ },
+
+ initializeButtons: function() {
+ // Initialize Google Pay express buttons for different contexts
+ // Only initialize buttons relevant to the current page
+ const isProductPage = jQuery('#cko-google-pay-button-wrapper').length > 0;
+ const isCartPageByWrapper = jQuery('#cko-google-pay-button-wrapper-cart').length > 0;
+ const isCartPageByClass = jQuery('.wc-block-cart, .woocommerce-cart').length > 0;
+ const isCartPage = isCartPageByWrapper || isCartPageByClass;
+ const isShopPage = jQuery('[id^="cko-google-pay-button-wrapper-"]').filter(function() {
+ return !jQuery(this).is('#cko-google-pay-button-wrapper-cart') && !jQuery(this).is('#cko-google-pay-button-wrapper');
+ }).length > 0;
+
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] Button initialization check:', {
+ isProductPage,
+ isCartPageByWrapper,
+ isCartPageByClass,
+ isCartPage,
+ isShopPage,
+ productWrapper: jQuery('#cko-google-pay-button-wrapper').length,
+ cartWrapper: jQuery('#cko-google-pay-button-wrapper-cart').length,
+ shopWrappers: jQuery('[id^="cko-google-pay-button-wrapper-"]').length,
+ cartPageClass: jQuery('.wc-block-cart, .woocommerce-cart').length
+ });
+ }
+
+ if (isProductPage) {
+ this.initProductPageButton();
+ }
+
+ if (isShopPage) {
+ this.initShopPageButtons();
+ }
+
+ if (isCartPage) {
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] Initializing cart page button');
+ this.initCartPageButton();
+ }
+
+ this.updateButtonVisibility();
+
+ jQuery(document).on('change', formSelector, onFormChange );
+ },
+
+ initProductPageButton: function(retryCount) {
+ retryCount = retryCount || 0;
+ const maxRetries = 5;
+
+ // Initialize button for single product page
+ const wrapper = jQuery('#cko-google-pay-button-wrapper');
+ if (wrapper.length && typeof google !== 'undefined' && google.payments && google.payments.api) {
+ try {
+ const paymentsClient = new google.payments.api.PaymentsClient({
+ environment: cko_google_pay_vars.environment || 'TEST'
+ });
+
+ const button = paymentsClient.createButton({
+ onClick: this.onGooglePayButtonClick.bind(this, 'product'),
+ buttonColor: cko_google_pay_vars.button_style === 'google-pay-white' ? 'white' : 'black',
+ buttonType: 'plain'
+ });
+
+ wrapper.html('');
+ wrapper.append(button);
+ wrapper.show();
+ } catch (error) {
+ console.error('[Google Pay Express] Error initializing product page button:', error.message);
+ }
+ } else {
+ // If wrapper doesn't exist or API not loaded, try again after a delay (with limit)
+ if (!wrapper.length && retryCount < maxRetries) {
+ setTimeout(() => this.initProductPageButton(retryCount + 1), 500);
+ } else if (!wrapper.length && retryCount >= maxRetries) {
+ console.warn('[Google Pay Express] Product page button wrapper not found after ' + maxRetries + ' retries. Make sure the product page setting is enabled.');
+ }
+ }
+ },
+
+ initShopPageButtons: function() {
+ // Initialize buttons for shop/listing pages
+ const self = this;
+
+ jQuery('[id^="cko-google-pay-button-wrapper-"]').each(function() {
+ const $wrapper = jQuery(this);
+ const productId = $wrapper.data('product-id');
+
+ if (productId && $wrapper.attr('id') !== 'cko-google-pay-button-wrapper' && typeof google !== 'undefined' && google.payments && google.payments.api) {
+ try {
+ const paymentsClient = new google.payments.api.PaymentsClient({
+ environment: cko_google_pay_vars.environment || 'TEST'
+ });
+
+ const button = paymentsClient.createButton({
+ onClick: self.onGooglePayButtonClick.bind(self, 'shop', productId),
+ buttonColor: cko_google_pay_vars.button_style === 'google-pay-white' ? 'white' : 'black',
+ buttonType: 'plain'
+ });
+
+ $wrapper.html('');
+ $wrapper.append(button);
+ $wrapper.show();
+ } catch (error) {
+ console.error('[Google Pay Express] Error initializing shop page button for product ' + productId + ':', error.message);
+ }
+ }
+ });
+ },
+
+ initCartPageButton: function(retryCount) {
+ retryCount = retryCount || 0;
+ const maxRetries = 10;
+
+ // Check if this is a Blocks cart page or classic cart
+ const isBlocksCart = jQuery('.wc-block-cart').length > 0;
+ const isClassicCart = jQuery('.woocommerce-cart').length > 0 && !isBlocksCart;
+ const wrapperExists = jQuery('#cko-google-pay-button-wrapper-cart').length > 0;
+
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] Cart page button initialization:', {
+ retryCount,
+ isBlocksCart,
+ isClassicCart,
+ wrapperExists,
+ googleApiLoaded: typeof google !== 'undefined' && google.payments && google.payments.api
+ });
+ }
+
+ // For Blocks cart, inject the button wrapper if it doesn't exist
+ if (isBlocksCart && !wrapperExists) {
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] Injecting button wrapper for Blocks cart');
+ const paymentOptions = jQuery('.wc-block-cart__payment-options');
+ if (paymentOptions.length) {
+ // Check if button wrapper already exists in payment options
+ if (!paymentOptions.find('#cko-google-pay-button-wrapper-cart').length) {
+ // Append instead of replacing to preserve PayPal button
+ paymentOptions.append('');
+ }
+ } else {
+ // Fallback: inject after proceed to checkout button
+ const proceedButton = jQuery('.wc-block-cart__submit, .wc-block-components-button--contained');
+ if (proceedButton.length) {
+ proceedButton.after('');
+ } else {
+ // Another fallback: inject before cart totals
+ const cartTotals = jQuery('.wc-block-cart__totals');
+ if (cartTotals.length) {
+ cartTotals.before('');
+ } else {
+ // Last fallback: inject at the end of cart block
+ const cartBlock = jQuery('.wc-block-cart');
+ if (cartBlock.length) {
+ cartBlock.append('');
+ }
+ }
+ }
+ }
+ } else if (isClassicCart && !wrapperExists) {
+ // For classic cart, try to inject if wrapper doesn't exist
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] Injecting button wrapper for classic cart');
+ const proceedToCheckout = jQuery('.wc-proceed-to-checkout');
+ if (proceedToCheckout.length) {
+ proceedToCheckout.before('');
+ } else {
+ // Fallback: inject before cart totals
+ const cartTotals = jQuery('.cart_totals');
+ if (cartTotals.length) {
+ cartTotals.before('');
+ }
+ }
+ }
+
+ // Initialize button for cart page
+ const wrapper = jQuery('#cko-google-pay-button-wrapper-cart');
+ if (wrapper.length && typeof google !== 'undefined' && google.payments && google.payments.api) {
+ try {
+ const paymentsClient = new google.payments.api.PaymentsClient({
+ environment: cko_google_pay_vars.environment || 'TEST'
+ });
+
+ const button = paymentsClient.createButton({
+ onClick: this.onGooglePayButtonClick.bind(this, 'cart'),
+ buttonColor: cko_google_pay_vars.button_style === 'google-pay-white' ? 'white' : 'black',
+ buttonType: 'plain'
+ });
+
+ wrapper.html('');
+ wrapper.append(button);
+ wrapper.show();
+
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] Cart page button initialized successfully');
+ } catch (error) {
+ console.error('[Google Pay Express] Error initializing cart page button:', error.message);
+ }
+ } else {
+ // If wrapper doesn't exist or API not loaded, try again after a delay (with limit)
+ if (!wrapper.length && retryCount < maxRetries) {
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] Wrapper not found, retrying...', retryCount + 1);
+ setTimeout(() => this.initCartPageButton(retryCount + 1), 500);
+ } else if (!wrapper.length && retryCount >= maxRetries) {
+ console.warn('[Google Pay Express] Cart page button wrapper not found after ' + maxRetries + ' retries. Make sure the cart page setting is enabled.');
+ } else if (typeof google === 'undefined' || !google.payments || !google.payments.api) {
+ if (retryCount < maxRetries) {
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] Google Pay API not loaded, retrying...', retryCount + 1);
+ setTimeout(() => this.initCartPageButton(retryCount + 1), 500);
+ } else {
+ console.warn('[Google Pay Express] Google Pay API not loaded after ' + maxRetries + ' retries.');
+ }
+ }
+ }
+ },
+
+ onGooglePayButtonClick: async function(context, productId) {
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] Button clicked:', context, productId);
+
+ // Show loading state
+ jQuery('body').addClass('google-pay-processing');
+
+ let loadingContainer = '#cko-google-pay-button-wrapper';
+ if (context === 'shop' && productId) {
+ loadingContainer = '#cko-google-pay-button-wrapper-' + productId;
+ } else if (context === 'cart') {
+ loadingContainer = '#cko-google-pay-button-wrapper-cart';
+ }
+
+ jQuery(loadingContainer).html('
Processing your payment...');
+
+ // Add CSS for spinner animation
+ if (!jQuery('#google-pay-spinner-css').length) {
+ jQuery('head').append('');
+ }
+
+ // Set a timeout fallback in case the API call takes too long (30 seconds)
+ var timeoutFallback = setTimeout(function() {
+ jQuery('body').removeClass('google-pay-processing');
+ jQuery(loadingContainer).html('');
+ showError('Payment processing is taking longer than expected. Please try again.');
+ }, 30000);
+
+ try {
+ // For Google Pay Express, we don't need payment contexts - process payment directly
+ // But we still need to add product to cart if on product/shop page
+ let cartTotal = 0;
+ if (context === 'shop' && productId) {
+ let addToCartSuccess = await cko_express_add_to_cart_for_product(productId);
+ if (!addToCartSuccess || addToCartSuccess.result === 'error') {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('google-pay-processing');
+ // Re-initialize the button after error
+ if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ } else {
+ jQuery(loadingContainer).html('');
+ }
+ showError('Failed to add product to cart. Please try again.');
+ return;
+ }
+ // Get cart total from add to cart response
+ cartTotal = parseFloat(addToCartSuccess.total || 0);
+ } else if (context === 'product') {
+ // For product page, use the form-based add to cart function
+ let addToCartSuccess = await cko_express_add_to_cart();
+ if (!addToCartSuccess || addToCartSuccess.result === 'error') {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('google-pay-processing');
+ // Re-initialize the button after error
+ this.initProductPageButton();
+ showError('Failed to add product to cart. Please try again.');
+ return;
+ }
+ // Get cart total from add to cart response
+ cartTotal = parseFloat(addToCartSuccess.total || 0);
+ } else {
+ // For cart page, try multiple methods to get cart total
+ // First try the dedicated API endpoint (most reliable)
+ cartTotal = await this.getCartTotalFromAPI();
+
+ // If API doesn't work, try server fragments
+ if (cartTotal === 0 || isNaN(cartTotal)) {
+ cartTotal = await this.getCartTotalFromServer();
+ }
+
+ // If still 0, try DOM
+ if (cartTotal === 0 || isNaN(cartTotal)) {
+ cartTotal = this.getCartTotal(context);
+ }
+
+ // Final fallback: try API again
+ if (cartTotal === 0 || isNaN(cartTotal)) {
+ cartTotal = await this.getCartTotalFromAPI();
+ }
+ }
+
+ // If cart total is still 0, try one more time from DOM as final fallback
+ if (cartTotal === 0) {
+ cartTotal = this.getCartTotal(context);
+ }
+
+ // If cart total is still 0, try to get it from server one more time
+ if (cartTotal === 0) {
+ cartTotal = await this.getCartTotalFromServer();
+ }
+
+ // Final validation - ensure we have a valid cart total
+ if (!cartTotal || cartTotal <= 0) {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('google-pay-processing');
+ // Re-initialize the button after error
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+ console.error('[Google Pay Express] Cart total is 0 or invalid:', cartTotal);
+ showError('Unable to calculate cart total. Please refresh the page and try again.');
+ return;
+ }
+
+ // Now create payment data request
+ const paymentsClient = new google.payments.api.PaymentsClient({
+ environment: cko_google_pay_vars.environment || 'TEST'
+ });
+
+ // Get cart items for display
+ let displayItems = await this.getCartItemsForDisplay();
+
+ // Ensure displayItems is an array (fallback if empty)
+ if (!Array.isArray(displayItems) || displayItems.length === 0) {
+ // Fallback: create a single item with cart total
+ displayItems = [{
+ label: 'Order Total',
+ type: 'LINE_ITEM',
+ price: cartTotal.toFixed(2),
+ quantity: '1'
+ }];
+ }
+
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] Payment data request:', {
+ cartTotal,
+ displayItemsCount: displayItems.length,
+ totalPrice: cartTotal.toFixed(2)
+ });
+ }
+
+ // Validate required configuration
+ if (!cko_google_pay_vars.public_key || !cko_google_pay_vars.public_key.trim()) {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('google-pay-processing');
+ // Re-initialize the button after error
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else {
+ jQuery(loadingContainer).html('');
+ }
+ console.error('[Google Pay Express] Public key is missing or empty');
+ showError('Payment configuration error: Public key is missing. Please contact support.');
+ return;
+ }
+
+ if (!cko_google_pay_vars.merchant_id || !cko_google_pay_vars.merchant_id.trim()) {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('google-pay-processing');
+ // Re-initialize the button after error
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else {
+ jQuery(loadingContainer).html('');
+ }
+ console.error('[Google Pay Express] Merchant ID is missing or empty');
+ showError('Payment configuration error: Merchant ID is missing. Please contact support.');
+ return;
+ }
+
+ // Use API v1 structure (same as classic Google Pay) to match working configuration
+ // This ensures compatibility with Google Pay merchant configuration
+ const paymentDataRequest = {
+ merchantId: cko_google_pay_vars.merchant_id.trim(),
+ paymentMethodTokenizationParameters: {
+ tokenizationType: 'PAYMENT_GATEWAY',
+ parameters: {
+ 'gateway': 'checkoutltd',
+ 'gatewayMerchantId': cko_google_pay_vars.public_key.trim()
+ }
+ },
+ allowedPaymentMethods: ['CARD', 'TOKENIZED_CARD'],
+ cardRequirements: {
+ allowedCardNetworks: ['AMEX', 'DISCOVER', 'JCB', 'MASTERCARD', 'VISA'],
+ // Request ECv2 by specifying allowedCardAuthMethods (CRYPTOGRAM_3DS is ECv2, PAN_ONLY may be ECv1)
+ allowedCardAuthMethods: ['CRYPTOGRAM_3DS']
+ },
+ transactionInfo: {
+ currencyCode: cko_google_pay_vars.currency_code || 'USD',
+ totalPriceStatus: 'FINAL',
+ totalPrice: cartTotal.toFixed(2),
+ totalPriceLabel: 'Total'
+ },
+ // Add display items for breakdown in popup (API v1 supports this)
+ displayItems: displayItems,
+ // Request shipping address and email (API v1 supports these)
+ shippingAddressRequired: true,
+ emailRequired: true,
+ shippingAddressParameters: {
+ phoneNumberRequired: false
+ }
+ };
+
+ // Load payment data
+ try {
+ let paymentData = await paymentsClient.loadPaymentData(paymentDataRequest);
+
+ // Clear the timeout since we got payment data
+ clearTimeout(timeoutFallback);
+
+ // IMPORTANT: Extract token data directly from paymentData, matching classic Google Pay
+ // Classic Google Pay does: JSON.parse(paymentData.paymentMethodToken.token).signedMessage
+ // We need to extract the token data and ensure it's in the same format
+ let tokenData = null;
+ if (paymentData.paymentMethodToken && paymentData.paymentMethodToken.token) {
+ // Parse the token JSON string to extract the token data (same as classic)
+ tokenData = JSON.parse(paymentData.paymentMethodToken.token);
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] Token data extracted - protocolVersion:', tokenData.protocolVersion);
+
+ // Create a modified payment data object with the token data properly formatted
+ // This ensures the signedMessage is in the exact same format as classic Google Pay
+ // Note: We use a new variable to avoid reassigning const
+ paymentData = {
+ cardInfo: paymentData.cardInfo,
+ email: paymentData.email,
+ shippingAddress: paymentData.shippingAddress,
+ // Keep the token as a JSON string (matching classic format)
+ paymentMethodToken: {
+ token: paymentData.paymentMethodToken.token, // Keep original token string
+ tokenizationType: paymentData.paymentMethodToken.tokenizationType
+ }
+ };
+ }
+
+ // Process the payment (no payment context needed for Google Pay)
+ await this.processPayment(paymentData, null, loadingContainer);
+ } catch (loadError) {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('google-pay-processing');
+
+ // Re-initialize the button after error/cancel
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ this.initShopPageButtons();
+ }
+
+ if (loadError.statusCode === 'CANCELED') {
+ return; // User canceled, don't show error
+ } else {
+ showError('Payment failed: ' + (loadError.message || 'Unknown error. Please try again.'));
+ }
+ return;
+ }
+
+ } catch (error) {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('google-pay-processing');
+
+ // Re-initialize the button after error
+ if (context === 'product') {
+ this.initProductPageButton();
+ } else if (context === 'cart') {
+ this.initCartPageButton();
+ } else if (context === 'shop' && productId) {
+ // For shop page, button will be re-initialized on next page load
+ jQuery(loadingContainer).html('');
+ }
+
+ if (error.statusCode !== 'CANCELED') {
+ showError('Payment failed: ' + (error.message || 'Unknown error. Please try again.'));
+ }
+ }
+ },
+
+ getCartTotalFromAPI: async function() {
+ // Get cart total directly from WooCommerce API endpoint
+ // This works for both classic and Blocks cart pages
+ try {
+ if (!cko_google_pay_vars.get_cart_total_url) {
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] get_cart_total_url not available');
+ }
+ return 0;
+ }
+
+ const response = await jQuery.ajax({
+ url: cko_google_pay_vars.get_cart_total_url,
+ type: 'GET',
+ dataType: 'json'
+ });
+
+ if (response && response.success && response.data && response.data.total) {
+ const total = parseFloat(response.data.total) || 0;
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] Cart total from API (Blocks/Classic):', total, response.data);
+ }
+ if (total > 0) {
+ return total;
+ }
+ } else if (response && response.success === false) {
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] API returned error:', response.data);
+ }
+ }
+
+ return 0;
+ } catch (error) {
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] API call failed:', error);
+ }
+ return 0;
+ }
+ },
+
+ getCartTotalFromServer: async function() {
+ // Get cart total from WooCommerce cart fragment
+ try {
+ // Build AJAX URL - try multiple methods
+ let ajaxUrl = window.location.href;
+
+ // Try to get WooCommerce AJAX URL from various sources
+ if (typeof wc_add_to_cart_params !== 'undefined' && wc_add_to_cart_params.wc_ajax_url) {
+ ajaxUrl = wc_add_to_cart_params.wc_ajax_url.toString().replace('%%endpoint%%', 'get_refreshed_fragments');
+ } else if (typeof wc_cart_fragments_params !== 'undefined' && wc_cart_fragments_params.wc_ajax_url) {
+ ajaxUrl = wc_cart_fragments_params.wc_ajax_url.toString().replace('%%endpoint%%', 'get_refreshed_fragments');
+ } else {
+ // Fallback: construct URL manually
+ ajaxUrl = window.location.origin + '/?wc-ajax=get_refreshed_fragments';
+ }
+
+ const response = await jQuery.ajax({
+ url: ajaxUrl,
+ type: 'POST',
+ data: {
+ 'wc-ajax': 'get_refreshed_fragments'
+ }
+ });
+
+ if (response && response.fragments) {
+ // Try to extract total from cart fragments (classic cart)
+ let cartTotalMatch = response.fragments['div.cart_totals']?.match(/total[^>]*>[\s\S]*?(\d+[.,]\d+)/i);
+ if (cartTotalMatch) {
+ const total = parseFloat(cartTotalMatch[1].replace(',', '.')) || 0;
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] Cart total from fragments (classic):', total);
+ }
+ if (total > 0) return total;
+ }
+
+ // Try Blocks cart fragments
+ const fragmentKeys = Object.keys(response.fragments);
+ for (let key of fragmentKeys) {
+ const fragment = response.fragments[key];
+ if (fragment && typeof fragment === 'string') {
+ // Look for total in Blocks cart format
+ const blocksTotalMatch = fragment.match(/wc-block-components-totals__total-value[^>]*>[\s\S]*?(\d+[.,]\d+)/i) ||
+ fragment.match(/wc-block-components-totals__item-value[^>]*>[\s\S]*?(\d+[.,]\d+)/i);
+ if (blocksTotalMatch) {
+ const total = parseFloat(blocksTotalMatch[1].replace(',', '.')) || 0;
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] Cart total from fragments (Blocks):', total);
+ }
+ if (total > 0) return total;
+ }
+ }
+ }
+ }
+
+ // Fallback: try to get from cart total element in DOM (both classic and Blocks)
+ const cartTotalElement = jQuery('.cart_totals .order-total .woocommerce-Price-amount, .wc-block-cart__totals .wc-block-components-totals__total-value, .wc-block-cart__totals .wc-block-components-totals__item-value');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ const total = parseFloat(totalText.replace(',', '.')) || 0;
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] Cart total from DOM fallback:', total);
+ }
+ return total;
+ }
+
+ return 0;
+ } catch (error) {
+ // If AJAX fails, try DOM fallback
+ cko_google_pay_vars.debug && console.log('[Google Pay Express] AJAX failed, using DOM fallback:', error);
+ const cartTotalElement = jQuery('.cart_totals .order-total .woocommerce-Price-amount, .wc-block-cart__totals .wc-block-components-totals__total-value, .wc-block-cart__totals .wc-block-components-totals__item-value');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ const total = parseFloat(totalText.replace(',', '.')) || 0;
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] Cart total from DOM error fallback:', total);
+ }
+ return total;
+ }
+ return 0;
+ }
+ },
+
+ getCartTotal: function(context) {
+ // Get cart total from page or cart (fallback method)
+ let total = '0.00';
+
+ if (context === 'cart') {
+ // Try multiple selectors for different cart page types
+ // Blocks cart page
+ let cartTotalElement = jQuery('.wc-block-cart__totals .wc-block-components-totals__item-value, .wc-block-cart__totals .wc-block-components-totals__total-value');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ total = totalText.replace(',', '.');
+ } else {
+ // Classic cart page
+ cartTotalElement = jQuery('.cart_totals .order-total .woocommerce-Price-amount, .cart_totals .woocommerce-Price-amount, .cart_totals .order-total td .amount');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ total = totalText.replace(',', '.');
+ } else {
+ // Another fallback for Blocks cart
+ cartTotalElement = jQuery('.wc-block-cart__totals .amount, .wc-block-cart__totals .woocommerce-Price-amount');
+ if (cartTotalElement.length) {
+ const totalText = cartTotalElement.last().text().replace(/[^\d.,]/g, '');
+ total = totalText.replace(',', '.');
+ }
+ }
+ }
+
+ if (cko_google_pay_vars.debug) {
+ console.log('[Google Pay Express] getCartTotal for cart:', {
+ total,
+ foundElements: cartTotalElement.length,
+ elementText: cartTotalElement.length ? cartTotalElement.last().text() : 'none'
+ });
+ }
+ } else {
+ // Get product price
+ const priceElement = jQuery('.price .amount, .price .woocommerce-Price-amount, .woocommerce-Price-amount');
+ if (priceElement.length) {
+ const priceText = priceElement.first().text().replace(/[^\d.,]/g, '');
+ total = priceText.replace(',', '.');
+ }
+ }
+
+ return parseFloat(total) || 0.00;
+ },
+
+ getCartItemsForDisplay: async function() {
+ // Get cart items for Google Pay display
+ const items = [];
+
+ try {
+ // Try to get cart items from DOM first (most reliable)
+ let hasItems = false;
+ jQuery('.cart .cart_item, .woocommerce-cart .cart_item').each(function() {
+ const $item = jQuery(this);
+ const productName = $item.find('.product-name a, .product-name').text().trim() || 'Product';
+ const quantity = parseInt($item.find('.product-quantity input, .quantity input').val() || $item.find('.product-quantity').text().match(/\d+/)?.[0] || '1');
+ const priceText = $item.find('.product-price .amount, .product-price .woocommerce-Price-amount').text().replace(/[^\d.,]/g, '');
+ const price = parseFloat(priceText.replace(',', '.')) || 0;
+
+ if (productName && price > 0 && productName !== 'Product') {
+ items.push({
+ label: productName,
+ type: 'LINE_ITEM',
+ price: price.toFixed(2),
+ quantity: quantity.toString()
+ });
+ hasItems = true;
+ }
+ });
+
+ // If no items found in DOM, create a default item with cart total
+ if (!hasItems || items.length === 0) {
+ // Try DOM first for cart total
+ let cartTotal = this.getCartTotal('cart');
+ if (cartTotal === 0) {
+ // Only try server if DOM fails
+ try {
+ cartTotal = await this.getCartTotalFromServer();
+ } catch (e) {
+ // Ignore error, use 0
+ }
+ }
+
+ if (cartTotal > 0) {
+ items.push({
+ label: 'Order Total',
+ type: 'LINE_ITEM',
+ price: cartTotal.toFixed(2),
+ quantity: '1'
+ });
+ }
+ }
+ } catch (error) {
+ cko_google_pay_vars.debug && console.error('[Google Pay Express] Error getting cart items:', error);
+ // Fallback: create a single item with cart total from DOM
+ const cartTotal = this.getCartTotal('cart');
+ if (cartTotal > 0) {
+ items.push({
+ label: 'Order Total',
+ type: 'LINE_ITEM',
+ price: cartTotal.toFixed(2),
+ quantity: '1'
+ });
+ }
+ }
+
+ return items;
+ },
+
+ processPayment: async function(paymentData, paymentContextId, loadingContainer) {
+ try {
+ // IMPORTANT: Use the exact same flow as classic Google Pay
+ // Classic Google Pay does:
+ // 1. JSON.parse(paymentData.paymentMethodToken.token).signature
+ // 2. JSON.parse(paymentData.paymentMethodToken.token).protocolVersion
+ // 3. JSON.parse(paymentData.paymentMethodToken.token).signedMessage
+ // 4. Sets form fields and submits form (which calls process_payment)
+ //
+ // For express, we do the same extraction but call process_payment directly via AJAX
+
+ // Extract token data exactly like classic Google Pay
+ let signature = '';
+ let protocolVersion = '';
+ let signedMessage = '';
+
+ if (paymentData.paymentMethodToken && paymentData.paymentMethodToken.token) {
+ // Parse the token JSON string exactly like classic does
+ const tokenData = JSON.parse(paymentData.paymentMethodToken.token);
+ signature = tokenData.signature;
+ protocolVersion = tokenData.protocolVersion;
+ signedMessage = tokenData.signedMessage;
+ }
+
+ // Extract email and address from payment data
+ const email = paymentData.email || '';
+ const shippingAddress = paymentData.shippingAddress || null;
+
+ // Create order first (like express does)
+ // Then call process_payment with the same data format as classic
+ const response = await jQuery.post(
+ cko_google_pay_vars.google_pay_order_session_url +
+ "&woocommerce-process-checkout-nonce=" + cko_google_pay_vars.woocommerce_process_checkout,
+ {
+ // Send token fields exactly like classic Google Pay form fields
+ 'cko-google-signature': signature,
+ 'cko-google-protocolVersion': protocolVersion,
+ 'cko-google-signedMessage': signedMessage,
+ // Also send payment data for email/address extraction
+ payment_data: JSON.stringify({
+ email: email,
+ shippingAddress: shippingAddress
+ })
+ }
+ );
+
+ // Check if response indicates error (WordPress wp_send_json_error format)
+ // wp_send_json_error returns: { success: false, data: { messages: '...' } }
+ if (response.success === false || (response.success !== true && response.data)) {
+ // Hide loading state on error
+ jQuery('body').removeClass('google-pay-processing');
+
+ // Re-initialize the button after error
+ // We need to determine context from loadingContainer
+ if (loadingContainer === '#cko-google-pay-button-wrapper') {
+ this.initProductPageButton();
+ } else if (loadingContainer === '#cko-google-pay-button-wrapper-cart') {
+ this.initCartPageButton();
+ } else {
+ jQuery(loadingContainer).html('');
+ }
+
+ // Extract error message from response
+ var messages = '';
+ if (response.data && response.data.messages) {
+ messages = response.data.messages;
+ } else if (response.data && typeof response.data === 'string') {
+ messages = response.data;
+ } else if (response.message) {
+ messages = response.message;
+ } else if (typeof response === 'string') {
+ messages = response;
+ } else {
+ messages = 'Google Pay returned ECv1 protocol which is not supported. Please try again or use a different payment method.';
+ }
+
+ // Always show error message
+ if (typeof messages === 'string') {
+ showError(messages);
+ } else if (Array.isArray(messages)) {
+ showError(messages);
+ } else {
+ showError('Google Pay returned ECv1 protocol which is not supported. Please try again or use a different payment method.');
+ }
+ return;
+ }
+
+ // Check if response indicates success (WordPress wp_send_json_success format)
+ // wp_send_json_success returns: { success: true, data: { redirect_url: '...' } }
+ if (response.success === true && response.data && response.data.redirect_url) {
+ // Redirect to success page
+ window.location.href = response.data.redirect_url;
+ } else {
+ // Unexpected response - re-initialize button
+ jQuery('body').removeClass('google-pay-processing');
+ if (loadingContainer === '#cko-google-pay-button-wrapper') {
+ this.initProductPageButton();
+ } else if (loadingContainer === '#cko-google-pay-button-wrapper-cart') {
+ this.initCartPageButton();
+ } else {
+ jQuery(loadingContainer).html('');
+ }
+ showError('Payment processing failed. Please try again.');
+ }
+ } catch (error) {
+ // Hide loading state on error
+ jQuery('body').removeClass('google-pay-processing');
+
+ // Re-initialize the button after error
+ if (loadingContainer === '#cko-google-pay-button-wrapper') {
+ this.initProductPageButton();
+ } else if (loadingContainer === '#cko-google-pay-button-wrapper-cart') {
+ this.initCartPageButton();
+ } else {
+ jQuery(loadingContainer).html('');
+ }
+
+ showError('Payment processing failed. Please try again.');
+ }
+ },
+
+ updateButtonVisibility: function () {
+ // Show product page button
+ if ( jQuery( cko_google_pay_vars.google_pay_button_selector ) ) {
+ jQuery( cko_google_pay_vars.google_pay_button_selector ).show();
+ }
+
+ // Show shop page buttons
+ jQuery('[id^="cko-google-pay-button-wrapper-"]').each(function() {
+ if (jQuery(this).attr('id') !== 'cko-google-pay-button-wrapper') {
+ jQuery(this).show();
+ }
+ });
+
+ // Show cart page button
+ if ( jQuery('#cko-google-pay-button-wrapper-cart') ) {
+ jQuery('#cko-google-pay-button-wrapper-cart').show();
+ }
+ }
+ }
+
+ // Initialize on document ready
+ googlePayButton.init();
+
+ // Also try to initialize after a short delay to catch cases where DOM isn't ready yet
+ setTimeout(function() {
+ if (typeof google !== 'undefined' && google.payments && google.payments.api) {
+ googlePayButton.initializeButtons();
+ }
+ }, 1000);
+
+ // Re-initialize buttons when cart is updated (for cart page)
+ jQuery(document.body).on('updated_cart_totals', function() {
+ if (typeof google !== 'undefined' && google.payments && google.payments.api) {
+ googlePayButton.initializeButtons();
+ }
+ });
+});
+
diff --git a/assets/js/cko-google-pay-integration.js b/checkout-com-unified-payments-api/assets/js/cko-google-pay-integration.js
similarity index 100%
rename from assets/js/cko-google-pay-integration.js
rename to checkout-com-unified-payments-api/assets/js/cko-google-pay-integration.js
diff --git a/checkout-com-unified-payments-api/assets/js/cko-paypal-express-integration.js b/checkout-com-unified-payments-api/assets/js/cko-paypal-express-integration.js
new file mode 100644
index 00000000..b65eb4c7
--- /dev/null
+++ b/checkout-com-unified-payments-api/assets/js/cko-paypal-express-integration.js
@@ -0,0 +1,653 @@
+/* global cko_paypal_vars */
+
+// Ensure cko_paypal_vars is available before proceeding
+if ( typeof cko_paypal_vars === 'undefined' ) {
+ console.error( '[PayPal Express] cko_paypal_vars is not defined. Make sure the script is properly enqueued and localized.' );
+}
+
+jQuery( function ( $ ) {
+
+ // Double-check cko_paypal_vars is available
+ if ( typeof cko_paypal_vars === 'undefined' ) {
+ console.error( '[PayPal Express] cko_paypal_vars is still undefined after jQuery ready. Script may not be properly loaded.' );
+ return;
+ }
+
+ const formSelector = 'form.cart';
+
+ const onFormChange = function ( e ) {
+ const form = document.querySelector( formSelector );
+
+ const addToCartButton = form ? form.querySelector('.single_add_to_cart_button') : null;
+
+ const isEnabled = ( null === addToCartButton ) || ! addToCartButton.classList.contains( 'disabled' );
+
+ const element = jQuery( cko_paypal_vars.paypal_button_selector );
+
+ if ( isEnabled ) {
+ jQuery(element)
+ .removeClass('cko-disabled')
+ .off('mouseup')
+ .find('> *')
+ .css('pointer-events', '');
+ } else {
+ jQuery(element)
+ .addClass('cko-disabled')
+ .on('mouseup', function(event) {
+ event.stopImmediatePropagation();
+ })
+ .find('> *')
+ .css('pointer-events', 'none');
+ }
+
+ };
+
+ const getAttributes = function() {
+ var select = $( '.variations_form' ).find( '.variations select' ),
+ data = {},
+ count = 0,
+ chosen = 0;
+
+ select.each( function() {
+ var attribute_name = $( this ).data( 'attribute_name' ) || $( this ).attr( 'name' );
+ var value = $( this ).val() || '';
+
+ if ( value.length > 0 ) {
+ chosen ++;
+ }
+
+ count ++;
+ data[ attribute_name ] = value;
+ });
+
+ return {
+ 'count' : count,
+ 'chosenCount': chosen,
+ 'data' : data
+ };
+ };
+
+ let showError = function ( error_message ) {
+
+ if ( 'string' === typeof error_message ) {
+ error_message = [ error_message ];
+ }
+
+ let ulWrapper = jQuery( '' ).html( value ) );
+ });
+ }
+
+ let wcNoticeDiv = jQuery( '
Processing your payment...
' )
+ .addClass( 'woocommerce-NoticeGroup woocommerce-NoticeGroup-checkout' )
+ .append( ulWrapper );
+
+ let scrollTarget;
+
+ if ( jQuery('form.checkout').length ) {
+ jQuery('form.checkout .woocommerce-NoticeGroup').remove();
+ jQuery('form.checkout').prepend(wcNoticeDiv);
+ jQuery('.woocommerce, .form.checkout').removeClass('processing').unblock();
+ scrollTarget = jQuery('form.checkout');
+ } else if ( jQuery('.woocommerce-order-pay').length ) {
+ jQuery('.woocommerce-order-pay .woocommerce-NoticeGroup').remove();
+ jQuery('.woocommerce-order-pay').prepend(wcNoticeDiv);
+ jQuery('.woocommerce, .woocommerce-order-pay').removeClass('processing').unblock();
+ scrollTarget = jQuery('.woocommerce-order-pay');
+ }
+
+ if ( scrollTarget ) {
+ jQuery('html, body').animate({
+ scrollTop: (scrollTarget.offset().top - 100)
+ }, 1000);
+ }
+ };
+
+ const cko_express_add_to_cart = async function () {
+ var product_id = $( '.single_add_to_cart_button' ).val();
+
+ // Check if product is a variable product.
+ if ( $( '.single_variation_wrap' ).length ) {
+ product_id = $( '.single_variation_wrap' ).find( 'input[name="product_id"]' ).val();
+ }
+
+ var data = {
+ product_id: product_id,
+ qty: $( '.quantity .qty' ).val(),
+ attributes: $( '.variations_form' ).length ? getAttributes().data : [],
+ nonce: cko_paypal_vars.paypal_express_add_to_cart_nonce
+ };
+
+ return await $.ajax( {
+ url: cko_paypal_vars.add_to_cart_url,
+ type: 'POST',
+ async: false,
+ data: data
+ } ).done( function ( response ) {
+ cko_paypal_vars.debug && console.log( response );
+ } ).fail( function ( xhr, status, error ) {
+ console.error('[PayPal Express] Add to cart failed:', error);
+ cko_paypal_vars.debug && console.error('[PayPal Express] Response text:', xhr.responseText);
+ // Return a default response to prevent the chain from breaking
+ return { result: 'error', message: 'Failed to add product to cart' };
+ } )
+ }
+
+ const cko_express_create_order_id_for_product = async function (productId) {
+ // Add product to cart first
+ let addToCartSuccess = await cko_express_add_to_cart_for_product(productId);
+
+ if (!addToCartSuccess || addToCartSuccess.result === 'error') {
+ console.error('[PayPal Express] Add to cart failed for product:', productId);
+ showError('Failed to add product to cart. Please try again.');
+ throw new Error('Failed to add product to cart');
+ }
+
+ let data = {
+ express_checkout: true,
+ add_to_cart: addToCartSuccess.result
+ }
+
+ return fetch( cko_paypal_vars.create_order_url, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/x-www-form-urlencoded'
+ },
+ body: jQuery.param( data )
+ }).then(function (res) {
+ if (!res.ok) {
+ throw new Error('Network response was not ok: ' + res.status);
+ }
+ return res.text().then(function(text) {
+ try {
+ return JSON.parse(text);
+ } catch (e) {
+ console.error('[PayPal Express] Invalid JSON response:', e.message);
+ throw new Error('Invalid JSON response from server: ' + text.substring(0, 200));
+ }
+ });
+ }).then(function (data) {
+ if (typeof data.success !== 'undefined' && data.success === false) {
+ let messages = data.data && data.data.messages ? data.data.messages : data.data;
+ if ( 'string' === typeof messages || Array.isArray( messages ) ) {
+ showError( messages );
+ }
+ throw new Error(typeof messages === 'string' ? messages : 'Failed to create PayPal order');
+ } else if (data.order_id) {
+ return data.order_id;
+ } else {
+ cko_paypal_vars.debug && console.error('[PayPal Express] Unexpected response format:', data);
+ showError('Unexpected response format from server');
+ throw new Error('Unexpected response format from server. Missing order_id.');
+ }
+ }).catch(function(error) {
+ console.error('[PayPal Express] Error in create_order_id_for_product:', error.message);
+ showError('Failed to create order: ' + error.message);
+ throw error;
+ });
+};
+
+const cko_express_create_order_id_for_cart = async function () {
+ cko_paypal_vars.debug && console.log('[PayPal Express] Creating order for cart page');
+
+ // Trigger cart fragments refresh to ensure cart is synced with server
+ // This works for both classic and Blocks cart pages
+ try {
+ await new Promise(function(resolve) {
+ jQuery(document.body).trigger('wc_fragment_refresh');
+ // Wait a bit for the cart to sync
+ setTimeout(resolve, 300);
+ });
+ } catch (e) {
+ // Continue even if refresh fails
+ cko_paypal_vars.debug && console.log('[PayPal Express] Cart refresh error (continuing):', e);
+ }
+
+ let data = {
+ express_checkout: true,
+ use_existing_cart: true
+ }
+
+ return fetch( cko_paypal_vars.create_order_url, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/x-www-form-urlencoded'
+ },
+ body: jQuery.param( data )
+ }).then(function (res) {
+ if (!res.ok) {
+ throw new Error('Network response was not ok: ' + res.status);
+ }
+ return res.text().then(function(text) {
+ try {
+ const parsed = JSON.parse(text);
+ cko_paypal_vars.debug && console.log('[PayPal Express] Response from server:', parsed);
+ return parsed;
+ } catch (e) {
+ console.error('[PayPal Express] Invalid JSON response:', e.message);
+ throw new Error('Invalid JSON response from server: ' + text.substring(0, 200));
+ }
+ });
+ }).then(function (data) {
+ cko_paypal_vars.debug && console.log('[PayPal Express] Order creation response:', data);
+
+ if (typeof data.success !== 'undefined' && data.success === false) {
+ let messages = data.data && data.data.messages ? data.data.messages : data.data;
+ console.error('[PayPal Express] Server returned error:', messages);
+
+ if ( 'string' === typeof messages || Array.isArray( messages ) ) {
+ const errorMsg = typeof messages === 'string' ? messages : messages.join('; ');
+ showError( messages );
+ throw new Error(errorMsg);
+ } else {
+ const errorMsg = 'Failed to create PayPal order';
+ throw new Error(errorMsg);
+ }
+ } else if (data.order_id) {
+ cko_paypal_vars.debug && console.log('[PayPal Express] Order ID received:', data.order_id);
+ return data.order_id;
+ } else {
+ const errorMsg = 'Unexpected response format from server. Missing order_id';
+ console.error('[PayPal Express]', errorMsg);
+ showError(errorMsg);
+ throw new Error(errorMsg);
+ }
+ }).catch(function(error) {
+ console.error('[PayPal Express] Error in create_order_id_for_cart:', error.message);
+ showError('Failed to create order: ' + error.message);
+ // Re-throw error - PayPal SDK will handle the rejection
+ throw error;
+ });
+};
+
+const cko_express_add_to_cart_for_product = async function (productId) {
+ let data = {
+ product_id: productId,
+ quantity: 1,
+ nonce: cko_paypal_vars.paypal_express_add_to_cart_nonce
+ };
+
+ return await $.ajax( {
+ url: cko_paypal_vars.add_to_cart_url,
+ type: 'POST',
+ async: false,
+ data: data
+ } ).done( function ( response ) {
+ cko_paypal_vars.debug && console.log( 'Add to cart response for product ' + productId + ':', response );
+ } ).fail( function ( xhr, status, error ) {
+ console.error('[PayPal Express] Add to cart failed for product ' + productId + ':', error);
+ cko_paypal_vars.debug && console.error('[PayPal Express] Response text:', xhr.responseText);
+ return { result: 'error', message: 'Failed to add product to cart' };
+ } )
+};
+
+const cko_express_create_order_id = async function () {
+ let addToCartSuccess = await cko_express_add_to_cart()
+
+ // Check if add to cart was successful
+ if (!addToCartSuccess || addToCartSuccess.result === 'error') {
+ console.error('[PayPal Express] Add to cart failed');
+ showError('Failed to add product to cart. Please try again.');
+ throw new Error('Failed to add product to cart');
+ }
+
+ // Prepare add-to-cart for express checkout.
+ let data = {
+ express_checkout: true,
+ add_to_cart: addToCartSuccess.result
+ }
+
+ cko_paypal_vars.debug && console.log( data );
+
+ // Get Order ID from below endpoint.
+ return fetch( cko_paypal_vars.create_order_url, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/x-www-form-urlencoded'
+ },
+ body: jQuery.param( data )
+ }).then(function (res) {
+ // Check if response is ok
+ if (!res.ok) {
+ throw new Error('Network response was not ok: ' + res.status);
+ }
+
+ // Get response text first to handle malformed JSON
+ return res.text().then(function(text) {
+ try {
+ // Try to parse as JSON
+ return JSON.parse(text);
+ } catch (e) {
+ // If JSON parsing fails, log the raw response and throw error
+ console.error('[PayPal Express] Invalid JSON response:', e.message);
+ throw new Error('Invalid JSON response from server: ' + text.substring(0, 200));
+ }
+ });
+ }).then(function (data) {
+ if (typeof data.success !== 'undefined' && data.success === false) {
+ let messages = data.data && data.data.messages ? data.data.messages : data.data;
+
+ if ( 'string' === typeof messages || Array.isArray( messages ) ) {
+ showError( messages );
+ }
+ throw new Error(typeof messages === 'string' ? messages : 'Failed to create PayPal order');
+ } else if (data.order_id) {
+ return data.order_id;
+ } else {
+ cko_paypal_vars.debug && console.error('[PayPal Express] Unexpected response format:', data);
+ showError('Unexpected response format from server');
+ throw new Error('Unexpected response format from server. Missing order_id.');
+ }
+ }).catch(function(error) {
+ console.error('[PayPal Express] Error in create_order_id:', error.message);
+ showError('Failed to create order: ' + error.message);
+ throw error;
+ });
+ };
+
+ const paypalButton = {
+ init: function () {
+ // Initialize PayPal express buttons for different contexts
+ this.initProductPageButton();
+ this.initShopPageButtons();
+ this.initCartPageButton();
+
+ this.updateButtonVisibility();
+
+ jQuery(document).on('change', formSelector, onFormChange );
+ },
+
+ initProductPageButton: function() {
+ // Initialize button for single product page
+ if (jQuery('#cko-paypal-button-wrapper').length && typeof paypal !== 'undefined') {
+ try {
+ paypal.Buttons({ ...this.paypalButtonProps('product') }).render('#cko-paypal-button-wrapper');
+ } catch (error) {
+ console.error('[PayPal Express] Error initializing product page button:', error);
+ }
+ }
+ },
+
+ initShopPageButtons: function() {
+ // Initialize buttons for shop/listing pages
+ const wrappers = jQuery('[id^="cko-paypal-button-wrapper-"]');
+
+ // Wait for PayPal SDK to be available
+ const checkPayPal = setInterval(function() {
+ if (typeof paypal !== 'undefined') {
+ clearInterval(checkPayPal);
+ jQuery('[id^="cko-paypal-button-wrapper-"]').each(function() {
+ const $wrapper = jQuery(this);
+ const productId = $wrapper.data('product-id');
+
+ if (productId && $wrapper.attr('id') !== 'cko-paypal-button-wrapper') {
+ try {
+ paypal.Buttons({ ...paypalButton.paypalButtonProps('shop', productId) }).render('#' + $wrapper.attr('id'));
+ } catch (error) {
+ // Silently fail - error already handled by PayPal SDK
+ }
+ }
+ });
+ }
+ }, 100);
+
+ // Timeout after 10 seconds
+ setTimeout(function() {
+ clearInterval(checkPayPal);
+ }, 10000);
+ },
+
+ initCartPageButton: function() {
+ // Initialize button for cart page
+ // Check if this is a Blocks cart page or classic cart
+ const isBlocksCart = jQuery('.wc-block-cart').length > 0;
+ const isClassicCart = jQuery('.woocommerce-cart').length > 0 && !isBlocksCart;
+ const wrapperExists = jQuery('#cko-paypal-button-wrapper-cart').length > 0;
+
+ // Clear existing PayPal button if it exists (to prevent duplicates on cart update)
+ if (wrapperExists) {
+ jQuery('#cko-paypal-button-wrapper-cart').empty();
+ }
+
+ // For Blocks cart, inject the button wrapper if it doesn't exist
+ if (isBlocksCart && !wrapperExists) {
+ const paymentOptions = jQuery('.wc-block-cart__payment-options');
+ if (paymentOptions.length) {
+ // Check if button wrapper already exists in payment options
+ if (!paymentOptions.find('#cko-paypal-button-wrapper-cart').length) {
+ // Append instead of replacing to preserve Google Pay button
+ paymentOptions.append('');
+ }
+ } else {
+ // Fallback: inject after proceed to checkout button
+ const proceedButton = jQuery('.wc-block-cart__submit, .wc-block-components-button--contained');
+ if (proceedButton.length) {
+ proceedButton.after('');
+ } else {
+ // Another fallback: inject before cart totals
+ const cartTotals = jQuery('.wc-block-cart__totals');
+ if (cartTotals.length) {
+ cartTotals.before('');
+ } else {
+ // Last fallback: inject at the end of cart block
+ const cartBlock = jQuery('.wc-block-cart');
+ if (cartBlock.length) {
+ cartBlock.append('');
+ }
+ }
+ }
+ }
+ } else if (isClassicCart && !wrapperExists) {
+ // For classic cart, try to inject if wrapper doesn't exist
+ const proceedToCheckout = jQuery('.wc-proceed-to-checkout');
+ if (proceedToCheckout.length) {
+ proceedToCheckout.before('');
+ } else {
+ // Fallback: inject before cart totals
+ const cartTotals = jQuery('.cart_totals');
+ if (cartTotals.length) {
+ cartTotals.before('');
+ }
+ }
+ }
+
+ // Wait for PayPal SDK to be available
+ const checkPayPal = setInterval(function() {
+ if (jQuery('#cko-paypal-button-wrapper-cart').length && typeof paypal !== 'undefined') {
+ clearInterval(checkPayPal);
+ try {
+ // Clear wrapper before rendering to prevent duplicates
+ jQuery('#cko-paypal-button-wrapper-cart').empty();
+ paypal.Buttons({ ...paypalButton.paypalButtonProps('cart') }).render('#cko-paypal-button-wrapper-cart');
+ } catch (error) {
+ console.error('[PayPal Express] Error rendering cart button:', error);
+ }
+ }
+ }, 100);
+
+ // Timeout after 10 seconds
+ setTimeout(function() {
+ clearInterval(checkPayPal);
+ }, 10000);
+ },
+
+ paypalButtonProps: function (context = 'product', productId = null) {
+ let paypalButtonProps = {
+ style: {
+ layout: 'vertical',
+ color: 'gold', // PayPal's default brand color (also allowed: blue, silver, white, black)
+ shape: 'rect',
+ label: 'paypal',
+ height: 40
+ },
+ onApprove: async function (data) {
+ cko_paypal_vars.debug && console.log('PayPal onApprove data:', data);
+
+ // Show loading state
+ jQuery('body').addClass('paypal-processing');
+
+ // Show loading state in the appropriate container
+ let loadingContainer = '#cko-paypal-button-wrapper';
+ if (context === 'shop' && productId) {
+ loadingContainer = '#cko-paypal-button-wrapper-' + productId;
+ } else if (context === 'cart') {
+ loadingContainer = '#cko-paypal-button-wrapper-cart';
+ }
+
+ jQuery(loadingContainer).html('
Processing your payment...');
+
+ // Add CSS for spinner animation
+ if (!jQuery('#paypal-spinner-css').length) {
+ jQuery('head').append('');
+ }
+
+ // Set a timeout fallback in case the API call takes too long (30 seconds)
+ var timeoutFallback = setTimeout(function() {
+ jQuery('body').removeClass('paypal-processing');
+ jQuery(loadingContainer).html('');
+ showError('Payment processing is taking longer than expected. Please try again.');
+ }, 30000);
+
+ // Validate URL before making request
+ if (!cko_paypal_vars.paypal_order_session_url ||
+ typeof cko_paypal_vars.paypal_order_session_url !== 'string' ||
+ cko_paypal_vars.paypal_order_session_url === 'undefined' ||
+ cko_paypal_vars.paypal_order_session_url.trim() === '') {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('paypal-processing');
+ jQuery(loadingContainer).html('');
+ console.error('[PayPal Express] paypal_order_session_url is invalid:', cko_paypal_vars.paypal_order_session_url);
+ showError('Payment processing failed: Invalid configuration. Please contact support.');
+ return;
+ }
+
+ // Construct URL with proper query parameters
+ var requestUrl = cko_paypal_vars.paypal_order_session_url.trim();
+
+ // Ensure requestUrl is a valid URL
+ try {
+ new URL(requestUrl);
+ } catch (e) {
+ clearTimeout(timeoutFallback);
+ jQuery('body').removeClass('paypal-processing');
+ jQuery(loadingContainer).html('');
+ console.error('[PayPal Express] paypal_order_session_url is not a valid URL:', requestUrl);
+ showError('Payment processing failed: Invalid URL configuration. Please contact support.');
+ return;
+ }
+
+ var separator = requestUrl.indexOf('?') !== -1 ? '&' : '?';
+ requestUrl += separator + 'paypal_order_id=' + encodeURIComponent(data.orderID) + '&woocommerce-process-checkout-nonce=' + encodeURIComponent(cko_paypal_vars.woocommerce_process_checkout);
+
+ jQuery.post(requestUrl, function (response) {
+
+ // Clear the timeout since we got a response
+ clearTimeout(timeoutFallback);
+
+ cko_paypal_vars.debug && console.log('PayPal API response:', response);
+ cko_paypal_vars.debug && console.log('Response type:', typeof response);
+ cko_paypal_vars.debug && console.log('Response success:', response.success);
+ cko_paypal_vars.debug && console.log('Response data:', response.data);
+
+ if (typeof response.success !== 'undefined' && response.success !== true ) {
+ // Hide loading state on error
+ jQuery('body').removeClass('paypal-processing');
+ jQuery('#cko-paypal-button-wrapper').html('');
+
+ var messages = response.data.messages ? response.data.messages : response.data;
+
+ if ( 'string' === typeof messages || Array.isArray( messages ) ) {
+ showError( messages );
+ }
+ } else {
+ // Check if we have a redirect URL for express checkout
+ if (response.data && response.data.redirect_url) {
+ cko_paypal_vars.debug && console.log('Redirecting to success page:', response.data.redirect_url);
+ // Express checkout - redirect directly to success page
+ window.location.href = response.data.redirect_url;
+ } else {
+ cko_paypal_vars.debug && console.log('No redirect URL found, using fallback to checkout page');
+ cko_paypal_vars.debug && console.log('Available redirect URL:', cko_paypal_vars.redirect);
+ // Fallback to checkout page (old behavior)
+ window.location.href = cko_paypal_vars.redirect;
+ }
+ }
+ }).fail(function(xhr, status, error) {
+ // Clear the timeout since we got a response (even if failed)
+ clearTimeout(timeoutFallback);
+
+ // Hide loading state on error
+ jQuery('body').removeClass('paypal-processing');
+ jQuery(loadingContainer).html('');
+
+ cko_paypal_vars.debug && console.log('PayPal API request failed:', xhr, status, error);
+ cko_paypal_vars.debug && console.log('Response text:', xhr.responseText);
+ showError('Payment processing failed. Please try again.');
+ });
+ },
+ onCancel: function (data, actions) {
+ // Hide loading state if user cancels
+ jQuery('body').removeClass('paypal-processing');
+ jQuery(loadingContainer).html('');
+
+ cko_paypal_vars.debug && console.log(data);
+ jQuery('.woocommerce').unblock();
+ },
+ onError: function (err) {
+ // Hide loading state on PayPal error
+ jQuery('body').removeClass('paypal-processing');
+ jQuery(loadingContainer).html('');
+
+ cko_paypal_vars.debug && console.log(err);
+ jQuery('.woocommerce').unblock();
+ },
+ };
+
+ // Always use createOrder for express checkout (no billing agreements)
+ paypalButtonProps.createOrder = function( data, actions ) {
+ if (context === 'shop' && productId) {
+ return cko_express_create_order_id_for_product(productId);
+ } else if (context === 'cart') {
+ return cko_express_create_order_id_for_cart();
+ } else {
+ return cko_express_create_order_id();
+ }
+ };
+
+ return paypalButtonProps;
+ },
+
+ updateButtonVisibility: function () {
+ // Show product page button
+ if ( jQuery( cko_paypal_vars.paypal_button_selector ) ) {
+ jQuery( cko_paypal_vars.paypal_button_selector ).show();
+ }
+
+ // Show shop page buttons
+ jQuery('[id^="cko-paypal-button-wrapper-"]').each(function() {
+ if (jQuery(this).attr('id') !== 'cko-paypal-button-wrapper') {
+ jQuery(this).show();
+ }
+ });
+
+ // Show cart page button
+ if ( jQuery('#cko-paypal-button-wrapper-cart') ) {
+ jQuery('#cko-paypal-button-wrapper-cart').show();
+ }
+ }
+ }
+
+ paypalButton.init();
+
+ // Re-initialize PayPal button when cart is updated (for cart page)
+ jQuery(document.body).on('updated_cart_totals', function() {
+ // Re-initialize cart page button after cart update
+ if (jQuery('#cko-paypal-button-wrapper-cart').length || jQuery('.woocommerce-cart').length || jQuery('.wc-block-cart').length) {
+ paypalButton.initCartPageButton();
+ }
+ });
+});
diff --git a/assets/js/cko-paypal-integration.js b/checkout-com-unified-payments-api/assets/js/cko-paypal-integration.js
similarity index 91%
rename from assets/js/cko-paypal-integration.js
rename to checkout-com-unified-payments-api/assets/js/cko-paypal-integration.js
index 3f769349..db8001a9 100644
--- a/assets/js/cko-paypal-integration.js
+++ b/checkout-com-unified-payments-api/assets/js/cko-paypal-integration.js
@@ -124,8 +124,16 @@ jQuery( function ( $ ) {
}
}
- // Initialize paypal button.
- paypal.Buttons({ ...this.paypalButtonProps() }).render( cko_paypal_vars.paypal_button_selector );
+ // Initialize paypal button only if container exists and PayPal SDK is available.
+ if ( typeof paypal !== 'undefined' && jQuery( cko_paypal_vars.paypal_button_selector ).length ) {
+ try {
+ paypal.Buttons({ ...this.paypalButtonProps() }).render( cko_paypal_vars.paypal_button_selector );
+ } catch (error) {
+ console.log('[PayPal] Error initializing PayPal button:', error);
+ }
+ } else {
+ console.log('[PayPal] Container not found or PayPal SDK not available, skipping PayPal button initialization');
+ }
this.updateButtonVisibility();
},
diff --git a/assets/js/jquery-tiptip/jquery.tipTip.js b/checkout-com-unified-payments-api/assets/js/jquery-tiptip/jquery.tipTip.js
similarity index 100%
rename from assets/js/jquery-tiptip/jquery.tipTip.js
rename to checkout-com-unified-payments-api/assets/js/jquery-tiptip/jquery.tipTip.js
diff --git a/assets/js/jquery-tiptip/jquery.tipTip.min.js b/checkout-com-unified-payments-api/assets/js/jquery-tiptip/jquery.tipTip.min.js
similarity index 100%
rename from assets/js/jquery-tiptip/jquery.tipTip.min.js
rename to checkout-com-unified-payments-api/assets/js/jquery-tiptip/jquery.tipTip.min.js
diff --git a/assets/js/klarna.js b/checkout-com-unified-payments-api/assets/js/klarna.js
similarity index 100%
rename from assets/js/klarna.js
rename to checkout-com-unified-payments-api/assets/js/klarna.js
diff --git a/checkout-com-unified-payments-api/check-database-indexes.php b/checkout-com-unified-payments-api/check-database-indexes.php
new file mode 100644
index 00000000..134f94e3
--- /dev/null
+++ b/checkout-com-unified-payments-api/check-database-indexes.php
@@ -0,0 +1,443 @@
+postmeta;
+
+/**
+ * Get table name for posts
+ */
+$posts_table = $wpdb->posts;
+
+/**
+ * Check if index exists on meta_key
+ */
+function check_meta_key_index( $wpdb, $table_name ) {
+ $indexes = $wpdb->get_results( "SHOW INDEX FROM {$table_name} WHERE Key_name = 'meta_key'" );
+ return ! empty( $indexes );
+}
+
+/**
+ * Check if composite index exists on meta_key and meta_value
+ */
+function check_composite_index( $wpdb, $table_name ) {
+ $indexes = $wpdb->get_results( "SHOW INDEX FROM {$table_name} WHERE Key_name LIKE '%cko_payment_session_id%'" );
+ return ! empty( $indexes );
+}
+
+/**
+ * Get all indexes on postmeta table
+ */
+function get_all_indexes( $wpdb, $table_name ) {
+ return $wpdb->get_results( "SHOW INDEX FROM {$table_name}" );
+}
+
+/**
+ * Check query performance
+ */
+function test_query_performance( $wpdb, $table_name, $meta_key ) {
+ // Get a sample payment_session_id from database
+ $sample_value = $wpdb->get_var( $wpdb->prepare(
+ "SELECT meta_value FROM {$table_name} WHERE meta_key = %s LIMIT 1",
+ $meta_key
+ ) );
+
+ if ( ! $sample_value ) {
+ return array(
+ 'success' => false,
+ 'message' => 'No sample data found to test query performance.',
+ );
+ }
+
+ // Test query performance
+ $start_time = microtime( true );
+ $result = $wpdb->get_results( $wpdb->prepare(
+ "SELECT post_id FROM {$table_name} WHERE meta_key = %s AND meta_value = %s LIMIT 1",
+ $meta_key,
+ $sample_value
+ ) );
+ $end_time = microtime( true );
+
+ $query_time = ( $end_time - $start_time ) * 1000; // Convert to milliseconds
+
+ return array(
+ 'success' => true,
+ 'query_time_ms' => round( $query_time, 2 ),
+ 'result_count' => count( $result ),
+ );
+}
+
+/**
+ * Create composite index if needed
+ */
+function create_composite_index( $wpdb, $table_name, $meta_key ) {
+ $index_name = 'idx_' . str_replace( '_', '', $meta_key );
+
+ // Check if index already exists
+ $existing = $wpdb->get_var( $wpdb->prepare(
+ "SELECT COUNT(*) FROM information_schema.statistics
+ WHERE table_schema = DATABASE()
+ AND table_name = %s
+ AND index_name = %s",
+ $table_name,
+ $index_name
+ ) );
+
+ if ( $existing > 0 ) {
+ return array(
+ 'success' => false,
+ 'message' => 'Index already exists.',
+ );
+ }
+
+ // Create composite index
+ $sql = $wpdb->prepare(
+ "CREATE INDEX %s ON %s (meta_key, meta_value(191)) WHERE meta_key = %s",
+ $index_name,
+ $table_name,
+ $meta_key
+ );
+
+ // Note: MySQL doesn't support filtered indexes, so we'll create a regular composite index
+ // For better performance, we'll create index on meta_key and meta_value
+ $sql = "CREATE INDEX {$index_name} ON {$table_name} (meta_key(191), meta_value(191))";
+
+ $result = $wpdb->query( $sql );
+
+ if ( $result === false ) {
+ return array(
+ 'success' => false,
+ 'message' => 'Failed to create index: ' . $wpdb->last_error,
+ );
+ }
+
+ return array(
+ 'success' => true,
+ 'message' => 'Index created successfully.',
+ 'index_name' => $index_name,
+ );
+}
+
+// Main execution
+$meta_key = '_cko_payment_session_id';
+$results = array();
+
+// 1. Check if meta_key index exists
+$results['meta_key_index'] = check_meta_key_index( $wpdb, $postmeta_table );
+
+// 2. Check if composite index exists
+$results['composite_index'] = check_composite_index( $wpdb, $postmeta_table );
+
+// 3. Get all indexes
+$results['all_indexes'] = get_all_indexes( $wpdb, $postmeta_table );
+
+// 4. Test query performance
+$results['query_performance'] = test_query_performance( $wpdb, $postmeta_table, $meta_key );
+
+// 5. Get table statistics
+$results['table_stats'] = array(
+ 'total_rows' => $wpdb->get_var( "SELECT COUNT(*) FROM {$postmeta_table}" ),
+ 'meta_key_rows' => $wpdb->get_var( $wpdb->prepare(
+ "SELECT COUNT(*) FROM {$postmeta_table} WHERE meta_key = %s",
+ $meta_key
+ ) ),
+);
+
+// Output results
+if ( php_sapi_name() === 'cli' ) {
+ // CLI output
+ echo "\n";
+ echo "========================================\n";
+ echo "Database Index Check - Checkout.com Flow\n";
+ echo "========================================\n\n";
+
+ echo "Meta Key: {$meta_key}\n";
+ echo "Table: {$postmeta_table}\n\n";
+
+ echo "1. Meta Key Index Exists: " . ( $results['meta_key_index'] ? 'YES ✅' : 'NO ❌' ) . "\n";
+ echo "2. Composite Index Exists: " . ( $results['composite_index'] ? 'YES ✅' : 'NO ❌' ) . "\n";
+
+ if ( $results['query_performance']['success'] ) {
+ echo "3. Query Performance Test:\n";
+ echo " - Query Time: " . $results['query_performance']['query_time_ms'] . "ms\n";
+ echo " - Result Count: " . $results['query_performance']['result_count'] . "\n";
+
+ if ( $results['query_performance']['query_time_ms'] > 20 ) {
+ echo " ⚠️ WARNING: Query time is high (>20ms). Consider adding index.\n";
+ } elseif ( $results['query_performance']['query_time_ms'] > 15 ) {
+ echo " ⚠️ Query time is moderate (15-20ms). Index may help.\n";
+ } else {
+ echo " ✅ Query time is good (<15ms).\n";
+ }
+ } else {
+ echo "3. Query Performance Test: " . $results['query_performance']['message'] . "\n";
+ }
+
+ echo "\n4. Table Statistics:\n";
+ echo " - Total Rows: " . number_format( $results['table_stats']['total_rows'] ) . "\n";
+ echo " - Rows with {$meta_key}: " . number_format( $results['table_stats']['meta_key_rows'] ) . "\n";
+
+ echo "\n5. Recommendations:\n";
+ if ( ! $results['meta_key_index'] ) {
+ echo " ⚠️ WordPress should automatically index meta_key, but it's missing.\n";
+ echo " ⚠️ This may indicate a database issue.\n";
+ }
+
+ if ( ! $results['composite_index'] && $results['table_stats']['meta_key_rows'] > 100 ) {
+ echo " ✅ Consider creating composite index for better performance.\n";
+ echo " ✅ Run: CREATE INDEX idx_ckopaymentsessionid ON {$postmeta_table} (meta_key(191), meta_value(191));\n";
+ } elseif ( ! $results['composite_index'] ) {
+ echo " ℹ️ Composite index not needed yet (low data volume).\n";
+ }
+
+ if ( $results['query_performance']['success'] && $results['query_performance']['query_time_ms'] > 20 ) {
+ echo " ⚠️ Query performance is slow. Adding index is recommended.\n";
+ }
+
+ echo "\n";
+} else {
+ // HTML output for browser
+ ?>
+
+
+
+ Database Index Check - Checkout.com Flow
+
+
+
+ ").html(value));
+ });
+ }
+
+ let wcNoticeDiv = jQuery("';
+ return;
+ }
+
+ $table_name = $wpdb->prefix . 'cko_pending_webhooks';
+
+ // Check if table exists
+ $table_exists = $wpdb->get_var( $wpdb->prepare( 'SHOW TABLES LIKE %s', $table_name ) );
+
+ if ( ! $table_exists ) {
+ echo '';
+ return;
+ }
+
+ // Get statistics
+ $total_count = $wpdb->get_var( "SELECT COUNT(*) FROM {$table_name}" );
+ $pending_count = $wpdb->get_var( "SELECT COUNT(*) FROM {$table_name} WHERE processed_at IS NULL" );
+ $processed_count = $wpdb->get_var( "SELECT COUNT(*) FROM {$table_name} WHERE processed_at IS NOT NULL" );
+
+ // Get records
+ $records = $wpdb->get_results( "SELECT * FROM {$table_name} ORDER BY created_at DESC LIMIT 100" );
+
+ ?>
+
+
+
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+
+
+
+ get_field_key( $key );
+ ?>
+
+
+
+
+
+
+
+
+ get_field_key( $key );
+
+ // Get the correct path based on server configuration
+ $well_known_info = $this->get_well_known_path();
+ $well_known_dir = $well_known_info['dir'];
+ $is_bitnami = $well_known_info['is_bitnami'];
+
+ // Apple now requires .txt extension
+ $well_known_url = home_url( '/.well-known/apple-developer-merchantid-domain-association.txt' );
+ $file_path = $well_known_dir . '/apple-developer-merchantid-domain-association.txt';
+
+ // Check if config is detected for collapsible sections
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_existing_config = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+ cart->get_shipping_total();
+ $checkout_fields = wp_json_encode( $woocommerce->checkout->checkout_fields, JSON_HEX_APOS );
+ $session_url = str_replace( 'https:', 'https:', add_query_arg( 'wc-api', 'wc_checkoutcom_session', home_url( '/' ) ) );
+ $generate_token_url = str_replace( 'https:', 'https:', add_query_arg( 'wc-api', 'wc_checkoutcom_generate_token', home_url( '/' ) ) );
+ $apple_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings' );
+ $mada_enabled = isset( $apple_settings['enable_mada'] ) && ( 'yes' === $apple_settings['enable_mada'] );
+
+ if ( ! empty( $this->get_option( 'description' ) ) ) {
+ echo esc_html( $this->get_option( 'description' ) );
+ }
+
+ // get country of current user.
+ $country_code = WC()->customer->get_billing_country();
+ $supported_networks = [ 'amex', 'masterCard', 'visa' ];
+ $merchant_capabilities = [ 'supports3DS', 'supportsEMV', 'supportsCredit', 'supportsDebit' ];
+
+ if ( $mada_enabled ) {
+ array_push( $supported_networks, 'mada' );
+ $country_code = 'SA';
+
+ $merchant_capabilities = array_values( array_diff( $merchant_capabilities, [ 'supportsEMV' ] ) );
+ }
+
+ ?>
+
+
+
+
+
+
+
+
+
+
+ cko_express_add_to_cart();
+ break;
+
+ case 'express_get_cart_total':
+ $this->cko_express_get_cart_total();
+ break;
+
+ case 'express_apple_pay_order_session':
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_apple_pay_order_id', isset( $_GET['apple_pay_order_id'] ) ? wc_clean( $_GET['apple_pay_order_id'] ) : '' );
+ $this->cko_express_apple_pay_order_session();
+ break;
+ }
+ }
+ // phpcs:enable
+ exit();
+ }
+
+ /**
+ * Add to cart for Apple Pay Express checkout.
+ *
+ * @return void
+ */
+ public function cko_express_add_to_cart() {
+ if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'checkoutcom_apple_pay_express_add_to_cart' ) ) {
+ wp_send_json( [ 'result' => 'failed' ] );
+ }
+
+ if ( ! defined( 'WOOCOMMERCE_CART' ) ) {
+ define( 'WOOCOMMERCE_CART', true );
+ }
+
+ WC()->shipping->reset_shipping();
+
+ $product_id = isset( $_POST['product_id'] ) ? absint( $_POST['product_id'] ) : 0;
+ $qty = ! isset( $_POST['qty'] ) ? 1 : absint( $_POST['qty'] );
+
+ $product = wc_get_product( $product_id );
+
+ if ( ! $product ) {
+ wp_send_json( [ 'result' => 'error', 'message' => 'Product not found' ] );
+ }
+
+ $product_type = $product->get_type();
+
+ // First empty the cart to prevent wrong calculation.
+ WC()->cart->empty_cart();
+
+ if ( ( 'variable' === $product_type || 'variable-subscription' === $product_type ) && isset( $_POST['attributes'] ) ) {
+ $attributes = wc_clean( wp_unslash( $_POST['attributes'] ) );
+
+ $data_store = WC_Data_Store::load( 'product' );
+ $variation_id = $data_store->find_matching_product_variation( $product, $attributes );
+
+ $is_added_to_cart = WC()->cart->add_to_cart( $product->get_id(), $qty, $variation_id, $attributes );
+ }
+
+ if ( in_array( $product_type, [ 'simple', 'variation', 'subscription', 'subscription_variation' ], true ) ) {
+ $is_added_to_cart = WC()->cart->add_to_cart( $product->get_id(), $qty );
+ }
+
+ WC()->cart->calculate_totals();
+
+ $data = [];
+ $data['result'] = 'success';
+ $data['total'] = WC()->cart->total;
+
+ wp_send_json( $data );
+ }
+
+ /**
+ * Get cart total for Apple Pay Express checkout.
+ *
+ * @return void
+ */
+ public function cko_express_get_cart_total() {
+ // Return cart total directly from WooCommerce
+ // This works for both classic and Blocks cart pages
+
+ // Ensure cart is loaded
+ if ( ! WC()->cart ) {
+ wp_send_json_error( array( 'messages' => 'Cart not initialized' ) );
+ return;
+ }
+
+ if ( WC()->cart->is_empty() ) {
+ wp_send_json_error( array( 'messages' => 'Cart is empty' ) );
+ return;
+ }
+
+ // Recalculate totals to ensure we have the latest
+ WC()->cart->calculate_totals();
+
+ // Get cart total - use 'raw' to get the numeric value directly
+ $cart_total_raw = WC()->cart->get_total( 'raw' );
+
+ // Also get formatted total for display
+ $cart_total_formatted = WC()->cart->get_total( '' );
+
+ // Ensure we have a valid total
+ if ( $cart_total_raw <= 0 ) {
+ wp_send_json_error( array( 'messages' => 'Invalid cart total' ) );
+ return;
+ }
+
+ wp_send_json_success( array(
+ 'total' => floatval( $cart_total_raw ),
+ 'total_formatted' => $cart_total_formatted,
+ 'currency' => get_woocommerce_currency(),
+ ) );
+ }
+
+ /**
+ * Process Apple Pay Express order session.
+ *
+ * @return void
+ */
+ public function cko_express_apple_pay_order_session() {
+ // Express now uses the same flow as classic Apple Pay
+ // Classic Apple Pay sends: cko-apple-card-token
+ // Express now sends the same field, so we can use the same process_payment method
+
+ // Get payment data for email and address extraction
+ $payment_data_json = isset( $_POST['payment_data'] ) ? wp_unslash( $_POST['payment_data'] ) : '';
+ $payment_data = ! empty( $payment_data_json ) ? json_decode( $payment_data_json, true ) : array();
+
+ // Extract email and address from payment data
+ // IMPORTANT: For guest users, both email and address are MANDATORY from Apple Pay
+ // Chrome may send email in a different structure than Safari, so we check multiple locations
+ $email = '';
+ $shipping_address = null;
+ $billing_address = null;
+
+ if ( ! empty( $payment_data ) ) {
+ // Extract email - try multiple locations (Chrome may send it differently)
+ // 1. Top-level email field
+ if ( isset( $payment_data['email'] ) && ! empty( $payment_data['email'] ) ) {
+ $email = sanitize_email( $payment_data['email'] );
+ }
+ // 2. billingContact.emailAddress
+ elseif ( isset( $payment_data['billingContact']['emailAddress'] ) && ! empty( $payment_data['billingContact']['emailAddress'] ) ) {
+ $email = sanitize_email( $payment_data['billingContact']['emailAddress'] );
+ }
+ // 3. shippingContact.emailAddress
+ elseif ( isset( $payment_data['shippingContact']['emailAddress'] ) && ! empty( $payment_data['shippingContact']['emailAddress'] ) ) {
+ $email = sanitize_email( $payment_data['shippingContact']['emailAddress'] );
+ }
+ // 4. Check if billingContact or shippingContact have email (without emailAddress key)
+ elseif ( isset( $payment_data['billingContact']['email'] ) && ! empty( $payment_data['billingContact']['email'] ) ) {
+ $email = sanitize_email( $payment_data['billingContact']['email'] );
+ }
+ elseif ( isset( $payment_data['shippingContact']['email'] ) && ! empty( $payment_data['shippingContact']['email'] ) ) {
+ $email = sanitize_email( $payment_data['shippingContact']['email'] );
+ }
+
+ // Extract shipping address (MANDATORY for express checkout)
+ if ( isset( $payment_data['shippingContact'] ) && ! empty( $payment_data['shippingContact'] ) ) {
+ $shipping_address = $payment_data['shippingContact'];
+ } elseif ( isset( $payment_data['billingContact'] ) && ! empty( $payment_data['billingContact'] ) ) {
+ // Fallback to billing contact if shipping contact not available
+ $shipping_address = $payment_data['billingContact'];
+ }
+
+ // Extract billing address - use billing contact if different, otherwise use shipping contact
+ if ( isset( $payment_data['billingContact'] ) && ! empty( $payment_data['billingContact'] ) ) {
+ $billing_address = $payment_data['billingContact'];
+ } elseif ( isset( $payment_data['shippingContact'] ) && ! empty( $payment_data['shippingContact'] ) ) {
+ $billing_address = $payment_data['shippingContact'];
+ }
+ }
+
+ // Store payment data in session for checkout page field population
+ // This ensures that if user is redirected to checkout, fields will be populated
+ if ( ! empty( $payment_data ) ) {
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_ap_details', $payment_data );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_ap_id', 'express_' . time() );
+ }
+
+ // Create the order from cart
+ $order = $this->create_express_order_from_cart( $email, $shipping_address, $billing_address );
+
+ if ( ! $order ) {
+ wp_send_json_error( array( 'messages' => 'Failed to create order for Apple Pay Express checkout.' ) );
+ return;
+ }
+
+ // Store order ID in session for checkout page reference
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_apple_pay_order_id', $order->get_id() );
+
+ // process_payment expects the payment method to be set in $_POST
+ $_POST['payment_method'] = 'wc_checkout_com_apple_pay';
+
+ // Use the same process_payment method as classic Apple Pay
+ $result = $this->process_payment( $order->get_id() );
+
+ // process_payment returns an array with 'result' and 'redirect'
+ if ( isset( $result['result'] ) && 'success' === $result['result'] ) {
+ // Payment successful - return success
+ wp_send_json_success(
+ array(
+ 'result' => 'success',
+ 'redirect_url' => isset( $result['redirect'] ) ? $result['redirect'] : $this->get_return_url( $order ),
+ )
+ );
+ } else {
+ // Payment failed
+ $error_message = isset( $result['messages'] ) ? $result['messages'] : 'Payment failed.';
+ wp_send_json_error( array( 'messages' => $error_message ) );
+ }
+ }
+
+ /**
+ * Create express order from cart.
+ *
+ * @param string $email Email address from Apple Pay.
+ * @param array $shipping_address Shipping address from Apple Pay.
+ * @param array $billing_address Billing address from Apple Pay (optional, defaults to shipping address).
+ * @return WC_Order|false
+ */
+ private function create_express_order_from_cart( $email = '', $shipping_address = null, $billing_address = null ) {
+ try {
+ // Determine customer ID and email
+ // IMPORTANT: For Apple Pay Express:
+ // - If user is logged in: Use logged-in user's email (NOT Apple Pay email), address from Apple Pay
+ // - If user is guest: Use email and address from Apple Pay only (mandatory)
+ $customer_id = 0;
+ $customer_email = '';
+
+ // Check if user is logged in
+ if ( is_user_logged_in() ) {
+ $current_user = wp_get_current_user();
+ $customer_id = $current_user->ID;
+ // For logged-in users, always use their account email (NOT Apple Pay email)
+ $customer_email = $current_user->user_email;
+ } else {
+ // For guest users, use email from Apple Pay data only (mandatory)
+ if ( ! empty( $email ) ) {
+ $customer_email = $email;
+ }
+ }
+
+ // Create order with proper customer ID
+ $order = wc_create_order( array( 'customer_id' => $customer_id ) );
+
+ if ( ! $order ) {
+ return false;
+ }
+
+ // Set customer email
+ if ( ! empty( $customer_email ) ) {
+ $order->set_billing_email( $customer_email );
+ }
+
+ // Add cart items to order
+ foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
+ $product = $cart_item['data'];
+ $order->add_product( $product, $cart_item['quantity'] );
+ }
+
+ // Set order addresses from Apple Pay payment data (MANDATORY - addresses must always be copied from Apple Pay)
+ // IMPORTANT: For Apple Pay Express:
+ // - Addresses are MANDATORY from Apple Pay for both logged-in and guest users
+ // - If logged in: Use logged-in user's email (already set above), but ALWAYS copy address from Apple Pay
+ // - If guest: Use Apple Pay email and address (both mandatory from Apple Pay)
+ if ( ! empty( $shipping_address ) ) {
+ // For logged-in users: Don't pass email to set_order_addresses_from_apple_pay_data
+ // because we want to keep the logged-in user's email (already set above)
+ // Addresses are ALWAYS copied from Apple Pay regardless of login status (MANDATORY)
+ // For guest users: Pass Apple Pay email so it gets set in the address
+ $email_for_address = is_user_logged_in() ? '' : $customer_email;
+ // Use billing address if different, otherwise use shipping address for both
+ $billing_address_to_use = ! empty( $billing_address ) ? $billing_address : $shipping_address;
+
+ $this->set_order_addresses_from_apple_pay_data( $order, $shipping_address, $email_for_address, $billing_address_to_use );
+ }
+
+ // Set shipping method if available
+ $shipping_packages = WC()->shipping->get_packages();
+ if ( ! empty( $shipping_packages ) ) {
+ foreach ( $shipping_packages as $package ) {
+ $chosen_methods = WC()->session->get( 'chosen_shipping_methods' );
+ if ( ! empty( $chosen_methods ) ) {
+ $order->set_shipping_method( $chosen_methods[0] );
+ }
+ }
+ }
+
+ // Calculate totals
+ $order->calculate_totals();
+
+ // Set payment method to Apple Pay Express
+ $order->set_payment_method( 'wc_checkout_com_apple_pay' );
+ $order->set_payment_method_title( 'Apple Pay Express' );
+
+ // Set order status
+ $order->set_status( 'pending' );
+ $order->save();
+
+ // Store order ID in session for potential use
+ WC()->session->set( 'order_awaiting_payment', $order->get_id() );
+
+ return $order;
+
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( 'Error creating Apple Pay Express order: ' . $e->getMessage(), $e );
+ return false;
+ }
+ }
+
+ /**
+ * Set order addresses from Apple Pay payment data.
+ * MANDATORY: Addresses must always be copied from Apple Pay when available.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $shipping_contact Shipping contact from Apple Pay (MANDATORY).
+ * @param string $email Email address (optional, for guest users).
+ * @param array $billing_contact Billing contact from Apple Pay (optional, defaults to shipping contact).
+ * @return void
+ */
+ private function set_order_addresses_from_apple_pay_data( $order, $shipping_contact, $email = '', $billing_contact = null ) {
+ // Addresses are MANDATORY from Apple Pay - if not provided, return
+ if ( empty( $shipping_contact ) ) {
+ return;
+ }
+
+ // Use billing contact if provided, otherwise use shipping contact for billing address
+ $billing_contact_to_use = ! empty( $billing_contact ) ? $billing_contact : $shipping_contact;
+
+ // Extract address fields from Apple Pay shipping contact
+ $shipping_first_name = isset( $shipping_contact['givenName'] ) ? sanitize_text_field( $shipping_contact['givenName'] ) : '';
+ $shipping_last_name = isset( $shipping_contact['familyName'] ) ? sanitize_text_field( $shipping_contact['familyName'] ) : '';
+ $shipping_address_lines = isset( $shipping_contact['addressLines'] ) ? $shipping_contact['addressLines'] : array();
+ $shipping_address_1 = isset( $shipping_address_lines[0] ) ? sanitize_text_field( $shipping_address_lines[0] ) : '';
+ $shipping_address_2 = isset( $shipping_address_lines[1] ) ? sanitize_text_field( $shipping_address_lines[1] ) : '';
+ $shipping_city = isset( $shipping_contact['locality'] ) ? sanitize_text_field( $shipping_contact['locality'] ) : '';
+ $shipping_state = isset( $shipping_contact['administrativeArea'] ) ? sanitize_text_field( $shipping_contact['administrativeArea'] ) : '';
+ $shipping_postcode = isset( $shipping_contact['postalCode'] ) ? sanitize_text_field( $shipping_contact['postalCode'] ) : '';
+ $shipping_country = isset( $shipping_contact['countryCode'] ) ? strtoupper( sanitize_text_field( $shipping_contact['countryCode'] ) ) : '';
+ $shipping_phone = isset( $shipping_contact['phoneNumber'] ) ? sanitize_text_field( $shipping_contact['phoneNumber'] ) : '';
+
+ // Extract address fields from Apple Pay billing contact
+ $billing_first_name = isset( $billing_contact_to_use['givenName'] ) ? sanitize_text_field( $billing_contact_to_use['givenName'] ) : '';
+ $billing_last_name = isset( $billing_contact_to_use['familyName'] ) ? sanitize_text_field( $billing_contact_to_use['familyName'] ) : '';
+ $billing_address_lines = isset( $billing_contact_to_use['addressLines'] ) ? $billing_contact_to_use['addressLines'] : array();
+ $billing_address_1 = isset( $billing_address_lines[0] ) ? sanitize_text_field( $billing_address_lines[0] ) : '';
+ $billing_address_2 = isset( $billing_address_lines[1] ) ? sanitize_text_field( $billing_address_lines[1] ) : '';
+ $billing_city = isset( $billing_contact_to_use['locality'] ) ? sanitize_text_field( $billing_contact_to_use['locality'] ) : '';
+ $billing_state = isset( $billing_contact_to_use['administrativeArea'] ) ? sanitize_text_field( $billing_contact_to_use['administrativeArea'] ) : '';
+ $billing_postcode = isset( $billing_contact_to_use['postalCode'] ) ? sanitize_text_field( $billing_contact_to_use['postalCode'] ) : '';
+ $billing_country = isset( $billing_contact_to_use['countryCode'] ) ? strtoupper( sanitize_text_field( $billing_contact_to_use['countryCode'] ) ) : '';
+ $billing_phone = isset( $billing_contact_to_use['phoneNumber'] ) ? sanitize_text_field( $billing_contact_to_use['phoneNumber'] ) : '';
+
+ // Set billing address (MANDATORY from Apple Pay)
+ // Always set all address fields from Apple Pay, even if some are empty
+ $order->set_billing_first_name( $billing_first_name );
+ $order->set_billing_last_name( $billing_last_name );
+ $order->set_billing_address_1( $billing_address_1 );
+ $order->set_billing_address_2( $billing_address_2 );
+ $order->set_billing_city( $billing_city );
+ $order->set_billing_state( $billing_state );
+ $order->set_billing_postcode( $billing_postcode );
+ $order->set_billing_country( $billing_country );
+ $order->set_billing_phone( $billing_phone );
+
+ // Email handling:
+ // IMPORTANT: Only use Apple Pay email for guest users
+ // - For logged-in users: Keep the account email (already set in create_express_order_from_cart)
+ // - For guest users: Set email from Apple Pay data (mandatory)
+ $current_billing_email = $order->get_billing_email();
+ $is_guest = ! is_user_logged_in();
+
+ if ( $is_guest && ! empty( $email ) ) {
+ // For guest users, always use Apple Pay email (mandatory)
+ $order->set_billing_email( sanitize_email( $email ) );
+ }
+
+ // Set shipping address (MANDATORY from Apple Pay)
+ // Always set all address fields from Apple Pay, even if some are empty
+ $order->set_shipping_first_name( $shipping_first_name );
+ $order->set_shipping_last_name( $shipping_last_name );
+ $order->set_shipping_address_1( $shipping_address_1 );
+ $order->set_shipping_address_2( $shipping_address_2 );
+ $order->set_shipping_city( $shipping_city );
+ $order->set_shipping_state( $shipping_state );
+ $order->set_shipping_postcode( $shipping_postcode );
+ $order->set_shipping_country( $shipping_country );
+ $order->set_shipping_phone( $shipping_phone );
+
+ // Save order to persist address changes
+ $order->save();
+ }
+
+ /**
+ * Apple pay session.
+ *
+ * @return void
+ */
+ public function applepay_sesion() {
+ // phpcs:disable WordPress.Security.NonceVerification.Missing
+ $url = isset( $_POST['url'] ) ? sanitize_text_field( $_POST['url'] ) : '';
+ $domain = isset( $_POST['domain'] ) ? sanitize_text_field( $_POST['domain'] ) : '';
+ $display_name = isset( $_POST['displayName'] ) ? sanitize_text_field( $_POST['displayName'] ) : '';
+ // phpcs:enable
+
+ $merchant_id = $this->get_option( 'ckocom_apple_mercahnt_id' );
+ $certificate = $this->get_option( 'ckocom_apple_certificate' );
+ $certificate_key = $this->get_option( 'ckocom_apple_key' );
+
+ if (
+ 'https' === wp_parse_url( $url, PHP_URL_SCHEME ) &&
+ substr( wp_parse_url( $url, PHP_URL_HOST ), - 10 ) === '.apple.com'
+ ) {
+ $ch = curl_init();
+
+ $data =
+ '{
+ "merchantIdentifier":"' . $merchant_id . '",
+ "domainName":"' . $domain . '",
+ "displayName":"' . $display_name . '"
+ }';
+
+ curl_setopt( $ch, CURLOPT_URL, $url );
+ curl_setopt( $ch, CURLOPT_SSLCERT, $certificate );
+ curl_setopt( $ch, CURLOPT_SSLKEY, $certificate_key );
+
+ curl_setopt( $ch, CURLOPT_POST, 1 );
+ curl_setopt( $ch, CURLOPT_POSTFIELDS, $data );
+
+ // TODO: throw error and log it.
+ if ( curl_exec( $ch ) === false ) {
+ echo '{"curlError":"' . curl_error( $ch ) . '"}';
+ }
+
+ // close cURL resource, and free up system resources.
+ curl_close( $ch );
+
+ exit();
+ }
+ }
+
+ /**
+ * Generate Apple Pay token.
+ *
+ * @return void
+ */
+ public function applepay_token() {
+ // Generate apple token.
+ $token = WC_Checkoutcom_Api_Request::generate_apple_token();
+
+ echo $token;
+
+ exit();
+ }
+
+ /**
+ * Process payment with Apple Pay.
+ *
+ * @param int $order_id Order ID.
+ *
+ * @return array|void
+ */
+ public function process_payment( $order_id ) {
+ if ( ! session_id() ) {
+ session_start();
+ }
+
+ $order = new WC_Order( $order_id );
+
+ // create apple token from apple payment data.
+ $apple_token = $_POST['cko-apple-card-token'] ?? ''; // phpcs:ignore WordPress.Security.NonceVerification.Missing
+
+ // Check if apple token is not empty.
+ if ( empty( $apple_token ) ) {
+ WC_Checkoutcom_Utility::wc_add_notice_self( __( 'There was an issue completing the payment.', 'checkout-com-unified-payments-api' ), 'error' );
+
+ return;
+ }
+
+ // Create payment with apple token.
+ $result = (array) ( new WC_Checkoutcom_Api_Request() )->create_payment( $order, $apple_token );
+
+ // check if result has error and return error message.
+ if ( ! empty( $result['error'] ) ) {
+ WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'] );
+
+ return;
+ }
+
+ if ( class_exists( 'WC_Subscriptions_Order' ) ) {
+ // Save source id for subscription.
+ WC_Checkoutcom_Subscription::save_source_id( $order_id, $order, $result['source']['id'] );
+ }
+
+ // Set action id as woo transaction id.
+ $order->set_transaction_id( $result['action_id'] );
+ $order->update_meta_data( '_cko_payment_id', $result['id'] );
+
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Authorised - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+
+ // check if payment was flagged.
+ if ( $result['risk']['flagged'] ) {
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_flagged', 'flagged' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Flagged - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+ }
+
+ // add notes for the order and update status.
+ $order->add_order_note( $message );
+ $order->update_status( $status );
+
+ // Reduce stock levels.
+ wc_reduce_stock_levels( $order_id );
+
+ // Remove cart.
+ WC()->cart->empty_cart();
+
+ // Return thank you page.
+ return [
+ 'result' => 'success',
+ 'redirect' => $this->get_return_url( $order ),
+ ];
+ }
+
+ /**
+ * Process refund for the order.
+ *
+ * @param int $order_id Order ID.
+ * @param int $amount Amount to refund.
+ * @param string $reason Refund reason.
+ *
+ * @return bool
+ */
+ public function process_refund( $order_id, $amount = null, $reason = '' ) {
+
+ $order = wc_get_order( $order_id );
+ $result = (array) WC_Checkoutcom_Api_Request::refund_payment( $order_id, $order );
+
+ // check if result has error and return error message.
+ if ( ! empty( $result['error'] ) ) {
+ WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'] );
+
+ return false;
+ }
+
+ // Set action id as woo transaction id.
+ $order->set_transaction_id( $result['action_id'] );
+ $order->update_meta_data( 'cko_payment_refunded', true );
+ $order->save();
+
+ if ( isset( $_SESSION['cko-refund-is-less'] ) ) {
+ if ( $_SESSION['cko-refund-is-less'] ) {
+ /* translators: %s: Action ID. */
+ $order->add_order_note( sprintf( __( 'Checkout.com Payment Partially refunded from Admin - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] ) );
+
+ unset( $_SESSION['cko-refund-is-less'] );
+
+ return true;
+ }
+ }
+
+ /* translators: %s: Action ID. */
+ $order->add_order_note( sprintf( __( 'Checkout.com Payment refunded from Admin - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] ) );
+
+ // when true is returned, status is changed to refunded automatically.
+ return true;
+ }
+
+ /**
+ * Enqueue scripts for CSR generation.
+ *
+ * @param string $hook Current admin page hook.
+ */
+ public function enqueue_csr_scripts( $hook ) {
+ // Only load on WooCommerce settings pages
+ if ( 'woocommerce_page_wc-settings' !== $hook ) {
+ return;
+ }
+
+ // Only load on Apple Pay settings page
+ if ( ! isset( $_GET['section'] ) || 'wc_checkout_com_apple_pay' !== $_GET['section'] ) {
+ return;
+ }
+
+ wp_enqueue_script(
+ 'cko-apple-pay-csr',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-csr.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-csr',
+ 'ckoCsrData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_generate_csr' ),
+ 'i18n' => [
+ 'generating' => __( 'Generating CSR...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'CSR generated successfully! Download starting...', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error generating CSR:', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue certificate upload script
+ wp_enqueue_script(
+ 'cko-apple-pay-certificate-upload',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-certificate-upload.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-certificate-upload',
+ 'ckoCertificateData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_upload_certificate' ),
+ 'i18n' => [
+ 'uploading' => __( 'Uploading certificate...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error uploading certificate:', 'checkout-com-unified-payments-api' ),
+ 'noFile' => __( 'Please select a certificate file (.cer) to upload.', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue merchant certificate generation script
+ wp_enqueue_script(
+ 'cko-apple-pay-merchant-certificate',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-merchant-certificate.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-merchant-certificate',
+ 'ckoMerchantCertificateData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_generate_merchant_certificate' ),
+ 'i18n' => [
+ 'generating' => __( 'Generating certificate and key...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Certificate and key generated successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error generating certificate and key:', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue domain association upload script
+ wp_enqueue_script(
+ 'cko-apple-pay-domain-association',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-domain-association.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-domain-association',
+ 'ckoDomainAssociationData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_upload_domain_association' ),
+ 'i18n' => [
+ 'uploading' => __( 'Uploading domain association file...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Domain association file uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error uploading domain association file:', 'checkout-com-unified-payments-api' ),
+ 'noFile' => __( 'Please select a domain association file (.txt) to upload.', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue merchant identity CSR script
+ wp_enqueue_script(
+ 'cko-apple-pay-merchant-identity-csr',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-merchant-identity-csr.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-merchant-identity-csr',
+ 'ckoMerchantIdentityCsrData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_generate_merchant_identity_csr' ),
+ 'i18n' => [
+ 'generating' => __( 'Generating CSR and key...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'CSR and key generated successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error generating CSR and key:', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue merchant identity certificate upload script
+ wp_enqueue_script(
+ 'cko-apple-pay-merchant-identity-certificate',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-merchant-identity-certificate.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-merchant-identity-certificate',
+ 'ckoMerchantIdentityCertificateData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_upload_merchant_identity_certificate' ),
+ 'i18n' => [
+ 'uploading' => __( 'Uploading and converting certificate...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Certificate uploaded and converted successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error uploading certificate:', 'checkout-com-unified-payments-api' ),
+ 'noFile' => __( 'Please select a certificate file (.cer) to upload.', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue test certificate script
+ wp_enqueue_script(
+ 'cko-apple-pay-test-certificate',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-test-certificate.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-test-certificate',
+ 'ckoTestCertificateData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_test_certificate' ),
+ 'i18n' => [
+ 'testing' => __( 'Testing certificate and key...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Certificate and key test successful!', 'checkout-com-unified-payments-api' ),
+ 'successDetails' => __( 'All paths and configurations are validated with Apple\'s services.', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Certificate and key test failed:', 'checkout-com-unified-payments-api' ),
+ 'errorDefault' => __( 'Test Failed. Please verify: 1. Your certificate paths are correct. 2. Your certificate has not expired. 3. You clicked "Verify" in your Apple Developer account for your domain.', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue custom CSS for Apple Pay settings page
+ wp_enqueue_style(
+ 'cko-apple-pay-settings',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/css/admin-apple-pay-settings.css',
+ [],
+ WC_CHECKOUTCOM_PLUGIN_VERSION
+ );
+
+ // Enqueue UX enhancements JavaScript
+ wp_enqueue_script(
+ 'cko-apple-pay-settings-ux',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-settings-ux.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+ }
+
+ /**
+ * AJAX handler for generating CSR.
+ */
+ public function ajax_generate_csr() {
+ // Log that the handler was called (for debugging)
+ if ( function_exists( 'WC_Checkoutcom_Utility' ) && method_exists( 'WC_Checkoutcom_Utility', 'logger' ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR AJAX Handler Called. POST data: ' . print_r( $_POST, true ),
+ null
+ );
+ }
+
+ // Verify nonce first
+ if ( ! isset( $_POST['nonce'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security token is missing. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'nonce_missing'
+ ] );
+ return;
+ }
+
+ if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_generate_csr' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'nonce_verification_failed'
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'insufficient_permissions'
+ ] );
+ }
+
+ // Get settings
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+
+ if ( empty( $core_settings['ckocom_sk'] ) ) {
+ wp_send_json_error( [ 'message' => __( 'Secret key is not configured. Please configure Checkout.com settings first.', 'checkout-com-unified-payments-api' ) ] );
+ }
+
+ $secret_key_raw = $core_settings['ckocom_sk'];
+ $environment = isset( $core_settings['ckocom_environment'] ) ? $core_settings['ckocom_environment'] : 'sandbox';
+ $account_type = isset( $core_settings['ckocom_account_type'] ) ? $core_settings['ckocom_account_type'] : 'ABC';
+ $region = isset( $core_settings['ckocom_region'] ) ? $core_settings['ckocom_region'] : 'global';
+ $protocol_version = isset( $_POST['protocol_version'] ) ? sanitize_text_field( $_POST['protocol_version'] ) : 'ec_v1';
+
+ // Check if NAS account
+ if ( function_exists( 'cko_is_nas_account' ) && cko_is_nas_account() ) {
+ $account_type = 'NAS';
+ }
+
+ // Build API URL
+ $base_url = 'https://api.checkout.com';
+ if ( 'sandbox' === $environment ) {
+ $base_url = 'https://api.sandbox.checkout.com';
+ }
+
+ // Add region subdomain if not global
+ if ( 'global' !== $region && ! empty( $region ) ) {
+ $base_url = str_replace( 'api.', $region . '.api.', $base_url );
+ }
+
+ $api_url = $base_url . '/applepay/signing-requests';
+
+ // Prepare authorization header
+ // Remove any existing "Bearer " prefix from the secret key
+ $secret_key_clean = str_replace( 'Bearer ', '', trim( $secret_key_raw ) );
+
+ // Apple Pay signing-requests endpoint authentication
+ // For NAS accounts, always use Bearer prefix
+ // For ABC accounts, try direct key first (as per other API calls in the codebase)
+ if ( 'NAS' === $account_type ) {
+ $auth_header = 'Bearer ' . $secret_key_clean;
+ } else {
+ // ABC accounts - try direct key first (no Bearer prefix)
+ // This matches how other ABC API calls work in the codebase
+ $auth_header = $secret_key_clean;
+ }
+
+ // Prepare request body
+ $request_body = [
+ 'protocol_version' => $protocol_version,
+ ];
+
+ // Always log request details for debugging (help diagnose Bad Request errors)
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR Generation Request: ' .
+ 'URL: ' . $api_url . ', ' .
+ 'Account Type: ' . $account_type . ', ' .
+ 'Environment: ' . $environment . ', ' .
+ 'Protocol Version: ' . $protocol_version . ', ' .
+ 'Auth Header Format: ' . ( strpos( $auth_header, 'Bearer' ) !== false ? 'Bearer' : 'Direct' ),
+ null
+ );
+
+ // Make API request
+ $response = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ // Check for errors
+ if ( is_wp_error( $response ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Error making API request:', 'checkout-com-unified-payments-api' ) . ' ' . $response->get_error_message(),
+ ] );
+ }
+
+ $response_code = wp_remote_retrieve_response_code( $response );
+ $response_body = wp_remote_retrieve_body( $response );
+
+ if ( 200 !== $response_code && 201 !== $response_code ) {
+ // Try to parse error message for better user feedback
+ $error_message = $response_body;
+ $error_data = json_decode( $response_body, true );
+
+ if ( $error_data && isset( $error_data['error_type'] ) ) {
+ $error_message = $error_data['error_type'];
+ if ( isset( $error_data['error_codes'] ) && is_array( $error_data['error_codes'] ) ) {
+ $error_message .= ': ' . implode( ', ', $error_data['error_codes'] );
+ }
+ if ( isset( $error_data['message'] ) ) {
+ $error_message .= ' - ' . $error_data['message'];
+ }
+ } elseif ( $error_data && isset( $error_data['message'] ) ) {
+ $error_message = $error_data['message'];
+ }
+
+ // If 401 (Unauthorized) or 400 (Bad Request), try with Bearer for ABC accounts
+ if ( ( 401 === $response_code || 400 === $response_code ) && 'ABC' === $account_type ) {
+ // Retry with Bearer prefix for ABC accounts
+ $auth_header_bearer = 'Bearer ' . $secret_key_clean;
+
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR Generation: Retrying with Bearer authentication for ABC account',
+ null
+ );
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header_bearer,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ // Success with Bearer, use this response
+ $response_code = $retry_code;
+ $response_body = $retry_body;
+ } else {
+ // Log detailed error for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR Generation Failed (both direct key and Bearer): ' .
+ 'Direct Key: ' . $response_code . ' - ' . $response_body . ', ' .
+ 'Bearer: ' . $retry_code . ' - ' . $retry_body,
+ null
+ );
+ }
+ }
+ }
+
+ // If still an error after retry, send error response
+ if ( 200 !== $response_code && 201 !== $response_code ) {
+ // Log detailed error for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR Generation Failed: ' . $response_code . ' - ' . $response_body .
+ ' | URL: ' . $api_url .
+ ' | Account Type: ' . $account_type .
+ ' | Environment: ' . $environment,
+ null
+ );
+
+ // For Bad Request (400), show full response to help diagnose
+ if ( 400 === $response_code ) {
+ $error_message = __( 'Bad Request. Please check your API credentials and account configuration.', 'checkout-com-unified-payments-api' );
+
+ // Try to extract specific error from response
+ if ( $error_data ) {
+ if ( isset( $error_data['error_codes'] ) && is_array( $error_data['error_codes'] ) ) {
+ $error_message .= ' Error codes: ' . implode( ', ', $error_data['error_codes'] );
+ }
+ if ( isset( $error_data['error_type'] ) ) {
+ $error_message .= ' Type: ' . $error_data['error_type'];
+ }
+ }
+ }
+
+ wp_send_json_error( [
+ 'message' => sprintf(
+ /* translators: 1: Response code, 2: Error message */
+ __( 'API request failed (HTTP %1$s). %2$s', 'checkout-com-unified-payments-api' ),
+ $response_code,
+ $error_message
+ ),
+ 'details' => $response_body, // Include full response for debugging
+ 'debug_info' => [
+ 'url' => $api_url,
+ 'account_type' => $account_type,
+ 'environment' => $environment,
+ 'secret_key_prefix' => substr( $secret_key_clean, 0, 10 ) . '...', // First 10 chars for debugging (safe)
+ ],
+ ] );
+ }
+ }
+
+ // Parse response
+ $response_data = json_decode( $response_body, true );
+
+ if ( ! isset( $response_data['content'] ) || empty( $response_data['content'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Invalid response from API. Content field is missing.', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ // Get CSR content
+ $csr_content = $response_data['content'];
+
+ // Ensure CSR content is properly formatted
+ if ( false === strpos( $csr_content, '-----BEGIN CERTIFICATE REQUEST-----' ) ) {
+ $csr_content = "-----BEGIN CERTIFICATE REQUEST-----\n" . $csr_content . "\n-----END CERTIFICATE REQUEST-----";
+ }
+
+ // Return CSR content for download
+ wp_send_json_success( [
+ 'csr_content' => $csr_content,
+ 'filename' => 'cko.csr',
+ ] );
+ }
+
+ /**
+ * AJAX handler for uploading Apple Pay certificate.
+ */
+ public function ajax_upload_certificate() {
+ // Log that the handler was called (for debugging)
+ if ( function_exists( 'WC_Checkoutcom_Utility' ) && method_exists( 'WC_Checkoutcom_Utility', 'logger' ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload AJAX Handler Called. POST data: ' . print_r( $_POST, true ),
+ null
+ );
+ }
+
+ // Verify nonce first
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_upload_certificate' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'nonce_verification_failed'
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'insufficient_permissions'
+ ] );
+ }
+
+ // Get certificate from POST data
+ if ( ! isset( $_POST['certificate'] ) || empty( $_POST['certificate'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Certificate data is missing. Please select a certificate file and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ $certificate_base64_raw = wp_unslash( $_POST['certificate'] );
+
+ // The certificate from Apple is in DER format (binary)
+ // JavaScript FileReader already converts it to base64
+ // According to Checkout.com docs: "Encode the apple_pay.cer in base64"
+ // The command they mention: openssl x509 -inform der -in apple_pay.cer -out base64_converted.cer
+ // This converts DER to PEM format (base64 with headers)
+ // But the API likely expects just the base64 content (PEM without headers)
+
+ // Decode base64 to get DER binary
+ $certificate_der = base64_decode( $certificate_base64_raw, true );
+
+ if ( false === $certificate_der ) {
+ wp_send_json_error( [
+ 'message' => __( 'Invalid certificate format. Could not decode base64 certificate.', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ // Convert DER to PEM format, then extract base64 content
+ $certificate_final = false;
+
+ // Try using OpenSSL PHP functions first
+ if ( function_exists( 'openssl_x509_read' ) ) {
+ $cert_resource = @openssl_x509_read( $certificate_der );
+ if ( false !== $cert_resource ) {
+ $pem_output = '';
+ @openssl_x509_export( $cert_resource, $pem_output );
+ if ( ! empty( $pem_output ) ) {
+ // Extract base64 from PEM (remove headers and whitespace)
+ $certificate_final = preg_replace( '/-----BEGIN CERTIFICATE-----|-----END CERTIFICATE-----|\s/', '', $pem_output );
+ }
+ }
+ }
+
+ // Fallback: use shell command to convert DER to PEM
+ if ( false === $certificate_final && function_exists( 'shell_exec' ) ) {
+ $temp_der = tmpfile();
+ $temp_pem = tmpfile();
+
+ if ( $temp_der && $temp_pem ) {
+ $temp_der_path = stream_get_meta_data( $temp_der )['uri'];
+ $temp_pem_path = stream_get_meta_data( $temp_pem )['uri'];
+
+ file_put_contents( $temp_der_path, $certificate_der );
+
+ // Convert DER to PEM: openssl x509 -inform der -in cert.cer -out cert.pem
+ @shell_exec( sprintf( 'openssl x509 -inform der -in %s -out %s 2>&1', escapeshellarg( $temp_der_path ), escapeshellarg( $temp_pem_path ) ) );
+
+ if ( file_exists( $temp_pem_path ) && filesize( $temp_pem_path ) > 0 ) {
+ $pem_content = file_get_contents( $temp_pem_path );
+ // Extract base64 from PEM (remove headers and whitespace)
+ $certificate_final = preg_replace( '/-----BEGIN CERTIFICATE-----|-----END CERTIFICATE-----|\s/', '', $pem_content );
+ }
+
+ fclose( $temp_der );
+ fclose( $temp_pem );
+ }
+ }
+
+ // Final fallback: clean the original base64 (remove any whitespace)
+ if ( false === $certificate_final ) {
+ $certificate_final = preg_replace( '/\s/', '', $certificate_base64_raw );
+ }
+
+ // Get settings
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+
+ if ( empty( $core_settings['ckocom_sk'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Secret key is not configured. Please configure Checkout.com settings first.', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ $secret_key_raw = $core_settings['ckocom_sk'];
+ $environment = isset( $core_settings['ckocom_environment'] ) ? $core_settings['ckocom_environment'] : 'sandbox';
+ $account_type = isset( $core_settings['ckocom_account_type'] ) ? $core_settings['ckocom_account_type'] : 'ABC';
+ $region = isset( $core_settings['ckocom_region'] ) ? $core_settings['ckocom_region'] : 'global';
+
+ // Check if NAS account
+ if ( function_exists( 'cko_is_nas_account' ) && cko_is_nas_account() ) {
+ $account_type = 'NAS';
+ }
+
+ // Build API URL
+ $base_url = 'https://api.checkout.com';
+ if ( 'sandbox' === $environment ) {
+ $base_url = 'https://api.sandbox.checkout.com';
+ }
+
+ // Add region subdomain if not global
+ if ( 'global' !== $region && ! empty( $region ) ) {
+ $base_url = str_replace( 'api.', $region . '.api.', $base_url );
+ }
+
+ $api_url = $base_url . '/applepay/certificates';
+
+ // Prepare authorization header
+ $secret_key_clean = str_replace( 'Bearer ', '', trim( $secret_key_raw ) );
+
+ if ( 'NAS' === $account_type ) {
+ $auth_header = 'Bearer ' . $secret_key_clean;
+ } else {
+ // ABC accounts - try direct key first
+ $auth_header = $secret_key_clean;
+ }
+
+ // Prepare request body - According to Checkout.com docs:
+ // "Encode the apple_pay.cer in base64 using: openssl x509 -inform der -in apple_pay.cer -out base64_converted.cer"
+ // The command converts DER to PEM, but the API might expect:
+ // Option 1: Raw DER certificate in base64 (what JavaScript FileReader already provides)
+ // Option 2: PEM format (converted from DER)
+ // Option 3: Base64 content from PEM (without headers)
+
+ // Clean the base64 from JavaScript (remove any whitespace)
+ $certificate_clean_base64 = preg_replace( '/\s/', '', $certificate_base64_raw );
+
+ // Try format 1: Raw DER in base64 with field name "certificate"
+ // The API might expect different field names or structures
+ // Based on CSR response format {"content": "..."}, maybe upload expects different structure
+ $request_body = [
+ 'certificate' => $certificate_clean_base64,
+ ];
+
+ // Also prepare alternative structures for fallback
+ $request_body_alternatives = [
+ // Alternative 1: Using "content" field (like CSR response)
+ [ 'content' => $certificate_clean_base64 ],
+ // Alternative 2: Using "certificate_data"
+ [ 'certificate_data' => $certificate_clean_base64 ],
+ // Alternative 3: Nested structure
+ [ 'certificate' => [ 'content' => $certificate_clean_base64 ] ],
+ ];
+
+ // Also prepare PEM format for fallback
+ $pem_with_headers = false;
+ if ( function_exists( 'openssl_x509_read' ) ) {
+ $cert_resource = @openssl_x509_read( $certificate_der );
+ if ( false !== $cert_resource ) {
+ @openssl_x509_export( $cert_resource, $pem_with_headers );
+ }
+ }
+
+ // Extract base64 from PEM if we have it
+ $pem_base64_content = false;
+ if ( false !== $pem_with_headers && ! empty( $pem_with_headers ) ) {
+ $pem_base64_content = preg_replace( '/-----BEGIN CERTIFICATE-----|-----END CERTIFICATE-----|\s/', '', $pem_with_headers );
+ }
+
+ // Log request details for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Request: ' .
+ 'URL: ' . $api_url . ', ' .
+ 'Account Type: ' . $account_type . ', ' .
+ 'Environment: ' . $environment . ', ' .
+ 'Auth Header Format: ' . ( strpos( $auth_header, 'Bearer' ) !== false ? 'Bearer' : 'Direct' ) . ', ' .
+ 'Certificate Length: ' . strlen( $request_body['certificate'] ) . ', ' .
+ 'Certificate First 100 chars: ' . substr( $request_body['certificate'], 0, 100 ) . ', ' .
+ 'Certificate Format: ' . ( strpos( $request_body['certificate'], 'BEGIN' ) !== false ? 'PEM with headers' : 'Base64' ) . ', ' .
+ 'Request Body Structure: ' . json_encode( [ 'certificate' => substr( $request_body['certificate'], 0, 100 ) . '...' ] ),
+ null
+ );
+
+ // Make API request
+ $response = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ // Check for errors
+ if ( is_wp_error( $response ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Error making API request:', 'checkout-com-unified-payments-api' ) . ' ' . $response->get_error_message(),
+ ] );
+ }
+
+ $response_code = wp_remote_retrieve_response_code( $response );
+ $response_body = wp_remote_retrieve_body( $response );
+
+ if ( 200 !== $response_code && 201 !== $response_code ) {
+ // Log the actual request body for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Failed - Request Body: ' . json_encode( $request_body, JSON_UNESCAPED_SLASHES ),
+ null
+ );
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Failed - Response: ' . $response_code . ' - ' . $response_body,
+ null
+ );
+
+ // If 422, try alternative formats and structures
+ if ( 422 === $response_code ) {
+ // Try alternative request body structures first
+ foreach ( $request_body_alternatives as $index => $alt_body ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload: Retrying with alternative structure #' . ( $index + 1 ) . ': ' . json_encode( [ 'field' => array_keys( $alt_body )[0] ] ),
+ null
+ );
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $alt_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+ }
+ }
+
+ // Try format 2: PEM base64 content (without headers)
+ if ( false !== $pem_base64_content && ! empty( $pem_base64_content ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload: Retrying with PEM base64 content (without headers)',
+ null
+ );
+
+ $request_body_retry = [
+ 'certificate' => $pem_base64_content,
+ ];
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body_retry ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+ }
+ }
+
+ // Try format 3: Full PEM format (with headers)
+ if ( false !== $pem_with_headers && ! empty( $pem_with_headers ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload: Retrying with full PEM format (with headers)',
+ null
+ );
+
+ $request_body_retry = [
+ 'certificate' => $pem_with_headers,
+ ];
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body_retry ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+ }
+ }
+ }
+
+ // Try to parse error message
+ $error_message = $response_body;
+ $error_data = json_decode( $response_body, true );
+
+ // Log full error details
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload - Full Error Data: ' . print_r( $error_data, true ),
+ null
+ );
+
+ if ( $error_data && isset( $error_data['error_type'] ) ) {
+ $error_message = $error_data['error_type'];
+ if ( isset( $error_data['error_codes'] ) && is_array( $error_data['error_codes'] ) ) {
+ $error_message .= ': ' . implode( ', ', $error_data['error_codes'] );
+
+ // Log individual error codes for debugging
+ foreach ( $error_data['error_codes'] as $error_code ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload - Error Code: ' . $error_code,
+ null
+ );
+ }
+ }
+ if ( isset( $error_data['message'] ) ) {
+ $error_message .= ' - ' . $error_data['message'];
+ }
+ // Check for additional error details
+ if ( isset( $error_data['details'] ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload - Error Details: ' . print_r( $error_data['details'], true ),
+ null
+ );
+ }
+ } elseif ( $error_data && isset( $error_data['message'] ) ) {
+ $error_message = $error_data['message'];
+ }
+
+ // If 401 (Unauthorized) or 400 (Bad Request), try with Bearer for ABC accounts
+ if ( ( 401 === $response_code || 400 === $response_code ) && 'ABC' === $account_type ) {
+ // Retry with Bearer prefix for ABC accounts
+ $auth_header_bearer = 'Bearer ' . $secret_key_clean;
+
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload: Retrying with Bearer authentication for ABC account',
+ null
+ );
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header_bearer,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ // Success with Bearer
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ } else {
+ // Log detailed error for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Failed (both direct key and Bearer): ' .
+ 'Direct Key: ' . $response_code . ' - ' . $response_body . ', ' .
+ 'Bearer: ' . $retry_code . ' - ' . $retry_body,
+ null
+ );
+ }
+ }
+ }
+
+ // Log detailed error for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Failed: ' . $response_code . ' - ' . $response_body .
+ ' | URL: ' . $api_url .
+ ' | Account Type: ' . $account_type .
+ ' | Environment: ' . $environment,
+ null
+ );
+
+ // Build detailed error message
+ $detailed_error = $error_message;
+ if ( $error_data ) {
+ if ( isset( $error_data['error_codes'] ) && is_array( $error_data['error_codes'] ) ) {
+ $detailed_error .= ' Error codes: ' . implode( ', ', $error_data['error_codes'] );
+ }
+ if ( isset( $error_data['details'] ) ) {
+ $detailed_error .= ' Details: ' . ( is_array( $error_data['details'] ) ? json_encode( $error_data['details'] ) : $error_data['details'] );
+ }
+ }
+
+ wp_send_json_error( [
+ 'message' => sprintf(
+ /* translators: 1: Response code, 2: Error message */
+ __( 'API request failed (HTTP %1$s). %2$s', 'checkout-com-unified-payments-api' ),
+ $response_code,
+ $detailed_error
+ ),
+ 'details' => $response_body,
+ 'error_data' => $error_data,
+ 'debug_info' => [
+ 'url' => $api_url,
+ 'account_type' => $account_type,
+ 'environment' => $environment,
+ 'certificate_length' => strlen( $request_body['certificate'] ),
+ 'certificate_format' => 'DER base64',
+ ],
+ ] );
+ return;
+ }
+
+ // Success
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Success: ' . $response_body,
+ null
+ );
+
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ /**
+ * AJAX handler for generating merchant certificate and private key.
+ * Generates a self-signed certificate and private key pair for Apple Pay merchant validation.
+ *
+ * @return void
+ */
+ public function ajax_generate_merchant_certificate() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_generate_merchant_certificate' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Check if doing AJAX
+ if ( ! wp_doing_ajax() ) {
+ wp_send_json_error( [
+ 'message' => __( 'Invalid request. This action must be performed via AJAX.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Check if OpenSSL is available
+ if ( ! function_exists( 'openssl_pkey_new' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'OpenSSL is not available on this server. Please contact your hosting provider to enable OpenSSL.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get site domain for certificate subject
+ $site_domain = parse_url( home_url(), PHP_URL_HOST );
+ if ( empty( $site_domain ) ) {
+ $site_domain = 'example.com';
+ }
+
+ // Generate certificate configuration
+ $config = [
+ 'digest_alg' => 'sha256',
+ 'private_key_bits' => 2048,
+ 'private_key_type' => OPENSSL_KEYTYPE_RSA,
+ 'x509_extensions' => 'v3_req',
+ ];
+
+ // Create certificate subject
+ $dn = [
+ 'countryName' => 'US',
+ 'stateOrProvinceName' => 'State',
+ 'localityName' => 'City',
+ 'organizationName' => get_bloginfo( 'name' ),
+ 'organizationalUnitName' => 'Apple Pay',
+ 'commonName' => $site_domain,
+ 'emailAddress' => get_option( 'admin_email', 'admin@example.com' ),
+ ];
+
+ // Generate private key
+ $private_key = openssl_pkey_new( $config );
+ if ( false === $private_key ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to generate private key. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Generate certificate signing request
+ $csr = openssl_csr_new( $dn, $private_key, $config );
+ if ( false === $csr ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to generate certificate signing request. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Sign the certificate (self-signed, valid for 1 year)
+ $cert = openssl_csr_sign( $csr, null, $private_key, 365, $config, time() );
+ if ( false === $cert ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to sign certificate. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Export certificate to PEM format
+ $certificate_pem = '';
+ if ( ! openssl_x509_export( $cert, $certificate_pem ) ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to export certificate. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Export private key to PEM format
+ $private_key_pem = '';
+ if ( ! openssl_pkey_export( $private_key, $private_key_pem ) ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to export private key. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Return certificate and private key as base64 for download
+ wp_send_json_success( [
+ 'message' => __( 'Certificate and private key generated successfully!', 'checkout-com-unified-payments-api' ),
+ 'certificate' => base64_encode( $certificate_pem ),
+ 'private_key' => base64_encode( $private_key_pem ),
+ 'certificate_filename' => 'apple-pay-merchant-certificate.pem',
+ 'private_key_filename' => 'apple-pay-merchant-private-key.key',
+ ] );
+ }
+
+ /**
+ * Get the correct .well-known directory path based on server configuration.
+ * Detects Bitnami installations and uses the Let's Encrypt path.
+ *
+ * @return array Array with 'dir' (directory path) and 'is_bitnami' (boolean).
+ */
+ private function get_well_known_path() {
+ // Check if this is a Bitnami installation
+ $is_bitnami = file_exists( '/opt/bitnami/apps/letsencrypt/.well-known' ) ||
+ file_exists( '/opt/bitnami/apps/letsencrypt' ) ||
+ ( defined( 'ABSPATH' ) && strpos( ABSPATH, '/opt/bitnami/' ) !== false );
+
+ if ( $is_bitnami && file_exists( '/opt/bitnami/apps/letsencrypt/.well-known' ) ) {
+ // Bitnami uses Let's Encrypt directory for .well-known
+ return array(
+ 'dir' => '/opt/bitnami/apps/letsencrypt/.well-known',
+ 'is_bitnami' => true,
+ );
+ }
+
+ // Standard WordPress installation
+ return array(
+ 'dir' => ABSPATH . '.well-known',
+ 'is_bitnami' => false,
+ );
+ }
+
+ /**
+ * AJAX handler for uploading domain association file.
+ */
+ public function ajax_upload_domain_association() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_upload_domain_association' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get file content from POST data
+ if ( ! isset( $_POST['file_content'] ) || empty( $_POST['file_content'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'File content is missing. Please select a domain association file and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $file_content = wp_unslash( $_POST['file_content'] );
+
+ // Get the correct .well-known directory path
+ $well_known_info = $this->get_well_known_path();
+ $well_known_dir = $well_known_info['dir'];
+ $is_bitnami = $well_known_info['is_bitnami'];
+
+ // Create .well-known directory if it doesn't exist
+ if ( ! file_exists( $well_known_dir ) ) {
+ if ( $is_bitnami ) {
+ // For Bitnami, try to create with sudo permissions (user will need to do this manually if it fails)
+ if ( ! wp_mkdir_p( $well_known_dir ) && ! is_dir( $well_known_dir ) ) {
+ wp_send_json_error( [
+ 'message' => sprintf(
+ __( 'Failed to create .well-known directory at %s. For Bitnami installations, you may need to create it manually via SSH: sudo mkdir -p %s && sudo chmod 755 %s', 'checkout-com-unified-payments-api' ),
+ $well_known_dir,
+ $well_known_dir,
+ $well_known_dir
+ ),
+ ] );
+ return;
+ }
+ } else {
+ if ( ! wp_mkdir_p( $well_known_dir ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to create .well-known directory. Please check file permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+ }
+ }
+
+ // Apple now requires the file to have .txt extension
+ // Save file to .well-known/apple-developer-merchantid-domain-association.txt
+ $file_path = $well_known_dir . '/apple-developer-merchantid-domain-association.txt';
+ $file_saved = file_put_contents( $file_path, $file_content );
+
+ if ( false === $file_saved ) {
+ wp_send_json_error( [
+ 'message' => sprintf(
+ __( 'Failed to save domain association file to %s. Please check file permissions. For Bitnami, you may need to set permissions manually: sudo chmod 644 %s', 'checkout-com-unified-payments-api' ),
+ $file_path,
+ $file_path
+ ),
+ ] );
+ return;
+ }
+
+ // Set appropriate file permissions
+ @chmod( $file_path, 0644 );
+
+ // For non-Bitnami installations, ensure .well-known directory is accessible
+ if ( ! $is_bitnami ) {
+ $this->ensure_well_known_accessible();
+ }
+
+ // Also save without .txt extension for backward compatibility (if not Bitnami)
+ if ( ! $is_bitnami ) {
+ $file_path_no_ext = $well_known_dir . '/apple-developer-merchantid-domain-association';
+ file_put_contents( $file_path_no_ext, $file_content );
+ @chmod( $file_path_no_ext, 0644 );
+ }
+
+ wp_send_json_success( [
+ 'message' => __( 'Domain association file uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ 'file_path' => $file_path,
+ 'file_url' => home_url( '/.well-known/apple-developer-merchantid-domain-association.txt' ),
+ 'is_bitnami' => $is_bitnami,
+ ] );
+ }
+
+ /**
+ * AJAX handler for generating Merchant Identity CSR and private key.
+ */
+ public function ajax_generate_merchant_identity_csr() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_generate_merchant_identity_csr' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Check if OpenSSL is available
+ if ( ! function_exists( 'openssl_pkey_new' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'OpenSSL is not available on this server. Please contact your hosting provider to enable OpenSSL.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get site domain for certificate subject
+ $site_domain = parse_url( home_url(), PHP_URL_HOST );
+ if ( empty( $site_domain ) ) {
+ $site_domain = 'example.com';
+ }
+
+ // Generate certificate configuration
+ $config = [
+ 'digest_alg' => 'sha256',
+ 'private_key_bits' => 2048,
+ 'private_key_type' => OPENSSL_KEYTYPE_RSA,
+ ];
+
+ // Create certificate subject
+ $dn = [
+ 'countryName' => 'US',
+ 'stateOrProvinceName' => 'State',
+ 'localityName' => 'City',
+ 'organizationName' => get_bloginfo( 'name' ),
+ 'organizationalUnitName' => 'Apple Pay',
+ 'commonName' => $site_domain,
+ 'emailAddress' => get_option( 'admin_email', 'admin@example.com' ),
+ ];
+
+ // Generate private key
+ $private_key = openssl_pkey_new( $config );
+ if ( false === $private_key ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to generate private key. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Generate certificate signing request
+ $csr = openssl_csr_new( $dn, $private_key, $config );
+ if ( false === $csr ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to generate certificate signing request. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Export CSR to PEM format
+ $csr_pem = '';
+ if ( ! openssl_csr_export( $csr, $csr_pem ) ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to export CSR. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Export private key to PEM format
+ $private_key_pem = '';
+ if ( ! openssl_pkey_export( $private_key, $private_key_pem ) ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to export private key. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Save private key file on server
+ $upload_dir = wp_upload_dir();
+ if ( $upload_dir['error'] ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to access uploads directory.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $certificate_dir = $upload_dir['basedir'] . '/checkout-com-apple-pay';
+ if ( ! file_exists( $certificate_dir ) ) {
+ wp_mkdir_p( $certificate_dir );
+ }
+
+ // Save key file on server
+ $key_file = $certificate_dir . '/certificate_sandbox.key';
+ $key_saved = file_put_contents( $key_file, $private_key_pem );
+
+ if ( false === $key_saved ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to save private key file on server. Please check file permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Set appropriate file permissions (readable only by owner)
+ chmod( $key_file, 0600 );
+
+ // Return CSR and private key as base64 for download, and also return server paths
+ wp_send_json_success( [
+ 'message' => __( 'CSR and private key generated successfully! Both files have been saved on your server.', 'checkout-com-unified-payments-api' ),
+ 'csr' => base64_encode( $csr_pem ),
+ 'private_key' => base64_encode( $private_key_pem ),
+ 'csr_filename' => 'uploadMe.csr',
+ 'private_key_filename' => 'certificate_sandbox.key',
+ 'key_file_path' => $key_file,
+ 'key_file_url' => $upload_dir['baseurl'] . '/checkout-com-apple-pay/certificate_sandbox.key',
+ ] );
+ }
+
+ /**
+ * AJAX handler for uploading and converting Merchant Identity certificate.
+ */
+ public function ajax_upload_merchant_identity_certificate() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_upload_merchant_identity_certificate' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get certificate from POST data
+ if ( ! isset( $_POST['certificate'] ) || empty( $_POST['certificate'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Certificate data is missing. Please select a certificate file and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $certificate_base64 = wp_unslash( $_POST['certificate'] );
+
+ // Decode base64 to get DER format
+ $certificate_der = base64_decode( $certificate_base64 );
+ if ( false === $certificate_der ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to decode certificate. Please ensure the file is valid.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Convert DER to PEM format
+ $certificate_pem = '';
+ if ( function_exists( 'openssl_x509_read' ) ) {
+ // Try to read the certificate from DER format
+ $cert = openssl_x509_read( $certificate_der );
+ if ( false !== $cert ) {
+ openssl_x509_export( $cert, $certificate_pem );
+ }
+ }
+
+ // Fallback to shell command if PHP function fails
+ if ( empty( $certificate_pem ) ) {
+ // Create temporary DER file
+ $temp_der = sys_get_temp_dir() . '/' . uniqid( 'cert_' ) . '.der';
+ file_put_contents( $temp_der, $certificate_der );
+
+ // Convert using openssl command
+ $command = 'openssl x509 -inform DER -in ' . escapeshellarg( $temp_der ) . ' -outform PEM';
+ $certificate_pem = shell_exec( $command );
+
+ // Clean up temp file
+ @unlink( $temp_der );
+ }
+
+ if ( empty( $certificate_pem ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to convert certificate from DER to PEM format. Please ensure OpenSSL is available.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Save certificate to WordPress uploads directory
+ $upload_dir = wp_upload_dir();
+ if ( $upload_dir['error'] ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to access uploads directory.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $certificate_dir = $upload_dir['basedir'] . '/checkout-com-apple-pay';
+ if ( ! file_exists( $certificate_dir ) ) {
+ wp_mkdir_p( $certificate_dir );
+ }
+
+ // Save as certificate_sandbox.pem to match the key file name
+ $certificate_file = $certificate_dir . '/certificate_sandbox.pem';
+ $file_saved = file_put_contents( $certificate_file, $certificate_pem );
+
+ if ( false === $file_saved ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to save certificate file. Please check file permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Set appropriate file permissions
+ chmod( $certificate_file, 0600 );
+
+ // Check if key file exists from previous step
+ $key_file = $certificate_dir . '/certificate_sandbox.key';
+ $key_file_exists = file_exists( $key_file );
+
+ $response_data = [
+ 'message' => __( 'Certificate uploaded and converted successfully! Both files are now saved on your server.', 'checkout-com-unified-payments-api' ),
+ 'certificate_path' => $certificate_file,
+ 'key_path' => $key_file_exists ? $key_file : null,
+ ];
+
+ if ( $key_file_exists ) {
+ $response_data['message'] = __( 'Certificate uploaded and converted successfully! Both certificate (.pem) and key (.key) files are now saved on your server.', 'checkout-com-unified-payments-api' );
+ } else {
+ $response_data['message'] = __( 'Certificate uploaded and converted successfully! The certificate (.pem) file is saved. Make sure the key (.key) file from Step 1 is also saved on your server.', 'checkout-com-unified-payments-api' );
+ }
+
+ wp_send_json_success( $response_data );
+ }
+
+ /**
+ * AJAX handler for testing Apple Pay certificate and key.
+ */
+ public function ajax_test_certificate() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_test_certificate' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get settings
+ $apple_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', [] );
+
+ $merchant_id = isset( $apple_settings['ckocom_apple_mercahnt_id'] ) ? $apple_settings['ckocom_apple_mercahnt_id'] : '';
+ $domain_name = isset( $apple_settings['apple_pay_domain_name'] ) ? $apple_settings['apple_pay_domain_name'] : '';
+ $display_name = isset( $apple_settings['apple_pay_display_name'] ) ? $apple_settings['apple_pay_display_name'] : '';
+ $certificate_path = isset( $apple_settings['ckocom_apple_certificate'] ) ? $apple_settings['ckocom_apple_certificate'] : '';
+ $key_path = isset( $apple_settings['ckocom_apple_key'] ) ? $apple_settings['ckocom_apple_key'] : '';
+
+ // Validate required fields
+ if ( empty( $merchant_id ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Merchant Identifier is required. Please configure it in the Apple Pay Configuration section.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( empty( $domain_name ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Domain Name is required. Please configure it in the Apple Pay Configuration section.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( empty( $display_name ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Display Name is required. Please configure it in the Apple Pay Configuration section.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( empty( $certificate_path ) || ! file_exists( $certificate_path ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Certificate file not found. Please ensure the certificate path is correct and the file exists.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( empty( $key_path ) || ! file_exists( $key_path ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Private key file not found. Please ensure the key path is correct and the file exists.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Prepare request data
+ $request_data = [
+ 'merchantIdentifier' => $merchant_id,
+ 'displayName' => $display_name,
+ 'domainName' => $domain_name,
+ ];
+
+ // Make request to Apple Pay payment session endpoint
+ $api_url = 'https://apple-pay-gateway.apple.com/paymentservices/paymentSession';
+
+ // Use cURL for certificate-based authentication
+ $ch = curl_init();
+ curl_setopt( $ch, CURLOPT_URL, $api_url );
+ curl_setopt( $ch, CURLOPT_POST, true );
+ curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode( $request_data ) );
+ curl_setopt( $ch, CURLOPT_SSLCERT, $certificate_path );
+ curl_setopt( $ch, CURLOPT_SSLKEY, $key_path );
+ curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
+ curl_setopt( $ch, CURLOPT_VERBOSE, true );
+ curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, true );
+ curl_setopt( $ch, CURLOPT_HTTPHEADER, [
+ 'Content-Type: application/json',
+ ] );
+
+ $response = curl_exec( $ch );
+ $http_code = curl_getinfo( $ch, CURLINFO_HTTP_CODE );
+ $curl_error = curl_error( $ch );
+ curl_close( $ch );
+
+ if ( ! empty( $curl_error ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'cURL error: ', 'checkout-com-unified-payments-api' ) . $curl_error,
+ ] );
+ return;
+ }
+
+ // Check response
+ if ( 200 === $http_code ) {
+ // Simplified success message - don't return full JSON response
+ wp_send_json_success( [
+ 'message' => __( 'Certificate and key test successful! All paths and configurations are validated with Apple\'s services.', 'checkout-com-unified-payments-api' ),
+ ] );
+ } else {
+ // Simplified error message with actionable guidance
+ $error_message = __( 'Test Failed. Please verify:', 'checkout-com-unified-payments-api' );
+ $error_message .= '\n";
+ $htaccess_content .= "RewriteEngine On\n";
+ $htaccess_content .= "RewriteRule ^apple-developer-merchantid-domain-association$ - [L]\n";
+ $htaccess_content .= " \n";
+
+ // Only write if file doesn't exist or doesn't have our rule
+ if ( ! file_exists( $htaccess_file ) || strpos( file_get_contents( $htaccess_file ), 'apple-developer-merchantid-domain-association' ) === false ) {
+ file_put_contents( $htaccess_file, $htaccess_content );
+ chmod( $htaccess_file, 0644 );
+ }
+
+ // Also check main .htaccess and add rule if needed (before WordPress rules)
+ $main_htaccess = ABSPATH . '.htaccess';
+ if ( file_exists( $main_htaccess ) ) {
+ $main_htaccess_content = file_get_contents( $main_htaccess );
+
+ // Check if .well-known rule already exists
+ if ( strpos( $main_htaccess_content, '# BEGIN Allow .well-known' ) === false ) {
+ // Add rule before WordPress rules
+ $well_known_rule = "\n# BEGIN Allow .well-known\n";
+ $well_known_rule .= "\n";
+ $well_known_rule .= "RewriteEngine On\n";
+ $well_known_rule .= "RewriteRule ^\.well-known/ - [L]\n";
+ $well_known_rule .= " \n";
+ $well_known_rule .= "# END Allow .well-known\n";
+
+ // Insert before # BEGIN WordPress if it exists
+ if ( strpos( $main_htaccess_content, '# BEGIN WordPress' ) !== false ) {
+ $main_htaccess_content = str_replace( '# BEGIN WordPress', $well_known_rule . "\n# BEGIN WordPress", $main_htaccess_content );
+ } else {
+ // If no WordPress section, add at the beginning
+ $main_htaccess_content = $well_known_rule . "\n" . $main_htaccess_content;
+ }
+
+ file_put_contents( $main_htaccess, $main_htaccess_content );
+ }
+ }
+ }
+}
diff --git a/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-cards.php b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-cards.php
new file mode 100644
index 00000000..99432d87
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-cards.php
@@ -0,0 +1,1172 @@
+id = 'wc_checkout_com_cards';
+ $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' );
+ $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' );
+ $this->title = __( 'Cards payment and general configuration', 'checkout-com-unified-payments-api' );
+ $this->has_fields = true;
+ $this->supports = [
+ 'products',
+ 'refunds',
+ 'tokenization',
+ 'subscriptions',
+ 'subscription_cancellation',
+ 'subscription_suspension',
+ 'subscription_reactivation',
+ 'subscription_amount_changes',
+ 'subscription_date_changes',
+ 'subscription_payment_method_change',
+ 'subscription_payment_method_change_customer',
+ 'subscription_payment_method_change_admin',
+ 'multiple_subscriptions',
+ ];
+
+ $this->new_method_label = __( 'Use a new card', 'checkout-com-unified-payments-api' );
+
+ $this->init_form_fields();
+ $this->init_settings();
+
+ // Turn these settings into variables we can use.
+ foreach ( $this->settings as $setting_key => $value ) {
+ $this->$setting_key = $value;
+ }
+
+ add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] );
+
+ // Redirection hook.
+ add_action( 'woocommerce_api_wc_checkoutcom_callback', [ $this, 'callback_handler' ] );
+
+ // Webhook handler hook - only register if not in Flow mode
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = $core_settings['ckocom_checkout_mode'] ?? 'classic';
+
+ if ( 'flow' !== $checkout_mode ) {
+ add_action( 'woocommerce_api_wc_checkoutcom_webhook', [ $this, 'webhook_handler' ] );
+ }
+
+ // Payment scripts.
+ add_action( 'wp_enqueue_scripts', [ $this, 'payment_scripts' ] );
+
+ // Meta field on subscription edit.
+ add_filter( 'woocommerce_subscription_payment_meta', [ $this, 'add_payment_meta_field' ], 10, 2 );
+ }
+
+ /**
+ * Add subscription order payment meta field.
+ *
+ * @param array $payment_meta associative array of meta data required for automatic payments.
+ * @param WC_Subscription $subscription An instance of a subscription object.
+ * @return array
+ */
+ public function add_payment_meta_field( $payment_meta, $subscription ) {
+ $source_id = $subscription->get_meta( '_cko_source_id' );
+
+ $payment_meta[ $this->id ] = [
+ 'post_meta' => [
+ '_cko_source_id' => [
+ 'value' => $source_id,
+ 'label' => 'Checkout.com Card Source ID',
+ ],
+ ],
+ ];
+
+ return $payment_meta;
+ }
+
+ /**
+ * Outputs scripts used for checkout payment.
+ */
+ public function payment_scripts() {
+
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $card_pay_enabled = ! empty( $core_settings['enabled'] ) && 'yes' === $core_settings['enabled'];
+ $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
+
+ // Return if card payment is disabled.
+ if ( ! $card_pay_enabled ) {
+ return;
+ }
+
+ // Load on Cart, Checkout, pay for order or add payment method pages.
+ if ( ! is_cart() && ! is_checkout() && ! isset( $_GET['pay_for_order'] ) && ! is_add_payment_method_page() ) {
+ return;
+ }
+
+ if ( is_wc_endpoint_url( 'order-received' ) ) {
+ return;
+ }
+
+ // Styles.
+ if ( WC_Admin_Settings::get_option( 'ckocom_iframe_style', '0' ) ) {
+ wp_register_style( 'frames_style', WC_CHECKOUTCOM_PLUGIN_URL . '/assets/css/multi-iframe.css', [], WC_CHECKOUTCOM_PLUGIN_VERSION );
+ } else {
+ wp_register_style( 'frames_style', WC_CHECKOUTCOM_PLUGIN_URL . '/assets/css/style.css', [], WC_CHECKOUTCOM_PLUGIN_VERSION );
+ }
+
+ wp_enqueue_style( 'frames_style' );
+
+ // Scripts.
+ wp_register_script( 'cko-frames-script', 'https://cdn.checkout.com/js/framesv2.min.js', [ 'jquery' ], WC_CHECKOUTCOM_PLUGIN_VERSION );
+ wp_enqueue_script( 'cko-frames-script' );
+
+ $vars = [
+ 'card-number' => esc_html__( 'Please enter a valid card number', 'checkout-com-unified-payments-api' ),
+ 'expiry-date' => esc_html__( 'Please enter a valid expiry date', 'checkout-com-unified-payments-api' ),
+ 'cvv' => esc_html__( 'Please enter a valid cvv code', 'checkout-com-unified-payments-api' ),
+ 'is-add-payment-method' => is_wc_endpoint_url( 'add-payment-method' ) ? 'yes' : 'no',
+ ];
+
+ wp_register_script(
+ 'cko-jquery-tiptip',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/jquery-tiptip/jquery.tipTip' . $suffix . '.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION
+ );
+
+ wp_localize_script( 'cko-frames-script', 'cko_frames_vars', $vars );
+
+ wp_register_script(
+ 'cko-frames-integration-script',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/cko-frames-integration.js',
+ [ 'cko-frames-script', 'jquery', 'cko-jquery-tiptip' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION
+ );
+ wp_enqueue_script( 'cko-frames-integration-script' );
+ }
+
+ /**
+ * Show module configuration in backend.
+ *
+ * @return string|void
+ */
+ public function init_form_fields() {
+ $this->form_fields = ( new WC_Checkoutcom_Cards_Settings() )->core_settings();
+
+ $this->form_fields = array_merge(
+ $this->form_fields,
+ [
+ 'screen_button' => [
+ 'id' => 'screen_button',
+ 'type' => 'screen_button',
+ 'title' => __( 'Other Settings', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+ }
+
+ /**
+ * Generate links for the admin page.
+ *
+ * @param string $key The key.
+ * @param array $value The value.
+ */
+ public function generate_screen_button_html( $key, $value ) {
+ WC_Checkoutcom_Admin::generate_links( $key, $value );
+ }
+
+ /**
+ * Show module settings links.
+ */
+ public function admin_options() {
+ if ( ! isset( $_GET['screen'] ) || '' === sanitize_text_field( $_GET['screen'] ) ) {
+ parent::admin_options();
+ } else {
+
+ $screen = sanitize_text_field( $_GET['screen'] );
+
+ $test = [
+ 'screen_button' => [
+ 'id' => 'screen_button',
+ 'type' => 'screen_button',
+ 'title' => __( 'Settings', 'checkout-com-unified-payments-api' ),
+ ],
+ ];
+
+ echo '';
+ WC_Admin_Settings::output_fields( WC_Checkoutcom_Cards_Settings::order_settings() );
+ echo '
';
+ } elseif ( 'card_settings' === $screen ) {
+
+ echo '';
+ WC_Admin_Settings::output_fields( WC_Checkoutcom_Cards_Settings::cards_settings() );
+ echo '
';
+ } elseif ( 'debug_settings' === $screen ) {
+
+ echo '';
+ WC_Admin_Settings::output_fields( WC_Checkoutcom_Cards_Settings::debug_settings() );
+ echo '
';
+ } elseif ( 'webhook' === $screen ) {
+
+ echo '';
+ WC_Admin_Settings::output_fields( WC_Checkoutcom_Cards_Settings::webhook_settings() );
+ echo '
';
+ } elseif ( 'webhook_queue' === $screen ) {
+ // Render webhook queue page
+ if ( class_exists( 'WC_Checkoutcom_Webhook_Queue_Admin' ) ) {
+ WC_Checkoutcom_Webhook_Queue_Admin::render_admin_page();
+ } else {
+ echo '';
+ }
+ } else {
+
+ echo '';
+ WC_Admin_Settings::output_fields( WC_Checkoutcom_Cards_Settings::core_settings() );
+ echo '
';
+ }
+ }
+ }
+
+ /**
+ * Save module settings in woocommerce db.
+ *
+ * @return void
+ */
+ public function process_admin_options() {
+ if ( isset( $_GET['screen'] ) && '' !== $_GET['screen'] ) {
+ if ( 'card_settings' === $_GET['screen'] ) {
+ WC_Admin_Settings::save_fields( WC_Checkoutcom_Cards_Settings::cards_settings() );
+ } elseif ( 'orders_settings' === $_GET['screen'] ) {
+ WC_Admin_Settings::save_fields( WC_Checkoutcom_Cards_Settings::order_settings() );
+ } elseif ( 'debug_settings' === $_GET['screen'] ) {
+ WC_Admin_Settings::save_fields( WC_Checkoutcom_Cards_Settings::debug_settings() );
+ } else {
+ WC_Admin_Settings::save_fields( WC_Checkoutcom_Cards_Settings::core_settings() );
+ }
+ do_action( 'woocommerce_update_options_' . $this->id );
+ } else {
+ parent::process_admin_options();
+ do_action( 'woocommerce_update_options_' . $this->id );
+ }
+ }
+
+ /**
+ * Show frames js on checkout page.
+ */
+ public function payment_fields() {
+ $save_card = WC_Admin_Settings::get_option( 'ckocom_card_saved' );
+ $mada_enable = '1' === WC_Admin_Settings::get_option( 'ckocom_card_mada', '0' );
+ $require_cvv = WC_Admin_Settings::get_option( 'ckocom_card_require_cvv' );
+ $is_mada_token = false;
+ $card_validation_alert = __( 'Please enter your card details.', 'checkout-com-unified-payments-api' );
+ $iframe_style = WC_Admin_Settings::get_option( 'ckocom_iframe_style', '0' );
+
+ ?>
+ ' />
+ '/>
+
+
+ '/>
+
+
+
+
+
+
+
+
+ saved_payment_methods();
+
+ // check if mada enable in module settings.
+ if ( $mada_enable ) {
+ foreach ( $this->get_tokens() as $item ) {
+ $token_id = $item->get_id();
+ $token = WC_Payment_Tokens::get( $token_id );
+ // check if token is mada.
+ $is_mada = $token->get_meta( 'is_mada' );
+ if ( $is_mada ) {
+ $is_mada_token = $token_id;
+ }
+ }
+ }
+ }
+
+ // Check require cvv or mada is enabled from module setting.
+ if ( $require_cvv || $mada_enable ) {
+ $this->element_form_cvv();
+ }
+
+ // Render Card input fields.
+ $this->element_form( $iframe_style );
+
+ // Render Save Card input.
+ $this->element_form_save_card( $save_card );
+ }
+
+ /**
+ * Renders the checkout frame elements form.
+ *
+ * @param string $iframe_style Type of iFrame style.
+ *
+ * @return void
+ */
+ public function element_form( $iframe_style ) {
+ ?>
+
+
+
+
+
+
+ session->set( '_cko_preferred_scheme', $card_scheme );
+ }
+ }
+
+ // Create payment with card token.
+ $result = (array) WC_Checkoutcom_Api_Request::create_payment( $order, $arg );
+
+ if ( isset( $result['3d_redirection_error'] ) && true === $result['3d_redirection_error'] ) {
+ // Retry Create payment with card token.
+ $result = (array) WC_Checkoutcom_Api_Request::create_payment( $order, $arg, null, true );
+ }
+
+ // check if result has error and return error message.
+ if ( isset( $result['error'] ) && ! empty( $result['error'] ) ) {
+ WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'] );
+
+ return;
+ }
+
+ // Get save card config from module setting.
+ $save_card = WC_Admin_Settings::get_option( 'ckocom_card_saved' );
+
+ // Check if result contains 3d redirection url.
+ if ( isset( $result['3d'] ) && ! empty( $result['3d'] ) ) {
+
+ // Check if save card is enable and customer select to save card.
+ if ( $save_card && isset( $_POST['wc-wc_checkout_com_cards-new-payment-method'] ) && sanitize_text_field( $_POST['wc-wc_checkout_com_cards-new-payment-method'] ) ) {
+ // Save in session for 3D secure payment.
+ WC()->session->set( 'wc-wc_checkout_com_cards-new-payment-method', 'yes' );
+ } else {
+ WC()->session->set( 'wc-wc_checkout_com_cards-new-payment-method', 'no' );
+ }
+
+ $order->add_order_note(
+ sprintf(
+ esc_html__( 'Checkout.com 3d Redirect waiting. URL : %s', 'checkout-com-unified-payments-api' ),
+ $result['3d']
+ )
+ );
+
+ // Redirect to 3D secure page.
+ return [
+ 'result' => 'success',
+ 'redirect' => $result['3d'],
+ ];
+ }
+
+ // Save card in db.
+ if ( $save_card && isset( $_POST['wc-wc_checkout_com_cards-new-payment-method'] ) && sanitize_text_field( $_POST['wc-wc_checkout_com_cards-new-payment-method'] ) ) {
+ $this->save_token( get_current_user_id(), $result );
+ }
+
+ if ( class_exists( 'WC_Subscriptions_Order' ) ) {
+ // Save source id for subscription.
+ WC_Checkoutcom_Subscription::save_source_id( $order_id, $order, $result['source']['id'] );
+
+ // save Cartes Bancaires card scheme for subscription.
+ $card_scheme = WC()->session->get( '_cko_preferred_scheme' );
+
+ if ( ! empty( $card_scheme ) ) {
+ $this->save_preferred_card_scheme( $order_id, $order, $card_scheme );
+ WC()->session->__unset( '_cko_preferred_scheme' );
+ }
+ }
+
+ // Set action id as woo transaction id.
+ $order->set_transaction_id( $result['action_id'] );
+ $order->update_meta_data( '_cko_payment_id', $result['id'] );
+
+
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Authorised - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+
+ // Check if payment was flagged.
+ if ( $result['risk']['flagged'] ) {
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_flagged', 'flagged' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Flagged - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+ }
+
+ // Add notes for the order.
+ $order->add_order_note( $message );
+
+ $order_status = $order->get_status();
+
+ if ( 'pending' === $order_status || 'failed' === $order_status ) {
+ $order->update_meta_data( 'cko_payment_authorized', true );
+ $order->update_status( $status );
+ }
+
+ // Reduce stock levels.
+ wc_reduce_stock_levels( $order_id );
+
+ // Remove cart.
+ WC()->cart->empty_cart();
+
+ // Return thank you page.
+ return [
+ 'result' => 'success',
+ 'redirect' => $this->get_return_url( $order ),
+ ];
+ }
+
+ /**
+ * Handle redirection callback.
+ */
+ public function callback_handler() {
+ if ( ! session_id() ) {
+ session_start();
+ }
+
+ if ( $_REQUEST['cko-session-id'] ) {
+ $cko_session_id = $_REQUEST['cko-session-id'];
+ }
+
+ // Verify session id.
+ $result = (array) ( new WC_Checkoutcom_Api_Request() )->verify_session( $cko_session_id );
+
+ // Redirect to cart if an error occurred.
+ if ( isset( $result['error'] ) && ! empty( $result['error'] ) ) {
+ WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'] );
+ wp_redirect( wc_get_checkout_url() );
+ exit();
+ }
+
+ $order_id = $result['metadata']['order_id'];
+ $action = $result['actions'];
+
+ // Get object as an instance of WC_Subscription.
+ $subscription_object = wc_get_order( $order_id );
+
+ $order = new WC_Order( $order_id );
+
+ // Query order by order number to check if order exist.
+ if ( ! $order ) {
+ $orders = wc_get_orders(
+ [
+ 'order_number' => $order_id,
+ ]
+ );
+
+ $order = $orders[0];
+ $order_id = $order->get_id();
+ }
+
+ // Redirect to my-account/payment-method if card verification failed.
+ // show error to customer.
+ if ( isset( $result['card_verification'] ) && 'error' === $result['card_verification'] ) {
+ WC_Checkoutcom_Utility::wc_add_notice_self( __( 'Unable to add payment method to your account.', 'checkout-com-unified-payments-api' ), 'error' );
+ wp_redirect( $result['redirection_url'] );
+ exit;
+ }
+
+ // Redirect to my-account/payment-method if card verification successful.
+ // show notice to customer.
+ if ( 'Card Verified' === $result['status'] && isset( $result['metadata']['card_verification'] ) ) {
+
+ $this->save_token( get_current_user_id(), $result );
+
+ WC_Checkoutcom_Utility::wc_add_notice_self( __( 'Payment method successfully added.', 'checkout-com-unified-payments-api' ), 'notice' );
+ wp_redirect( $result['metadata']['redirection_url'] );
+ exit;
+ }
+
+ // Set action id as woo transaction id.
+ $order->set_transaction_id( $action['0']['id'] );
+
+ // if no action id and source is boleto or paypal.
+ if ( null == $action['0']['id'] && in_array( $result['source']['type'], [ 'paypal', 'boleto' ], true ) ) { // phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison -- Deliberate loose comparison.
+ $order->set_transaction_id( $result['id'] );
+ }
+
+ $order->update_meta_data( '_cko_payment_id', $result['id'] );
+
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Authorised - Action ID : %s', 'checkout-com-unified-payments-api' ), $action['0']['id'] );
+
+ // check if payment was flagged.
+ if ( $result['risk']['flagged'] ) {
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_flagged', 'flagged' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Flagged - Action ID : %s', 'checkout-com-unified-payments-api' ), $action['0']['id'] );
+ }
+
+ if ( 'Canceled' === $result['status'] ) {
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_void', 'cancelled' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Canceled - Action ID : %s', 'checkout-com-unified-payments-api' ), $action['0']['id'] );
+ }
+
+ if ( 'Captured' === $result['status'] ) {
+ $order->update_meta_data( 'cko_payment_captured', true );
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_captured', 'processing' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Captured - Action ID : %s', 'checkout-com-unified-payments-api' ), $action['0']['id'] );
+ }
+
+ // save card to db.
+ $save_card = WC_Admin_Settings::get_option( 'ckocom_card_saved' );
+ if ( $save_card && 'yes' === WC()->session->get( 'wc-wc_checkout_com_cards-new-payment-method' ) ) {
+ $this->save_token( $order->get_user_id(), $result );
+ WC()->session->__unset( 'wc-wc_checkout_com_cards-new-payment-method' );
+ }
+
+ if ( class_exists( 'WC_Subscriptions_Order' ) ) {
+ // save source id for subscription.
+ WC_Checkoutcom_Subscription::save_source_id( $order_id, $subscription_object, $result['source']['id'] );
+
+ // save Cartes Bancaires card scheme for subscription.
+ $card_scheme = WC()->session->get( '_cko_preferred_scheme' );
+
+ if ( ! empty( $card_scheme ) ) {
+ $this->save_preferred_card_scheme( $order_id, $order, $card_scheme );
+ WC()->session->__unset( '_cko_preferred_scheme' );
+ }
+ }
+
+ $order_status = $order->get_status();
+
+ $order->add_order_note( $message );
+
+ if ( 'pending' === $order_status || 'failed' === $order_status ) {
+ $order->update_meta_data( 'cko_payment_authorized', true );
+ $order->update_status( $status );
+ }
+
+ // Reduce stock levels.
+ wc_reduce_stock_levels( $order_id );
+
+ // Remove cart.
+ WC()->cart->empty_cart();
+
+ $url = esc_url( $order->get_checkout_order_received_url() );
+ wp_redirect( $url );
+
+ exit();
+ }
+
+ /**
+ * Handle add Payment Method from My Account page.
+ *
+ * @return array
+ */
+ public function add_payment_method() {
+ // Check if cko card token is not empty.
+ if ( empty( $_POST['cko-card-token'] ) ) {
+ return [
+ 'result' => 'failure',
+ 'redirect' => wc_get_endpoint_url( 'payment-methods' ),
+ ];
+ }
+
+ $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+
+ // Load method with card token.
+ $method = new RequestTokenSource();
+ $method->token = sanitize_text_field( $_POST['cko-card-token'] );
+
+ // Initialize the Checkout Api.
+ $checkout = new Checkout_SDK();
+ $payment = $checkout->get_payment_request();
+ $payment->source = $method;
+ $payment->currency = get_woocommerce_currency();
+
+ // Load current user.
+ $current_user = wp_get_current_user();
+
+ // Set customer email and name to payment request.
+ $customer = new CustomerRequest();
+ $customer->email = $current_user->user_email;
+ $customer->name = $current_user->first_name . ' ' . $current_user->last_name;
+
+ $payment->customer = $customer;
+
+ // Set Metadata in card verification request to use in callback handler.
+ $payment->metadata = [
+ 'card_verification' => true,
+ 'redirection_url' => wc_get_endpoint_url( 'payment-methods' ),
+ ];
+
+ // Set redirection url in payment request.
+ $redirection_url = add_query_arg( 'wc-api', 'wc_checkoutcom_callback', home_url( '/' ) );
+ $payment->success_url = $redirection_url;
+ $payment->failure_url = $redirection_url;
+
+ // to remove.
+ $three_ds = new ThreeDsRequest();
+ $three_ds->enabled = true;
+
+ $payment->three_ds = $three_ds;
+ // end to remove.
+
+ try {
+ $response = $checkout->get_builder()->getPaymentsClient()->requestPayment( $payment );
+
+ // Check if payment successful.
+ if ( WC_Checkoutcom_Utility::is_successful( $response ) ) {
+
+ // Check if payment is 3D secure.
+ if ( WC_Checkoutcom_Utility::is_pending( $response ) ) {
+ // Check if redirection link exist.
+ if ( WC_Checkoutcom_Utility::get_redirect_url( $response ) ) {
+ // Return 3d redirection url.
+ wp_redirect( WC_Checkoutcom_Utility::get_redirect_url( $response ) );
+ exit();
+
+ } else {
+ return [
+ 'result' => 'failure',
+ 'redirect' => wc_get_endpoint_url( 'payment-methods' ),
+ ];
+ }
+ } else {
+ $this->save_token( $current_user->ID, (array) $response );
+
+ return [
+ 'result' => 'success',
+ ];
+ }
+ } else {
+ return [
+ 'result' => 'failure',
+ 'redirect' => wc_get_endpoint_url( 'payment-methods' ),
+ ];
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $error_message = esc_html__( 'An error has occurred while processing your cancel request. ', 'checkout-com-unified-payments-api' );
+
+ // check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ return [
+ 'result' => 'failure',
+ 'redirect' => wc_get_endpoint_url( 'payment-methods' ),
+ ];
+ }
+ }
+
+ /**
+ * Save card.
+ *
+ * @param int $user_id User id.
+ * @param array $payment_response Payment response.
+ *
+ * @return void
+ */
+ public function save_token( $user_id, $payment_response ) {
+ // Check if payment response is not null.
+ if ( ! is_null( $payment_response ) ) {
+ // argument to check token.
+ $arg = [
+ 'user_id' => $user_id,
+ 'gateway_id' => $this->id,
+ ];
+
+ // Query token by userid and gateway id.
+ $token = WC_Payment_Tokens::get_tokens( $arg );
+
+ foreach ( $token as $tok ) {
+ $token_data = $tok->get_data();
+ // do not save source if it already exists in db.
+ if ( $token_data['token'] === $payment_response['source']['id'] ) {
+ return;
+ }
+ }
+
+ // Save source_id in db.
+ $token = new WC_Payment_Token_CC();
+ $token->set_token( (string) $payment_response['source']['id'] );
+ $token->set_gateway_id( $this->id );
+ $token->set_card_type( (string) $payment_response['source']['scheme'] );
+ $token->set_last4( $payment_response['source']['last4'] );
+ $token->set_expiry_month( $payment_response['source']['expiry_month'] );
+ $token->set_expiry_year( $payment_response['source']['expiry_year'] );
+ $token->set_user_id( $user_id );
+
+ // Check if session has is mada and set token metadata.
+ if ( isset( $_SESSION['cko-is-mada'] ) ) {
+ $token->add_meta_data( 'is_mada', true, true );
+ unset( $_SESSION['cko-is-mada'] );
+ }
+
+ $card_scheme = WC()->session->get( '_cko_preferred_scheme' );
+
+ if ( $card_scheme ) {
+ $token->add_meta_data( 'preferred_scheme', $card_scheme, true );
+ }
+
+ $token->save();
+ }
+ }
+
+ /**
+ * This function save card scheme for recurring payment like subscription renewal.
+ *
+ * @param int $order_id Order ID.
+ * @param WC_Order $order Order object.
+ * @param string $card_scheme Card Scheme.
+ *
+ * @return void
+ */
+ public function save_preferred_card_scheme( $order_id, $order, $card_scheme ) {
+
+ if ( empty( $card_scheme ) ) {
+ return;
+ }
+
+ if ( $order instanceof WC_Subscription ) {
+ $order->update_meta_data( '_cko_preferred_scheme', $card_scheme );
+ $order->save();
+ }
+
+ // Check for subscription and save source id.
+ if ( function_exists( 'wcs_order_contains_subscription' ) ) {
+ if ( wcs_order_contains_subscription( $order_id ) ) {
+ $subscriptions = wcs_get_subscriptions_for_order( $order );
+
+ foreach ( $subscriptions as $subscription_obj ) {
+ $subscription_obj->update_meta_data( '_cko_preferred_scheme', $card_scheme );
+ $subscription_obj->save();
+ }
+ }
+ }
+ }
+
+ /**
+ * Handle Card refund.
+ *
+ * @param int $order_id Order ID.
+ * @param null $amount Amount to refund.
+ * @param string $reason Reason for refund.
+ *
+ * @return bool
+ */
+ public function process_refund( $order_id, $amount = null, $reason = '' ) {
+ WC_Checkoutcom_Utility::logger( "REFUND DEBUG: Cards gateway process_refund called for order $order_id, amount: $amount, reason: $reason" );
+
+ $order = wc_get_order( $order_id );
+ WC_Checkoutcom_Utility::logger( "REFUND DEBUG: Order loaded. Payment method: " . $order->get_payment_method() );
+
+ $result = (array) WC_Checkoutcom_Api_Request::refund_payment( $order_id, $order );
+ WC_Checkoutcom_Utility::logger( "REFUND DEBUG: API refund result: " . print_r( $result, true ) );
+
+ // check if result has error and return error message.
+ if ( isset( $result['error'] ) && ! empty( $result['error'] ) ) {
+ WC_Checkoutcom_Utility::logger( "REFUND DEBUG: Error in refund result: " . $result['error'] );
+ WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'] );
+ return false;
+ }
+
+ // Set action id as woo transaction id.
+ WC_Checkoutcom_Utility::logger( "REFUND DEBUG: Setting transaction ID: " . $result['action_id'] );
+ $order->set_transaction_id( $result['action_id'] );
+ $order->update_meta_data( 'cko_payment_refunded', true );
+ $order->save();
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment refunded from Admin - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+
+ if ( isset( $_SESSION['cko-refund-is-less'] ) ) {
+ if ( $_SESSION['cko-refund-is-less'] ) {
+ WC_Checkoutcom_Utility::logger( "REFUND DEBUG: Partial refund completed" );
+ /* translators: %s: Action ID. */
+ $order->add_order_note( sprintf( esc_html__( 'Checkout.com Payment Partially refunded from Admin - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] ) );
+
+ unset( $_SESSION['cko-refund-is-less'] );
+
+ return true;
+ }
+ }
+
+ // add note for order.
+ WC_Checkoutcom_Utility::logger( "REFUND DEBUG: Full refund completed" );
+ $order->add_order_note( $message );
+
+ // when true is returned, status is changed to refunded automatically.
+ return true;
+ }
+
+ /**
+ * Webhook handler.
+ * Handle Webhook.
+ *
+ * @return bool|int|void
+ */
+ public function webhook_handler() {
+ // webhook_url_format = http://example.com/?wc-api=wc_checkoutcom_webhook .
+
+ // Get webhook data.
+ $data = json_decode( file_get_contents( 'php://input' ) );
+
+ // Return to home page if empty data.
+ if ( empty( $data ) ) {
+ wp_redirect( get_home_url() );
+ exit();
+ }
+
+ // Create apache function if not exist to get header authorization.
+ if ( ! function_exists( 'apache_request_headers' ) ) {
+ /**
+ * Get request headers.
+ *
+ * @return array
+ */
+ function apache_request_headers() {
+ $arh = [];
+ $rx_http = '/\AHTTP_/';
+ foreach ( $_SERVER as $key => $val ) {
+ if ( preg_match( $rx_http, $key ) ) {
+ $arh_key = preg_replace( $rx_http, '', $key );
+ $rx_matches = [];
+ $rx_matches = explode( '_', $arh_key );
+ if ( count( $rx_matches ) > 0 and strlen( $arh_key ) > 2 ) {
+ foreach ( $rx_matches as $ak_key => $ak_val ) {
+ $rx_matches[ $ak_key ] = ucfirst( $ak_val );
+ }
+ $arh_key = implode( '-', $rx_matches );
+ }
+ $arh[ $arh_key ] = $val;
+ }
+ }
+ return( $arh );
+ }
+ }
+
+ $header = array_change_key_case( apache_request_headers(), CASE_LOWER );
+ $header_signature = $header['cko-signature'];
+
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $raw_event = file_get_contents( 'php://input' );
+
+ $core_settings['ckocom_sk'] = cko_is_nas_account() ? 'Bearer ' . $core_settings['ckocom_sk'] : $core_settings['ckocom_sk'];
+
+ $signature = WC_Checkoutcom_Utility::verify_signature( $raw_event, $core_settings['ckocom_sk'], $header_signature );
+
+ // check if cko signature matches.
+ if ( false === $signature ) {
+ return http_response_code( 401 );
+ }
+
+ $order = false;
+ $payment_id = null;
+
+ if ( ! empty( $data->data->metadata->order_id ) ) {
+ $order = wc_get_order( $data->data->metadata->order_id );
+ } elseif ( ! empty( $data->data->reference ) ) {
+ $order = wc_get_order( $data->data->reference );
+
+ if ( isset( $data->data->metadata ) ) {
+ $data->data->metadata->order_id = $data->data->reference;
+ } else {
+ $data->data->metadata = new StdClass();
+ $data->data->metadata->order_id = $data->data->reference;
+ }
+ }
+
+ if ( $order ) {
+ $payment_id = $order->get_meta( '_cko_payment_id' ) ?? null;
+ }
+
+ // check if payment ID matches that of the webhook.
+ if ( is_null( $payment_id ) || $payment_id !== $data->data->id ) {
+
+ $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+ if ( $gateway_debug ) {
+ /* translators: 1: Payment ID, 2: Webhook ID. */
+ $message = sprintf( esc_html__( 'Order payment Id (%1$s) does not match that of the webhook (%2$s)', 'checkout-com-unified-payments-api' ), $payment_id, $data->data->id );
+
+ WC_Checkoutcom_Utility::logger( $message, null );
+ }
+
+ return http_response_code( 422 );
+ }
+
+ // Get webhook event type from data.
+ $event_type = $data->type;
+
+ switch ( $event_type ) {
+ case 'card_verified':
+ $response = WC_Checkout_Com_Webhook::card_verified( $data );
+ break;
+ case 'payment_approved':
+ $response = WC_Checkout_Com_Webhook::authorize_payment( $data );
+ break;
+ case 'payment_captured':
+ $response = WC_Checkout_Com_Webhook::capture_payment( $data );
+ break;
+ case 'payment_voided':
+ $response = WC_Checkout_Com_Webhook::void_payment( $data );
+ break;
+ case 'payment_capture_declined':
+ $response = WC_Checkout_Com_Webhook::capture_declined( $data );
+ break;
+ case 'payment_refunded':
+ $response = WC_Checkout_Com_Webhook::refund_payment( $data );
+ break;
+ case 'payment_canceled':
+ $response = WC_Checkout_Com_Webhook::cancel_payment( $data );
+ break;
+ case 'payment_declined':
+ case 'payment_authentication_failed':
+ $response = WC_Checkout_Com_Webhook::decline_payment( $data );
+ break;
+
+ default:
+ $response = true;
+ break;
+ }
+
+ $http_code = $response ? 200 : 400;
+
+ return http_response_code( $http_code );
+ }
+
+ /**
+ * Get localisation.
+ *
+ * @return string
+ */
+ public function get_localisation() {
+ $woo_locale = str_replace( '_', '-', get_locale() );
+ $locale = substr( $woo_locale, 0, 2 );
+
+ $ckocom_language_type = WC_Admin_Settings::get_option( 'ckocom_language_type', '0' );
+
+ if ( '0' === $ckocom_language_type ) {
+ switch ( $locale ) {
+ case 'en':
+ $localization = 'EN-GB';
+ break;
+ case 'it':
+ $localization = 'IT-IT';
+ break;
+ case 'nl':
+ $localization = 'NL-NL';
+ break;
+ case 'fr':
+ $localization = 'FR-FR';
+ break;
+ case 'de':
+ $localization = 'DE-DE';
+ break;
+ case 'kr':
+ $localization = 'KR-KR';
+ break;
+ case 'es':
+ $localization = 'ES-ES';
+ break;
+ default:
+ $localization = WC_Admin_Settings::get_option( 'ckocom_language_fallback', 'EN-GB' );
+ }
+ } else {
+ $localization = [
+ 'cardNumberPlaceholder' => WC_Admin_Settings::get_option( 'ckocom_card_number_placeholder', 'Card number' ),
+ 'expiryMonthPlaceholder' => WC_Admin_Settings::get_option( 'ckocom_card_expiry_month_placeholder', 'MM' ),
+ 'expiryYearPlaceholder' => WC_Admin_Settings::get_option( 'ckocom_card_expiry_year_placeholder', 'YY' ),
+ 'cvvPlaceholder' => WC_Admin_Settings::get_option( 'ckocom_card_cvv_placeholder', 'CVV' ),
+ 'cardSchemeLink' => WC_Admin_Settings::get_option( 'ckocom_card_scheme_link_placeholder', 'Click here to update your type of card' ),
+ 'cardSchemeHeader' => WC_Admin_Settings::get_option( 'ckocom_card_scheme_header_placeholder', 'Choose your type of card' ),
+ ];
+
+ $localization = wp_json_encode( $localization );
+ }
+
+ return $localization;
+ }
+}
diff --git a/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-google-pay.php b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-google-pay.php
new file mode 100644
index 00000000..aa31adeb
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-google-pay.php
@@ -0,0 +1,1162 @@
+id = 'wc_checkout_com_google_pay';
+ $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' );
+ $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' );
+ $this->title = __( 'Google Pay', 'checkout-com-unified-payments-api' );
+ $this->has_fields = true;
+ $this->supports = [
+ 'products',
+ 'refunds',
+ 'subscriptions',
+ 'subscription_cancellation',
+ 'subscription_suspension',
+ 'subscription_reactivation',
+ 'subscription_date_changes',
+ ];
+
+ $this->init_form_fields();
+ $this->init_settings();
+
+ // Turn these settings into variables we can use.
+ foreach ( $this->settings as $setting_key => $value ) {
+ $this->$setting_key = $value;
+ }
+
+ add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] );
+
+ // Payment scripts.
+ add_action( 'wp_enqueue_scripts', [ $this, 'payment_scripts' ] );
+
+ add_action( 'woocommerce_api_' . strtolower( 'CKO_Google_Pay_Woocommerce' ), [ $this, 'handle_wc_api' ] );
+ }
+
+ /**
+ * Handle Google Pay method API requests.
+ *
+ * @return void
+ */
+ public function handle_wc_api() {
+ // Log that API endpoint was hit
+ WC_Checkoutcom_Utility::logger( 'Google Pay: handle_wc_api called' );
+ WC_Checkoutcom_Utility::logger( 'Google Pay: GET params: ' . print_r( $_GET, true ) );
+
+ // phpcs:disable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing
+ if ( ! empty( $_GET['cko_google_pay_action'] ) ) {
+ WC_Checkoutcom_Utility::logger( 'Google Pay: Action requested: ' . $_GET['cko_google_pay_action'] );
+
+ switch ( $_GET['cko_google_pay_action'] ) {
+
+ case 'express_add_to_cart':
+ $this->cko_express_add_to_cart();
+ break;
+
+ case 'express_create_payment_context':
+ $this->cko_express_create_payment_context();
+ break;
+
+ case 'express_get_cart_total':
+ $this->cko_express_get_cart_total();
+ break;
+
+ case 'express_google_pay_order_session':
+ WC_Checkoutcom_Utility::logger( 'Google Pay: Calling cko_express_google_pay_order_session' );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_google_pay_order_id', isset( $_GET['google_pay_order_id'] ) ? wc_clean( $_GET['google_pay_order_id'] ) : '' );
+ $this->cko_express_google_pay_order_session();
+ break;
+ }
+ } else {
+ WC_Checkoutcom_Utility::logger( 'Google Pay: No cko_google_pay_action in GET params' );
+ }
+
+ // phpcs:enable
+ exit();
+ }
+
+ public function cko_express_add_to_cart() {
+ if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'checkoutcom_google_pay_express_add_to_cart' ) ) {
+ wp_send_json( [ 'result' => 'failed' ] );
+ }
+
+ if ( ! defined( 'WOOCOMMERCE_CART' ) ) {
+ define( 'WOOCOMMERCE_CART', true );
+ }
+
+ WC()->shipping->reset_shipping();
+
+ $product_id = isset( $_POST['product_id'] ) ? absint( $_POST['product_id'] ) : 0;
+ $qty = ! isset( $_POST['qty'] ) ? 1 : absint( $_POST['qty'] );
+
+ $product = wc_get_product( $product_id );
+
+ if ( ! $product ) {
+ wp_send_json( [ 'result' => 'error', 'message' => 'Product not found' ] );
+ }
+
+ $product_type = $product->get_type();
+
+ // First empty the cart to prevent wrong calculation.
+ WC()->cart->empty_cart();
+
+ if ( ( 'variable' === $product_type || 'variable-subscription' === $product_type ) && isset( $_POST['attributes'] ) ) {
+ $attributes = wc_clean( wp_unslash( $_POST['attributes'] ) );
+
+ $data_store = WC_Data_Store::load( 'product' );
+ $variation_id = $data_store->find_matching_product_variation( $product, $attributes );
+
+ $is_added_to_cart = WC()->cart->add_to_cart( $product->get_id(), $qty, $variation_id, $attributes );
+ }
+
+ if ( in_array( $product_type, [ 'simple', 'variation', 'subscription', 'subscription_variation' ], true ) ) {
+ $is_added_to_cart = WC()->cart->add_to_cart( $product->get_id(), $qty );
+ }
+
+ WC()->cart->calculate_totals();
+
+ $data = [];
+ $data['result'] = 'success';
+ $data['total'] = WC()->cart->total;
+
+ wp_send_json( $data );
+ }
+
+ public function cko_express_create_payment_context() {
+
+ // phpcs:ignore WordPress.Security.NonceVerification.Missing
+ if ( ! empty( $_POST['express_checkout'] ) ) {
+ // Check if add_to_cart was successful
+ if ( ! empty( $_POST['add_to_cart'] ) && 'success' !== $_POST['add_to_cart'] ) {
+ wp_send_json_error( array( 'messages' => 'Failed to add product to cart' ) );
+ return;
+ }
+
+ // Check if using existing cart
+ if ( ! empty( $_POST['use_existing_cart'] ) && 'true' === $_POST['use_existing_cart'] ) {
+ // Cart should already be populated
+ }
+ }
+
+ if ( WC()->cart->is_empty() ) {
+ wp_send_json_error( array( 'messages' => 'Cart is empty' ) );
+ return;
+ }
+
+ // Create payment context similar to PayPal
+ $this->cko_create_payment_context_request( true );
+ }
+
+ public function cko_express_get_cart_total() {
+ // Return cart total directly from WooCommerce
+ // This works for both classic and Blocks cart pages
+
+ // Ensure cart is loaded
+ if ( ! WC()->cart ) {
+ wp_send_json_error( array( 'messages' => 'Cart not initialized' ) );
+ return;
+ }
+
+ if ( WC()->cart->is_empty() ) {
+ wp_send_json_error( array( 'messages' => 'Cart is empty' ) );
+ return;
+ }
+
+ // Recalculate totals to ensure we have the latest
+ WC()->cart->calculate_totals();
+
+ // Get cart total - use 'raw' to get the numeric value directly
+ $cart_total_raw = WC()->cart->get_total( 'raw' );
+
+ // Also get formatted total for display
+ $cart_total_formatted = WC()->cart->get_total( '' );
+
+ // Ensure we have a valid total
+ if ( $cart_total_raw <= 0 ) {
+ wp_send_json_error( array( 'messages' => 'Invalid cart total' ) );
+ return;
+ }
+
+ wp_send_json_success( array(
+ 'total' => floatval( $cart_total_raw ),
+ 'total_formatted' => $cart_total_formatted,
+ 'currency' => get_woocommerce_currency(),
+ ) );
+ }
+
+ public function cko_express_google_pay_order_session() {
+ // Express now uses the exact same flow as classic Google Pay
+ // Classic Google Pay sends: cko-google-signature, cko-google-protocolVersion, cko-google-signedMessage
+ // Express now sends the same fields, so we can use the same process_payment method
+ $has_classic_token_fields = isset( $_POST['cko-google-signature'] ) && isset( $_POST['cko-google-protocolVersion'] ) && isset( $_POST['cko-google-signedMessage'] );
+
+ if ( $has_classic_token_fields ) {
+ // Get payment data for email and address extraction
+ $payment_data_json = isset( $_POST['payment_data'] ) ? wp_unslash( $_POST['payment_data'] ) : '';
+ $payment_data = ! empty( $payment_data_json ) ? json_decode( $payment_data_json, true ) : array();
+
+ // Extract email and address from payment data
+ $email = '';
+ $shipping_address = null;
+ if ( ! empty( $payment_data ) ) {
+ if ( isset( $payment_data['email'] ) ) {
+ $email = sanitize_email( $payment_data['email'] );
+ }
+ if ( isset( $payment_data['shippingAddress'] ) ) {
+ $shipping_address = $payment_data['shippingAddress'];
+ }
+ }
+
+ // Create the order from cart
+ $order = $this->create_express_order_from_cart( $email, $shipping_address );
+
+ if ( ! $order ) {
+ wp_send_json_error( array( 'messages' => 'Failed to create order for Google Pay Express checkout.' ) );
+ return;
+ }
+
+ // process_payment expects the payment method to be set in $_POST
+ $_POST['payment_method'] = 'wc_checkout_com_google_pay';
+
+ // Use the same process_payment method as classic Google Pay
+ $result = $this->process_payment( $order->get_id() );
+
+ // process_payment returns an array with 'result' and 'redirect'
+ if ( isset( $result['result'] ) && 'success' === $result['result'] ) {
+ // Payment successful - return success
+ wp_send_json_success(
+ array(
+ 'result' => 'success',
+ 'redirect_url' => isset( $result['redirect'] ) ? $result['redirect'] : $this->get_return_url( $order ),
+ )
+ );
+ } else {
+ // Payment failed
+ $error_message = isset( $result['messages'] ) ? $result['messages'] : 'Payment failed.';
+ wp_send_json_error( array( 'messages' => $error_message ) );
+ }
+
+ return; // Exit early since we've handled the payment
+
+ // Convert response to array if it's an object
+ if ( is_object( $payment_result ) ) {
+ $payment_result = json_decode( json_encode( $payment_result ), true );
+ } else {
+ $payment_result = (array) $payment_result;
+ }
+
+ // Debug: Log the payment response
+ WC_Checkoutcom_Utility::logger( 'Google Pay Express: Payment response received. Has error: ' . ( isset( $payment_result['error'] ) ? 'yes' : 'no' ) );
+ WC_Checkoutcom_Utility::logger( 'Google Pay Express: Payment response type: ' . gettype( $payment_result ) );
+ WC_Checkoutcom_Utility::logger( 'Google Pay Express: Payment response structure: ' . print_r( $payment_result, true ) );
+
+ // Clear Google Pay session
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_google_pay_order_id', '' );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_gc_id', '' );
+
+ // Check if payment was successful
+ if ( isset( $payment_result['error'] ) && ! empty( $payment_result['error'] ) ) {
+ // Payment failed
+ $order->update_status( 'failed', 'Google Pay Express payment failed.' );
+ WC_Checkoutcom_Utility::logger( 'Google Pay Express: Payment failed with error: ' . $payment_result['error'] );
+ wp_send_json_error( array( 'messages' => $payment_result['error'] ) );
+ return;
+ }
+
+ // Extract action_id from response (might be directly in response or in actions array)
+ $action_id = null;
+ if ( isset( $payment_result['action_id'] ) ) {
+ $action_id = $payment_result['action_id'];
+ } elseif ( isset( $payment_result['actions'] ) && is_array( $payment_result['actions'] ) && ! empty( $payment_result['actions'][0]['id'] ) ) {
+ $action_id = $payment_result['actions'][0]['id'];
+ }
+
+ // Extract payment ID
+ $payment_id = isset( $payment_result['id'] ) ? $payment_result['id'] : null;
+
+ // Update order with payment details
+ $order->set_transaction_id( $payment_id );
+ $order->update_meta_data( '_cko_payment_id', $payment_id );
+ $order->update_meta_data( '_cko_action_id', $action_id );
+ $order->update_meta_data( '_cko_payment_method', 'googlepay' );
+ $order->save();
+
+ // Handle subscriptions
+ if ( WC_Checkoutcom_Utility::is_subscription( $order_id ) ) {
+ WC_Checkoutcom_Utility::update_subscription_payment_method( $order, $payment_id );
+ }
+
+ // Reduce stock levels
+ $order->reduce_order_stock();
+
+ // Remove cart
+ WC()->cart->empty_cart();
+
+ // Return success and redirect to order received page
+ wp_send_json_success(
+ array(
+ 'result' => 'success',
+ 'redirect_url' => $this->get_return_url( $order ),
+ )
+ );
+
+ return; // Exit early since we've handled the payment
+ } else {
+ // Fallback to old approach (for backwards compatibility)
+ $payment_data_json = isset( $_POST['payment_data'] ) ? wp_unslash( $_POST['payment_data'] ) : '';
+
+ if ( empty( $payment_data_json ) ) {
+ wp_send_json_error( array( 'messages' => 'Missing payment data for Google Pay Express checkout.' ) );
+ return;
+ }
+
+ $payment_data = json_decode( $payment_data_json, true );
+ }
+
+ if ( ! $payment_data ) {
+ wp_send_json_error( array( 'messages' => 'Invalid payment data for Google Pay Express checkout.' ) );
+ return;
+ }
+
+ try {
+ // Extract email and address from Google Pay payment data
+ $email = '';
+ $shipping_address = null;
+
+ // Extract email from payment data
+ if ( isset( $payment_data['email'] ) ) {
+ $email = sanitize_email( $payment_data['email'] );
+ }
+
+ // Extract shipping address from payment data
+ if ( isset( $payment_data['shippingAddress'] ) ) {
+ $shipping_address = $payment_data['shippingAddress'];
+ }
+
+ // Store payment data in session for address extraction
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_google_pay_payment_data', $payment_data );
+
+ // Create the order from cart
+ $order = $this->create_express_order_from_cart( $email, $shipping_address );
+
+ if ( ! $order ) {
+ wp_send_json_error( array( 'messages' => 'Failed to create order for Google Pay Express checkout.' ) );
+ return;
+ }
+
+ // Extract Google Pay token data - handle both API v1 and v2 structures
+ $tokenization_data = null;
+ $token_data = null;
+
+ // Check if we have extracted token fields (new approach matching classic)
+ if ( $has_extracted_token_fields ) {
+ // Use extracted token fields directly (same format as classic Google Pay)
+ $token_data = array(
+ 'signature' => wp_unslash( $_POST['token_signature'] ),
+ 'protocolVersion' => sanitize_text_field( $_POST['token_protocolVersion'] ),
+ 'signedMessage' => wp_unslash( $_POST['token_signedMessage'] ),
+ );
+ }
+ // API v1 structure: paymentMethodToken.token (string that needs JSON.parse)
+ // Fallback: parse from payment_data (old approach)
+ elseif ( isset( $payment_data['paymentMethodToken'] ) && isset( $payment_data['paymentMethodToken']['token'] ) ) {
+ $tokenization_data = $payment_data['paymentMethodToken']['token'];
+
+ if ( is_array( $tokenization_data ) ) {
+ $token_data = $tokenization_data;
+ } else {
+ $token_data = json_decode( $tokenization_data, true );
+
+ if ( json_last_error() !== JSON_ERROR_NONE ) {
+ wp_send_json_error( array( 'messages' => 'Invalid Google Pay token data: ' . json_last_error_msg() ) );
+ return;
+ }
+ }
+ }
+ // API v2 structure: paymentMethodData.tokenizationData.token (fallback)
+ elseif ( isset( $payment_data['paymentMethodData'] ) && isset( $payment_data['paymentMethodData']['tokenizationData'] ) && isset( $payment_data['paymentMethodData']['tokenizationData']['token'] ) ) {
+ $tokenization_data = $payment_data['paymentMethodData']['tokenizationData']['token'];
+ $token_data = json_decode( $tokenization_data, true );
+ }
+
+ // Check if we have token data
+ if ( ! $token_data || ! isset( $token_data['signature'] ) || ! isset( $token_data['signedMessage'] ) ) {
+ wp_send_json_error( array( 'messages' => 'Invalid Google Pay payment data structure.' ) );
+ return;
+ }
+
+ // Get protocol version
+ $protocol_version = isset( $token_data['protocolVersion'] ) ? $token_data['protocolVersion'] : 'ECv2';
+
+ // Generate Google Pay token using Checkout.com wallet token API
+ $_POST['cko-google-protocolVersion'] = $protocol_version;
+ $_POST['cko-google-signature'] = $token_data['signature'];
+
+ // signedMessage is a JSON string that contains encryptedMessage for ECv1 or base64 string for ECv2
+ $signed_message = $token_data['signedMessage'];
+
+ // If signedMessage is an array/object (shouldn't happen but just in case), encode it
+ if ( is_array( $signed_message ) || is_object( $signed_message ) ) {
+ $signed_message = json_encode( $signed_message );
+ }
+
+ $_POST['cko-google-signedMessage'] = (string) $signed_message;
+
+ $token_response = WC_Checkoutcom_Api_Request::generate_google_token();
+
+ // If wallet token API fails for ECv1, we'll need to use network_token approach
+ if ( isset( $token_response['error'] ) || ! isset( $token_response['token'] ) ) {
+ if ( 'ECv1' === $protocol_version ) {
+ $error_message = isset( $token_response['error'] ) ? $token_response['error'] : 'Google Pay returned ECv1 protocol which requires network_token approach. Please contact support or try again.';
+ wp_send_json_error( array(
+ 'messages' => 'Google Pay returned ECv1 protocol. Please try again or use a different payment method.'
+ ) );
+ return;
+ } else {
+ $error_message = isset( $token_response['error'] ) ? $token_response['error'] : 'Failed to generate Google Pay token.';
+ wp_send_json_error( array( 'messages' => $error_message ) );
+ return;
+ }
+ }
+
+ // Process payment directly with the token (same as normal Google Pay)
+ $payment_result = ( new WC_Checkoutcom_Api_Request() )->create_payment( $order, $token_response );
+
+ // Convert response to array if it's an object
+ if ( is_object( $payment_result ) ) {
+ $payment_result = json_decode( json_encode( $payment_result ), true );
+ } else {
+ $payment_result = (array) $payment_result;
+ }
+
+ // Clear Google Pay session
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_google_pay_order_id', '' );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_gc_id', '' );
+
+ // Check if payment was successful
+ if ( isset( $payment_result['error'] ) && ! empty( $payment_result['error'] ) ) {
+ // Payment failed
+ $order->update_status( 'failed', 'Google Pay Express payment failed.' );
+ WC_Checkoutcom_Utility::logger( 'Google Pay Express: Payment failed with error: ' . $payment_result['error'] );
+ wp_send_json_error( array( 'messages' => $payment_result['error'] ) );
+ return;
+ }
+
+ // Extract action_id from response (might be directly in response or in actions array)
+ $action_id = null;
+ if ( isset( $payment_result['action_id'] ) ) {
+ $action_id = $payment_result['action_id'];
+ } elseif ( isset( $payment_result['actions'] ) && is_array( $payment_result['actions'] ) && ! empty( $payment_result['actions'][0]['id'] ) ) {
+ $action_id = $payment_result['actions'][0]['id'];
+ }
+
+ // Extract payment ID
+ $payment_id = isset( $payment_result['id'] ) ? $payment_result['id'] : null;
+
+ // Check if payment result is valid (must have at least id or action_id)
+ if ( empty( $payment_id ) && empty( $action_id ) ) {
+ $error_message = 'Invalid payment response: missing payment ID';
+ WC_Checkoutcom_Utility::logger( 'Google Pay Express: ' . $error_message, new Exception( print_r( $payment_result, true ) ) );
+ $order->update_status( 'failed', 'Google Pay Express payment failed: Invalid response.' );
+ wp_send_json_error( array( 'messages' => $error_message ) );
+ return;
+ }
+
+ // Check for 3DS redirect (same as normal Google Pay)
+ if ( isset( $payment_result['3d'] ) && ! empty( $payment_result['3d'] ) ) {
+ $order->add_order_note(
+ sprintf(
+ /* translators: %s: URL */
+ esc_html__( 'Checkout.com 3d Redirect waiting. URL : %s', 'checkout-com-unified-payments-api' ),
+ $payment_result['3d']
+ )
+ );
+
+ wp_send_json_success( array( 'redirect_url' => $payment_result['3d'] ) );
+ return;
+ }
+
+ // Handle subscriptions (same as normal Google Pay)
+ if ( class_exists( 'WC_Subscriptions_Order' ) && isset( $payment_result['source']['id'] ) ) {
+ // Save source id for subscription.
+ WC_Checkoutcom_Subscription::save_source_id( $order->get_id(), $order, $payment_result['source']['id'] );
+ }
+
+ // Set action id as woo transaction id (same as normal Google Pay)
+ if ( ! empty( $action_id ) ) {
+ $order->set_transaction_id( $action_id );
+ }
+ if ( ! empty( $payment_id ) ) {
+ $order->update_meta_data( '_cko_payment_id', $payment_id );
+ }
+
+ // Get cko auth status configured in admin (same as normal Google Pay)
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
+
+ // Get action ID for order notes
+ $action_id_for_notes = ! empty( $action_id ) ? $action_id : ( ! empty( $payment_id ) ? $payment_id : 'N/A' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Authorised - Action ID : %s', 'checkout-com-unified-payments-api' ), $action_id_for_notes );
+
+ // check if payment was flagged (same as normal Google Pay)
+ if ( isset( $payment_result['risk']['flagged'] ) && $payment_result['risk']['flagged'] ) {
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_flagged', 'flagged' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Flagged - Action ID : %s', 'checkout-com-unified-payments-api' ), $action_id_for_notes );
+ }
+
+ // add notes for the order and update status (same as normal Google Pay)
+ $order->add_order_note( $message );
+ $order->update_status( $status );
+
+ // Reduce stock levels (same as normal Google Pay)
+ wc_reduce_stock_levels( $order->get_id() );
+
+ // Remove cart (same as normal Google Pay)
+ WC()->cart->empty_cart();
+
+ // Payment successful - redirect to thank you page
+ $redirect_url = $this->get_return_url( $order );
+
+ wp_send_json_success( array( 'redirect_url' => $redirect_url ) );
+
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+ $error_message = 'An error occurred while processing Google Pay Express payment. ';
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ wp_send_json_error( array( 'messages' => $error_message ) );
+ } catch ( Exception $ex ) {
+ WC_Checkoutcom_Utility::logger( 'Google Pay Express: Unexpected error', $ex );
+ wp_send_json_error( array( 'messages' => 'An unexpected error occurred. Please check logs.' ) );
+ }
+ }
+
+ /**
+ * Create payment context request for express checkout.
+ *
+ * @param bool $is_express Whether this is express checkout.
+ * @return void
+ */
+ private function cko_create_payment_context_request( $is_express = false ) {
+ // Set proper headers for JSON response
+ header( 'Content-Type: application/json' );
+
+ // Ensure no output before JSON response
+ if ( ob_get_level() ) {
+ ob_clean();
+ }
+
+ // Google Pay Express does not use payment contexts - it processes payments directly with tokens
+ // This method is kept for compatibility but just returns success without creating a context
+ // The actual payment processing happens in cko_express_google_pay_order_session with the token
+ wp_send_json( [ 'success' => true, 'message' => 'Google Pay Express does not use payment contexts' ], 200 );
+ exit();
+ }
+
+ /**
+ * Create express order from cart.
+ *
+ * @param string $email Email address from Google Pay.
+ * @param array $shipping_address Shipping address from Google Pay.
+ * @return WC_Order|false
+ */
+ private function create_express_order_from_cart( $email = '', $shipping_address = null ) {
+ try {
+ // Determine customer ID and email
+ // IMPORTANT: For Google Pay Express:
+ // - If user is logged in: Use logged-in user's email, but address from Google Pay
+ // - If user is not logged in: Use email and address from Google Pay only
+ $customer_id = 0;
+ $customer_email = '';
+
+ // Check if user is logged in
+ if ( is_user_logged_in() ) {
+ $current_user = wp_get_current_user();
+ $customer_id = $current_user->ID;
+ // For logged-in users, use their account email (not Google Pay email)
+ $customer_email = $current_user->user_email;
+ } else {
+ // For guest users, use email from Google Pay data only
+ if ( ! empty( $email ) ) {
+ $customer_email = $email;
+ }
+ }
+
+ // Create order with proper customer ID
+ $order = wc_create_order( array( 'customer_id' => $customer_id ) );
+
+ if ( ! $order ) {
+ return false;
+ }
+
+ // Set customer email
+ if ( ! empty( $customer_email ) ) {
+ $order->set_billing_email( $customer_email );
+ }
+
+ // Add cart items to order
+ foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
+ $product = $cart_item['data'];
+ $order->add_product( $product, $cart_item['quantity'] );
+ }
+
+ // Set order addresses from Google Pay payment data if available
+ // IMPORTANT: For Google Pay Express:
+ // - If logged in: Use logged-in user's email (already set above), but address from Google Pay
+ // - If guest: Use Google Pay email and address
+ if ( ! empty( $shipping_address ) ) {
+ // For logged-in users: Don't pass email to set_order_addresses_from_google_pay_data
+ // because we want to keep the logged-in user's email (already set above)
+ // For guest users: Pass Google Pay email so it gets set in the address
+ $email_for_address = is_user_logged_in() ? '' : $customer_email;
+ $this->set_order_addresses_from_google_pay_data( $order, $shipping_address, $email_for_address );
+ }
+
+ // Set shipping method if available
+ $shipping_packages = WC()->shipping->get_packages();
+ if ( ! empty( $shipping_packages ) ) {
+ foreach ( $shipping_packages as $package ) {
+ $chosen_methods = WC()->session->get( 'chosen_shipping_methods' );
+ if ( ! empty( $chosen_methods ) ) {
+ $order->set_shipping_method( $chosen_methods[0] );
+ }
+ }
+ }
+
+ // Calculate totals
+ $order->calculate_totals();
+
+ // Set payment method to Google Pay Express
+ $order->set_payment_method( 'wc_checkout_com_google_pay' );
+ $order->set_payment_method_title( 'Google Pay Express' );
+
+ // Set order status
+ $order->set_status( 'pending' );
+ $order->save();
+
+ // Store order ID in session for potential use
+ WC()->session->set( 'order_awaiting_payment', $order->get_id() );
+
+ return $order;
+
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( 'Error creating Google Pay Express order: ' . $e->getMessage(), $e );
+ return false;
+ }
+ }
+
+ /**
+ * Get Google Pay email from payment context.
+ *
+ * @return string
+ */
+ private function get_google_pay_email_from_context() {
+ $cko_gc_details = WC_Checkoutcom_Utility::cko_get_session( 'cko_gc_details' );
+
+ if ( empty( $cko_gc_details ) ) {
+ $cko_gc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_gc_id' );
+ if ( ! empty( $cko_gc_id ) ) {
+ try {
+ $checkout = new Checkout_SDK();
+ $cko_gc_details = $checkout->get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_gc_id );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_gc_details', $cko_gc_details );
+ } catch ( Exception $e ) {
+ return '';
+ }
+ }
+ }
+
+ if ( ! empty( $cko_gc_details ) ) {
+ // Check multiple possible locations for email
+ if ( isset( $cko_gc_details['payment_request']['source']['account_holder']['email'] ) ) {
+ return $cko_gc_details['payment_request']['source']['account_holder']['email'];
+ }
+ if ( isset( $cko_gc_details['payment_request']['shipping']['email'] ) ) {
+ return $cko_gc_details['payment_request']['shipping']['email'];
+ }
+ if ( isset( $cko_gc_details['payment_request']['billing']['email'] ) ) {
+ return $cko_gc_details['payment_request']['billing']['email'];
+ }
+ if ( isset( $cko_gc_details['payment_request']['payer']['email'] ) ) {
+ return $cko_gc_details['payment_request']['payer']['email'];
+ }
+ if ( isset( $cko_gc_details['payment_request']['customer']['email'] ) ) {
+ return $cko_gc_details['payment_request']['customer']['email'];
+ }
+ }
+
+ return '';
+ }
+
+ /**
+ * Set order addresses from Google Pay payment data (for express checkout).
+ *
+ * @param WC_Order $order Order object.
+ * @param array $shipping_address Shipping address from Google Pay.
+ * @param string $email Email address from Google Pay.
+ */
+ private function set_order_addresses_from_google_pay_data( $order, $shipping_address, $email = '' ) {
+ if ( empty( $shipping_address ) ) {
+ return;
+ }
+
+ // Extract name from Google Pay address
+ $name_parts = array();
+ if ( isset( $shipping_address['name'] ) ) {
+ $name_parts = explode( ' ', $shipping_address['name'], 2 );
+ }
+ $first_name = $name_parts[0] ?? '';
+ $last_name = $name_parts[1] ?? '';
+
+ // Map Google Pay address fields to WooCommerce fields
+ $address_line1 = $shipping_address['address1'] ?? '';
+ $address_line2 = $shipping_address['address2'] ?? $shipping_address['address3'] ?? '';
+ $city = $shipping_address['locality'] ?? $shipping_address['city'] ?? '';
+ $state = $shipping_address['administrativeArea'] ?? $shipping_address['state'] ?? '';
+ $postcode = $shipping_address['postalCode'] ?? $shipping_address['postal_code'] ?? '';
+ $country = $shipping_address['countryCode'] ?? $shipping_address['country'] ?? '';
+
+ // Set billing address (always set all fields to ensure address is saved)
+ $order->set_billing_first_name( $first_name );
+ $order->set_billing_last_name( $last_name );
+ $order->set_billing_address_1( $address_line1 );
+ $order->set_billing_address_2( $address_line2 );
+ $order->set_billing_city( $city );
+ $order->set_billing_state( $state );
+ $order->set_billing_postcode( $postcode );
+ $order->set_billing_country( $country );
+ // Only set billing email if provided and not already set
+ // For Google Pay Express, logged-in users already have their email set
+ // so we don't want to overwrite it with Google Pay email
+ if ( ! empty( $email ) && empty( $order->get_billing_email() ) ) {
+ $order->set_billing_email( $email );
+ }
+ if ( isset( $shipping_address['phoneNumber'] ) && ! empty( $shipping_address['phoneNumber'] ) ) {
+ $order->set_billing_phone( $shipping_address['phoneNumber'] );
+ }
+
+ // Set shipping address (same as billing for express checkout)
+ // Always set shipping address fields, even if some are empty, to ensure WooCommerce shows shipping address
+ $order->set_shipping_first_name( $first_name );
+ $order->set_shipping_last_name( $last_name );
+ $order->set_shipping_address_1( $address_line1 );
+ $order->set_shipping_address_2( $address_line2 );
+ $order->set_shipping_city( $city );
+ $order->set_shipping_state( $state );
+ $order->set_shipping_postcode( $postcode );
+ $order->set_shipping_country( $country );
+
+ // Save the order to ensure shipping address is persisted
+ $order->save();
+ }
+
+ /**
+ * Set order addresses from Google Pay payment context data (for payment contexts - not used in express).
+ *
+ * @param WC_Order $order
+ */
+ private function set_order_addresses_from_google_pay( $order ) {
+ $cko_gc_details = WC_Checkoutcom_Utility::cko_get_session( 'cko_gc_details' );
+
+ if ( empty( $cko_gc_details ) ) {
+ // Try to get payment context details
+ $cko_gc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_gc_id' );
+ if ( ! empty( $cko_gc_id ) ) {
+ try {
+ $checkout = new Checkout_SDK();
+ $cko_gc_details = $checkout->get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_gc_id );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_gc_details', $cko_gc_details );
+ } catch ( Exception $e ) {
+ // If we can't get details, use default addresses
+ return;
+ }
+ }
+ }
+
+ if ( ! empty( $cko_gc_details ) && isset( $cko_gc_details['payment_request']['shipping']['address'] ) ) {
+ $shipping_address = $cko_gc_details['payment_request']['shipping']['address'];
+ $shipping_name = isset( $cko_gc_details['payment_request']['shipping']['first_name'] )
+ ? explode( ' ', $cko_gc_details['payment_request']['shipping']['first_name'] )
+ : array();
+ $first_name = $shipping_name[0] ?? '';
+ $last_name = $shipping_name[1] ?? '';
+
+ // Set billing address
+ $order->set_billing_first_name( $first_name );
+ $order->set_billing_last_name( $last_name );
+ $order->set_billing_address_1( $shipping_address['address_line1'] ?? '' );
+ $order->set_billing_address_2( $shipping_address['address_line2'] ?? '' );
+ $order->set_billing_city( $shipping_address['city'] ?? '' );
+ $order->set_billing_postcode( $shipping_address['zip'] ?? '' );
+ $order->set_billing_country( $shipping_address['country'] ?? '' );
+
+ // Set shipping address
+ $order->set_shipping_first_name( $first_name );
+ $order->set_shipping_last_name( $last_name );
+ $order->set_shipping_address_1( $shipping_address['address_line1'] ?? '' );
+ $order->set_shipping_address_2( $shipping_address['address_line2'] ?? '' );
+ $order->set_shipping_city( $shipping_address['city'] ?? '' );
+ $order->set_shipping_postcode( $shipping_address['zip'] ?? '' );
+ $order->set_shipping_country( $shipping_address['country'] ?? '' );
+ }
+ }
+
+ /**
+ * Request payment with payment context.
+ *
+ * @param WC_Order $order Order object.
+ * @param string $payment_context_id Payment context ID.
+ * @param string $processing_channel_id Processing channel ID.
+ * @return array
+ */
+ private function request_payment( $order, $payment_context_id, $processing_channel_id ) {
+ try {
+ $checkout = new Checkout_SDK();
+
+ $amount = $order->get_total();
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $amount, $order->get_currency() );
+
+ $payment_request_param = $checkout->get_payment_request();
+ $payment_request_param->payment_context_id = $payment_context_id;
+ $payment_request_param->processing_channel_id = $processing_channel_id;
+ $payment_request_param->reference = $order->get_order_number();
+ $payment_request_param->amount = $amount_cents;
+
+ $items = new Checkout\Payments\Contexts\PaymentContextsItems();
+ $items->name = 'All Products';
+ $items->unit_price = $amount_cents;
+ $items->quantity = '1';
+
+ $payment_request_param->items = [ $items ];
+
+ $response = $checkout->get_builder()->getPaymentsClient()->requestPayment( $payment_request_param );
+ $response_code = $response['http_metadata']->getStatusCode();
+
+ if ( ! WC_Checkoutcom_Utility::is_successful( $response ) || 'Declined' === $response['status'] ) {
+ $order->update_meta_data( '_cko_payment_id', $response['id'] );
+ $order->save();
+
+ $error_message = esc_html__( 'An error has occurred while Google Pay payment request. ', 'checkout-com-unified-payments-api' );
+
+ wp_send_json_error( [ 'messages' => $error_message ] );
+ }
+
+ /**
+ * Full Success = 201
+ * Partial Success = 202
+ *
+ * Ref : https://api-reference.checkout.com/#operation/requestAPaymentOrPayout!path=1/payment_context_id&t=request
+ */
+ if ( in_array( $response_code, [ 201, 202 ], true ) ) {
+
+ $order->set_transaction_id( $response['id'] );
+ $order->update_meta_data( '_cko_payment_id', $response['id'] );
+
+ if ( class_exists( 'WC_Subscriptions_Order' ) && isset( $response['source'] ) ) {
+ // Save source id for subscription.
+ WC_Checkoutcom_Subscription::save_source_id( $order->get_id(), $order, $response['source']['id'] );
+ }
+
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
+
+ $order->update_meta_data( 'cko_payment_authorized', true );
+ $order->update_status( $status );
+
+ // Reduce stock levels.
+ wc_reduce_stock_levels( $order->get_id() );
+
+ // Remove cart.
+ WC()->cart->empty_cart();
+
+ // Return thank you page.
+ return [
+ 'result' => 'success',
+ 'redirect' => $this->get_return_url( $order ),
+ ];
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = esc_html__( 'An error has occurred while Google Pay payment request. ', 'checkout-com-unified-payments-api' );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ wp_send_json_error( [ 'messages' => $error_message ] );
+ }
+ }
+
+ /**
+ * Outputs scripts used for checkout payment.
+ */
+ public function payment_scripts() {
+ // Load on Cart, Checkout, pay for order or add payment method pages.
+ if ( ! is_cart() && ! is_checkout() && ! isset( $_GET['pay_for_order'] ) && ! is_add_payment_method_page() ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
+ return;
+ }
+
+ // Load cko google pay setting.
+ $google_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings' );
+ $google_pay_enabled = ! empty( $google_settings['enabled'] ) && 'yes' === $google_settings['enabled'];
+
+ wp_register_script( 'cko-google-script', 'https://pay.google.com/gp/p/js/pay.js', [ 'jquery' ] );
+ wp_register_script( 'cko-google-pay-integration-script', WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/cko-google-pay-integration.js', [ 'jquery', 'cko-google-script' ], WC_CHECKOUTCOM_PLUGIN_VERSION );
+
+ // Enqueue google pay script.
+ if ( $google_pay_enabled ) {
+
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $environment = 'sandbox' === $core_settings['ckocom_environment'];
+ $currency_code = get_woocommerce_currency();
+ $total_price = WC()->cart->total;
+
+ // Logic for order-pay page.
+ // If on order-pay page, try fetching order total from the last order.
+ if ( is_wc_endpoint_url( 'order-pay' ) ) {
+
+ global $wp;
+
+ // Get order ID from URL if available.
+ $order_id = absint( $wp->query_vars['order-pay'] );
+
+ if ( ! $order_id && isset( $_GET['key'] ) ) {
+ $pay_order = wc_get_order( wc_get_order_id_by_order_key( sanitize_text_field( $_GET['key'] ) ) );
+ } else {
+ $pay_order = wc_get_order( $order_id );
+ }
+
+ if ( $pay_order ) {
+ $total_price = $pay_order->get_total();
+ }
+ }
+
+ $vars = [
+ 'environment' => $environment ? 'TEST' : 'PRODUCTION',
+ 'public_key' => $core_settings['ckocom_pk'],
+ 'merchant_id' => $this->get_option( 'ckocom_google_merchant_id' ),
+ 'currency_code' => $currency_code,
+ 'total_price' => $total_price,
+ 'button_type' => $this->get_option( 'ckocom_google_style', 'google-pay-black' ),
+ ];
+
+ wp_localize_script( 'cko-google-pay-integration-script', 'cko_google_pay_vars', $vars );
+
+ wp_enqueue_script( 'cko-google-pay-integration-script' );
+ }
+ }
+
+ /**
+ * Show module configuration in backend.
+ *
+ * @return string|void
+ */
+ public function init_form_fields() {
+ $this->form_fields = WC_Checkoutcom_Cards_Settings::google_settings();
+ $this->form_fields = array_merge(
+ $this->form_fields,
+ [
+ 'screen_button' => [
+ 'id' => 'screen_button',
+ 'type' => 'screen_button',
+ 'title' => __( 'Other Settings', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+ }
+
+ /**
+ * Generate links for the admin page.
+ *
+ * @param string $key The key.
+ * @param array $value The value.
+ */
+ public function generate_screen_button_html( $key, $value ) {
+ WC_Checkoutcom_Admin::generate_links( $key, $value );
+ }
+
+ /**
+ * Show frames js on checkout page.
+ */
+ public function payment_fields() {
+
+ if ( ! empty( $this->get_option( 'description' ) ) ) {
+ echo esc_html( $this->get_option( 'description' ) );
+ }
+
+ ?>
+
+
+
+ create_payment( $order, $google_token );
+
+ // Redirect to apm if redirection url is available.
+ if ( isset( $result['3d'] ) && ! empty( $result['3d'] ) ) {
+
+ $order->add_order_note(
+ sprintf(
+ /* translators: %s: URL */
+ esc_html__( 'Checkout.com 3d Redirect waiting. URL : %s', 'checkout-com-unified-payments-api' ),
+ $result['3d']
+ )
+ );
+
+ return [
+ 'result' => 'success',
+ 'redirect' => $result['3d'],
+ ];
+ }
+
+ // check if result has error and return error message.
+ if ( isset( $result['error'] ) && ! empty( $result['error'] ) ) {
+ WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'] );
+ return;
+ }
+
+ if ( class_exists( 'WC_Subscriptions_Order' ) ) {
+ // Save source id for subscription.
+ WC_Checkoutcom_Subscription::save_source_id( $order_id, $order, $result['source']['id'] );
+ }
+
+ // Set action id as woo transaction id.
+ $order->set_transaction_id( $result['action_id'] );
+ $order->update_meta_data( '_cko_payment_id', $result['id'] );
+
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Authorised - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+
+ // check if payment was flagged.
+ if ( $result['risk']['flagged'] ) {
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_flagged', 'flagged' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Flagged - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+ }
+
+ // add notes for the order and update status.
+ $order->add_order_note( $message );
+ $order->update_status( $status );
+
+ // Reduce stock levels.
+ wc_reduce_stock_levels( $order_id );
+
+ // Remove cart.
+ WC()->cart->empty_cart();
+
+ // Return thank you page.
+ return [
+ 'result' => 'success',
+ 'redirect' => $this->get_return_url( $order ),
+ ];
+ }
+
+ /**
+ * Handle Google Pay refund.
+ *
+ * @param int $order_id Order ID.
+ * @param null $amount Amount to refund.
+ * @param string $reason Reason for refund.
+ *
+ * @return bool|WP_Error
+ */
+ public function process_refund( $order_id, $amount = null, $reason = '' ) {
+ $order = wc_get_order( $order_id );
+ $result = (array) WC_Checkoutcom_Api_Request::refund_payment( $order_id, $order );
+
+ // check if result has error and return error message.
+ if ( ! empty( $result['error'] ) ) {
+ WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'] );
+ return false;
+ }
+
+ // Set action id as woo transaction id.
+ $order->set_transaction_id( $result['action_id'] );
+ $order->save();
+
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_refunded', 'refunded' );
+
+ /* translators: %s: Action ID. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment refunded - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+
+ if ( isset( $_SESSION['cko-refund-is-less'] ) ) {
+ if ( $_SESSION['cko-refund-is-less'] ) {
+ /* translators: %s: Action ID. */
+ $order->add_order_note( sprintf( esc_html__( 'Checkout.com Payment Partially refunded - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] ) );
+
+ unset( $_SESSION['cko-refund-is-less'] );
+
+ return true;
+ }
+ }
+
+ // Add notes for the order and update status.
+ $order->add_order_note( $message );
+ $order->update_status( $status );
+
+ return true;
+ }
+}
diff --git a/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-paypal.php b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-paypal.php
new file mode 100644
index 00000000..746f12e6
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-paypal.php
@@ -0,0 +1,1034 @@
+id = 'wc_checkout_com_paypal';
+ $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' );
+ $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' );
+ $this->title = __( 'PayPal', 'checkout-com-unified-payments-api' );
+ $this->has_fields = true;
+ $this->supports = [
+ 'products',
+ 'refunds',
+ 'subscriptions',
+ 'subscription_cancellation',
+ 'subscription_suspension',
+ 'subscription_reactivation',
+ 'subscription_date_changes',
+ ];
+
+ $this->init_form_fields();
+ $this->init_settings();
+
+ // Turn these settings into variables we can use.
+ foreach ( $this->settings as $setting_key => $value ) {
+ $this->$setting_key = $value;
+ }
+
+ add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] );
+
+ // PayPal Payment scripts.
+ add_action( 'wp_enqueue_scripts', [ $this, 'payment_scripts' ] );
+ add_filter( 'script_loader_tag', [ $this, 'add_attributes_to_script' ], 10, 3 );
+
+ add_action( 'woocommerce_api_' . strtolower( 'CKO_Paypal_Woocommerce' ), [ $this, 'handle_wc_api' ] );
+ }
+
+ /**
+ * Handle paypal method API requests.
+ *
+ * @return void
+ */
+ public function handle_wc_api() {
+
+ // phpcs:disable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing
+ if ( ! empty( $_GET['cko_paypal_action'] ) ) {
+ switch ( $_GET['cko_paypal_action'] ) {
+
+ case 'create_order':
+ if ( ! empty( $_POST ) ) {
+ // Check if this is an express checkout request
+ // phpcs:ignore WordPress.Security.NonceVerification.Missing
+ $express_checkout = ! empty( $_POST['express_checkout'] ) || ! empty( $_POST['use_existing_cart'] );
+
+ if ( $express_checkout ) {
+ // Route to express checkout handler
+ $this->cko_express_create_order();
+ break;
+ }
+
+ WC()->checkout->process_checkout();
+
+ if ( wc_notice_count( 'error' ) > 0 ) {
+ WC()->session->set( 'reload_checkout', true );
+ $error_messages_data = wc_get_notices( 'error' );
+ $error_messages = array();
+ foreach ( $error_messages_data as $key => $value ) {
+ $error_messages[] = $value['notice'];
+ }
+ wc_clear_notices();
+ ob_start();
+ wp_send_json_error( array( 'messages' => $error_messages ) );
+ exit;
+ }
+ exit();
+ }
+ break;
+
+ case 'empty_session':
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_paypal_order_id', '' );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_pc_id', '' );
+
+ case 'cc_capture':
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_paypal_order_id', wc_clean( $_GET['paypal_order_id'] ) );
+ $this->cko_cc_capture();
+ break;
+
+ case 'express_add_to_cart':
+ $this->cko_express_add_to_cart();
+ break;
+
+ case 'express_create_order':
+ $this->cko_express_create_order();
+ break;
+
+ case 'express_paypal_order_session':
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_paypal_order_id', wc_clean( $_GET['paypal_order_id'] ) );
+ $this->cko_express_paypal_order_session();
+ break;
+
+ case 'order_pay':
+ $this->cko_create_order_request();
+ break;
+ }
+ }
+
+ // phpcs:enable
+ exit();
+ }
+
+ public function cko_express_add_to_cart() {
+ if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'checkoutcom_paypal_express_add_to_cart' ) ) {
+ wp_send_json( [ 'result' => 'failed' ] );
+ }
+
+ if ( ! defined( 'WOOCOMMERCE_CART' ) ) {
+ define( 'WOOCOMMERCE_CART', true );
+ }
+
+ WC()->shipping->reset_shipping();
+
+ $product_id = isset( $_POST['product_id'] ) ? absint( $_POST['product_id'] ) : 0;
+ $qty = ! isset( $_POST['qty'] ) ? 1 : absint( $_POST['qty'] );
+ $product = wc_get_product( $product_id );
+ $product_type = $product->get_type();
+
+ // First empty the cart to prevent wrong calculation.
+ WC()->cart->empty_cart();
+
+ if ( ( 'variable' === $product_type || 'variable-subscription' === $product_type ) && isset( $_POST['attributes'] ) ) {
+ $attributes = wc_clean( wp_unslash( $_POST['attributes'] ) );
+
+ $data_store = WC_Data_Store::load( 'product' );
+ $variation_id = $data_store->find_matching_product_variation( $product, $attributes );
+
+ $is_added_to_cart = WC()->cart->add_to_cart( $product->get_id(), $qty, $variation_id, $attributes );
+ }
+
+ if ( in_array( $product_type, [ 'simple', 'variation', 'subscription', 'subscription_variation' ], true ) ) {
+ $is_added_to_cart = WC()->cart->add_to_cart( $product->get_id(), $qty );
+ }
+
+ WC()->cart->calculate_totals();
+
+ $data = [];
+ $data['result'] = 'success';
+ $data['total'] = WC()->cart->total;
+
+ wp_send_json( $data );
+ }
+
+ public function cko_express_create_order() {
+
+ // phpcs:ignore WordPress.Security.NonceVerification.Missing
+ $express_checkout = ! empty( $_POST['express_checkout'] );
+ $add_to_cart = isset( $_POST['add_to_cart'] ) ? sanitize_text_field( wp_unslash( $_POST['add_to_cart'] ) ) : '';
+ $use_existing_cart = ! empty( $_POST['use_existing_cart'] );
+
+ // For product pages, check if add_to_cart was successful
+ if ( $express_checkout && ! empty( $add_to_cart ) && 'success' !== $add_to_cart ) {
+ wp_send_json_error( [ 'messages' => 'Failed to add product to cart' ] );
+ return;
+ }
+
+ // Ensure cart is loaded - important for Blocks cart pages
+ if ( ! WC()->cart ) {
+ wp_send_json_error( [ 'messages' => 'Cart not initialized' ] );
+ return;
+ }
+
+ // For Blocks cart pages, ensure cart is loaded from session
+ // This is important because Blocks cart might not have synced with server session
+ if ( $use_existing_cart ) {
+ // Force cart to load from session
+ WC()->cart->get_cart_from_session();
+
+ // Recalculate totals to ensure we have the latest
+ WC()->cart->calculate_totals();
+
+ // Check if cart is empty after loading from session
+ if ( WC()->cart->is_empty() ) {
+ wp_send_json_error( [ 'messages' => 'Cart is empty' ] );
+ return;
+ }
+ }
+
+ // For product pages, ensure cart is not empty after adding product
+ if ( ! $use_existing_cart && WC()->cart->is_empty() ) {
+ wp_send_json_error( [ 'messages' => 'Cart is empty' ] );
+ return;
+ }
+
+ $this->cko_create_order_request( true );
+ }
+
+ public function cko_express_paypal_order_session() {
+ $cko_paypal_order_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_paypal_order_id' );
+ $cko_pc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_id' );
+
+ // If we have a payment context, process the express checkout immediately
+ if ( ! empty( $cko_pc_id ) ) {
+ try {
+ // Create the order from cart
+ $order = $this->create_express_order_from_cart();
+
+ if ( ! $order ) {
+ wp_send_json_error( array( 'messages' => 'Failed to create order for PayPal Express checkout.' ) );
+ return;
+ }
+
+ // Get payment context details
+ $checkout = new Checkout_SDK();
+ $response = $checkout->get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_pc_id );
+
+ $payment_context_id = $cko_pc_id;
+ $processing_channel_id = $response['payment_request']['processing_channel_id'];
+
+ // Process the payment immediately
+ $payment_response = $this->request_payment( $order, $payment_context_id, $processing_channel_id );
+
+ // Debug: Log the payment response
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Payment response received: ' . print_r( $payment_response, true ) );
+
+ // Clear PayPal session
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_paypal_order_id', '' );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_pc_id', '' );
+
+ // Check if payment was successful
+ if ( isset( $payment_response['result'] ) && $payment_response['result'] === 'success' ) {
+ // Payment was successful - use the redirect URL from the response
+ $redirect_url = $payment_response['redirect'];
+
+ // Debug logging
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Payment successful, redirecting to: ' . $redirect_url );
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Order ID: ' . $order->get_id() . ', Order Key: ' . $order->get_order_key() );
+
+ wp_send_json_success( array( 'redirect_url' => $redirect_url ) );
+ } else {
+ // Payment failed
+ $order->update_status( 'failed', 'PayPal Express payment failed.' );
+ wp_send_json_error( array( 'messages' => 'Payment failed. Please try again.' ) );
+ }
+
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+ $error_message = 'An error occurred while processing PayPal Express payment. ';
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ wp_send_json_error( array( 'messages' => $error_message ) );
+ }
+ } else {
+ // No payment context, just return success (fallback to old behavior)
+ wp_send_json_success();
+ }
+ }
+
+ /**
+ * Create order from cart for PayPal Express checkout.
+ *
+ * @return WC_Order|false
+ */
+ private function create_express_order_from_cart() {
+ try {
+ // Determine customer ID and email
+ $customer_id = 0;
+ $customer_email = '';
+
+ // Check if user is logged in
+ if ( is_user_logged_in() ) {
+ $current_user = wp_get_current_user();
+ $customer_id = $current_user->ID;
+ $customer_email = $current_user->user_email;
+ } else {
+ // For guest users, get email from PayPal data
+ $paypal_email = $this->get_paypal_email_from_context();
+ if ( ! empty( $paypal_email ) ) {
+ $customer_email = $paypal_email;
+ }
+ }
+
+ // Create order with proper customer ID
+ $order = wc_create_order( array( 'customer_id' => $customer_id ) );
+
+ if ( ! $order ) {
+ return false;
+ }
+
+ // Set customer email if we have one
+ if ( ! empty( $customer_email ) ) {
+ $order->set_billing_email( $customer_email );
+ }
+
+ // Add cart items to order
+ foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
+ $product = $cart_item['data'];
+ $order->add_product( $product, $cart_item['quantity'] );
+ }
+
+ // Set order addresses from PayPal data if available
+ $this->set_order_addresses_from_paypal( $order );
+
+ // Set shipping method if available
+ $shipping_packages = WC()->shipping->get_packages();
+ if ( ! empty( $shipping_packages ) ) {
+ foreach ( $shipping_packages as $package ) {
+ $chosen_methods = WC()->session->get( 'chosen_shipping_methods' );
+ if ( ! empty( $chosen_methods ) ) {
+ $order->set_shipping_method( $chosen_methods[0] );
+ }
+ }
+ }
+
+ // Calculate totals
+ $order->calculate_totals();
+
+ // Set payment method to PayPal Express
+ $order->set_payment_method( 'wc_checkout_com_paypal' );
+ $order->set_payment_method_title( 'PayPal Express' );
+
+ // Set order status
+ $order->set_status( 'pending' );
+ $order->save();
+
+ // Store order ID in session for potential use
+ WC()->session->set( 'order_awaiting_payment', $order->get_id() );
+
+ return $order;
+
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( 'Error creating PayPal Express order: ' . $e->getMessage(), $e );
+ return false;
+ }
+ }
+
+ /**
+ * Set order addresses from PayPal payment context data.
+ *
+ * @param WC_Order $order
+ */
+ private function set_order_addresses_from_paypal( $order ) {
+ $cko_pc_details = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_details' );
+
+ if ( empty( $cko_pc_details ) ) {
+ // Try to get payment context details
+ $cko_pc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_id' );
+ if ( ! empty( $cko_pc_id ) ) {
+ try {
+ $checkout = new Checkout_SDK();
+ $cko_pc_details = $checkout->get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_pc_id );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_pc_details', $cko_pc_details );
+ } catch ( Exception $e ) {
+ // If we can't get details, use default addresses
+ return;
+ }
+ }
+ }
+
+ if ( isset( $cko_pc_details['payment_request']['shipping']['address'] ) ) {
+ $paypal_shipping_address = $cko_pc_details['payment_request']['shipping']['address'];
+ $shipping_name = $cko_pc_details['payment_request']['shipping']['first_name'] ?? '';
+ $shipping_name_parts = explode( ' ', $shipping_name );
+ $shipping_first_name = $shipping_name_parts[0] ?? '';
+ $shipping_last_name = $shipping_name_parts[1] ?? '';
+
+ // Set shipping address
+ $order->set_shipping_first_name( $shipping_first_name );
+ $order->set_shipping_last_name( $shipping_last_name );
+ $order->set_shipping_address_1( $paypal_shipping_address['address_line1'] ?? '' );
+ $order->set_shipping_address_2( $paypal_shipping_address['address_line2'] ?? '' );
+ $order->set_shipping_city( $paypal_shipping_address['city'] ?? '' );
+ $order->set_shipping_postcode( $paypal_shipping_address['zip'] ?? '' );
+ $order->set_shipping_country( $paypal_shipping_address['country'] ?? '' );
+
+ // Set billing address (same as shipping for PayPal Express)
+ $order->set_billing_first_name( $shipping_first_name );
+ $order->set_billing_last_name( $shipping_last_name );
+ $order->set_billing_address_1( $paypal_shipping_address['address_line1'] ?? '' );
+ $order->set_billing_address_2( $paypal_shipping_address['address_line2'] ?? '' );
+ $order->set_billing_city( $paypal_shipping_address['city'] ?? '' );
+ $order->set_billing_postcode( $paypal_shipping_address['zip'] ?? '' );
+ $order->set_billing_country( $paypal_shipping_address['country'] ?? '' );
+
+ // Set email based on user login status
+ if ( is_user_logged_in() ) {
+ // For logged-in users, use their account email
+ $current_user = wp_get_current_user();
+ if ( $current_user && $current_user->user_email ) {
+ $order->set_billing_email( $current_user->user_email );
+ }
+ } else {
+ // For guest users, get email from PayPal data
+ $paypal_email = $this->get_paypal_email_from_context( $cko_pc_details );
+ if ( ! empty( $paypal_email ) ) {
+ $order->set_billing_email( $paypal_email );
+ }
+ }
+ }
+ }
+
+ /**
+ * Get PayPal email from payment context details.
+ * Checks multiple possible locations in the PayPal response.
+ *
+ * @param array $cko_pc_details Payment context details (optional, will fetch if not provided).
+ * @return string Email address or empty string if not found.
+ */
+ private function get_paypal_email_from_context( $cko_pc_details = null ) {
+ if ( empty( $cko_pc_details ) ) {
+ $cko_pc_details = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_details' );
+ }
+
+ if ( empty( $cko_pc_details ) ) {
+ // Try to get payment context details
+ $cko_pc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_id' );
+ if ( ! empty( $cko_pc_id ) ) {
+ try {
+ $checkout = new Checkout_SDK();
+ $cko_pc_details = $checkout->get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_pc_id );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_pc_details', $cko_pc_details );
+ } catch ( Exception $e ) {
+ return '';
+ }
+ }
+ }
+
+ if ( empty( $cko_pc_details ) || ! isset( $cko_pc_details['payment_request'] ) ) {
+ return '';
+ }
+
+ // Try to get email from different possible locations in PayPal response
+ // Check source.account_holder.email first (this is where PayPal often puts it)
+ if ( isset( $cko_pc_details['payment_request']['source']['account_holder']['email'] ) ) {
+ return $cko_pc_details['payment_request']['source']['account_holder']['email'];
+ }
+
+ if ( isset( $cko_pc_details['payment_request']['shipping']['email'] ) ) {
+ return $cko_pc_details['payment_request']['shipping']['email'];
+ }
+
+ if ( isset( $cko_pc_details['payment_request']['billing']['email'] ) ) {
+ return $cko_pc_details['payment_request']['billing']['email'];
+ }
+
+ if ( isset( $cko_pc_details['payment_request']['payer']['email'] ) ) {
+ return $cko_pc_details['payment_request']['payer']['email'];
+ }
+
+ // Try additional locations that might contain email
+ if ( isset( $cko_pc_details['payment_request']['customer']['email'] ) ) {
+ return $cko_pc_details['payment_request']['customer']['email'];
+ }
+
+ return '';
+ }
+
+ /**
+ * Process payment with PayPal.
+ *
+ * @param int $order_id Order ID.
+ *
+ * @return array
+ */
+ public function process_payment( $order_id ) {
+ if ( ! session_id() ) {
+ session_start();
+ }
+
+ $cko_paypal_order_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_paypal_order_id' );
+ $cko_pc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_id' );
+
+ if ( ! empty( $cko_pc_id ) ) {
+
+ try {
+ $checkout = new Checkout_SDK();
+ $response = $checkout->get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_pc_id );
+
+ $order_id = absint( WC()->session->get( 'order_awaiting_payment' ) );
+ $order = wc_get_order( $order_id );
+
+ $payment_context_id = $cko_pc_id;
+ $processing_channel_id = $response['payment_request']['processing_channel_id'];
+
+ // Payment request to capture amount.
+ $return_response = $this->request_payment( $order, $payment_context_id, $processing_channel_id );
+
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_paypal_order_id', '' );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_pc_id', '' );
+
+ wp_send_json( $return_response );
+
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = 'An error has occurred while processing PayPal getPaymentContextDetails request. ';
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ wp_send_json_error( [ 'messages' => $error_message ] );
+ }
+ } else {
+ // Not express checkout
+ $this->cko_create_order_request();
+ }
+
+ exit();
+ }
+
+ /**
+ * Handle PayPal PaymentContexts request with cart data.
+ *
+ * 1st step to generate PayPal Order ID.
+ *
+ * @return void
+ */
+ public function cko_create_order_request( $is_express = false ) {
+
+ // Ensure cart is loaded and totals are calculated
+ // This is important for Blocks cart pages
+ if ( ! WC()->cart ) {
+ wp_send_json_error( array( 'messages' => 'Cart not initialized' ) );
+ return;
+ }
+
+ // For Blocks cart pages, ensure cart is loaded from session
+ // Sometimes the cart needs to be refreshed from the session
+ if ( WC()->cart->is_empty() ) {
+ // Try to load cart from session
+ WC()->cart->get_cart_from_session();
+ WC()->cart->calculate_totals();
+ }
+
+ // Recalculate totals to ensure we have the latest (important for Blocks cart)
+ WC()->cart->calculate_totals();
+
+ // For Blocks cart pages, ensure cart contents are loaded
+ if ( WC()->cart->is_empty() ) {
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Cart is empty after session load. Cart contents: ' . print_r( WC()->cart->get_cart(), true ) );
+ wp_send_json_error( array( 'messages' => 'Cart is empty. Please add items to your cart.' ) );
+ return;
+ }
+
+ $paymentContextsRequest = new Checkout\Payments\Contexts\PaymentContextsRequest();
+ $paymentContextsRequest->source = new Checkout\Payments\Request\Source\Apm\RequestPayPalSource();
+ $paymentContextsRequest->currency = get_woocommerce_currency();
+
+ $paymentContextsRequest->processing = new Checkout\Payments\Contexts\PaymentContextsProcessing();
+ $paymentContextsRequest->processing->shipping_preference = Checkout\Payments\ShippingPreference::$GET_FROM_FILE;
+
+ if ( $is_express ) {
+ $paymentContextsRequest->processing->user_action = Checkout\Payments\UserAction::$CONTINUE;
+ }
+
+ // Get cart total - use 'raw' to get the numeric value directly
+ $total_amount = WC()->cart->get_total( 'raw' );
+
+ // Fallback to formatted total if raw is 0
+ if ( $total_amount <= 0 ) {
+ $total_amount = WC()->cart->total;
+ }
+
+ // Validate that we have a valid total amount
+ if ( $total_amount <= 0 ) {
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Invalid cart total. Cart contents: ' . print_r( WC()->cart->get_cart(), true ) );
+ wp_send_json_error( array( 'messages' => 'Cart total is invalid. Please refresh the page and try again.' ) );
+ return;
+ }
+
+ // Logic for order-pay page.
+
+ $is_order_pay = get_option( 'woocommerce_checkout_pay_endpoint', 'order-pay' );
+
+ $nonce = isset( $_POST['woocommerce-pay-nonce'] ) ? sanitize_text_field( wp_unslash( $_POST['woocommerce-pay-nonce'] ) ) : '';
+
+ if ( ! empty( $nonce ) && wp_verify_nonce( $nonce, 'woocommerce-pay' ) ) {
+
+ $referer_url = isset( $_POST['_wp_http_referer'] ) ? esc_url_raw( wp_unslash( $_POST['_wp_http_referer'] ) ) : '';
+
+ if ( strpos( $referer_url, "/{$is_order_pay}/" ) !== false ) {
+ $parts = explode( '/', trim( $referer_url, '/' ) );
+
+ $order_pay_id = isset( $parts[2] ) ? absint( $parts[2] ) : 0;
+
+ $pay_order = wc_get_order( $order_pay_id );
+
+ if ( $pay_order ) {
+ $total_amount = $pay_order->get_total();
+ }
+ }
+ }
+
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_amount, get_woocommerce_currency() );
+
+ $paymentContextsRequest->amount = $amount_cents;
+ $paymentContextsRequest->capture = true;
+
+ $paymentContextsRequest->payment_type = PaymentType::$regular;
+
+ if ( WC_Checkoutcom_Utility::is_cart_contains_subscription() ) {
+ $paymentContextsRequest->payment_type = PaymentType::$recurring;
+
+ $plan = new Checkout\Payments\BillingPlan();
+ $plan->type = Checkout\Payments\BillingPlanType::$merchant_initiated_billing_single_agreement;
+
+ $paymentContextsRequest->processing->plan = $plan;
+ }
+
+ $items = new Checkout\Payments\Contexts\PaymentContextsItems();
+ $items->name = 'All Products';
+ $items->unit_price = $amount_cents;
+ $items->quantity = '1';
+
+ $paymentContextsRequest->items = [ $items ];
+
+ $checkout = new Checkout_SDK();
+
+ try {
+ $response = $checkout->get_builder()->getPaymentContextsClient()->createPaymentContexts( $paymentContextsRequest );
+
+ // Log the full response for debugging
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Payment context response. Full response: ' . print_r( $response, true ) );
+
+ if ( ! isset( $response['id'] ) ) {
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: No payment context ID in response. Response: ' . print_r( $response, true ) );
+ wp_send_json_error( [ 'messages' => 'Failed to create PayPal payment context. No ID returned.' ] );
+ return;
+ }
+
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_pc_id', $response['id'] );
+
+ // Return order_id from partner_metadata (PayPal Order ID)
+ // Check multiple possible locations for order_id
+ $order_id = null;
+ if ( isset( $response['partner_metadata']['order_id'] ) ) {
+ $order_id = $response['partner_metadata']['order_id'];
+ } elseif ( isset( $response['partner_metadata'] ) && is_array( $response['partner_metadata'] ) ) {
+ // Try to find order_id anywhere in partner_metadata
+ foreach ( $response['partner_metadata'] as $key => $value ) {
+ if ( 'order_id' === $key || 'orderId' === $key || 'order-id' === $key ) {
+ $order_id = $value;
+ break;
+ }
+ }
+ } elseif ( isset( $response['order_id'] ) ) {
+ $order_id = $response['order_id'];
+ }
+
+ if ( $order_id ) {
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Order ID found: ' . $order_id );
+ wp_send_json( [ 'order_id' => $order_id ], 200 );
+ } else {
+ // If no order_id found, log and return error
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: No order_id found in response. Response structure: ' . print_r( $response, true ) );
+ wp_send_json_error( [ 'messages' => 'Failed to create PayPal order. No order ID returned from payment context.' ] );
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = 'An error has occurred while processing PayPal createPaymentContexts request. ';
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ // Log detailed error information
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: CheckoutApiException caught. Error message: ' . $ex->getMessage() );
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Exception details: ' . print_r( $ex, true ) );
+
+ // Get more detailed error information if available
+ if ( method_exists( $ex, 'getErrorDetails' ) ) {
+ $error_details = $ex->getErrorDetails();
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Error details: ' . print_r( $error_details, true ) );
+ if ( is_array( $error_details ) && isset( $error_details['error_codes'] ) ) {
+ $error_message .= ' Error codes: ' . implode( ', ', $error_details['error_codes'] );
+ }
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ wp_send_json_error( [ 'messages' => $error_message ] );
+ } catch ( \Exception $ex ) {
+ // Catch any other exceptions
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: General exception caught. Error: ' . $ex->getMessage() );
+ WC_Checkoutcom_Utility::logger( 'PayPal Express: Exception trace: ' . $ex->getTraceAsString() );
+ wp_send_json_error( [ 'messages' => 'An unexpected error occurred: ' . $ex->getMessage() ] );
+ }
+
+ exit();
+ }
+
+ /**
+ * Handle last payment request to capture payment.
+ *
+ * @return void
+ */
+ public function cko_cc_capture() {
+ $cko_paypal_order_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_paypal_order_id' );
+ $cko_pc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_id' );
+
+ if ( empty( $cko_pc_id ) ) {
+ return;
+ }
+
+ try {
+ $checkout = new Checkout_SDK();
+ $response = $checkout->get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_pc_id );
+
+ $order_id = absint( WC()->session->get( 'order_awaiting_payment' ) );
+ $order = wc_get_order( $order_id );
+
+ $payment_context_id = $cko_pc_id;
+ $processing_channel_id = $response['payment_request']['processing_channel_id'];
+
+ // Payment request to capture amount.
+ $return_response = $this->request_payment( $order, $payment_context_id, $processing_channel_id );
+
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_paypal_order_id', '' );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_pc_id', '' );
+
+ wp_send_json_success( $return_response );
+
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = 'An error has occurred while processing PayPal getPaymentContextDetails request. ';
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ wp_send_json_error( [ 'messages' => $error_message ] );
+ }
+ }
+
+ /**
+ * Handle request to capture amount.
+ *
+ * @param WC_Order $order Order object.
+ * @param string $payment_context_id Payment Context ID.
+ * @param string $processing_channel_id Processing channel ID.
+ * @return array|void
+ */
+ public function request_payment( $order, $payment_context_id, $processing_channel_id ) {
+
+ try {
+ $checkout = new Checkout_SDK();
+
+ $amount = $order->get_total();
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $amount, $order->get_currency() );
+
+ $payment_request_param = $checkout->get_payment_request();
+ $payment_request_param->payment_context_id = $payment_context_id;
+ $payment_request_param->processing_channel_id = $processing_channel_id;
+ $payment_request_param->reference = $order->get_order_number();
+ $payment_request_param->amount = $amount_cents;
+
+ $items = new Checkout\Payments\Contexts\PaymentContextsItems();
+ $items->name = 'All Products';
+ $items->unit_price = $amount_cents;
+ $items->quantity = '1';
+
+ $payment_request_param->items = [ $items ];
+
+ $response = $checkout->get_builder()->getPaymentsClient()->requestPayment( $payment_request_param );
+ $response_code = $response['http_metadata']->getStatusCode();
+
+ if ( ! WC_Checkoutcom_Utility::is_successful( $response ) || 'Declined' === $response['status'] ) {
+ $order->update_meta_data( '_cko_payment_id', $response['id'] );
+ $order->save();
+
+ $error_message = esc_html__( 'An error has occurred while PayPal payment request. ', 'checkout-com-unified-payments-api' );
+
+ wp_send_json_error( [ 'messages' => $error_message ] );
+ }
+
+ /**
+ * Full Success = 201
+ * Partial Success = 202
+ *
+ * Ref : https://api-reference.checkout.com/#operation/requestAPaymentOrPayout!path=1/payment_context_id&t=request
+ */
+ if ( in_array( $response_code, [ 201, 202 ], true ) ) {
+
+ $order->set_transaction_id( $response['id'] );
+ $order->update_meta_data( '_cko_payment_id', $response['id'] );
+
+ if ( class_exists( 'WC_Subscriptions_Order' ) && isset( $response['source'] ) ) {
+ // Save source id for subscription.
+ WC_Checkoutcom_Subscription::save_source_id( $order->get_id(), $order, $response['source']['id'] );
+ }
+
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
+
+ $order->update_meta_data( 'cko_payment_authorized', true );
+ $order->update_status( $status );
+
+ // Reduce stock levels.
+ wc_reduce_stock_levels( $order->get_id() );
+
+ // Remove cart.
+ WC()->cart->empty_cart();
+
+ // Return thank you page.
+ return [
+ 'result' => 'success',
+ 'redirect' => $this->get_return_url( $order ),
+ ];
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = esc_html__( 'An error has occurred while PayPal payment request. ', 'checkout-com-unified-payments-api' );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ wp_send_json_error( [ 'messages' => $error_message ] );
+ }
+ }
+
+ /**
+ * Show module configuration in backend.
+ *
+ * @return string|void
+ */
+ public function init_form_fields() {
+ $this->form_fields = WC_Checkoutcom_Cards_Settings::paypal_settings();
+ $this->form_fields = array_merge(
+ $this->form_fields,
+ [
+ 'screen_button' => [
+ 'id' => 'screen_button',
+ 'type' => 'screen_button',
+ 'title' => __( 'Other Settings', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+ }
+
+ /**
+ * Generate links for the admin page.
+ *
+ * @param string $key The key.
+ * @param array $value The value.
+ */
+ public function generate_screen_button_html( $key, $value ) {
+ WC_Checkoutcom_Admin::generate_links( $key, $value );
+ }
+
+ /**
+ * Add attributes to script tag.
+ *
+ * @param string $tag HTML for the script tag.
+ * @param string $handle Handle of script.
+ * @param string $src Src of script.
+ * @return string
+ */
+ public function add_attributes_to_script( $tag, $handle, $src ) {
+ if ( 'cko-paypal-script' !== $handle ) {
+ return $tag;
+ }
+
+ return str_replace( '
+ is_type( 'variable' ) ) {
+ return;
+ }
+
+ $product_id = $product ? $product->get_id() : 0;
+ ?>
+
+
+ cart->is_empty() ) {
+ return;
+ }
+
+ // Check if unified express checkout container should be rendered
+ $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', array() );
+ $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() );
+
+ $paypal_express_enabled = isset( $paypal_settings['paypal_express'] )
+ && 'yes' === $paypal_settings['paypal_express']
+ && ! empty( $paypal_settings['paypal_express'] );
+ $paypal_available = WC_Checkoutcom_Utility::is_paypal_express_available();
+ $paypal_show_on_cart = ! isset( $paypal_settings['paypal_express_cart_page'] )
+ || ( isset( $paypal_settings['paypal_express_cart_page'] )
+ && 'yes' === $paypal_settings['paypal_express_cart_page']
+ && ! empty( $paypal_settings['paypal_express_cart_page'] ) );
+
+ $google_pay_express_enabled = isset( $google_pay_settings['google_pay_express'] )
+ && 'yes' === $google_pay_settings['google_pay_express']
+ && ! empty( $google_pay_settings['google_pay_express'] );
+ $google_pay_available = WC_Checkoutcom_Utility::is_google_pay_express_available();
+ $google_pay_show_on_cart = ! isset( $google_pay_settings['google_pay_express_cart_page'] )
+ || ( isset( $google_pay_settings['google_pay_express_cart_page'] )
+ && 'yes' === $google_pay_settings['google_pay_express_cart_page']
+ && ! empty( $google_pay_settings['google_pay_express_cart_page'] ) );
+
+ // Check if unified container has been rendered
+ $unified_container_rendered = WC_Checkoutcom_Utility::express_checkout_container_rendered();
+
+ // Determine if we should render unified container
+ $should_render_unified = ! $unified_container_rendered && (
+ ( $paypal_express_enabled && $paypal_available && $paypal_show_on_cart ) ||
+ ( $google_pay_express_enabled && $google_pay_available && $google_pay_show_on_cart )
+ );
+
+ // Render unified container only once if at least one other express method is enabled
+ if ( $should_render_unified ) {
+ WC_Checkoutcom_Utility::express_checkout_container_rendered( true );
+ $container_rendered = true;
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ [
+ 'title' => __( 'Core settings', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => '',
+ ],
+ 'enabled' => [
+ 'id' => 'enable',
+ 'title' => __( 'Enable/Disable', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'label' => __( 'Enable Checkout.com cards payment', 'checkout-com-unified-payments-api' ),
+ 'description' => __( 'This enables Checkout.com. cards payment', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'default' => 'yes',
+ 'custom_attributes' => $should_disable_checkbox ? [ 'disabled' => 'disabled' ] : [],
+ ],
+ 'ckocom_checkout_mode' => [
+ 'title' => __( 'Checkout Mode', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'description' => __( 'Select the checkout mode for payment processing.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'options' => [
+ 'classic' => __( 'Classic', 'checkout-com-unified-payments-api' ),
+ 'flow' => __( 'Flow', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 'classic',
+ ],
+ 'ckocom_region' => [
+ 'title' => __( 'Region', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'description' => __( 'Choose subdomain for multi-region configuration', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'options' => [
+ 'global' => __( 'Global', 'checkout-com-unified-payments-api' ),
+ 'ksa' => __( 'KSA', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 'global',
+ 'custom_attributes' => [
+ 'disabled' => 'disabled',
+ ],
+ ],
+ 'ckocom_environment' => [
+ 'title' => __( 'Environment', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'description' => __( 'When going to production, make sure to set this to Live', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'options' => [
+ 'sandbox' => __( 'SandBox', 'checkout-com-unified-payments-api' ),
+ 'live' => __( 'Live', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 'sandbox',
+ ],
+ 'title' => [
+ 'title' => __( 'Payment Option Title', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'label' => __( 'Pay by Card with Checkout.com', 'checkout-com-unified-payments-api' ),
+ 'description' => __( 'Title that will be displayed on the checkout page', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'default' => 'Pay by Card with Checkout.com',
+ ],
+ 'ckocom_account_type' => [
+ 'title' => __( 'Account Type', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'description' => __( 'Contact support team to know your account type.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'options' => [
+ 'ABC' => __( 'ABC', 'checkout-com-unified-payments-api' ),
+ 'NAS' => __( 'NAS', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 'ABC',
+ ],
+ 'ckocom_sk' => [
+ 'title' => __( 'Secret Key', 'checkout-com-unified-payments-api' ),
+ 'type' => 'password',
+ /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */
+ 'description' => sprintf( __( 'You can %1$s find your secret key %2$s in the Checkout.com Hub', 'checkout-com-unified-payments-api' ), '', '' ),
+ 'placeholder' => 'sk_xxx',
+ ],
+ 'ckocom_pk' => [
+ 'title' => __( 'Public Key', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */
+ 'description' => sprintf( __( 'You can %1$s find your public key %2$s in the Checkout.com Hub', 'checkout-com-unified-payments-api' ), '', '' ),
+ 'placeholder' => 'pk_xxx',
+ ],
+ 'enable_fallback_ac' => [
+ 'id' => 'enable',
+ 'title' => __( 'Fallback Account', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'label' => __( 'Enable Fallback Account(ABC account) for Refund', 'checkout-com-unified-payments-api' ),
+ 'default' => 'no',
+ ],
+ 'fallback_ckocom_sk' => [
+ 'title' => __( 'Secret Key', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'placeholder' => 'sk_xxx',
+ ],
+ 'fallback_ckocom_pk' => [
+ 'title' => __( 'Public Key', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'placeholder' => 'pk_xxx',
+ ],
+ ];
+
+ return apply_filters( 'wc_checkout_com_cards', $settings );
+ }
+
+ /**
+ * CKO admin card setting fields
+ *
+ * @return mixed|void
+ */
+ public static function cards_settings() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = $core_settings['ckocom_checkout_mode'];
+ $should_disable_flow_incompatible = false;
+
+ if ( 'flow' === $checkout_mode ) {
+ $should_disable_flow_incompatible = true;
+ }
+
+ $settings = [
+ 'card_setting' => [
+ 'title' => __( 'Card settings', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => '',
+ ],
+ 'ckocom_card_autocap' => [
+ 'id' => 'ckocom_card_autocap',
+ 'title' => __( 'Payment Action', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'Authorize only', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Authorize and Capture', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 1,
+ 'desc' => 'Set this to Authorise only if you want to manually capture the payment.',
+ ],
+ 'ckocom_card_cap_delay' => [
+ 'id' => 'ckocom_card_cap_delay',
+ 'title' => __( 'Capture Delay', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'desc' => __( 'The delay in hours (0 means immediately, 1.2 means one hour and 30 min)', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_card_threed' => [
+ 'id' => 'ckocom_card_threed',
+ 'title' => __( 'Use 3D Secure', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'No', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Yes', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => '3D secure payment',
+ ],
+ 'ckocom_card_notheed' => [
+ 'id' => 'ckocom_card_notheed',
+ 'title' => __( 'Attempt non-3D Secure', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'No', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Yes', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => 'Attempt non-3D Secure payment',
+ ],
+ 'ckocom_card_3ds_challenge_indicator' => [
+ 'id' => 'ckocom_card_3ds_challenge_indicator',
+ 'title' => __( '3DS Challenge Indicator', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 'no_preference' => __( 'No Preference', 'checkout-com-unified-payments-api' ),
+ 'no_challenge_requested' => __( 'No Challenge Requested', 'checkout-com-unified-payments-api' ),
+ 'challenge_requested' => __( 'Challenge Requested', 'checkout-com-unified-payments-api' ),
+ 'challenge_requested_mandate' => __( 'Challenge Requested Mandate', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 'no_preference',
+ 'desc' => __( 'Specifies the preference for whether a challenge should be performed', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_card_3ds_exemption' => [
+ 'id' => 'ckocom_card_3ds_exemption',
+ 'title' => __( '3DS Exemption', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ '' => __( 'No Exemption', 'checkout-com-unified-payments-api' ),
+ 'low_value' => __( 'Low Value', 'checkout-com-unified-payments-api' ),
+ 'trusted_listing' => __( 'Trusted Listing', 'checkout-com-unified-payments-api' ),
+ 'trusted_listing_prompt' => __( 'Trusted Listing Prompt', 'checkout-com-unified-payments-api' ),
+ 'transaction_risk_assessment' => __( 'Transaction Risk Assessment', 'checkout-com-unified-payments-api' ),
+ '3ds_outage' => __( '3DS Outage', 'checkout-com-unified-payments-api' ),
+ 'sca_delegation' => __( 'SCA Delegation', 'checkout-com-unified-payments-api' ),
+ 'out_of_sca_scope' => __( 'Out of SCA Scope', 'checkout-com-unified-payments-api' ),
+ 'low_risk_program' => __( 'Low Risk Program', 'checkout-com-unified-payments-api' ),
+ 'recurring_operation' => __( 'Recurring Operation', 'checkout-com-unified-payments-api' ),
+ 'data_share' => __( 'Data Share', 'checkout-com-unified-payments-api' ),
+ 'other' => __( 'Other', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => '',
+ 'desc' => __( 'Specifies the exemption type for 3DS authentication', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_card_3ds_allow_upgrade' => [
+ 'id' => 'ckocom_card_3ds_allow_upgrade',
+ 'title' => __( 'Allow 3DS Upgrade', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 'yes' => __( 'Yes', 'checkout-com-unified-payments-api' ),
+ 'no' => __( 'No', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 'yes',
+ 'desc' => __( 'Allow 3DS to be upgraded to a higher version if available', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_card_saved' => [
+ 'id' => 'ckocom_card_saved',
+ 'title' => __( 'Enable Save Cards', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'No', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Yes', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => 'Allow customers to save cards for future payments',
+ ],
+ 'ckocom_card_require_cvv' => [
+ 'id' => 'ckocom_card_require_cvv',
+ 'title' => __( 'Require CVV For Saved Cards', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'No', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Yes', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => 'Allow customers to save cards for future payments',
+ ],
+ 'ckocom_card_desctiptor' => [
+ 'id' => 'ckocom_card_desctiptor',
+ 'title' => __( 'Enable Dynamic Descriptor', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'No', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Yes', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => __( 'Dynamic Descriptor', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_card_desctiptor_name' => [
+ 'id' => 'ckocom_card_desctiptor_name',
+ 'title' => __( 'Descriptor Name', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'desc' => __( 'Maximum 25 characters)', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_card_desctiptor_city' => [
+ 'id' => 'ckocom_card_desctiptor_city',
+ 'title' => __( 'Descriptor City', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'desc' => __( 'Maximum 13 characters)', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_card_mada' => [
+ 'id' => 'ckocom_card_mada',
+ 'title' => __( 'Enable MADA Bin Check', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'No', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Yes', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => __( 'For processing MADA transactions, this option needs to be set to Yes', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_display_icon' => [
+ 'id' => 'ckocom_display_icon',
+ 'title' => __( 'Display Card Icons', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'No', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Yes', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => 'Enable/disable cards icon on checkout page',
+ 'custom_attributes' => $should_disable_flow_incompatible ? [ 'disabled' => 'disabled' ] : [],
+ ],
+ 'ckocom_card_icons' => [
+ 'id' => 'ckocom_card_icons',
+ 'title' => __( 'Card Icons', 'checkout-com-unified-payments-api' ),
+ 'type' => 'multiselect',
+ 'options' => [
+ 'visa' => __( 'Visa', 'checkout-com-unified-payments-api' ),
+ 'mastercard' => __( 'Mastercard', 'checkout-com-unified-payments-api' ),
+ 'amex' => __( 'American Express', 'checkout-com-unified-payments-api' ),
+ 'dinersclub' => __( 'Diners Club International', 'checkout-com-unified-payments-api' ),
+ 'discover' => __( 'Discover', 'checkout-com-unified-payments-api' ),
+ 'jcb' => __( 'JCB', 'checkout-com-unified-payments-api' ),
+ 'cartesbancaires' => __( 'Cartes Bancaires', 'checkout-com-unified-payments-api' ),
+ 'mada' => __( 'Mada', 'checkout-com-unified-payments-api' ),
+ ],
+ 'class' => 'wc-enhanced-select',
+ 'css' => 'width: 400px;',
+ 'custom_attributes' => $should_disable_flow_incompatible ? [ 'disabled' => 'disabled' ] : [],
+ ],
+ 'ckocom_language_type' => [
+ 'id' => 'ckocom_language_type',
+ 'title' => __( 'Language Support', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'Predefined Translation', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Custom Translation', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => 'Select a translation type for card input fields',
+ 'custom_attributes' => $should_disable_flow_incompatible ? [ 'disabled' => 'disabled' ] : [],
+ ],
+ 'ckocom_language_fallback' => [
+ 'id' => 'ckocom_language_fallback',
+ 'title' => __( 'Language Fallback', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 'EN-GB' => __( 'English', 'checkout-com-unified-payments-api' ),
+ 'NL-NL' => __( 'Dutch', 'checkout-com-unified-payments-api' ),
+ 'FR-FR' => __( 'French', 'checkout-com-unified-payments-api' ),
+ 'DE-DE' => __( 'German', 'checkout-com-unified-payments-api' ),
+ 'IT-IT' => __( 'Italian', 'checkout-com-unified-payments-api' ),
+ 'KR-KR' => __( 'Korean', 'checkout-com-unified-payments-api' ),
+ 'ES-ES' => __( 'Spanish', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 'EN-GB',
+ 'desc' => 'Select the language to use by default if the one used by the shopper is not supported by the integration.',
+ 'custom_attributes' => $should_disable_flow_incompatible ? [ 'disabled' => 'disabled' ] : [],
+ ],
+ 'ckocom_card_number_placeholder' => [
+ 'id' => 'ckocom_card_number_placeholder',
+ 'title' => __( 'Card Number Placeholder', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'default' => 'Card number',
+ 'desc' => __( 'Card number input box placeholder.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_card_expiry_month_placeholder' => [
+ 'id' => 'ckocom_card_expiry_month_placeholder',
+ 'title' => __( 'Card Expiry Month Placeholder', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'default' => 'MM',
+ 'desc' => __( 'Card expiry month input box placeholder.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_card_expiry_year_placeholder' => [
+ 'id' => 'ckocom_card_expiry_year_placeholder',
+ 'title' => __( 'Card Expiry Year Placeholder', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'default' => 'YY',
+ 'desc' => __( 'Card expiry year input box placeholder.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_card_cvv_placeholder' => [
+ 'id' => 'ckocom_card_cvv_placeholder',
+ 'title' => __( 'Card CVV Placeholder', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'default' => 'CVV',
+ 'desc' => __( 'Card CVV input box placeholder.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_card_scheme_link_placeholder' => [
+ 'id' => 'ckocom_card_scheme_link_placeholder',
+ 'title' => __( 'Card Scheme Link Placeholder', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'default' => 'Click here to update your type of card',
+ 'desc' => __( 'Card Scheme Link input box placeholder.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_card_scheme_header_placeholder' => [
+ 'id' => 'ckocom_card_scheme_header_placeholder',
+ 'title' => __( 'Card Scheme Header Placeholder', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'default' => 'Choose your type of card',
+ 'desc' => __( 'Card Scheme Header input box placeholder.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ ],
+ 'ckocom_iframe_style' => [
+ 'id' => 'ckocom_iframe_style',
+ 'title' => __( 'Iframe Style', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => [
+ 0 => __( 'Single Iframe', 'checkout-com-unified-payments-api' ),
+ 1 => __( 'Multiple Iframe', 'checkout-com-unified-payments-api' ),
+ ],
+ 'default' => 0,
+ 'desc' => 'Select the styling for card iframe',
+ 'custom_attributes' => $should_disable_flow_incompatible ? [ 'disabled' => 'disabled' ] : [],
+ ],
+ ];
+
+ return apply_filters( 'wc_checkout_com_cards', $settings );
+ }
+
+ /**
+ * CKO admin order management settings fields
+ *
+ * @return mixed
+ */
+ public static function order_settings() {
+
+ $settings = [
+ 'order_setting' => [
+ 'title' => __( 'Order Management settings', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => '',
+ ],
+ 'ckocom_order_authorised' => [
+ 'id' => 'ckocom_order_authorised',
+ 'title' => __( 'Authorised Order Status', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => wc_get_order_statuses(),
+ 'default' => 'wc-on-hold',
+ 'desc' => __( 'Select the status that should be used for orders with successful payment authorisation', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_order_captured' => [
+ 'id' => 'ckocom_order_captured',
+ 'title' => __( 'Captured Order Status', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => wc_get_order_statuses(),
+ 'default' => 'wc-processing',
+ 'desc' => __( 'Select the status that should be used for orders with successful payment capture', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_order_void' => [
+ 'id' => 'ckocom_order_void',
+ 'title' => __( 'Void Order Status', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => wc_get_order_statuses(),
+ 'default' => 'wc-cancelled',
+ 'desc' => __( 'Select the status that should be used for orders that have been voided', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_order_flagged' => [
+ 'id' => 'ckocom_order_flagged',
+ 'title' => __( 'Flagged Order Status', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => wc_get_order_statuses(),
+ 'default' => 'wc-flagged',
+ 'desc' => __( 'Select the status that should be used for flagged orders', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_order_refunded' => [
+ 'id' => 'ckocom_order_refunded',
+ 'title' => __( 'Refunded Order Status', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'desc_tip' => true,
+ 'options' => wc_get_order_statuses(),
+ 'default' => 'wc-refunded',
+ 'desc' => __( 'Select the status that should be used for new orders with successful payment refund', 'checkout-com-unified-payments-api' ),
+ ],
+ ];
+
+ return apply_filters( 'wc_checkout_com_cards', $settings );
+ }
+
+ /**
+ * CKO admin apple pay settting fields
+ *
+ * @return mixed|void
+ */
+ public static function apple_settings() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $nas_docs = 'https://www.checkout.com/docs/four/payments/payment-methods/apple-pay';
+ $abc_docs = 'https://www.checkout.com/docs/payments/payment-methods/wallets/apple-pay';
+ $docs_link = $abc_docs;
+
+ if ( isset( $core_settings['ckocom_account_type'] ) && 'NAS' === $core_settings['ckocom_account_type'] ) {
+ $docs_link = $nas_docs;
+ }
+
+ $checkout_mode = $core_settings['ckocom_checkout_mode'];
+ $should_disable_checkbox = false;
+
+ if ( 'flow' === $checkout_mode ) {
+ $should_disable_checkbox = true;
+ }
+
+ $settings = [
+ // ==================== APPLE PAY SETTINGS ====================
+ 'apple_setting' => [
+ 'title' => __( 'Apple Pay Settings', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => '',
+ ],
+ 'enabled' => [
+ 'id' => 'enable',
+ 'title' => __( 'Enable Apple Pay', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'label' => __( 'Enable Apple Pay payment method', 'checkout-com-unified-payments-api' ),
+ 'description' => __( 'Enable this option to activate Apple Pay as a payment method on your checkout page. When enabled, customers with compatible Apple devices can use Apple Pay to complete their purchase.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'yes',
+ 'custom_attributes' => $should_disable_checkbox ? [ 'disabled' => 'disabled' ] : [],
+ ],
+ 'title' => [
+ 'title' => __( 'Payment Method Title', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'description' => __( 'This is the title that customers will see on the checkout page. Choose a clear, recognizable name for the payment method (e.g., "Apple Pay" or "Pay with Apple Pay").', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'Apple Pay',
+ ],
+ 'description' => [
+ 'title' => __( 'Payment Method Description', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'description' => __( 'A short description that appears below the payment method title on the checkout page. This helps customers understand what Apple Pay is and how it works.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'Pay securely with Apple Pay using your iPhone, iPad, or Mac.',
+ ],
+
+ // ==================== STEP 1: PAYMENT PROCESSING CERTIFICATE SETUP (for decryption) ====================
+ 'apple_pay_certificate_setup' => [
+ 'title' => __( 'Step 1: Payment Processing Certificate Setup (for decryption)', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Set up your Apple Pay Payment Processing Certificate. This certificate is required for Checkout.com to decrypt Apple Pay payment tokens. Follow the steps below to generate and upload your certificate.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'apple_pay_csr_generate' => [
+ 'title' => __( 'Step 1a: Generate Certificate Signing Request (CSR)', 'checkout-com-unified-payments-api' ),
+ 'type' => 'apple_pay_csr_button',
+ /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */
+ 'description' => sprintf( __( 'First, create a Merchant ID in your %1$sApple Developer account%2$s if you haven\'t already. Then generate a Certificate Signing Request (CSR) file that you will upload to Apple Developer. This CSR is valid for 24 hours, so complete the certificate creation process promptly.', 'checkout-com-unified-payments-api' ), '', '' ),
+ 'desc_tip' => false,
+ ],
+ 'apple_pay_certificate_upload' => [
+ 'title' => __( 'Step 1b: Upload Signed Certificate', 'checkout-com-unified-payments-api' ),
+ 'type' => 'apple_pay_certificate_upload',
+ 'description' => __( 'After generating the CSR above, upload it to Apple Developer and download the signed certificate (apple_pay.cer). Then upload that certificate here to complete the setup.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ ],
+
+ // ==================== STEP 2: DOMAIN ASSOCIATION SETUP ====================
+ 'apple_pay_domain_association_setup' => [
+ 'title' => __( 'Step 2: Domain Association Setup', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Register your merchant domain with Apple. This is required to display the Apple Pay button on your website. You must have a valid TLS certificate on your domain.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'apple_pay_domain_association_upload' => [
+ 'title' => __( 'Upload Domain Association File', 'checkout-com-unified-payments-api' ),
+ 'type' => 'apple_pay_domain_association_upload',
+ /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */
+ 'description' => sprintf( __( 'After adding your domain in Apple Developer, download the domain association file (.txt) and upload it here. The file will be automatically saved to your server. Go to your %1$sApple Developer Merchant IDs%2$s to manage your domains.', 'checkout-com-unified-payments-api' ), '', '' ),
+ 'desc_tip' => false,
+ ],
+
+ // ==================== STEP 3: MERCHANT IDENTITY CERTIFICATE SETUP (for session signing) ====================
+ 'apple_pay_merchant_identity_certificate_setup' => [
+ 'title' => __( 'Step 3: Merchant Identity Certificate Setup (for session signing)', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Create and set up your Apple Pay Merchant Identity Certificate. This certificate is used to sign merchant session responses during Apple Pay payment authorization. Generate a CSR and private key locally using OpenSSL, upload the CSR to Apple Developer, download the signed certificate, and convert it to PEM format.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'apple_pay_merchant_identity_csr_generate' => [
+ 'title' => __( 'Step 3a: Generate Merchant Identity CSR and Key', 'checkout-com-unified-payments-api' ),
+ 'type' => 'apple_pay_merchant_identity_csr_button',
+ 'description' => __( 'Generate a Certificate Signing Request (CSR) and private key file using OpenSSL. Click the button below to generate these files on your server. The files will be downloaded automatically: uploadMe.csr and certificate_sandbox.key. Save the private key file securely on your server, then upload the CSR file to Apple Developer.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ ],
+ 'apple_pay_merchant_identity_certificate_upload' => [
+ 'title' => __( 'Step 3b: Upload and Convert Merchant Identity Certificate', 'checkout-com-unified-payments-api' ),
+ 'type' => 'apple_pay_merchant_identity_certificate_upload',
+ 'description' => __( 'After uploading the CSR to Apple Developer and downloading the signed certificate (merchant_id.cer), upload it here. The certificate will be automatically converted from DER (.cer) format to PEM format and saved to your server. Make sure you have the certificate_sandbox.key file saved on your server from Step 3a.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ ],
+ 'apple_pay_test_certificate' => [
+ 'title' => __( 'Step 4: Test Certificate and Key (Final Verification)', 'checkout-com-unified-payments-api' ),
+ 'type' => 'apple_pay_test_certificate_button',
+ 'description' => __( 'Test your Apple Pay certificate and private key by validating them with Apple\'s payment session endpoint. This will verify that your certificate and key are correctly configured and working. Make sure you have configured the Merchant Identifier, Domain Name, Display Name, and certificate/key paths above.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ ],
+
+ // ==================== EXPRESS CHECKOUT SETTINGS ====================
+ 'apple_pay_express_section' => [
+ 'title' => __( 'Express Checkout Settings', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Decide how buttons for digital wallets Apple Pay and Google Pay are displayed in your store. Depending on their web browser and their wallet configurations, your customers will see either Apple Pay or Google Pay, but not both.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'apple_pay_express' => [
+ 'title' => __( 'Enable Apple Pay / Google Pay', 'checkout-com-unified-payments-api' ),
+ 'label' => __( 'Enable Apple Pay / Google Pay', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'description' => __( 'When enabled, customers who have configured Apple Pay or Google Pay enabled devices will be able to pay with their respective choice of Wallet.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'no',
+ ],
+ 'apple_pay_express_location' => [
+ 'title' => __( 'Show express checkouts on', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Configure the display of Apple Pay and Google Pay buttons on your store.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'apple_pay_express_product_page' => [
+ 'title' => __( 'Product page', 'checkout-com-unified-payments-api' ),
+ 'label' => __( 'Product page', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'description' => __( 'Display the Apple Pay button on individual product pages.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'yes',
+ ],
+ 'apple_pay_express_shop_page' => [
+ 'title' => __( 'Shop & Category Pages', 'checkout-com-unified-payments-api' ),
+ 'label' => __( 'Shop & Category Pages', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'description' => __( 'Display the Apple Pay button on shop pages, category pages, tag archives, and other product listing pages.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'yes',
+ ],
+ 'apple_pay_express_cart_page' => [
+ 'title' => __( 'Cart', 'checkout-com-unified-payments-api' ),
+ 'label' => __( 'Cart', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'description' => __( 'Display the Apple Pay button on the cart page.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'yes',
+ ],
+ 'apple_pay_express_checkout_page' => [
+ 'title' => __( 'Checkout', 'checkout-com-unified-payments-api' ),
+ 'label' => __( 'Checkout', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'description' => __( 'Display the Apple Pay button on the checkout page.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'yes',
+ ],
+ 'apple_pay_express_appearance' => [
+ 'title' => __( 'Appearance', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Configure the appearance of Apple Pay and Google Pay buttons. Note: Some appearance settings may be overridden by the express payment section of the Cart & Checkout blocks.', 'checkout-com-unified-payments-api' ),
+ ],
+ // Size settings temporarily disabled - buttons use native SDK sizes
+ /*
+ 'apple_pay_express_button_size_preset' => [
+ 'title' => __( 'Size', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'description' => __( 'Select the button size. Note that larger buttons are more suitable for mobile use.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'default',
+ 'options' => [
+ 'native' => __( 'Native (Recommended)', 'checkout-com-unified-payments-api' ),
+ 'small' => __( 'Small (40 px)', 'checkout-com-unified-payments-api' ),
+ 'default' => __( 'Default (48 px)', 'checkout-com-unified-payments-api' ),
+ 'large' => __( 'Large (56 px)', 'checkout-com-unified-payments-api' ),
+ 'custom' => __( 'Custom Height', 'checkout-com-unified-payments-api' ),
+ ],
+ ],
+ 'apple_pay_express_button_custom_height' => [
+ 'title' => __( 'Custom Button Height', 'checkout-com-unified-payments-api' ),
+ 'type' => 'number',
+ 'description' => __( 'Enter a custom height in pixels (minimum 36px, maximum 60px). This setting only applies when "Custom Height" is selected above.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => '48',
+ 'custom_attributes' => [
+ 'min' => '36',
+ 'max' => '60',
+ 'step' => '1',
+ ],
+ ],
+ */
+
+ // ==================== APPLE PAY CONFIGURATION ====================
+ 'apple_pay_configuration' => [
+ 'title' => __( 'Apple Pay Configuration', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Configure your Apple Pay merchant identifier and certificate settings. These are required for Apple Pay to function properly.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_apple_mercahnt_id' => [
+ 'title' => __( 'Merchant Identifier', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */
+ 'description' => sprintf( __( 'Your Apple Pay Merchant Identifier is a unique identifier registered with Apple. You can find this in your Apple Developer account under Certificates, Identifiers & Profiles > Identifiers. To create a new Merchant ID, follow this %1$s guide %2$s', 'checkout-com-unified-payments-api' ), '', '' ),
+ 'desc_tip' => false,
+ 'default' => '',
+ 'placeholder' => 'merchant.com.yourdomain.production',
+ ],
+ 'ckocom_apple_certificate' => [
+ 'title' => __( 'Merchant Identity Certificate Path', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'description' => __( 'Enter the absolute server path to your Apple Pay Merchant Identity Certificate file (.pem). This certificate is used to sign merchant session responses during Apple Pay payment authorization. This is the certificate from Step 3 (Merchant Identity Certificate Setup).', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => '',
+ 'placeholder' => '/path/to/your/certificate_sandbox.pem',
+ ],
+ 'ckocom_apple_key' => [
+ 'title' => __( 'Merchant Identity Certificate Key Path', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'description' => __( 'Enter the absolute server path to your Apple Pay Merchant Identity Certificate private key file (.key). This key is used alongside the certificate to sign merchant session responses. This is the private key from Step 3a (Generate Merchant Identity CSR and Key).', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => '',
+ 'placeholder' => '/path/to/your/certificate_sandbox.key',
+ 'custom_attributes' => [
+ 'data-field-type' => 'private-key',
+ ],
+ ],
+ 'apple_pay_domain_name' => [
+ 'title' => __( 'Domain Name', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'description' => __( 'Enter the domain name where you will display the Apple Pay button (e.g., example.com or sandbox.example.com). This domain must match the domain where your Apple Pay button is displayed.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => '',
+ 'placeholder' => 'example.com',
+ ],
+ 'apple_pay_display_name' => [
+ 'title' => __( 'Display Name', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'description' => __( 'Enter a display name for your merchant account (e.g., "merchant id for test environment"). This name will be used during Apple Pay payment session validation.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => '',
+ 'placeholder' => 'merchant id for test environment',
+ ],
+
+ // ==================== BUTTON CUSTOMIZATION ====================
+ 'apple_pay_button_customization' => [
+ 'title' => __( 'Button Appearance', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Customize the appearance of Apple Pay buttons on your store. These settings control the style and language of the Apple Pay button.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'ckocom_apple_theme' => array(
+ 'title' => __( 'Theme', 'checkout-com-unified-payments-api' ),
+ 'type' => 'select',
+ 'description' => __( 'Choose the color theme for the Apple Pay button. Select a theme that contrasts well with your website design for optimal visibility.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'options' => array(
+ 'black' => __( 'Dark', 'checkout-com-unified-payments-api' ) . ' - ' . __( 'Recommended for white or light-colored backgrounds with high contrast.', 'checkout-com-unified-payments-api' ),
+ 'white' => __( 'Light', 'checkout-com-unified-payments-api' ) . ' - ' . __( 'Recommended for dark or colored backgrounds with high contrast.', 'checkout-com-unified-payments-api' ),
+ 'white-outline' => __( 'Outline', 'checkout-com-unified-payments-api' ) . ' - ' . __( 'Recommended for white or light-colored backgrounds with insufficient contrast.', 'checkout-com-unified-payments-api' ),
+ ),
+ 'default' => 'black',
+ ),
+ 'ckocom_apple_language' => [
+ 'title' => __( 'Button Language', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */
+ 'description' => sprintf( __( 'Enter the ISO 639-1 language code for the Apple Pay button (e.g., "en" for English, "es" for Spanish). If left empty, the button will use the browser default language. See supported languages %1$s here %2$s', 'checkout-com-unified-payments-api' ), '', '' ),
+ 'desc_tip' => false,
+ 'default' => '',
+ 'placeholder' => 'en',
+ ],
+
+ // ==================== MERCHANT CERTIFICATE SETUP ====================
+ 'apple_pay_merchant_certificate_setup' => [
+ 'title' => __( 'Merchant Certificate & Private Key Setup', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Generate a self-signed merchant certificate and private key pair for Apple Pay merchant validation. These certificates are used to sign merchant session responses during Apple Pay payment authorization. After generating, download both files and configure their paths in the "Apple Pay Configuration" section above.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'apple_pay_merchant_certificate_generate' => [
+ 'title' => __( 'Generate Merchant Certificate and Key', 'checkout-com-unified-payments-api' ),
+ 'type' => 'apple_pay_merchant_certificate_button',
+ 'description' => __( 'Click the button below to generate a self-signed merchant certificate (.pem) and private key (.key) file pair. After generation, both files will be automatically downloaded. Save these files securely on your server and configure their paths in the "Merchant Certificate Path" and "Merchant Certificate Key Path" fields above.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ ],
+
+ // ==================== ADVANCED SETTINGS ====================
+ 'apple_pay_advanced_settings' => [
+ 'title' => __( 'Advanced Settings', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => __( 'Additional configuration options for specialized use cases.', 'checkout-com-unified-payments-api' ),
+ ],
+ 'enable_mada' => [
+ 'id' => 'enable_mada_apple_pay',
+ 'title' => __( 'Enable MADA Support', 'checkout-com-unified-payments-api' ),
+ 'label' => __( 'Enable MADA card support for Apple Pay', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'description' => __( 'Enable this option if your business is located in Saudi Arabia and you want to accept MADA (Saudi Payments Network) cards through Apple Pay. MADA is the national payment network of Saudi Arabia.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => false,
+ 'default' => 'no',
+ ],
+ ];
+
+ return apply_filters( 'wc_checkout_com_apple_pay', $settings );
+ }
+
+ /**
+ * CKO admin google pay setting fields
+ *
+ * @return mixed|void
+ */
+ public static function google_settings() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+
+ $checkout_mode = isset( $core_settings['ckocom_checkout_mode'] ) ? $core_settings['ckocom_checkout_mode'] : 'classic';
+ $should_disable_checkbox = false;
+
+ if ( 'flow' === $checkout_mode ) {
+ $should_disable_checkbox = true;
+ }
+
+ $settings = [
+ 'google_setting' => [
+ 'title' => __( 'Google Pay Settings', 'checkout-com-unified-payments-api' ),
+ 'type' => 'title',
+ 'description' => '',
+ ],
+ 'enabled' => [
+ 'id' => 'enable',
+ 'title' => __( 'Enable/Disable', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'label' => __( 'Enable Checkout.com', 'checkout-com-unified-payments-api' ),
+ 'description' => __( 'This enables google pay as a payment method', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'default' => 'no',
+ 'custom_attributes' => $should_disable_checkbox ? [ 'disabled' => 'disabled' ] : [],
+ ],
+ 'title' => [
+ 'title' => __( 'Title', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'label' => __( 'Google Pay', 'checkout-com-unified-payments-api' ),
+ 'description' => __( 'Title that will be displayed on the checkout page', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'default' => 'Google Pay',
+ ],
+ 'description' => [
+ 'title' => __( 'Description', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'description' => __( 'This controls the description which the user sees during checkout.', 'checkout-com-unified-payments-api' ),
+ 'default' => 'Pay with Google Pay.',
+ 'desc_tip' => true,
+ ],
+ 'ckocom_google_merchant_id' => [
+ 'title' => __( 'Merchant Identifier', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ 'description' => __( 'Your production merchant identifier.', 'checkout-com-unified-payments-api' ) . '
' . __( 'For testing use the following value: 01234567890123456789', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => '01234567890123456789', + ], + 'ckocom_google_threed' => [ + 'id' => 'ckocom_google_threed', + 'title' => __( 'Use 3D Secure', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'desc_tip' => true, + 'options' => [ + 0 => __( 'No', 'checkout-com-unified-payments-api' ), + 1 => __( 'Yes', 'checkout-com-unified-payments-api' ), + ], + 'default' => 0, + 'description' => '3D secure payment', + ], + 'ckocom_google_style' => [ + 'title' => __( 'Button Style', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'class' => 'wc-enhanced-select', + 'description' => __( 'Select button color.', 'checkout-com-unified-payments-api' ), + 'default' => 'google-pay-black', + 'desc_tip' => true, + 'options' => [ + 'google-pay-black' => __( 'Black', 'checkout-com-unified-payments-api' ), + 'google-pay-white' => __( 'White', 'checkout-com-unified-payments-api' ), + ], + ], + 'google_pay_express' => [ + 'title' => __( 'Google Pay Express', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Enable Google Pay Express', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Master toggle to activate Google Pay Express checkout. When enabled, use the options below to control where buttons appear.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'no', + ], + 'google_pay_express_location' => [ + 'title' => __( 'Button Locations', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => __( 'Control where Google Pay Express buttons appear on your store.', 'checkout-com-unified-payments-api' ), + ], + 'google_pay_express_product_page' => [ + 'title' => __( 'Show on Product Page', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display Google Pay Express button on product detail pages', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show Google Pay Express button on individual product pages.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + 'google_pay_express_shop_page' => [ + 'title' => __( 'Show on Shop/Category Pages', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display Google Pay Express button on shop and category listing pages', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show Google Pay Express button on shop, category, tag, and archive pages.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + 'google_pay_express_cart_page' => [ + 'title' => __( 'Show on Cart Page', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display Google Pay Express button on cart page', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show Google Pay Express button on the cart page.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + // Size settings temporarily disabled - buttons use native SDK sizes + /* + 'google_pay_express_button_size' => [ + 'title' => __( 'Button Size Customization', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => __( 'Customize the size of Google Pay Express buttons. By default, buttons use their native styles for optimal appearance. You can choose to set a consistent size across all express buttons if needed.', 'checkout-com-unified-payments-api' ), + ], + 'google_pay_express_button_size_preset' => [ + 'title' => __( 'Button Size', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'description' => __( 'Choose the button size preset. "Native" uses the default Google Pay button styling (recommended). Other options set a consistent height across all express buttons.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => 'native', + 'options' => [ + 'native' => __( 'Native (Recommended)', 'checkout-com-unified-payments-api' ), + 'small' => __( 'Small (36px)', 'checkout-com-unified-payments-api' ), + 'medium' => __( 'Medium (40px)', 'checkout-com-unified-payments-api' ), + 'large' => __( 'Large (48px)', 'checkout-com-unified-payments-api' ), + 'custom' => __( 'Custom Height', 'checkout-com-unified-payments-api' ), + ], + ], + 'google_pay_express_button_custom_height' => [ + 'title' => __( 'Custom Button Height', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Enter a custom height in pixels (minimum 36px, maximum 60px). This setting only applies when "Custom Height" is selected above.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => '40', + 'custom_attributes' => [ + 'min' => '36', + 'max' => '60', + 'step' => '1', + ], + ], + */ + ]; + + return apply_filters( 'wc_checkout_com_google_pay', $settings ); + } + + /** + * CKO admin paypal setting fields + * + * @return mixed|void + */ + public static function paypal_settings() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' ); + + $checkout_mode = $core_settings['ckocom_checkout_mode']; + $should_disable_checkbox = false; + + if ( 'flow' === $checkout_mode ) { + $should_disable_checkbox = true; + } + + $settings = [ + 'google_setting' => [ + 'title' => __( 'PayPal Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ], + 'enabled' => [ + 'id' => 'enable', + 'title' => __( 'Enable/Disable', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'label' => __( 'Enable Checkout.com', 'checkout-com-unified-payments-api' ), + 'description' => __( 'This enables PayPal as a payment method', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'no', + 'custom_attributes' => $should_disable_checkbox ? [ 'disabled' => 'disabled' ] : [], + ], + 'title' => [ + 'title' => __( 'Title', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'label' => __( 'PayPal', 'checkout-com-unified-payments-api' ), + 'description' => __( 'Title that will be displayed on the checkout page', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'PayPal', + ], + 'description' => [ + 'title' => __( 'Description', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'This controls the description which the user sees during checkout.', 'checkout-com-unified-payments-api' ), + 'default' => 'Pay with PayPal.', + 'desc_tip' => true, + ], + 'ckocom_paypal_merchant_id' => [ + 'title' => __( 'Merchant ID', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Your Paypal merchant ID.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => '', + 'placeholder' => 'ABCD1EFGH2I3K', + ], + 'paypal_express' => [ + 'title' => __( 'PayPal Express', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Enable PayPal Express', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Master toggle to activate PayPal Express checkout. When enabled, use the options below to control where buttons appear.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'no', + ], + 'paypal_express_location' => [ + 'title' => __( 'Button Locations', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => __( 'Control where PayPal Express buttons appear on your store.', 'checkout-com-unified-payments-api' ), + ], + 'paypal_express_product_page' => [ + 'title' => __( 'Show on Product Page', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display PayPal Express button on product detail pages', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show PayPal Express button on individual product pages.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + 'paypal_express_shop_page' => [ + 'title' => __( 'Show on Shop/Category Pages', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display PayPal Express button on shop and category listing pages', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show PayPal Express button on shop, category, tag, and archive pages.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + 'paypal_express_cart_page' => [ + 'title' => __( 'Show on Cart Page', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display PayPal Express button on cart page', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show PayPal Express button on the cart page.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + // Size settings temporarily disabled - buttons use native SDK sizes + /* + 'paypal_express_button_size' => [ + 'title' => __( 'Button Size Customization', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => __( 'Customize the size of PayPal Express buttons. By default, buttons use their native styles for optimal appearance. You can choose to set a consistent size across all express buttons if needed.', 'checkout-com-unified-payments-api' ), + ], + 'paypal_express_button_size_preset' => [ + 'title' => __( 'Button Size', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'description' => __( 'Choose the button size preset. "Native" uses the default PayPal button styling (recommended). Other options set a consistent height across all express buttons.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => 'native', + 'options' => [ + 'native' => __( 'Native (Recommended)', 'checkout-com-unified-payments-api' ), + 'small' => __( 'Small (36px)', 'checkout-com-unified-payments-api' ), + 'medium' => __( 'Medium (40px)', 'checkout-com-unified-payments-api' ), + 'large' => __( 'Large (48px)', 'checkout-com-unified-payments-api' ), + 'custom' => __( 'Custom Height', 'checkout-com-unified-payments-api' ), + ], + ], + 'paypal_express_button_custom_height' => [ + 'title' => __( 'Custom Button Height', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Enter a custom height in pixels (minimum 36px, maximum 60px). This setting only applies when "Custom Height" is selected above.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => '40', + 'custom_attributes' => [ + 'min' => '36', + 'max' => '60', + 'step' => '1', + ], + ], + */ + ]; + + return apply_filters( 'wc_checkout_com_paypal', $settings ); + } + + /** + * Alternative payment methods settings fields. + * + * @return mixed + */ + public static function apm_settings() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' ); + + $checkout_mode = $core_settings['ckocom_checkout_mode']; + $should_disable_checkbox = false; + + if ( 'flow' === $checkout_mode ) { + $should_disable_checkbox = true; + } + + $settings = [ + 'apm_setting' => [ + 'title' => __( 'Alternative Payment Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ], + 'enabled' => [ + 'id' => 'enable', + 'title' => __( 'Enable/Disable', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'label' => __( 'Enable Checkout.com', 'checkout-com-unified-payments-api' ), + 'description' => __( 'This enables alternative payment methods', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'no', + 'custom_attributes' => $should_disable_checkbox ? [ 'disabled' => 'disabled' ] : [], + ], + 'title' => [ + 'title' => __( 'Title', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'label' => __( 'Alternative Payments', 'checkout-com-unified-payments-api' ), + 'description' => __( 'Title that will be displayed on the checkout page', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'Alternative Payment Methods', + ], + 'ckocom_apms_selector' => [ + 'title' => __( 'Alternative Payment Methods', 'checkout-com-unified-payments-api' ), + 'type' => 'multiselect', + 'options' => [ + 'alipay' => __( 'Alipay', 'checkout-com-unified-payments-api' ), + 'boleto' => __( 'Boleto', 'checkout-com-unified-payments-api' ), + 'ideal' => __( 'iDEAL', 'checkout-com-unified-payments-api' ), + 'klarna' => __( 'Klarna', 'checkout-com-unified-payments-api' ), + 'poli' => __( 'Poli', 'checkout-com-unified-payments-api' ), + 'sepa' => __( 'Sepa Direct Debit', 'checkout-com-unified-payments-api' ), + 'sofort' => __( 'Sofort', 'checkout-com-unified-payments-api' ), + 'eps' => __( 'EPS', 'checkout-com-unified-payments-api' ), + 'bancontact' => __( 'Bancontact', 'checkout-com-unified-payments-api' ), + 'knet' => __( 'KNET', 'checkout-com-unified-payments-api' ), + 'fawry' => __( 'Fawry', 'checkout-com-unified-payments-api' ), + 'qpay' => __( 'QPay', 'checkout-com-unified-payments-api' ), + 'multibanco' => __( 'Multibanco', 'checkout-com-unified-payments-api' ), + ], + 'class' => 'wc-enhanced-select', + 'css' => 'width: 400px;', + ], + + ]; + + return apply_filters( 'wc_checkout_com_alternative_payments', $settings ); + } + + /** + * Debugging settings. + * + * @return mixed + */ + public static function debug_settings() { + $settings = [ + 'debug_settings' => [ + 'title' => __( 'Debug Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ], + 'cko_file_logging' => [ + 'id' => 'cko_file_logging', + 'title' => __( 'File Logging', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'desc_tip' => true, + 'default' => 'no', + 'desc' => __( 'Check to enable file logging', 'checkout-com-unified-payments-api' ), + ], + 'cko_console_logging' => [ + 'id' => 'cko_console_logging', + 'title' => __( 'Console Logging', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'desc_tip' => true, + 'default' => 'no', + 'desc' => __( 'Check to enable console logging', 'checkout-com-unified-payments-api' ), + ], + 'cko_gateway_responses' => [ + 'id' => 'cko_gateway_responses', + 'title' => __( 'Gateway Responses', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'desc_tip' => true, + 'default' => 'no', + 'desc' => __( 'Check to show gateway response.', 'checkout-com-unified-payments-api' ), + ], + ]; + + return apply_filters( 'wc_checkout_com_cards', $settings ); + } + + /** + * CKO webhook settings fields. + * + * @return mixed + */ + public static function webhook_settings() { + + $settings = [ + 'webhook_settings' => [ + 'title' => __( 'Webhook Details', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ], + 'cko_webhook_set' => [ + 'id' => 'cko_webhook_set', + 'type' => 'checkoutcom_webhook_settings', + ], + ]; + + return apply_filters( 'wc_checkout_com_cards', $settings ); + } + + /** + * CKO FLOW settings fields. + * + * @return array + */ + public static function flow_settings() { + + $locale_link = 'https://www.checkout.com/docs/payments/accept-payments/accept-a-payment-on-your-website/add-localization-to-your-flow-integration#Supported_languages'; + $translation_link = 'https://www.checkout.com/docs/payments/accept-payments/accept-a-payment-on-your-website/add-localization-to-your-flow-integration#Add_custom_translations'; + $flow_com_link = 'https://www.checkout.com/docs/payments/accept-payments/accept-a-payment-on-your-website/flow-library-reference/checkoutwebcomponents#Methods'; + + // Flow Appearance settings. + $settings = array( + 'flow_appearance_settings' => array( + 'title' => __( 'Appearance', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_appearance_color_action' => array( + 'id' => 'flow_appearance_color_action', + 'title' => __( 'Color Action', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Pay Button', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#186AFF', + ), + 'flow_appearance_color_background' => array( + 'id' => 'flow_appearance_color_background', + 'title' => __( 'Color Background', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Background', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#f8f9fa', + ), + 'flow_appearance_color_border' => array( + 'id' => 'flow_appearance_color_border', + 'title' => __( 'Color Border', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Border', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#68686C', + ), + 'flow_appearance_color_disabled' => array( + 'id' => 'flow_appearance_color_disabled', + 'title' => __( 'Color Disabled', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Disabled button', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#64646E', + ), + 'flow_appearance_color_error' => array( + 'id' => 'flow_appearance_color_error', + 'title' => __( 'Color Error', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Error Notification', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#FF3300', + ), + 'flow_appearance_color_form_background' => array( + 'id' => 'flow_appearance_color_form_background', + 'title' => __( 'Color Form Background', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( "Choose a color for the Form's Background", 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#e9ebeb', + ), + 'flow_appearance_color_form_border' => array( + 'id' => 'flow_appearance_color_form_border', + 'title' => __( 'Color Form Border', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( "Choose a color for the Form's Border", 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#1F1F1F', + ), + 'flow_appearance_color_inverse' => array( + 'id' => 'flow_appearance_color_inverse', + 'title' => __( 'Color Inverse', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the text on Pay Button', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#F9F9FB', + ), + 'flow_appearance_color_outline' => array( + 'id' => 'flow_appearance_color_outline', + 'title' => __( 'Color Outline', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the outline', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#ADA4EC', + ), + 'flow_appearance_color_primary' => array( + 'id' => 'flow_appearance_color_primary', + 'title' => __( 'Color Primary', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a primary color for the flow container', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#454553', + ), + 'flow_appearance_color_secondary' => array( + 'id' => 'flow_appearance_color_secondary', + 'title' => __( 'Color Secondary', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a secondary color for the flow container', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#828388', + ), + 'flow_appearance_color_success' => array( + 'id' => 'flow_appearance_color_success', + 'title' => __( 'Color Success', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for success notifications', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#2ECC71', + ), + ); + + // Flow Button settings. + $settings = array_merge( + $settings, + array( + 'flow_button_settings' => array( + 'title' => __( 'Button Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_button_font_family' => array( + 'id' => 'flow_button_font_family', + 'title' => __( 'Font Family', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font family', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '"Roboto Mono", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif', + ), + 'flow_button_font_size' => array( + 'id' => 'flow_button_font_size', + 'title' => __( 'Font Size', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font size', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '16px', + ), + 'flow_button_font_weight' => array( + 'id' => 'flow_button_font_weight', + 'title' => __( 'Font Weight', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set the font weight (e.g., 400, 700)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '700', + ), + 'flow_button_letter_spacing' => array( + 'id' => 'flow_button_letter_spacing', + 'title' => __( 'Letter Spacing', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set letter spacing (px)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '0', + ), + 'flow_button_line_height' => array( + 'id' => 'flow_button_line_height', + 'title' => __( 'Line Height', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set line height', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '24px', + ), + ) + ); + + // Flow Footnote settings. + $settings = array_merge( + $settings, + array( + 'flow_footnote_settings' => array( + 'title' => __( 'Footnote Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_footnote_font_family' => array( + 'id' => 'flow_footnote_font_family', + 'title' => __( 'Font Family', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font family', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '"PT Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif', + ), + 'flow_footnote_font_size' => array( + 'id' => 'flow_footnote_font_size', + 'title' => __( 'Font Size', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font size', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '14px', + ), + 'flow_footnote_font_weight' => array( + 'id' => 'flow_footnote_font_weight', + 'title' => __( 'Font Weight', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set the font weight (e.g., 400, 700)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '400', + ), + 'flow_footnote_letter_spacing' => array( + 'id' => 'flow_footnote_letter_spacing', + 'title' => __( 'Letter Spacing', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set letter spacing (px)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '0', + ), + 'flow_footnote_line_height' => array( + 'id' => 'flow_footnote_line_height', + 'title' => __( 'Line Height', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set line height', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '20px', + ), + ) + ); + + // Flow Label settings. + $settings = array_merge( + $settings, + array( + 'flow_label_settings' => array( + 'title' => __( 'Label Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_label_font_family' => array( + 'id' => 'flow_label_font_family', + 'title' => __( 'Font Family', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font family', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '"Roboto Mono", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif', + ), + 'flow_label_font_size' => array( + 'id' => 'flow_label_font_size', + 'title' => __( 'Font Size', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font size', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '14px', + ), + 'flow_label_font_weight' => array( + 'id' => 'flow_label_font_weight', + 'title' => __( 'Font Weight', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set the font weight (e.g., 400, 700)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '400', + ), + 'flow_label_letter_spacing' => array( + 'id' => 'flow_label_letter_spacing', + 'title' => __( 'Letter Spacing', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set letter spacing (px)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '0', + ), + 'flow_label_line_height' => array( + 'id' => 'flow_label_line_height', + 'title' => __( 'Line Height', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set line height', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '20px', + ), + ) + ); + + // Flow Subheading settings. + $settings = array_merge( + $settings, + array( + 'flow_subheading_settings' => array( + 'title' => __( 'Subheading Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_subheading_font_family' => array( + 'id' => 'flow_subheading_font_family', + 'title' => __( 'Font Family', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font family', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '"Roboto Mono", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif', + ), + 'flow_subheading_font_size' => array( + 'id' => 'flow_subheading_font_size', + 'title' => __( 'Font Size', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font size', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '16px', + ), + 'flow_subheading_font_weight' => array( + 'id' => 'flow_subheading_font_weight', + 'title' => __( 'Font Weight', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set the font weight (e.g., 400, 700)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '700', + ), + 'flow_subheading_letter_spacing' => array( + 'id' => 'flow_subheading_letter_spacing', + 'title' => __( 'Letter Spacing', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set letter spacing (px)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '0', + ), + 'flow_subheading_line_height' => array( + 'id' => 'flow_subheading_line_height', + 'title' => __( 'Line Height', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set line height', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '24px', + ), + ) + ); + + // Flow Border settings. + $settings = array_merge( + $settings, + array( + 'flow_border_settings' => array( + 'title' => __( 'Border Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_form_border_radius' => array( + 'id' => 'flow_form_border_radius', + 'title' => __( 'Form Border Radius', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Enter Form border-radius value', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '8px', + ), + 'flow_button_border_radius' => array( + 'id' => 'flow_button_border_radius', + 'title' => __( 'Button Border Radius', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Enter Button border-radius value', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '8px', + ), + ) + ); + + // Flow Component options. + $settings = array_merge( + $settings, + array( + 'flow_component_options' => array( + 'title' => __( 'Component Options', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_component_expand_first_payment_method' => array( + 'id' => 'flow_component_expand_first_payment_method', + 'title' => __( 'Auto Expand', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'label' => __( 'Expand/Collapse First Payment Method', 'checkout-com-unified-payments-api' ), + 'description' => __( 'Automatically expand the first available payment method if multiple methods exist.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ), + 'flow_show_card_holder_name' => array( + 'id' => 'flow_show_card_holder_name', + 'title' => __( 'Card Holder Name', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'label' => __( 'Show/Hide Card Holder Name', 'checkout-com-unified-payments-api' ), + 'description' => __( 'Show Card holder name from their account', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ), + 'flow_saved_payment' => array( + 'id' => 'flow_saved_payment', + 'title' => __( 'Saved Payment Display Order', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'description' => __( "Choose how to display payment options at checkout: + - **Saved Cards First**: Show saved payment methods first and expand them by default when available. + - **New Payment Methods First**: Show new payment options first and expand them by default.", 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'saved_cards_first', + 'options' => array( + 'saved_cards_first' => __( 'Saved Cards First (default expanded)', 'checkout-com-unified-payments-api' ), + 'new_payment_first' => __( 'New Payment Methods First (default expanded)', 'checkout-com-unified-payments-api' ), + ), + ), + 'flow_component_cardholder_name_position' => array( + 'id' => 'flow_component_cardholder_name_position', + 'title' => __( 'Cardholder Name Position', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'options' => array( + 'top' => __( 'Top', 'checkout-com-unified-payments-api' ), + 'bottom' => __( 'Bottom', 'checkout-com-unified-payments-api' ), + 'hidden' => __( 'Hidden', 'checkout-com-unified-payments-api' ), + ), + 'description' => __( 'Choose the position of the cardholder name field.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'top', + ), + 'flow_component_locale' => array( + 'id' => 'flow_component_locale', + 'title' => __( 'Locale', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */ + 'description' => sprintf( __( 'You can %1$s check out locales here %2$s in the Checkout.com Hub', 'checkout-com-unified-payments-api' ), '', '' ), + 'default' => 'en', + ), + 'flow_component_translation' => array( + 'id' => 'flow_component_translation', + 'title' => __( 'Custom Translation', 'checkout-com-unified-payments-api' ), + 'type' => 'textarea', + /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */ + 'description' => sprintf( __( 'Add data in JSON format. You can %1$s check out about translations here %2$s in the Checkout.com Hub', 'checkout-com-unified-payments-api' ), '', '' ), + 'placeholder' => << array(
+ 'id' => 'flow_component_name',
+ 'title' => __( 'Flow Payment method', 'checkout-com-unified-payments-api' ),
+ 'type' => 'text',
+ /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */
+ 'description' => sprintf( __( 'You can %1$s read more about flow component name here %2$s in the Checkout.com Hub. "flow" option will render all the available payment methods.', 'checkout-com-unified-payments-api' ), '', '' ),
+ 'default' => 'flow',
+ ),
+ 'flow_enabled_payment_methods' => array(
+ 'id' => 'flow_enabled_payment_methods',
+ 'title' => __( 'Enabled Payment Methods', 'checkout-com-unified-payments-api' ),
+ 'type' => 'multiselect',
+ 'class' => 'wc-enhanced-select',
+ 'css' => 'width: 400px;',
+ 'description' => __( 'Select which payment methods to enable at checkout. Leave empty to enable all available methods. Select "Card" if you want only specific methods to show. Note: MOTO orders (admin-created orders) will always allow all payment methods regardless of this setting.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'options' => array(
+ // Card payments
+ 'card' => __( '💳 Card (Credit/Debit) - Global', 'checkout-com-unified-payments-api' ),
+ 'stored_card' => __( '🔐 Stored Card (Checkout.com Network) - Global', 'checkout-com-unified-payments-api' ),
+
+ // Global / Multi-Region
+ 'googlepay' => __( '🟢 Google Pay - Global', 'checkout-com-unified-payments-api' ),
+ 'applepay' => __( '🍎 Apple Pay - Global', 'checkout-com-unified-payments-api' ),
+ 'paypal' => __( '🅿️ PayPal - Global', 'checkout-com-unified-payments-api' ),
+
+ // Europe
+ 'ideal' => __( '🇳🇱 iDEAL - Netherlands', 'checkout-com-unified-payments-api' ),
+ 'eps' => __( '🇦🇹 EPS - Austria', 'checkout-com-unified-payments-api' ),
+ 'bancontact' => __( '🇧🇪 Bancontact - Belgium', 'checkout-com-unified-payments-api' ),
+ 'p24' => __( '🇵🇱 Przelewy24 - Poland', 'checkout-com-unified-payments-api' ),
+ 'multibanco' => __( '🇵🇹 Multibanco - Portugal', 'checkout-com-unified-payments-api' ),
+ 'mbway' => __( '🇵🇹 MB WAY - Portugal', 'checkout-com-unified-payments-api' ),
+ 'klarna' => __( '🇪🇺 Klarna - EU/Nordics/UK', 'checkout-com-unified-payments-api' ),
+ 'sepa' => __( '🇪🇺 SEPA Direct Debit - EU', 'checkout-com-unified-payments-api' ),
+ 'alma' => __( '🇫🇷 Alma (Installments) - France', 'checkout-com-unified-payments-api' ),
+
+ // Middle East
+ 'knet' => __( '🇰🇼 KNET - Kuwait', 'checkout-com-unified-payments-api' ),
+ 'benefit' => __( '🇧🇭 BenefitPay - Bahrain', 'checkout-com-unified-payments-api' ),
+ 'stcpay' => __( '🇸🇦 STC Pay - Saudi Arabia', 'checkout-com-unified-payments-api' ),
+ 'tabby' => __( '🇦🇪 Tabby - UAE/Saudi Arabia', 'checkout-com-unified-payments-api' ),
+ 'tamara' => __( '🇦🇪 Tamara - UAE/Saudi Arabia', 'checkout-com-unified-payments-api' ),
+ 'qpay' => __( '🇶🇦 QPay - Qatar', 'checkout-com-unified-payments-api' ),
+
+ // Asia
+ 'tng' => __( '🇲🇾 Touch n Go - Malaysia', 'checkout-com-unified-payments-api' ),
+ 'truemoney' => __( '🇹🇭 TrueMoney - Thailand', 'checkout-com-unified-payments-api' ),
+ 'dana' => __( '🇮🇩 DANA - Indonesia', 'checkout-com-unified-payments-api' ),
+ 'gcash' => __( '🇵🇭 GCash - Philippines', 'checkout-com-unified-payments-api' ),
+ 'kakaopay' => __( '🇰🇷 KakaoPay - South Korea', 'checkout-com-unified-payments-api' ),
+
+ // China / Hong Kong
+ 'alipay_cn' => __( '🇨🇳 Alipay CN - China', 'checkout-com-unified-payments-api' ),
+ 'alipay_hk' => __( '🇭🇰 Alipay HK - Hong Kong', 'checkout-com-unified-payments-api' ),
+ ),
+ 'default' => array(), // Empty by default - shows all available methods including cards
+ ),
+ 'flow_debug_logging' => array(
+ 'id' => 'flow_debug_logging',
+ 'title' => __( 'Debug Logging', 'checkout-com-unified-payments-api' ),
+ 'type' => 'checkbox',
+ 'label' => __( 'Enable detailed console logging for debugging', 'checkout-com-unified-payments-api' ),
+ 'description' => __( 'When enabled, logs detailed debugging information to browser console including initialization, form submissions, and card saving. Shows performance metrics, 3DS flows, and payment processing steps. Disable in production to reduce console output. Critical errors, warnings, webhooks, and 3DS authentication will always be visible.', 'checkout-com-unified-payments-api' ),
+ 'desc_tip' => true,
+ 'default' => 'yes',
+ ),
+ )
+ );
+
+
+ return apply_filters( 'wc_checkout_com_flow_settings', $settings );
+ }
+
+}
diff --git a/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-logging-settings.php b/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-logging-settings.php
new file mode 100644
index 00000000..5611c18b
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-logging-settings.php
@@ -0,0 +1,368 @@
+get_log_statistics();
+ ?>
+ ';
+ }
+
+ /**
+ * Export logs via AJAX.
+ */
+ public static function export_logs() {
+ if (!wp_verify_nonce($_GET['nonce'], 'cko_export_logs')) {
+ wp_die(__('Security check failed.', 'checkout-com-unified-payments-api'));
+ }
+
+ if (!current_user_can('manage_woocommerce')) {
+ wp_die(__('Insufficient permissions.', 'checkout-com-unified-payments-api'));
+ }
+
+ $log_manager = WC_Checkoutcom_Log_Manager::get_instance();
+ $export_data = $log_manager->export_logs(7); // Export last 7 days
+
+ header('Content-Type: application/json');
+ header('Content-Disposition: attachment; filename="checkout-com-logs-' . date('Y-m-d') . '.json"');
+ echo $export_data;
+ exit;
+ }
+
+ /**
+ * Clear logs via AJAX.
+ */
+ public static function clear_logs() {
+ if (!wp_verify_nonce($_POST['nonce'], 'cko_clear_logs')) {
+ wp_send_json_error(__('Security check failed.', 'checkout-com-unified-payments-api'));
+ }
+
+ if (!current_user_can('manage_woocommerce')) {
+ wp_send_json_error(__('Insufficient permissions.', 'checkout-com-unified-payments-api'));
+ }
+
+ $log_manager = WC_Checkoutcom_Log_Manager::get_instance();
+ $result = $log_manager->clear_all_logs();
+
+ if ($result) {
+ wp_send_json_success(__('Logs cleared successfully.', 'checkout-com-unified-payments-api'));
+ } else {
+ wp_send_json_error(__('Failed to clear logs.', 'checkout-com-unified-payments-api'));
+ }
+ }
+
+ /**
+ * Get log statistics via AJAX.
+ */
+ public static function get_log_stats() {
+ if (!wp_verify_nonce($_POST['nonce'], 'cko_log_stats')) {
+ wp_send_json_error(__('Security check failed.', 'checkout-com-unified-payments-api'));
+ }
+
+ if (!current_user_can('manage_woocommerce')) {
+ wp_send_json_error(__('Insufficient permissions.', 'checkout-com-unified-payments-api'));
+ }
+
+ $log_manager = WC_Checkoutcom_Log_Manager::get_instance();
+ $stats = $log_manager->get_log_statistics();
+
+ wp_send_json_success($stats);
+ }
+}
diff --git a/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-webhook.php b/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-webhook.php
new file mode 100644
index 00000000..44bcbe01
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-webhook.php
@@ -0,0 +1,306 @@
+account_type = cko_is_nas_account() ? 'NAS' : 'ABC';
+
+ $this->checkout = new Checkout_SDK();
+ }
+
+ /**
+ * Get singleton instance.
+ *
+ * @return WC_Checkoutcom_Webhook
+ */
+ public static function get_instance(): WC_Checkoutcom_Webhook {
+ if ( null === self::$instance ) {
+ self::$instance = new WC_Checkoutcom_Webhook();
+ }
+
+ return self::$instance;
+ }
+
+ /**
+ * AJAX request handler for registering webhook.
+ *
+ * @return void
+ */
+ public function ajax_register_webhook() {
+
+ check_ajax_referer( 'checkoutcom_register_webhook', 'security' );
+
+ $w_id = false;
+
+ if ( 'ABC' === $this->account_type ) {
+ $webhook_response = (array) $this->create( $this->generate_current_webhook_url() );
+
+ if ( empty( $webhook_response ) || empty( $webhook_response['id'] ) ) {
+ WC_Checkoutcom_Utility::logger( $webhook_response, null );
+ }
+
+ $w_id = $webhook_response['id'];
+
+ } else {
+
+ // NAS account type.
+ $workflow_response = WC_Checkoutcom_Workflows::get_instance()->create( $this->generate_current_webhook_url() );
+
+ if ( empty( $workflow_response ) || empty( $workflow_response['id'] ) ) {
+ WC_Checkoutcom_Utility::logger( $workflow_response, null );
+ }
+
+ $w_id = $workflow_response['id'];
+ }
+
+ if ( false === $w_id ) {
+ wp_send_json_error( null, 400 );
+ } else {
+ wp_send_json_success();
+ }
+
+ wp_die();
+ }
+
+ /**
+ * Register new webhook.
+ *
+ * @param string $url Webhook URL.
+ *
+ * @return mixed|WP_Error
+ */
+ public function create( $url ) {
+
+ if ( empty( $url ) ) {
+ $url = $this->generate_current_webhook_url();
+ }
+
+ $event_types = [
+ 'card_verification_declined',
+ 'card_verified',
+ 'dispute_canceled',
+ 'dispute_evidence_required',
+ 'dispute_expired',
+ 'dispute_lost',
+ 'dispute_resolved',
+ 'dispute_won',
+ 'payment_approved',
+ 'payment_canceled',
+ 'payment_capture_declined',
+ 'payment_capture_pending',
+ 'payment_captured',
+ 'payment_chargeback',
+ 'payment_declined',
+ 'payment_authentication_failed',
+ // 'payment_authorized',
+ // 'payment_retry_scheduled',
+ // 'payment_returned',
+ 'payment_expired',
+ 'payment_paid',
+ 'payment_pending',
+ 'payment_refund_declined',
+ 'payment_refund_pending',
+ 'payment_refunded',
+ 'payment_retrieval',
+ 'payment_void_declined',
+ 'payment_voided',
+ 'source_updated',
+ ];
+
+ try {
+ // Check if SDK classes are available
+ if ( ! class_exists( 'Checkout\Webhooks\Previous\WebhookRequest' ) ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK Webhook classes not found - cannot create webhook' );
+ return array( 'error' => 'Payment gateway not properly configured. Please contact support.' );
+ }
+
+ $webhook_request = new WebhookRequest();
+ $webhook_request->url = $url;
+ $webhook_request->content_type = 'json';
+ $webhook_request->event_types = $event_types;
+ $webhook_request->active = true;
+
+ $builder = $this->checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot register webhook' );
+ return array( 'error' => 'Payment gateway not properly configured. Please contact support.' );
+ }
+
+ return $builder->getWebhooksClient()->registerWebhook( $webhook_request );
+
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = esc_html__( 'An error has occurred while processing webhook request.', 'checkout-com-unified-payments-api' );
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ }
+ }
+
+ /**
+ * Get current webhook url.
+ *
+ * @return string
+ */
+ public static function generate_current_webhook_url(): string {
+ return add_query_arg( 'wc-api', 'wc_checkoutcom_webhook', home_url( '/' ) );
+ }
+
+ /**
+ * AJAX request handler for checking webhook.
+ *
+ * @return string|void
+ */
+ public function ajax_check_webhook() {
+
+ check_ajax_referer( 'checkoutcom_check_webhook', 'security' );
+
+ if ( 'ABC' === $this->account_type ) {
+ $webhook_is_ready = $this->is_registered();
+
+ $message = esc_html__( 'Webhook is configured at this URL:', 'checkout-com-unified-payments-api' );
+ } else {
+ // NAS account type.
+ // @todo: Use SDK to get webhooks or workflows.
+ $webhook_is_ready = WC_Checkoutcom_Workflows::get_instance()->is_registered();
+
+ $message = esc_html__( 'Webhook is configured with this name:', 'checkout-com-unified-payments-api' );
+ }
+
+ if ( $webhook_is_ready ) {
+
+ $message = $message ? $message : esc_html__( 'Webhook is configured at this URL:', 'checkout-com-unified-payments-api' );
+ $message = sprintf( '%s Webhook Queue - Direct Access
+
+
+
+ $fawry$fawry_number ')
+ })
+ "
+ );
+ }
+}
+
+add_filter( 'woocommerce_gateway_icon', 'cko_gateway_icon', 10, 2 );
+
+/**
+ * Filter for custom gateway icons.
+ *
+ * @param string $icons Icons markup.
+ * @param string $id Gateway ID.
+ *
+ * @return string
+ */
+function cko_gateway_icon( $icons, $id ) {
+
+ $plugin_url = WC_CHECKOUTCOM_PLUGIN_URL . '/assets/images/';
+
+ /* Check if checkoutcom gateway */
+ if ( 'wc_checkout_com_cards' === $id ) {
+ $display_card_icon = WC_Admin_Settings::get_option( 'ckocom_display_icon', '0' ) === '1';
+
+ /* check if display card option is selected */
+ if ( $display_card_icon ) {
+ $card_icon = WC_Admin_Settings::get_option( 'ckocom_card_icons' );
+
+ $icons = '';
+
+ foreach ( $card_icon as $key => $value ) {
+ $card_icons = $plugin_url . $value . '.svg';
+ $icons .= sprintf( '
', $card_icons, $value );
+ }
+
+ return $icons;
+ }
+
+ return $icons;
+ }
+
+ /**
+ * Display logo for APM available for payment
+ */
+ if ( strpos( $id, 'alternative_payments' ) ) {
+
+ $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods();
+
+ foreach ( $apm_available as $value ) {
+ if ( strpos( $id, $value ) ) {
+ $apm_icons = $plugin_url . $value . '.svg';
+ $icons .= sprintf( '', $apm_icons, $value );
+
+ return $icons;
+ }
+ }
+
+ return $icons;
+ }
+
+ /* Check if Google Pay gateway */
+ if ( 'wc_checkout_com_google_pay' === $id ) {
+ $display_card_icon = WC_Admin_Settings::get_option( 'ckocom_display_icon', '0' ) === '1';
+
+ /* check if display card option is selected */
+ if ( $display_card_icon ) {
+
+ $value = 'googlepay';
+ $card_icons = $plugin_url . $value . '.svg';
+
+ return sprintf( '', $card_icons, $value );
+ }
+
+ return $icons;
+ }
+
+ /* Check if Google Pay gateway */
+ if ( 'wc_checkout_com_apple_pay' === $id ) {
+ $display_card_icon = WC_Admin_Settings::get_option( 'ckocom_display_icon', '0' ) === '1';
+
+ /* check if display card option is selected */
+ if ( $display_card_icon ) {
+
+ $value = 'applepay';
+ $card_icons = $plugin_url . $value . '.svg';
+
+ return sprintf( '', $card_icons, $value );
+ }
+
+ return $icons;
+ }
+
+ return $icons;
+}
+
+/**
+ * Check if account is NAS.
+ *
+ * @return bool
+ */
+function cko_is_nas_account() {
+
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+
+ return isset( $core_settings['ckocom_account_type'] ) && ( 'NAS' === $core_settings['ckocom_account_type'] );
+}
+
+add_action( 'woocommerce_scheduled_subscription_payment_wc_checkout_com_cards', 'subscription_payment', 10, 2 );
+add_action( 'woocommerce_scheduled_subscription_payment_wc_checkout_com_alternative_payments_sepa', 'subscription_payment', 10, 2 );
+add_action( 'woocommerce_scheduled_subscription_payment_wc_checkout_com_google_pay', 'subscription_payment', 10, 2 );
+add_action( 'woocommerce_scheduled_subscription_payment_wc_checkout_com_apple_pay', 'subscription_payment', 10, 2 );
+add_action( 'woocommerce_scheduled_subscription_payment_wc_checkout_com_paypal', 'subscription_payment', 10, 2 );
+add_action( 'woocommerce_scheduled_subscription_payment_wc_checkout_com_flow', 'subscription_payment', 10, 2 );
+
+/**
+ * Function to handle subscription renewal payment for card, SEPA APM, Google Pay & Apple Pay.
+ *
+ * @param float $renewal_total The amount to charge.
+ * @param WC_Order $renewal_order A WC_Order object created to record the renewal payment.
+ */
+function subscription_payment( $renewal_total, $renewal_order ) {
+ include_once 'includes/subscription/class-wc-checkoutcom-subscription.php';
+
+ WC_Checkoutcom_Subscription::renewal_payment( $renewal_total, $renewal_order );
+}
+
+add_action( 'woocommerce_subscription_status_cancelled', 'subscription_cancelled', 20 );
+
+/**
+ * Function to handle subscription cancelled.
+ *
+ * @param WC_Subscription|WC_Order $subscription The subscription or order for which the status has changed.
+ *
+ * @return void
+ */
+function subscription_cancelled( $subscription ) {
+ include_once 'includes/subscription/class-wc-checkoutcom-subscription.php';
+
+ WC_Checkoutcom_Subscription::subscription_cancelled( $subscription );
+}
+
+// @TODO : Remove all below functions and logic once product is fixed.
+if ( cko_is_nas_account() ) {
+ add_filter( 'rewrite_rules_array', 'cko_add_rewrite_rules', -1 );
+ add_filter( 'query_vars', 'cko_add_query_vars' );
+ add_action( 'parse_request', 'cko_set_query_vars', -1, 1 );
+}
+
+/**
+ * Add rewrite rules for NAS.
+ *
+ * @param array $rules Rules.
+ *
+ * @return array
+ */
+function cko_add_rewrite_rules( $rules ) {
+
+ $new_rules = [];
+ foreach ( $rules as $rule => $value ) {
+
+ if ( '(.?.+?)(?:/([0-9]+))?/?$' === $rule ) {
+ $new_rules['checkoutcom-callback'] = 'index.php?&cko-callback=true';
+ }
+ $new_rules[ $rule ] = $value;
+ }
+
+ return $new_rules;
+}
+
+/**
+ * Add query vars for NAS.
+ *
+ * @param array $vars Query vars.
+ *
+ * @return array
+ */
+function cko_add_query_vars( $vars ) {
+ $vars[] = 'cko-callback';
+ $vars[] = 'cko-session-id';
+
+ return $vars;
+}
+
+/**
+ * Set query vars for NAS.
+ *
+ * @param WP $wp WordPress environment object.
+ *
+ * @return void
+ */
+function cko_set_query_vars( $wp ) {
+
+ if ( ! empty( $wp->query_vars['cko-callback'] ) ) {
+ $wp->set_query_var( 'wc-api', 'wc_checkoutcom_callback' );
+ }
+}
+
+add_action( 'wp_ajax_cko_validate_checkout', 'cko_validate_checkout' );
+add_action( 'wp_ajax_nopriv_cko_validate_checkout', 'cko_validate_checkout' );
+
+/**
+ * AJAX handler wrapper for Flow payment session creation.
+ * This ensures the handler is always available, even if the gateway class isn't fully instantiated.
+ */
+if ( ! function_exists( 'cko_ajax_flow_create_payment_session' ) ) {
+ function cko_ajax_flow_create_payment_session() {
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Flow' ) ) {
+ wp_send_json_error( array(
+ 'message' => __( 'Flow gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ) );
+ return;
+ }
+
+ // Get the gateway instance
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_flow'] ) ) {
+ $gateways['wc_checkout_com_flow']->ajax_create_payment_session();
+ } else {
+ // Fallback: create a temporary instance
+ $gateway = new WC_Gateway_Checkout_Com_Flow();
+ $gateway->ajax_create_payment_session();
+ }
+ }
+}
+
+/**
+ * AJAX handler wrapper for Flow order creation.
+ * This ensures the handler is always available, even if the gateway class isn't fully instantiated.
+ */
+if ( ! function_exists( 'cko_ajax_flow_create_order' ) ) {
+ function cko_ajax_flow_create_order() {
+ // Log immediately to verify function is being called
+ error_log( '[WRAPPER] cko_ajax_flow_create_order called' );
+ error_log( '[WRAPPER] POST action: ' . ( isset( $_POST['action'] ) ? $_POST['action'] : 'NOT SET' ) );
+ error_log( '[WRAPPER] POST keys: ' . implode( ', ', array_keys( $_POST ) ) );
+
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Flow' ) ) {
+ error_log( '[WRAPPER] ERROR: Flow gateway class not found' );
+ wp_send_json_error( array(
+ 'message' => __( 'Flow gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ) );
+ return;
+ }
+
+ // Get the gateway instance
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_flow'] ) ) {
+ error_log( '[WRAPPER] Using existing gateway instance' );
+ $gateways['wc_checkout_com_flow']->ajax_create_order();
+ } else {
+ error_log( '[WRAPPER] Creating new gateway instance' );
+ // Fallback: create a temporary instance
+ $gateway = new WC_Gateway_Checkout_Com_Flow();
+ $gateway->ajax_create_order();
+ }
+ }
+}
+
+// Register Flow AJAX handlers VERY early (before gateway class instantiation)
+// Use 'init' hook with priority 0 to ensure registration happens as early as possible
+add_action( 'init', function() {
+ add_action( 'wp_ajax_cko_flow_create_order', 'cko_ajax_flow_create_order', 1 );
+ add_action( 'wp_ajax_nopriv_cko_flow_create_order', 'cko_ajax_flow_create_order', 1 );
+}, 0 );
+
+// Also register directly (in case init hook doesn't work for AJAX)
+add_action( 'wp_ajax_cko_flow_create_payment_session', 'cko_ajax_flow_create_payment_session' );
+add_action( 'wp_ajax_nopriv_cko_flow_create_payment_session', 'cko_ajax_flow_create_payment_session' );
+add_action( 'wp_ajax_cko_flow_create_order', 'cko_ajax_flow_create_order', 1 );
+add_action( 'wp_ajax_nopriv_cko_flow_create_order', 'cko_ajax_flow_create_order', 1 );
+
+/**
+ * Validates the WooCommerce checkout form via AJAX.
+ */
+function cko_validate_checkout() {
+ try {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ========== ENTRY POINT ==========' );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Payment method in POST: ' . ( isset( $_POST['payment_method'] ) ? sanitize_text_field( $_POST['payment_method'] ) : 'NOT SET' ) );
+
+ // Load WooCommerce checkout class.
+ if ( ! function_exists( 'WC' ) || ! WC() ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR: WooCommerce not available' );
+ wp_send_json_error( array( 'message' => __( 'WooCommerce not available.', 'checkout-com-unified-payments-api' ) ) );
+ return;
+ }
+
+ $checkout = WC()->checkout();
+ if ( ! $checkout ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR: Checkout class not available' );
+ wp_send_json_error( array( 'message' => __( 'Checkout class not available.', 'checkout-com-unified-payments-api' ) ) );
+ return;
+ }
+
+ // Validate nonce.
+ $nonce_value = wc_get_var( $_REQUEST['woocommerce-process-checkout-nonce'], wc_get_var( $_REQUEST['_wpnonce'], '' ) ); // phpcs:ignore
+ if ( empty( $nonce_value ) || ! wp_verify_nonce( $nonce_value, 'woocommerce-process_checkout' ) ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR: Invalid nonce' );
+ wp_send_json_error( array( 'message' => __( 'Session expired. Please refresh.', 'woocommerce' ) ) );
+ return;
+ }
+
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Nonce validated successfully' );
+
+ // Pre-check actions.
+ try {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Running woocommerce_before_checkout_process hook' );
+ do_action( 'woocommerce_before_checkout_process' );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Running woocommerce_checkout_process hook' );
+ do_action( 'woocommerce_checkout_process' );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Hooks executed successfully' );
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR in hooks: ' . $e->getMessage() );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR stack trace: ' . $e->getTraceAsString() );
+ wp_send_json_error( array( 'message' => __( 'Error during checkout validation: ', 'checkout-com-unified-payments-api' ) . $e->getMessage() ) );
+ return;
+ }
+
+ // Get posted data and prepare for validation.
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Getting posted data' );
+ $posted_data = $checkout->get_posted_data();
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Posted data retrieved' );
+
+ try {
+ // Use Reflection to call the protected update_session method.
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Calling update_session via Reflection' );
+ $reflection1 = new ReflectionClass( $checkout );
+ $method = $reflection1->getMethod( 'update_session' );
+ $method->setAccessible( true );
+ $method->invoke( $checkout, $posted_data );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] update_session completed' );
+ } catch ( ReflectionException $e ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR in update_session: ' . $e->getMessage() );
+ wp_send_json_error( array( 'message' => __( 'Could not access checkout update method.', 'checkout-com-unified-payments-api' ) ) );
+ return;
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR in update_session (general): ' . $e->getMessage() );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR stack trace: ' . $e->getTraceAsString() );
+ wp_send_json_error( array( 'message' => __( 'Error updating checkout session: ', 'checkout-com-unified-payments-api' ) . $e->getMessage() ) );
+ return;
+ }
+
+ $errors = new WP_Error();
+
+ try {
+ // Use Reflection to call the protected validate_checkout method.
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Calling validate_checkout via Reflection' );
+ $reflection2 = new ReflectionClass( $checkout );
+ $method = $reflection2->getMethod( 'validate_checkout' );
+ $method->setAccessible( true );
+ $method->invokeArgs( $checkout, array( &$posted_data, &$errors ) );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] validate_checkout completed' );
+ } catch ( ReflectionException $e ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR in validate_checkout: ' . $e->getMessage() );
+ wp_send_json_error( array( 'message' => __( 'Could not access checkout validate method.', 'checkout-com-unified-payments-api' ) ) );
+ return;
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR in validate_checkout (general): ' . $e->getMessage() );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] ERROR stack trace: ' . $e->getTraceAsString() );
+ wp_send_json_error( array( 'message' => __( 'Error validating checkout: ', 'checkout-com-unified-payments-api' ) . $e->getMessage() ) );
+ return;
+ }
+
+ // If any validation errors occurred, send them back as an error response.
+ if ( ! empty( $errors->errors ) ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Validation errors found: ' . count( $errors->errors ) );
+ $messages = array();
+ foreach ( $errors->errors as $code => $msgs ) {
+ foreach ( $msgs as $msg ) {
+ $messages[] = $msg;
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Error: ' . $code . ' - ' . $msg );
+ }
+ }
+ wp_send_json_error( array( 'message' => implode( "\n", $messages ) ) );
+ return;
+ }
+
+ // If everything passed, return success.
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] Validation successful' );
+ wp_send_json_success( array( 'message' => __( 'Validation successful', 'checkout-com-unified-payments-api' ) ) );
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] FATAL ERROR: ' . $e->getMessage() );
+ WC_Checkoutcom_Utility::logger( '[VALIDATE CHECKOUT] FATAL ERROR stack trace: ' . $e->getTraceAsString() );
+ wp_send_json_error( array( 'message' => __( 'Fatal error during validation: ', 'checkout-com-unified-payments-api' ) . $e->getMessage() ) );
+ }
+}
+
+add_action( 'wp_ajax_cko_get_payment_session', 'cko_get_payment_session' );
+add_action( 'wp_ajax_nopriv_cko_get_payment_session', 'cko_get_payment_session' );
+
+/**
+ * Retrieves payment session details from Checkout.com via AJAX.
+ */
+function cko_get_payment_session() {
+ // Get the session ID from the request
+ $session_id = isset( $_REQUEST['session_id'] ) ? sanitize_text_field( $_REQUEST['session_id'] ) : '';
+
+ if ( empty( $session_id ) ) {
+ wp_send_json_error( array( 'message' => __( 'Session ID is required', 'checkout-com-unified-payments-api' ) ) );
+ }
+
+ WC_Checkoutcom_Utility::logger( '=== GET PAYMENT SESSION ===' );
+ WC_Checkoutcom_Utility::logger( 'Session ID: ' . $session_id );
+
+ try {
+ // Get Checkout.com API settings
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $environment = ! empty( $core_settings['ckocom_environment'] ) ? $core_settings['ckocom_environment'] : 'sandbox';
+ $secret_key = $environment === 'sandbox'
+ ? ( ! empty( $core_settings['ckocom_sk'] ) ? $core_settings['ckocom_sk'] : '' )
+ : ( ! empty( $core_settings['ckocom_sk_live'] ) ? $core_settings['ckocom_sk_live'] : '' );
+
+ if ( empty( $secret_key ) ) {
+ WC_Checkoutcom_Utility::logger( 'Error: Secret key not configured' );
+ wp_send_json_error( array( 'message' => __( 'Payment gateway not properly configured', 'checkout-com-unified-payments-api' ) ) );
+ }
+
+ // Make API call to Checkout.com to get payment session details
+ $api_url = $environment === 'sandbox'
+ ? 'https://api.sandbox.checkout.com/payment-sessions/' . $session_id
+ : 'https://api.checkout.com/payment-sessions/' . $session_id;
+
+ WC_Checkoutcom_Utility::logger( 'API URL: ' . $api_url );
+
+ $response = wp_remote_get(
+ $api_url,
+ array(
+ 'headers' => array(
+ 'Authorization' => 'Bearer ' . $secret_key,
+ 'Content-Type' => 'application/json',
+ ),
+ 'timeout' => 30,
+ )
+ );
+
+ if ( is_wp_error( $response ) ) {
+ WC_Checkoutcom_Utility::logger( 'WP Error: ' . $response->get_error_message() );
+ wp_send_json_error( array( 'message' => __( 'Could not retrieve payment session', 'checkout-com-unified-payments-api' ) ) );
+ }
+
+ $body = wp_remote_retrieve_body( $response );
+ $data = json_decode( $body, true );
+
+ WC_Checkoutcom_Utility::logger( 'API Response: ' . print_r( $data, true ) );
+
+ // Check if we have payment data
+ if ( isset( $data['payment'] ) && isset( $data['payment']['id'] ) ) {
+ $payment_data = array(
+ 'payment_id' => $data['payment']['id'],
+ 'payment_type' => isset( $data['payment']['source']['type'] ) ? $data['payment']['source']['type'] : 'card',
+ 'three_ds_status' => isset( $data['payment']['3ds']['status'] ) ? $data['payment']['3ds']['status'] : '',
+ 'three_ds_auth_id' => isset( $data['payment']['3ds']['authentication_id'] ) ? $data['payment']['3ds']['authentication_id'] : '',
+ );
+
+ WC_Checkoutcom_Utility::logger( 'Payment data extracted: ' . print_r( $payment_data, true ) );
+
+ wp_send_json_success( $payment_data );
+ } else {
+ WC_Checkoutcom_Utility::logger( 'Error: Payment data not found in response' );
+ wp_send_json_error( array( 'message' => __( 'Payment data not found', 'checkout-com-unified-payments-api' ) ) );
+ }
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( 'Exception: ' . $e->getMessage() );
+ wp_send_json_error( array( 'message' => __( 'An error occurred while processing the payment session', 'checkout-com-unified-payments-api' ) ) );
+ }
+}
+
+/**
+ * Register a custom REST API route for checking payment status.
+ */
+add_action(
+ 'rest_api_init',
+ function () {
+ register_rest_route(
+ 'ckoplugin/v1',
+ '/payment-status',
+ array(
+ 'methods' => 'GET',
+ 'callback' => 'cko_get_payment_status',
+ 'permission_callback' => '__return_true',
+ )
+ );
+ }
+);
+
+/**
+ * Callback function to get payment status from Checkout.com API.
+ *
+ * @param WP_REST_Request $request The REST API request object.
+ * @return WP_REST_Response JSON response with payment status or error.
+ */
+function cko_get_payment_status( $request ) {
+ $payment_id = sanitize_text_field( $request->get_param( 'paymentId' ) );
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $env = $core_settings['ckocom_environment'];
+ $secret_key = $core_settings['ckocom_sk'];
+
+ if ( empty( $payment_id ) ) {
+ return new WP_REST_Response( array( 'error' => 'Missing paymentId' ), 400 );
+ }
+
+ $url = "https://api.checkout.com/payments/{$payment_id}";
+
+ if ( 'sandbox' === $env ) {
+ $url = "https://api.sandbox.checkout.com/payments/{$payment_id}";
+ }
+
+ // Send the GET request to Checkout.com.
+ $response = wp_remote_get(
+ $url,
+ array(
+ 'headers' => array(
+ 'Authorization' => "Bearer $secret_key",
+ 'Content-Type' => 'application/json',
+ ),
+ )
+ );
+
+ if ( is_wp_error( $response ) ) {
+ return new WP_REST_Response( array( 'error' => $response->get_error_message() ), 500 );
+ }
+
+ $code = wp_remote_retrieve_response_code( $response );
+ $body = json_decode( wp_remote_retrieve_body( $response ), true );
+
+ // Return API response.
+ return new WP_REST_Response( $body, $code );
+}
+
+/**
+ * Sends the updated cart information as a JSON response.
+ *
+ * Used in AJAX handlers to fetch updated cart data.
+ *
+ * @return void
+ */
+function get_updated_cart_info() {
+ wp_send_json_success( WC_Checkoutcom_Api_Request::get_cart_info(true) );
+}
+
+add_action('wp_ajax_get_cart_info', 'get_updated_cart_info');
+add_action('wp_ajax_nopriv_get_cart_info', 'get_updated_cart_info');
diff --git a/flow-integration/.DS_Store b/flow-integration/.DS_Store
new file mode 100644
index 00000000..c3288384
Binary files /dev/null and b/flow-integration/.DS_Store differ
diff --git a/flow-integration/assets/.DS_Store b/flow-integration/assets/.DS_Store
new file mode 100644
index 00000000..f4636617
Binary files /dev/null and b/flow-integration/assets/.DS_Store differ
diff --git a/flow-integration/assets/css/flow.css b/flow-integration/assets/css/flow.css
new file mode 100644
index 00000000..19eeb339
--- /dev/null
+++ b/flow-integration/assets/css/flow.css
@@ -0,0 +1,581 @@
+#loading-overlay,
+#loading-overlay2 {
+ display: none;
+ position: fixed;
+ top: 0;
+ left: 0;
+ width: 100vw;
+ height: 100vh;
+ background: rgba(0, 0, 0, 0.5);
+ z-index: 9999;
+ align-items: center;
+ justify-content: center;
+ color: white;
+ font-size: 1.5rem;
+}
+
+/* Flow container loading state */
+#flow-container {
+ min-height: 100px;
+ position: relative;
+ transition: opacity 0.3s ease, box-shadow 0.3s ease;
+}
+
+/* When saved cards exist, style Flow container as a simple bordered block */
+.saved-cards-accordion-container ~ * #flow-container,
+.payment_method_wc_checkout_com_flow:has(.saved-cards-accordion-container) #flow-container {
+ background: #ffffff;
+ border: 1px solid #186aff;
+ border-radius: 8px;
+ padding: 20px;
+ margin: 20px 0;
+}
+
+#flow-container.loading {
+ opacity: 0.6;
+ pointer-events: none;
+}
+
+/* Skeleton loader for Flow component */
+.flow-skeleton-loader {
+ display: none;
+ padding: 0;
+ background: transparent;
+ border-radius: 0;
+ margin: 0;
+ opacity: 0;
+ transition: opacity 0.3s ease-out;
+}
+
+.flow-skeleton-loader.show {
+ display: block;
+ opacity: 1;
+}
+
+.flow-skeleton-line {
+ height: 40px;
+ background: linear-gradient(90deg, #e0e0e0 25%, #f0f0f0 50%, #e0e0e0 75%);
+ background-size: 200% 100%;
+ border-radius: 4px;
+ margin-bottom: 15px;
+ animation: shimmer 1.5s infinite;
+}
+
+.flow-skeleton-line:last-child {
+ margin-bottom: 0;
+}
+
+.flow-skeleton-line.short {
+ width: 60%;
+}
+
+@keyframes shimmer {
+ 0% {
+ background-position: 200% 0;
+ }
+ 100% {
+ background-position: -200% 0;
+ }
+}
+
+@keyframes pulse {
+ 0%, 100% {
+ opacity: 1;
+ }
+ 50% {
+ opacity: 0.8;
+ }
+}
+
+/* CRITICAL: For single Flow payment method pages, hide button immediately via CSS
+ This prevents the flash before JavaScript executes */
+body.flow-method-single #place_order {
+ opacity: 0;
+ visibility: hidden;
+ transition: opacity 0.2s ease, visibility 0.2s ease;
+}
+
+/* Show button when Flow is ready (single payment method) */
+body.flow-method-single.flow-ready #place_order {
+ opacity: 1;
+ visibility: visible;
+}
+
+/* Hide button when Flow is selected from multiple payment methods */
+body.flow-method-selected:not(.flow-method-single) #place_order {
+ opacity: 0;
+ visibility: hidden;
+ transition: opacity 0.2s ease, visibility 0.2s ease;
+}
+
+/* Show button when Flow is ready (multiple payment methods) */
+body.flow-method-selected.flow-ready #place_order {
+ opacity: 1;
+ visibility: visible;
+}
+
+/* Save to Account checkbox - initially hidden, shown by JS when card payment type is selected */
+.cko-save-card-checkbox {
+ display: none;
+ transition: opacity 0.2s ease;
+}
+
+/* When card payment is selected, the checkbox will be shown by JS with display: block */
+.cko-save-card-checkbox.wc-cko-flow-card-on {
+ /* Additional styling when card is selected */
+ opacity: 1;
+}
+
+/* Hide place order button when Flow is loading */
+#place_order.flow-loading {
+ opacity: 0.5;
+ pointer-events: none;
+ position: relative;
+}
+
+#place_order.flow-loading::after {
+ content: '';
+ position: absolute;
+ top: 50%;
+ right: 15px;
+ width: 16px;
+ height: 16px;
+ margin-top: -8px;
+ border: 2px solid #ffffff;
+ border-radius: 50%;
+ border-top-color: transparent;
+ animation: spin 0.8s linear infinite;
+}
+
+@keyframes spin {
+ to {
+ transform: rotate(360deg);
+ }
+}
+
+/* Smooth fade-in for Flow component */
+#flow-container > div {
+ animation: fadeIn 0.3s ease-in;
+}
+
+@keyframes fadeIn {
+ from {
+ opacity: 0;
+ transform: translateY(10px);
+ }
+ to {
+ opacity: 1;
+ transform: translateY(0);
+ }
+}
+
+.button-container {
+ display: flex;
+ height: 100%;
+}
+
+.wp-style-button {
+ border: none;
+ padding: 10px 3px;
+ margin: 8px;
+ cursor: pointer;
+ transition: 0.2s ease-in-out;
+}
+
+#flow-container .woocommerce-SavedPaymentMethods {
+ margin-left: 1.5em !important;
+}
+
+#flow-container .cko-save-card-checkbox {
+ margin-left: 0.7em !important;
+}
+
+#flow-container .cko-save-card-checkbox label[for="wc-wc_checkout_com_flow-new-payment-method"] {
+ margin-left: 0.1em !important;
+}
+
+#flow-container ul.woocommerce-SavedPaymentMethods:nth-of-type(1) li.woocommerce-SavedPaymentMethods-new {
+ display: none !important;
+}
+
+#flow-container ul.woocommerce-SavedPaymentMethods:nth-of-type(2) {
+ padding-top: 0 !important;
+}
+
+/* Flow Accordion Style */
+.flow-accordion-container {
+ margin: 20px 0;
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+}
+
+.flow-accordion {
+ background: #ffffff;
+ border: 1px solid #186aff;
+ border-radius: 8px;
+ overflow: hidden;
+}
+
+.flow-accordion-header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 16px 20px;
+ background: #ffffff;
+ cursor: default;
+}
+
+.flow-accordion-left {
+ display: flex;
+ align-items: center;
+ gap: 12px;
+ flex: 1;
+}
+
+.flow-icon {
+ width: 40px;
+ height: 24px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+}
+
+.flow-icon svg {
+ width: 40px;
+ height: 24px;
+}
+
+.flow-label {
+ display: flex;
+ flex-direction: column;
+ gap: 2px;
+}
+
+.flow-label-text {
+ font-size: 14px;
+ font-weight: 500;
+ color: #27292d;
+ line-height: 1.4;
+}
+
+.flow-label-subtext {
+ font-size: 12px;
+ color: #68686c;
+ line-height: 1.3;
+}
+
+.flow-accordion-panel {
+ padding: 0 20px 16px 20px;
+ animation: flowFadeIn 0.3s ease-in;
+}
+
+@keyframes flowFadeIn {
+ from {
+ opacity: 0;
+ transform: translateY(-10px);
+ }
+ to {
+ opacity: 1;
+ transform: translateY(0);
+ }
+}
+
+<<<<<<< HEAD
+/* Style the main payment method label - Customizable via CSS Variables */
+/* Defaults match standard WooCommerce appearance: transparent background, no border, icon on right */
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] {
+ display: flex !important;
+ align-items: center;
+ justify-content: space-between; /* For icon on right */
+ padding: var(--cko-payment-label-padding, 8px 12px); /* Standard WooCommerce padding */
+ background: var(--cko-payment-label-bg, transparent); /* Default: transparent (matches standard) */
+ border: var(--cko-payment-label-border-width, 0px) solid var(--cko-payment-label-border-color, transparent); /* Default: no border */
+ border-radius: var(--cko-payment-label-border-radius, 0px); /* Default: no rounding (matches standard) */
+ margin: 0 0 12px 0;
+ font-family: inherit; /* Inherit from theme (matches standard) */
+ cursor: pointer;
+ transition: all 0.2s ease;
+ text-align: var(--cko-payment-label-text-align, left); /* Default: left (matches standard WooCommerce) */
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"]:hover {
+ border-color: var(--cko-payment-label-border-color-hover, var(--cko-payment-label-border-color, transparent));
+ box-shadow: var(--cko-payment-label-box-shadow-hover, none);
+}
+
+/* Payment method icon/image - LEFT side (hidden by default, shown if icon_position = 'left') */
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"]::before {
+ content: '';
+ display: var(--cko-payment-label-icon-display-left, none); /* Default: hidden (icon on right) */
+ width: 40px;
+ height: 24px;
+ margin-right: 12px;
+ background-image: url('data:image/svg+xml;utf8,');
+ background-size: contain;
+ background-repeat: no-repeat;
+ background-position: center;
+ flex-shrink: 0;
+ order: var(--cko-payment-label-icon-order-left, 0);
+}
+
+/* Payment method icon/image - RIGHT side (shown by default, matches standard WooCommerce) */
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"]::after {
+ content: '';
+ display: var(--cko-payment-label-icon-display-right, inline-block); /* Default: shown (icon on right) */
+ width: 40px;
+ height: 24px;
+ margin-left: 12px;
+=======
+/* Style the main payment method label to match accordion design */
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] {
+ display: flex !important;
+ align-items: center;
+ padding: 16px 20px;
+ background: #ffffff;
+ border: 1px solid #186aff;
+ border-radius: 8px;
+ margin: 0 0 12px 0;
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+ cursor: pointer;
+ transition: all 0.2s ease;
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"]:hover {
+ border-color: #0052cc;
+ box-shadow: 0 2px 8px rgba(24, 106, 255, 0.15);
+}
+
+/* Payment method icon/image */
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"]::before {
+ content: '';
+ display: inline-block;
+ width: 40px;
+ height: 24px;
+ margin-right: 12px;
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ background-image: url('data:image/svg+xml;utf8,');
+ background-size: contain;
+ background-repeat: no-repeat;
+ background-position: center;
+ flex-shrink: 0;
+<<<<<<< HEAD
+ order: var(--cko-payment-label-icon-order-right, 2); /* Right side */
+}
+
+/* Custom image support - add this class to use custom image */
+.payment_method_wc_checkout_com_flow.has-custom-icon > label[for="payment_method_wc_checkout_com_flow"]::before,
+.payment_method_wc_checkout_com_flow.has-custom-icon > label[for="payment_method_wc_checkout_com_flow"]::after {
+=======
+}
+
+/* Custom image support - add this class to use custom image */
+.payment_method_wc_checkout_com_flow.has-custom-icon > label[for="payment_method_wc_checkout_com_flow"]::before {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ background-image: var(--checkout-payment-icon);
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] .payment-method-text {
+ display: flex;
+ flex-direction: column;
+ flex: 1;
+<<<<<<< HEAD
+ order: 1; /* Text always on left */
+ text-align: var(--cko-payment-label-text-align, left); /* Default: left (matches standard WooCommerce) */
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] .payment-method-title {
+ font-size: var(--cko-payment-label-title-font-size, inherit); /* Default: inherit from theme */
+ font-weight: var(--cko-payment-label-title-font-weight, inherit); /* Default: inherit from theme */
+ color: var(--cko-payment-label-text-color, inherit); /* Default: inherit from theme (matches standard) */
+ line-height: 1.4;
+ text-align: var(--cko-payment-label-text-align, left); /* Default: left (matches standard WooCommerce) */
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] .payment-method-subtitle {
+ font-size: var(--cko-payment-label-subtitle-font-size, 0.9em); /* Slightly smaller */
+ color: var(--cko-payment-label-subtitle-color, inherit); /* Default: inherit from theme (matches standard) */
+ margin-top: 2px;
+ line-height: 1.3;
+ opacity: var(--cko-payment-label-subtitle-opacity, 0.7); /* Subtle by default */
+ text-align: var(--cko-payment-label-text-align, left); /* Default: left (matches standard WooCommerce) */
+=======
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] .payment-method-title {
+ font-size: 15px;
+ font-weight: 600;
+ color: #1a1a1a;
+ line-height: 1.4;
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] .payment-method-subtitle {
+ font-size: 13px;
+ color: #666;
+ margin-top: 2px;
+ line-height: 1.3;
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+}
+
+/* Saved Cards Accordion Style - Matches Flow Style */
+.saved-cards-accordion-container {
+ margin: 20px 0;
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+ min-height: 50px !important;
+}
+
+body[data-saved-payment-order="saved_cards_first"] .saved-cards-accordion-container {
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+ min-height: 50px !important;
+}
+
+body[data-saved-payment-order="new_payment_first"] .saved-cards-accordion-container {
+ display: none !important;
+}
+
+body[data-saved-payment-order="new_payment_first"].flow-ready .saved-cards-accordion-container {
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+ min-height: 50px !important;
+}
+
+.saved-cards-accordion {
+ background: #ffffff;
+ border: 1px solid #186aff;
+ border-radius: 8px;
+ overflow: visible !important;
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+}
+
+.saved-cards-accordion-header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 12px 16px;
+ background: #ffffff;
+ cursor: pointer;
+}
+
+.saved-cards-accordion-left {
+ display: flex;
+ align-items: center;
+ gap: 12px;
+ flex: 1;
+}
+
+.saved-cards-icon {
+ width: 40px;
+ height: 24px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+}
+
+.saved-cards-icon svg {
+ width: 40px;
+ height: 24px;
+}
+
+.saved-cards-label {
+ display: flex;
+ flex-direction: column;
+ gap: 2px;
+}
+
+.saved-cards-label-text {
+ font-size: 14px;
+ font-weight: 500;
+ color: #27292d;
+ line-height: 1.4;
+}
+
+.saved-cards-label-subtext {
+ font-size: 12px;
+ color: #68686c;
+ line-height: 1.3;
+}
+
+.saved-cards-accordion-panel {
+ padding: 0 16px 12px 16px;
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods {
+ margin: 0 !important;
+ padding: 0 !important;
+ list-style: none !important;
+ background: transparent !important;
+ border: none !important;
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods-new,
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li.woocommerce-SavedPaymentMethods-new,
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods-tokenBase,
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li.woocommerce-SavedPaymentMethods-tokenBase,
+.saved-cards-accordion-panel input[value="new"],
+.saved-cards-accordion-panel li:has(input[value="new"]) {
+ display: none !important;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li {
+ padding: 10px 12px;
+ margin: 6px 0 !important;
+ background: #ffffff;
+ border: 1px solid #e9ebeb;
+ border-radius: 4px;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li:hover {
+ border-color: #186aff;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li input[type="radio"] {
+ margin-right: 10px;
+ accent-color: #186aff;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li label {
+ display: inline-flex;
+ align-items: center;
+ cursor: pointer;
+ font-size: 14px;
+ color: #27292d;
+ margin: 0;
+ width: 100%;
+ font-weight: 400;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li label::before {
+ content: '';
+ display: inline-block;
+ width: 32px;
+ height: 20px;
+ margin-right: 10px;
+ background: url('data:image/svg+xml,') center/contain no-repeat;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li input[type="radio"]:checked + label {
+ font-weight: 500;
+ color: #186aff;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li input[type="radio"]:checked + label::before {
+ background: url('data:image/svg+xml,') center/contain no-repeat;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li:has(input[type="radio"]:checked) {
+ background: #f0f6ff;
+ border-color: #186aff;
+ border-width: 1px;
+}
diff --git a/flow-integration/assets/js/flow-container.js b/flow-integration/assets/js/flow-container.js
new file mode 100644
index 00000000..95c44aef
--- /dev/null
+++ b/flow-integration/assets/js/flow-container.js
@@ -0,0 +1,164 @@
+// ALWAYS VISIBLE - Critical for diagnosing Flow disappearing issue
+console.log('[FLOW CONTAINER] Script loaded');
+
+// Define addPaymentMethod outside any event listener so it's always available
+function addPaymentMethod() {
+ // ALWAYS VISIBLE - Critical for diagnosing Flow disappearing issue
+ console.log('[FLOW CONTAINER] addPaymentMethod() called');
+
+ const paymentContainer = document.querySelector(
+ ".payment_method_wc_checkout_com_flow"
+ );
+
+ console.log('[FLOW CONTAINER] addPaymentMethod() state:', {
+ paymentContainerExists: !!paymentContainer,
+ existingContainerId: document.getElementById('flow-container') ? 'EXISTS' : 'NOT FOUND'
+ });
+
+ if (paymentContainer) {
+ // Add flow-container to the PAYMENT_BOX div, not the accordion!
+ // Skip any accordion divs and find the actual payment_box
+ const innerDiv = paymentContainer.querySelector("div.payment_box");
+
+ console.log('[FLOW CONTAINER] addPaymentMethod() - payment_box div:', {
+ innerDivExists: !!innerDiv,
+ innerDivHasId: innerDiv ? !!innerDiv.id : false,
+ innerDivId: innerDiv ? innerDiv.id : 'N/A'
+ });
+
+ if (innerDiv && !innerDiv.id) {
+ innerDiv.id = "flow-container";
+ innerDiv.style.padding = "0";
+ console.log('[FLOW CONTAINER] ✅ Created flow-container id on payment_box div');
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('Set flow-container id on payment_box div');
+ }
+ } else if (innerDiv && innerDiv.id === 'flow-container') {
+ console.log('[FLOW CONTAINER] ✅ Container already exists with correct ID');
+ } else if (!innerDiv) {
+ console.log('[FLOW CONTAINER] ❌ ERROR: payment_box div not found inside payment method container');
+ console.log('[FLOW CONTAINER] Payment container HTML:', paymentContainer.innerHTML.substring(0, 200));
+ }
+
+ // IMPORTANT: Check for saved payment methods (not accordion, which is created later)
+ // The .woocommerce-SavedPaymentMethods elements exist in DOM immediately (PHP rendered)
+ const savedPaymentMethods = document.querySelectorAll('.woocommerce-SavedPaymentMethods.wc-saved-payment-methods');
+ let hasSavedCards = false;
+
+ savedPaymentMethods.forEach(function(el) {
+ const count = parseInt(el.getAttribute("data-count") || '0', 10);
+ if (count > 0) {
+ hasSavedCards = true;
+ }
+ });
+
+ if (hasSavedCards) {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('Skipping Flow accordion - saved cards exist (count > 0), using simple layout');
+ }
+ return; // Don't wrap in accordion when saved cards are present
+ }
+
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('No saved cards found, using default label (no accordion wrapper)');
+ }
+
+ // DISABLED: Don't wrap Flow in accordion when no saved cards
+ // Use the default WooCommerce payment method label instead
+ // This ensures "Payment FLOW Payment" label is always visible
+ } else {
+ console.log('[FLOW CONTAINER] ❌ Payment method container not found');
+ }
+}
+
+// Run addPaymentMethod immediately if DOM is ready, otherwise wait
+if (document.readyState === 'loading') {
+ document.addEventListener("DOMContentLoaded", function () {
+ console.log('[FLOW CONTAINER] DOMContentLoaded - calling addPaymentMethod()');
+ addPaymentMethod();
+ });
+} else {
+ console.log('[FLOW CONTAINER] DOM already loaded - calling addPaymentMethod() immediately');
+ addPaymentMethod();
+}
+
+// Attach updated_checkout handler immediately (doesn't need to wait for DOMContentLoaded)
+jQuery(document).on("updated_checkout", function () {
+ // ALWAYS VISIBLE - Critical for diagnosing Flow disappearing issue
+ console.log('[FLOW CONTAINER] updated_checkout event fired, re-checking...');
+
+ // CRITICAL: Wait for WooCommerce to finish updating DOM before checking
+ // WooCommerce replaces HTML asynchronously, so we need to wait
+ setTimeout(function() {
+ const flowContainer = document.getElementById('flow-container');
+ const flowComponentRoot = document.querySelector('[data-testid="checkout-web-component-root"]');
+ const paymentMethod = document.querySelector('.payment_method_wc_checkout_com_flow');
+
+ console.log('[FLOW CONTAINER] After updated_checkout (100ms):', {
+ flowContainerExists: !!flowContainer,
+ flowComponentRootExists: !!flowComponentRoot,
+ paymentMethodExists: !!paymentMethod
+ });
+
+ // CRITICAL FIX: Always call addPaymentMethod() if payment method exists but container doesn't
+ // This ensures the container is recreated after WooCommerce destroys it
+ if (paymentMethod && !flowContainer) {
+ console.log('[FLOW CONTAINER] Payment method exists but container missing - creating container');
+ addPaymentMethod();
+ } else if (flowContainer && (!flowComponentRoot || !flowContainer.querySelector('[data-testid="checkout-web-component-root"]'))) {
+ console.log('[FLOW CONTAINER] Flow component not mounted after DOM update, calling addPaymentMethod');
+ addPaymentMethod();
+ } else if (flowContainer && flowComponentRoot) {
+ console.log('[FLOW CONTAINER] Flow component is still mounted, skipping addPaymentMethod');
+ } else if (!paymentMethod) {
+ console.log('[FLOW CONTAINER] Payment method not found - Flow not selected');
+ } else {
+ console.log('[FLOW CONTAINER] Container not found yet, will retry...');
+ // Container might not be ready yet, retry after a short delay
+ setTimeout(function() {
+ const flowContainerRetry = document.getElementById('flow-container');
+ const paymentMethodRetry = document.querySelector('.payment_method_wc_checkout_com_flow');
+ console.log('[FLOW CONTAINER] Retry check (300ms total):', {
+ flowContainerExists: !!flowContainerRetry,
+ paymentMethodExists: !!paymentMethodRetry
+ });
+ if (paymentMethodRetry && !flowContainerRetry) {
+ console.log('[FLOW CONTAINER] Payment method found on retry but container missing - creating container');
+ addPaymentMethod();
+ } else if (flowContainerRetry && !document.querySelector('[data-testid="checkout-web-component-root"]')) {
+ console.log('[FLOW CONTAINER] Flow container found on retry, calling addPaymentMethod');
+ addPaymentMethod();
+ }
+ }, 200);
+ }
+ }, 100); // Wait 100ms for WooCommerce to finish updating DOM
+});
+
+// Additional check after a delay to catch late-rendered saved cards
+setTimeout(function() {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('Delayed check for saved cards...');
+ }
+
+ // If saved cards accordion was created after initial load, remove Flow accordion if it exists
+ const savedCardsAccordion = document.querySelector('.saved-cards-accordion-container');
+ const flowAccordion = document.querySelector('.flow-accordion-container');
+
+ if (savedCardsAccordion && flowAccordion) {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('REMOVING Flow accordion - saved cards were created after initial load');
+ }
+
+ // Move flow-container out of the accordion
+ const flowContainer = document.getElementById('flow-container');
+ if (flowContainer) {
+ // Insert flow-container before the flow accordion
+ flowAccordion.parentNode.insertBefore(flowContainer, flowAccordion);
+ // Remove the flow accordion wrapper
+ flowAccordion.remove();
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('Flow accordion removed, using simple layout');
+ }
+ }
+ }
+}, 1000);
diff --git a/flow-integration/assets/js/flow-customization.js b/flow-integration/assets/js/flow-customization.js
new file mode 100644
index 00000000..725a1fc6
--- /dev/null
+++ b/flow-integration/assets/js/flow-customization.js
@@ -0,0 +1,181 @@
+/**
+ * Appearance, Button, Footnote, Label, Border and Subheading settings setion.
+ */
+
+window.appearance = {
+ colorAction: cko_flow_customization_vars.flow_appearance_color_action,
+ colorBackground: cko_flow_customization_vars.flow_appearance_color_background,
+ colorBorder: cko_flow_customization_vars.flow_appearance_color_border,
+ colorDisabled: cko_flow_customization_vars.flow_appearance_color_disabled,
+ colorError: cko_flow_customization_vars.flow_appearance_color_error,
+ colorFormBackground:
+ cko_flow_customization_vars.flow_appearance_color_form_background,
+ colorFormBorder:
+ cko_flow_customization_vars.flow_appearance_color_form_border,
+ colorInverse: cko_flow_customization_vars.flow_appearance_color_inverse,
+ colorOutline: cko_flow_customization_vars.flow_appearance_color_outline,
+ colorPrimary: cko_flow_customization_vars.flow_appearance_color_primary,
+ colorSecondary: cko_flow_customization_vars.flow_appearance_color_secondary,
+ colorSuccess: cko_flow_customization_vars.flow_appearance_color_success,
+ button: {
+ fontFamily: cko_flow_customization_vars.flow_button_font_family,
+ fontSize: cko_flow_customization_vars.flow_button_font_size,
+ fontWeight: cko_flow_customization_vars.flow_button_font_weight,
+ letterSpacing: cko_flow_customization_vars.flow_button_letter_spacing,
+ lineHeight: cko_flow_customization_vars.flow_button_line_height,
+ },
+ footnote: {
+ fontFamily: cko_flow_customization_vars.flow_footnote_font_family,
+ fontSize: cko_flow_customization_vars.flow_footnote_font_size,
+ fontWeight: cko_flow_customization_vars.flow_footnote_font_weight,
+ letterSpacing: cko_flow_customization_vars.flow_footnote_letter_spacing,
+ lineHeight: cko_flow_customization_vars.flow_footnote_line_height,
+ },
+ label: {
+ fontFamily: cko_flow_customization_vars.flow_label_font_family,
+ fontSize: cko_flow_customization_vars.flow_label_font_size,
+ fontWeight: cko_flow_customization_vars.flow_label_font_weight,
+ letterSpacing: cko_flow_customization_vars.flow_label_letter_spacing,
+ lineHeight: cko_flow_customization_vars.flow_label_line_height,
+ },
+ subheading: {
+ fontFamily: cko_flow_customization_vars.flow_subheading_font_family,
+ fontSize: cko_flow_customization_vars.flow_subheading_font_size,
+ fontWeight: cko_flow_customization_vars.flow_subheading_font_weight,
+ letterSpacing: cko_flow_customization_vars.flow_subheading_letter_spacing,
+ lineHeight: cko_flow_customization_vars.flow_subheading_line_height,
+ },
+ borderRadius: [
+ cko_flow_customization_vars.flow_form_border_radius,
+ cko_flow_customization_vars.flow_button_border_radius,
+ ],
+};
+
+/**
+ * Component Settings setion.
+ */
+
+// Expand first payment.
+let expand_first_payment_method =
+ cko_flow_customization_vars.flow_component_expand_first_payment_method;
+if (expand_first_payment_method === "yes") {
+ expand_first_payment_method = true;
+} else {
+ expand_first_payment_method = false;
+}
+
+window.componentOptions = {
+ flow: {
+ expandFirstPaymentMethod: expand_first_payment_method,
+ },
+ card: {
+ displayCardholderName:
+ cko_flow_customization_vars.flow_component_cardholder_name_position,
+ },
+};
+
+// Show card holder name.
+let show_card_holder_name =
+ cko_flow_customization_vars.flow_show_card_holder_name;
+
+// Saved Payment setting.
+window.saved_payment = cko_flow_customization_vars.flow_saved_payment;
+
+document.addEventListener("DOMContentLoaded", function () {
+ if (show_card_holder_name === "yes") {
+ // Function to set cardholder name
+ function setCardholderName() {
+ let family_name = "";
+ let given_name = "";
+
+ // Check if we're on order-pay page
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+
+ if (isOrderPayPage) {
+ // For order-pay pages, get billing info from order data instead of form fields
+ // The order data is available in the cart-info or order-pay-info data attribute
+ let orderData = null;
+
+ // Try to get order data from cart-info or order-pay-info
+ const cartInfoElement = document.getElementById("cart-info");
+ const orderPayInfoElement = document.getElementById("order-pay-info");
+
+ if (orderPayInfoElement) {
+ orderData = orderPayInfoElement.getAttribute("data-order-pay");
+ } else if (cartInfoElement) {
+ orderData = cartInfoElement.getAttribute("data-cart");
+ }
+
+ if (orderData) {
+ try {
+ const parsedData = JSON.parse(orderData);
+
+ // Get billing info from order data
+ if (parsedData.billing_address) {
+ given_name = parsedData.billing_address.given_name || "";
+ family_name = parsedData.billing_address.family_name || "";
+ }
+ } catch (e) {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.error('Error parsing order data for cardholder name:', e);
+ }
+ }
+ }
+
+ // Fallback: try to get from form fields (even if disabled)
+ if (!given_name && !family_name) {
+ family_name = document.getElementById("billing_last_name")?.value || "";
+ given_name = document.getElementById("billing_first_name")?.value || "";
+ }
+ } else {
+ // For regular checkout pages, get from form fields
+ family_name = document.getElementById("billing_last_name")?.value || "";
+ given_name = document.getElementById("billing_first_name")?.value || "";
+ }
+
+ const cardholderName = `${given_name} ${family_name}`.trim();
+
+ if (cardholderName) {
+ window.componentOptions.card.data = {
+ cardholderName: cardholderName,
+ };
+ }
+ }
+
+ // Set cardholder name immediately
+ setCardholderName();
+ }
+});
+
+// Component name section.
+window.componentName = cko_flow_customization_vars.flow_component_name || 'flow';
+
+// Locale and Translation section.
+window.locale = cko_flow_customization_vars.flow_component_locale;
+
+function isValidJson(str) {
+ try {
+ if (!str || str.trim() === '' || str === 'null' || str === 'undefined') {
+ return false;
+ }
+ JSON.parse(str);
+ return true;
+ } catch (error) {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.warn('Failed to parse translation data:', error);
+ }
+ return false;
+}
+}
+
+// Safely parse translation data with fallback
+window.translations = {};
+if (typeof cko_flow_customization_vars !== 'undefined' &&
+ cko_flow_customization_vars.flow_component_translation &&
+ isValidJson(cko_flow_customization_vars.flow_component_translation)) {
+ window.translations = JSON.parse(cko_flow_customization_vars.flow_component_translation);
+} else {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('No valid translation data found, using empty translations object');
+ }
+}
diff --git a/flow-integration/assets/js/payment-session.js b/flow-integration/assets/js/payment-session.js
new file mode 100644
index 00000000..f949b6d9
--- /dev/null
+++ b/flow-integration/assets/js/payment-session.js
@@ -0,0 +1,4921 @@
+/*
+ * Centralized logging utility for Checkout.com Flow integration.
+ * Controls what logs appear in production vs debug mode.
+ */
+var ckoLogger = {
+ debugEnabled: (typeof cko_flow_vars !== 'undefined' && cko_flow_vars.debug_logging) || false,
+
+ // ALWAYS VISIBLE (Production + Debug) - Critical for payment troubleshooting
+ error: function(message, data) {
+ console.error('[FLOW ERROR] ' + message, data !== undefined ? data : '');
+ },
+
+ warn: function(message, data) {
+ console.warn('[FLOW WARNING] ' + message, data !== undefined ? data : '');
+ },
+
+ webhook: function(message, data) {
+ console.log('[FLOW WEBHOOK] ' + message, data !== undefined ? data : '');
+ },
+
+ threeDS: function(message, data) {
+ console.log('[FLOW 3DS] ' + message, data !== undefined ? data : '');
+ },
+
+ payment: function(message, data) {
+ console.log('[FLOW PAYMENT] ' + message, data !== undefined ? data : '');
+ },
+
+ version: function(version) {
+ console.log('🚀 Checkout.com Flow v' + version);
+ },
+
+ // DEBUG ONLY (Hidden in Production) - Enable via "Debug Logging" setting
+ debug: function(message, data) {
+ if (this.debugEnabled) {
+ console.log('[FLOW DEBUG] ' + message, data !== undefined ? data : '');
+ }
+ },
+
+ performance: function(message, data) {
+ if (this.debugEnabled) {
+ console.log('[FLOW PERFORMANCE] ' + message, data !== undefined ? data : '');
+ }
+ }
+};
+
+/*
+ * CRITICAL: Early 3DS Detection - MUST run before any other code
+ * This prevents Flow from initializing during 3DS returns
+ */
+(function() {
+ // Check URL parameters immediately (before any other code runs)
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ // Set flag IMMEDIATELY - this prevents ALL Flow initialization
+ window.ckoFlow3DSReturn = true;
+
+ // Log using console.log (always available, even before ckoLogger is defined)
+ console.log('[FLOW 3DS] ⚠️⚠️⚠️ EARLY DETECTION: 3DS return detected, preventing ALL Flow initialization', {
+ paymentId: paymentId,
+ sessionId: sessionId,
+ paymentSessionId: paymentSessionId,
+ timestamp: new Date().toISOString()
+ });
+ }
+})();
+
+/*
+ * The main object managing the Checkout.com flow payment integration.
+ */
+var ckoFlow = {
+ flowComponent: null, // Holds the reference to the Checkout Web Component.
+ performanceMetrics: {
+ pageLoadTime: null,
+ flowInitStartTime: null,
+ flowReadyTime: null,
+ },
+
+ /*
+ * Initializes the payment flow by loading the component.
+ */
+ init: () => {
+ // Don't initialize if 3DS return is in progress
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('Skipping ckoFlow.init() - 3DS return in progress');
+ return;
+ }
+
+ // Mark when Flow initialization starts
+ ckoFlow.performanceMetrics.flowInitStartTime = performance.now();
+ ckoLogger.performance('Flow initialization started');
+ ckoFlow.loadFlow();
+ },
+
+ /*
+ * Loads the Checkout.com payment flow by collecting cart and user info,
+ * creating a payment session, and mounting the Checkout component.
+ */
+ loadFlow: async () => {
+ // CRITICAL: Check for 3DS return FIRST - before any other checks
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('loadFlow: 3DS return in progress, aborting Flow initialization');
+ return; // Exit immediately
+ }
+
+ // Check if cko_flow_vars is available
+ if (typeof cko_flow_vars === 'undefined') {
+ ckoLogger.error('cko_flow_vars is not defined. Flow cannot be initialized.');
+ return;
+ }
+
+ ckoLogger.version('2025-10-13-FINAL-E2E');
+
+ // Check if we're on a redirect page with payment parameters - if so, don't initialize Flow
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const status = urlParams.get("status");
+
+ // Detect 3DS redirect: if we have payment ID or session ID in URL, it's a 3DS return
+ // Don't require status parameter (some environments don't include it)
+ const is3DSReturn = (paymentId || sessionId);
+
+ if (is3DSReturn) {
+ ckoLogger.threeDS('3DS redirect detected - Server-side processing should handle this', {
+ paymentId: paymentId,
+ sessionId: sessionId,
+ status: status || 'detected_via_ids'
+ });
+
+ // Prevent Flow initialization and updated_checkout events during 3DS return
+ window.ckoFlow3DSReturn = true;
+
+ // Server-side should handle this, but if page loads, JavaScript can help as fallback
+ // Wait longer for slow environments - server-side processing might take time
+ setTimeout(() => {
+ // If we're still on checkout page after delay, server-side didn't redirect
+ // Fallback: submit form via JavaScript
+ if (window.location.pathname.includes('/checkout/') && !window.location.pathname.includes('/order-received/')) {
+ ckoLogger.threeDS('Server-side redirect did not occur, using JavaScript fallback');
+
+ // Set the payment ID in the hidden input
+ const paymentIdInput = document.getElementById('cko-flow-payment-id');
+ if (paymentIdInput && paymentId) {
+ paymentIdInput.value = paymentId;
+ ckoLogger.debug('Set payment ID in hidden input:', paymentId);
+ }
+
+ // Set payment type to card (most common)
+ const paymentTypeInput = document.getElementById('cko-flow-payment-type');
+ if (paymentTypeInput) {
+ paymentTypeInput.value = 'card';
+ ckoLogger.debug('Set payment type to: card');
+ }
+
+ // Submit the checkout form to complete the order
+ const checkoutForm = document.querySelector('form.checkout');
+ const orderPayForm = document.querySelector('form#order_review');
+
+ if (checkoutForm) {
+ ckoLogger.threeDS('Submitting checkout form to complete order (fallback)');
+ jQuery(checkoutForm).off('submit').submit();
+ } else if (orderPayForm) {
+ ckoLogger.threeDS('Submitting order-pay form to complete order (fallback)');
+ jQuery(orderPayForm).off('submit').submit();
+ } else {
+ ckoLogger.error('No checkout or order-pay form found after 3DS redirect');
+ }
+ } else {
+ ckoLogger.threeDS('Server-side redirect successful, no JavaScript action needed');
+ }
+ }, 5000); // Wait 5 seconds for server-side redirect (increased for slow environments)
+
+ return; // Don't initialize Flow component
+ }
+
+ // Show skeleton loader and disable place order button
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+
+ if (skeleton) {
+ skeleton.classList.add("show");
+ }
+ if (placeOrderBtn) {
+ placeOrderBtn.classList.add("flow-loading");
+ }
+
+ let cartInfo = jQuery("#cart-info").data("cart");
+
+ if ( ! cartInfo || jQuery.isEmptyObject( cartInfo ) ) {
+ cartInfo = jQuery("#order-pay-info").data("order-pay");
+ }
+
+ /*
+ * Extract information from cartInfo or fallback to DOM form inputs.
+ */
+ let amount = cartInfo["order_amount"];
+ let currency = cartInfo["purchase_currency"];
+
+ let reference = "WOO" + (cko_flow_vars.ref_session || 'default');
+
+ let email =
+ cartInfo["billing_address"]["email"] ||
+ (document.getElementById("billing_email") ? document.getElementById("billing_email").value : '');
+ let family_name =
+ cartInfo["billing_address"]["family_name"] ||
+ (document.getElementById("billing_last_name") ? document.getElementById("billing_last_name").value : '');
+ let given_name =
+ cartInfo["billing_address"]["given_name"] ||
+ (document.getElementById("billing_first_name") ? document.getElementById("billing_first_name").value : '');
+<<<<<<< HEAD
+
+ // CRITICAL: Validate email before proceeding - prevent API call with invalid email
+ // Use inline validation to ensure it works even if isValidEmail() isn't available
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ if (!email || typeof email !== 'string' || !email.trim() || !emailRegex.test(email.trim())) {
+ ckoLogger.error('❌ BLOCKED: Invalid email at first check', {
+ email: email,
+ emailType: typeof email,
+ emailLength: email?.length,
+ isEmpty: !email || !email.trim()
+ });
+ hideLoadingOverlay();
+ showError('Please enter a valid email address to continue with payment.');
+ return; // Exit early - don't call API with invalid email
+ }
+
+ // Trim email to remove whitespace
+ email = email.trim();
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ let phone =
+ cartInfo["billing_address"]["phone"] ||
+ (document.getElementById("billing_phone") ? document.getElementById("billing_phone").value : '');
+
+ let address1 = shippingAddress1 = cartInfo["billing_address"]["street_address"];
+ let address2 = shippingAddress2 = cartInfo["billing_address"]["street_address2"];
+ let city = shippingCity = cartInfo["billing_address"]["city"];
+ let zip = shippingZip = cartInfo["billing_address"]["postal_code"];
+ let country = shippingCountry = cartInfo["billing_address"]["country"];
+
+
+ let shippingElement = document.getElementById("ship-to-different-address-checkbox");
+ if ( shippingElement?.checked ) {
+ shippingAddress1 = cartInfo["shipping_address"]["street_address"];
+ shippingAddress2 = cartInfo["shipping_address"]["street_address2"];
+ shippingCity = cartInfo["shipping_address"]["city"];
+ shippingZip = cartInfo["shipping_address"]["postal_code"];
+ shippingCountry = cartInfo["shipping_address"]["country"];
+ }
+
+ let orders = cartInfo["order_lines"];
+
+<<<<<<< HEAD
+ // CLIENT-SIDE FIX: Check if shipping is missing from order_lines
+ // This handles cases where cart-info was populated before shipping was calculated
+ if (orders && Array.isArray(orders) && cartInfo["order_amount"]) {
+ const productsTotal = orders.reduce((sum, item) => {
+ return sum + (parseInt(item.total_amount) || 0);
+ }, 0);
+ const orderAmountCents = parseInt(cartInfo["order_amount"]) || 0;
+ const shippingDifference = orderAmountCents - productsTotal;
+
+ // If there's a positive difference (shipping amount) and no shipping item exists
+ if (shippingDifference > 0) {
+ const hasShipping = orders.some(item =>
+ item.type === 'shipping_fee' ||
+ item.reference === 'shipping' ||
+ (item.name && item.name.toLowerCase().includes('shipping'))
+ );
+
+ if (!hasShipping) {
+ // Try to get shipping method name from DOM or use default
+ let shippingMethodName = 'Shipping';
+ const shippingMethodElement = document.querySelector('.woocommerce-shipping-methods .shipping-method input:checked + label, .woocommerce-shipping-methods label');
+ if (shippingMethodElement) {
+ shippingMethodName = shippingMethodElement.textContent.trim() || 'Shipping';
+ }
+
+ // Add shipping to order_lines
+ orders.push({
+ name: shippingMethodName,
+ quantity: 1,
+ unit_price: shippingDifference,
+ total_amount: shippingDifference,
+ tax_amount: 0,
+ type: 'shipping_fee',
+ reference: 'shipping',
+ discount_amount: 0
+ });
+
+ ckoLogger.debug('[PAYMENT SESSION] [SHIPPING DEBUG] Added missing shipping to order_lines - Amount: ' + shippingDifference + ', Name: ' + shippingMethodName);
+ }
+ }
+ }
+
+ let products = orders
+=======
+ let products = cartInfo["order_lines"]
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ .map(line => line.name)
+ .join(', ');
+
+ let description = 'Payment from ' + cko_flow_vars.site_url + ' for [ ' + products + ' ]';
+
+ // Truncate description to 100 characters (Checkout.com API limit)
+ if (description.length > 100) {
+ description = description.substring(0, 97) + '...';
+ }
+
+ let orderId = cartInfo["order_id"];
+ ckoLogger.debug('Initial orderId from cartInfo:', orderId);
+ ckoLogger.debug('Current URL pathname:', window.location.pathname);
+ ckoLogger.debug('Current URL search:', window.location.search);
+
+ // For MOTO orders (order-pay page), get order ID from URL path if not in cartInfo
+ if ( ! orderId && window.location.pathname.includes('/order-pay/') ) {
+ // Extract order ID from URL path like /order-pay/4127/
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ orderId = pathMatch ? pathMatch[1] : null;
+ ckoLogger.debug('MOTO order detected - Order ID from URL path:', orderId);
+ }
+<<<<<<< HEAD
+ ckoLogger.debug('Final orderId:', orderId);
+
+ let payment_type = cko_flow_vars.regular_payment_type;
+=======
+
+ ckoLogger.debug('Final orderId:', orderId);
+
+ let payment_type = cko_flow_vars.regular_payment_type;
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ let metadata = {
+ udf5: cko_flow_vars.udf5,
+ }
+
+<<<<<<< HEAD
+ // Check for subscription product FIRST (before orderId check)
+ let containsSubscriptionProduct = cartInfo["contains_subscription_product"];
+ let cartInfoPaymentType = cartInfo["payment_type"];
+ let isSubscription = false;
+
+ // PRIORITY 1: Check cartInfo["payment_type"] if already set to Recurring by backend
+ if ( cartInfoPaymentType === cko_flow_vars.recurring_payment_type ) {
+ payment_type = cko_flow_vars.recurring_payment_type;
+ isSubscription = true;
+ ckoLogger.debug('Subscription detected via cartInfo["payment_type"] = Recurring');
+ }
+ // PRIORITY 2: Check containsSubscriptionProduct flag
+ else if ( containsSubscriptionProduct ) {
+ isSubscription = orders.some(order => order.is_subscription === true);
+ if ( isSubscription ) {
+ payment_type = cko_flow_vars.recurring_payment_type;
+ ckoLogger.debug('Subscription detected via containsSubscriptionProduct flag');
+ }
+ }
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ if ( orderId ) {
+ metadata = {
+ udf5: cko_flow_vars.udf5,
+ order_id: orderId,
+ }
+
+<<<<<<< HEAD
+ ckoLogger.debug('🔍 OrderId exists - Checking cartInfo payment_type:', {
+ orderId: orderId,
+ cartInfo_payment_type: cartInfo["payment_type"],
+ isSubscription: isSubscription,
+ current_payment_type: payment_type
+ });
+
+ // Only use cartInfo payment_type if it's not already set to recurring by subscription check
+ if ( !isSubscription ) {
+ payment_type = cartInfo["payment_type"];
+ ckoLogger.debug('✅ Using cartInfo payment_type:', payment_type);
+ } else {
+ ckoLogger.debug('⏭️ Skipping cartInfo payment_type (subscription takes priority). Current payment_type:', payment_type);
+ }
+ } else {
+ ckoLogger.debug('🔍 No orderId - payment_type remains:', payment_type);
+ }
+
+ ckoLogger.debug('🔍 Payment Type - Final value before paymentSessionRequest:', payment_type);
+=======
+ payment_type = cartInfo["payment_type"];
+ }
+
+ // Check for subscription product.
+ let containsSubscriptionProduct = cartInfo["contains_subscription_product"];
+
+ if ( containsSubscriptionProduct ) {
+ const isSubscription = orders.some(order => order.is_subscription === true);
+ if ( isSubscription ) {
+ payment_type = cko_flow_vars.recurring_payment_type;
+ }
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+
+ // Remove is_subscription from all orders.
+ orders.forEach(order => {
+ delete order.is_subscription;
+ });
+
+ /*
+ * Helper to get a field value by ID from the DOM.
+ */
+ function getCheckoutField(fieldId) {
+ const el = document.getElementById(fieldId);
+ return el && el.value ? el.value : null;
+ }
+
+ if (!email) {
+ email = getCheckoutField("billing_email");
+ }
+<<<<<<< HEAD
+
+ // CRITICAL: Validate email before proceeding - prevent API call with invalid email
+ // This is a safety check even though canInitializeFlow() should prevent this
+ // Use inline validation to ensure it works even if isValidEmail() isn't available
+ const emailRegex2 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ if (!email || typeof email !== 'string' || !email.trim() || !emailRegex2.test(email.trim())) {
+ ckoLogger.error('❌ BLOCKED: Invalid email at second check', {
+ email: email,
+ emailType: typeof email,
+ emailLength: email?.length,
+ isEmpty: !email || !email.trim()
+ });
+ hideLoadingOverlay();
+ showError('Please enter a valid email address to continue with payment.');
+ return; // Exit early - don't call API with invalid email
+ }
+
+ // Trim email to remove whitespace
+ email = email.trim();
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+
+ if (!family_name) {
+ family_name = getCheckoutField("billing_first_name");
+ }
+
+ if (!given_name) {
+ given_name = getCheckoutField("billing_last_name");
+ }
+
+ if (!phone) {
+ phone = getCheckoutField("billing_phone");
+ }
+
+ /*
+ * Displays the loading overlay.
+ */
+ function showLoadingOverlay(arg) {
+ let overlay = document.getElementById("loading-overlay");
+ if (arg === 2) {
+ overlay = document.getElementById("loading-overlay2");
+ }
+ if (overlay) {
+ overlay.style.display = "flex";
+ }
+ }
+
+ /*
+ * Hides the loading overlay.
+ */
+ function hideLoadingOverlay(arg) {
+ let overlay = document.getElementById("loading-overlay");
+ if (arg === 2) {
+ overlay = document.getElementById("loading-overlay2");
+ }
+ if (overlay) {
+ overlay.style.display = "none";
+ }
+ }
+
+ try {
+ showLoadingOverlay();
+
+ // Performance: Track API request start
+ const apiRequestStart = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance('Starting payment session API request...');
+ }
+
+ /*
+ * Send request to Checkout.com to create a payment session.
+ */
+ // Debug: Log 3DS configuration
+ // Ensure proper boolean values - convert any truthy/falsy values to strict booleans
+ const three_ds_enabled = Boolean(cko_flow_vars.three_d_enabled === true || cko_flow_vars.three_d_enabled === "true" || cko_flow_vars.three_d_enabled === 1 || cko_flow_vars.three_d_enabled === "1");
+ const attempt_n3d = Boolean(cko_flow_vars.attempt_no_three_d === true || cko_flow_vars.attempt_no_three_d === "true" || cko_flow_vars.attempt_no_three_d === 1 || cko_flow_vars.attempt_no_three_d === "1");
+
+ // Valid exemption values according to Checkout.com API
+ const valid_exemptions = [
+ "low_value", "trusted_listing", "trusted_listing_prompt",
+ "transaction_risk_assessment", "3ds_outage", "sca_delegation",
+ "out_of_sca_scope", "low_risk_program", "recurring_operation",
+ "data_share", "other"
+ ];
+
+ // Use valid exemption or default to null (no exemption)
+ const exemption = (cko_flow_vars.exemption && valid_exemptions.includes(cko_flow_vars.exemption)) ? cko_flow_vars.exemption : null;
+
+ ckoLogger.debug('Exemption Processing:', {
+ 'Raw exemption from backend': cko_flow_vars.exemption,
+ 'Type of raw exemption': typeof cko_flow_vars.exemption,
+ 'Is exemption truthy': !!cko_flow_vars.exemption,
+ 'Is exemption valid': cko_flow_vars.exemption && valid_exemptions.includes(cko_flow_vars.exemption),
+ 'Processed exemption': exemption,
+ 'Will exemption be included': !!exemption,
+ 'Valid exemptions list': valid_exemptions
+ });
+
+ ckoLogger.threeDS('3DS Configuration (field name: "3ds"):', {
+ 'Raw three_d_enabled': cko_flow_vars.three_d_enabled,
+ 'Type of three_d_enabled': typeof cko_flow_vars.three_d_enabled,
+ 'Processed enabled': three_ds_enabled,
+ 'Type of processed enabled': typeof three_ds_enabled,
+ 'Raw attempt_no_three_d': cko_flow_vars.attempt_no_three_d,
+ 'Type of attempt_no_three_d': typeof cko_flow_vars.attempt_no_three_d,
+ 'Processed attempt_n3d': attempt_n3d,
+ 'Type of processed attempt_n3d': typeof attempt_n3d,
+ challenge_indicator: cko_flow_vars.challenge_indicator || "no_preference",
+ 'Raw exemption': cko_flow_vars.exemption,
+ 'Processed exemption': exemption,
+ 'Raw allow_upgrade': cko_flow_vars.allow_upgrade,
+ 'Type of allow_upgrade': typeof cko_flow_vars.allow_upgrade,
+ allow_upgrade: cko_flow_vars.allow_upgrade === true || cko_flow_vars.allow_upgrade === "true" || cko_flow_vars.allow_upgrade === "yes",
+ });
+
+<<<<<<< HEAD
+ // CRITICAL: Log payment_type right before creating paymentSessionRequest
+ ckoLogger.debug('🔍 Payment Type Check - Right before paymentSessionRequest creation:', {
+ payment_type: payment_type,
+ regular_payment_type: cko_flow_vars.regular_payment_type,
+ recurring_payment_type: cko_flow_vars.recurring_payment_type,
+ isRecurring: payment_type === cko_flow_vars.recurring_payment_type,
+ isRegular: payment_type === cko_flow_vars.regular_payment_type
+ });
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // Debug: Log complete payment session request
+ const paymentSessionRequest = {
+ amount: amount,
+ currency: currency,
+<<<<<<< HEAD
+=======
+ reference: reference,
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ payment_type: payment_type,
+ description: description,
+ customer: {
+ name: `${given_name} ${family_name}`,
+ email: email,
+ },
+ billing: {
+ address: {
+ address_line1: address1,
+ address_line2: address2,
+ city: city,
+ zip: zip,
+ country: country,
+ },
+ },
+ shipping: {
+ address: {
+ address_line1: shippingAddress1,
+ address_line2: shippingAddress2,
+ city: shippingCity,
+ zip: shippingZip,
+ country: shippingCountry,
+ },
+ },
+<<<<<<< HEAD
+ // Determine success and failure URLs based on current page
+ // NOTE: success_url and failure_url are overridden below based on order-pay vs regular checkout
+ // These initial values are placeholders and will be replaced
+ // Use query string format (?wc-api=...) instead of path format (/wc-api/...) for WooCommerce API endpoints
+ success_url: window.location.origin + "/?wc-api=wc_checkoutcom_flow_process",
+ failure_url: window.location.origin + "/?wc-api=wc_checkoutcom_flow_process",
+=======
+ // Determine success and failure URLs based on current page
+ // NOTE: success_url and failure_url are overridden below based on order-pay vs regular checkout
+ // These initial values are placeholders and will be replaced
+ success_url: window.location.origin + "/wc-api/wc_checkoutcom_flow_process",
+ failure_url: window.location.origin + "/wc-api/wc_checkoutcom_flow_process",
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ metadata: metadata,
+ payment_method_configuration: {
+ card: {
+ store_payment_details: "enabled",
+ },
+ },
+ capture: true,
+ items: orders,
+ integration: {
+ external_platform: {
+ name: "Woocomerce",
+ version: cko_flow_vars.woo_version,
+ },
+ },
+ "3ds": {
+ enabled: three_ds_enabled,
+ attempt_n3d: attempt_n3d,
+ challenge_indicator: cko_flow_vars.challenge_indicator || "no_preference",
+ ...(exemption && { exemption: exemption }),
+ allow_upgrade: cko_flow_vars.allow_upgrade === true || cko_flow_vars.allow_upgrade === "true" || cko_flow_vars.allow_upgrade === "yes",
+ },
+ };
+
+ // Check if this is a MOTO order (admin-created order + order-pay page + guest customer)
+ const orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ const isMotoOrder = orderPayInfo?.payment_type === 'MOTO';
+
+ ckoLogger.debug('MOTO Detection - Payment Type:', orderPayInfo?.payment_type, 'Is MOTO:', isMotoOrder);
+
+ // Override payment type for MOTO orders
+ if (isMotoOrder) {
+ payment_type = 'MOTO';
+ ckoLogger.debug('MOTO order detected - setting payment_type to MOTO');
+ ckoLogger.debug('MOTO conditions: Admin order + Order-pay page + Guest customer');
+ } else {
+<<<<<<< HEAD
+ ckoLogger.debug('Not a MOTO order - current payment_type:', payment_type);
+ }
+
+ // CRITICAL: Log payment_type right before final assignment to paymentSessionRequest
+ ckoLogger.debug('🔍 Final Payment Type Assignment:', {
+ payment_type: payment_type,
+ regular_payment_type: cko_flow_vars.regular_payment_type,
+ recurring_payment_type: cko_flow_vars.recurring_payment_type,
+ isRecurring: payment_type === cko_flow_vars.recurring_payment_type,
+ isRegular: payment_type === cko_flow_vars.regular_payment_type,
+ isMOTO: payment_type === 'MOTO',
+ 'Will be assigned to paymentSessionRequest.payment_type': payment_type
+ });
+
+ // Update payment type in the request
+ paymentSessionRequest.payment_type = payment_type;
+
+ // Verify the assignment
+ ckoLogger.debug('✅ Verified paymentSessionRequest.payment_type after assignment:', paymentSessionRequest.payment_type);
+
+=======
+ ckoLogger.debug('Not a MOTO order - using regular payment type:', payment_type);
+ }
+
+ // Update payment type in the request
+ paymentSessionRequest.payment_type = payment_type;
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // SIMPLIFIED: All flows go directly to PHP endpoint which processes payment and redirects to success/failure page
+ // This provides a smooth transition: 3DS → PHP Endpoint → Success/Failure Page (no checkout page in between)
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+
+<<<<<<< HEAD
+ // Get save card preference to include in redirect URL (for 3DS flow)
+ const saveCardCheckbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ const saveCardValue = (saveCardCheckbox && saveCardCheckbox.checked) ? 'yes' : 'no';
+
+ ckoLogger.debug('[SAVE CARD DEBUG] Early checkbox read:', {
+ checkboxId: 'wc-wc_checkout_com_flow-new-payment-method',
+ checkboxFound: !!saveCardCheckbox,
+ checkboxChecked: saveCardCheckbox ? saveCardCheckbox.checked : false,
+ saveCardValue: saveCardValue
+ });
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ if (isOrderPayPage) {
+ // For order-pay pages, include order_id and key in URL so PHP endpoint can find the order
+ const orderId = window.location.pathname.match(/\/order-pay\/(\d+)\//)?.[1];
+ const orderKey = new URLSearchParams(window.location.search).get('key');
+
+ if (orderId && orderKey) {
+<<<<<<< HEAD
+ // Use query string format (?wc-api=...) for WooCommerce API endpoints
+ // Include save card preference in URL for 3DS flow
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&order_id=" + orderId + "&key=" + orderKey + "&cko-save-card=" + saveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&order_id=" + orderId + "&key=" + orderKey + "&cko-save-card=" + saveCardValue;
+ ckoLogger.debug('Order-pay - using PHP endpoint with order_id, key, and save card preference: ' + saveCardValue);
+ } else {
+ ckoLogger.error('❌ ERROR: Could not extract order ID or key from order-pay URL');
+ // Fallback to PHP endpoint without order_id (will try to find order by payment session ID)
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + saveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + saveCardValue;
+ ckoLogger.debug('Order-pay fallback - using PHP endpoint without order_id, save card preference: ' + saveCardValue);
+ }
+ } else {
+ // For regular checkout, redirect directly to PHP endpoint which processes payment and redirects to success page
+ // Use query string format (?wc-api=...) for WooCommerce API endpoints
+ // Include save card preference in URL for 3DS flow
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + saveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + saveCardValue;
+ ckoLogger.debug('Regular checkout - using PHP endpoint for direct redirect to success page, save card preference: ' + saveCardValue);
+=======
+ paymentSessionRequest.success_url = window.location.origin + "/wc-api/wc_checkoutcom_flow_process?order_id=" + orderId + "&key=" + orderKey;
+ paymentSessionRequest.failure_url = window.location.origin + "/wc-api/wc_checkoutcom_flow_process?order_id=" + orderId + "&key=" + orderKey;
+ ckoLogger.debug('Order-pay - using PHP endpoint with order_id and key for direct redirect to success page');
+ } else {
+ ckoLogger.error('❌ ERROR: Could not extract order ID or key from order-pay URL');
+ // Fallback to PHP endpoint without order_id (will try to find order by payment session ID)
+ paymentSessionRequest.success_url = window.location.origin + "/wc-api/wc_checkoutcom_flow_process";
+ paymentSessionRequest.failure_url = window.location.origin + "/wc-api/wc_checkoutcom_flow_process";
+ ckoLogger.debug('Order-pay fallback - using PHP endpoint without order_id');
+ }
+ } else {
+ // For regular checkout, redirect directly to PHP endpoint which processes payment and redirects to success page
+ paymentSessionRequest.success_url = window.location.origin + "/wc-api/wc_checkoutcom_flow_process";
+ paymentSessionRequest.failure_url = window.location.origin + "/wc-api/wc_checkoutcom_flow_process";
+ ckoLogger.debug('Regular checkout - using PHP endpoint for direct redirect to success page');
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ }
+
+ // Add enabled_payment_methods if specified by merchant
+ // Only send if array has items (empty array means show all methods)
+ // For MOTO orders, hardcode to only show card payment method
+ if (isMotoOrder) {
+ ckoLogger.debug('MOTO order detected - hardcoding to show only card payment method');
+ paymentSessionRequest.enabled_payment_methods = ['card'];
+ ckoLogger.debug('MOTO: Set enabled_payment_methods to:', paymentSessionRequest.enabled_payment_methods);
+ } else if (cko_flow_vars.enabled_payment_methods &&
+ Array.isArray(cko_flow_vars.enabled_payment_methods) &&
+ cko_flow_vars.enabled_payment_methods.length > 0) {
+ paymentSessionRequest.enabled_payment_methods = cko_flow_vars.enabled_payment_methods;
+ ckoLogger.debug('Regular: Enabled payment methods (sent to API):', cko_flow_vars.enabled_payment_methods);
+ } else {
+ ckoLogger.debug('No payment methods filter - all available methods will be shown');
+ ckoLogger.debug('cko_flow_vars.enabled_payment_methods:', cko_flow_vars.enabled_payment_methods);
+ }
+
+<<<<<<< HEAD
+ // Update save card value right before sending request to ensure latest checkbox state
+ // Check multiple sources: checkbox state, sessionStorage, hidden field
+ const currentSaveCardCheckbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ const checkboxFound = !!currentSaveCardCheckbox;
+ const checkboxChecked = currentSaveCardCheckbox ? currentSaveCardCheckbox.checked : false;
+
+ // Also check sessionStorage and hidden field as fallbacks
+ const sessionStorageValue = sessionStorage.getItem('cko_flow_save_card');
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ const hiddenFieldValue = hiddenField ? hiddenField.value : '';
+
+ // Determine final value: checkbox > sessionStorage > hidden field > 'no'
+ let currentSaveCardValue = 'no';
+ if (checkboxChecked) {
+ currentSaveCardValue = 'yes';
+ } else if (sessionStorageValue === 'yes') {
+ currentSaveCardValue = 'yes';
+ } else if (hiddenFieldValue === 'yes') {
+ currentSaveCardValue = 'yes';
+ }
+
+ ckoLogger.debug('[SAVE CARD DEBUG] Reading checkbox before API call:', {
+ checkboxId: 'wc-wc_checkout_com_flow-new-payment-method',
+ checkboxFound: checkboxFound,
+ checkboxChecked: checkboxChecked,
+ sessionStorageValue: sessionStorageValue,
+ hiddenFieldValue: hiddenFieldValue,
+ finalSaveCardValue: currentSaveCardValue,
+ checkboxElement: currentSaveCardCheckbox ? 'found' : 'NOT FOUND'
+ });
+
+ // Update success_url and failure_url with current checkbox value
+ const currentIsOrderPayPage = window.location.pathname.includes('/order-pay/');
+ if (currentIsOrderPayPage) {
+ const orderId = window.location.pathname.match(/\/order-pay\/(\d+)\//)?.[1];
+ const orderKey = new URLSearchParams(window.location.search).get('key');
+ if (orderId && orderKey) {
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&order_id=" + orderId + "&key=" + orderKey + "&cko-save-card=" + currentSaveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&order_id=" + orderId + "&key=" + orderKey + "&cko-save-card=" + currentSaveCardValue;
+ } else {
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + currentSaveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + currentSaveCardValue;
+ }
+ } else {
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + currentSaveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + currentSaveCardValue;
+ }
+
+ ckoLogger.debug('[SAVE CARD DEBUG] Final URLs set:', {
+ success_url: paymentSessionRequest.success_url,
+ failure_url: paymentSessionRequest.failure_url,
+ containsSaveCardYes: paymentSessionRequest.success_url.includes('cko-save-card=yes')
+ });
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ ckoLogger.debug('Complete Payment Session Request:', paymentSessionRequest);
+
+ // SECURITY: Use secure backend AJAX endpoint instead of exposing secret key to frontend
+ const formData = new FormData();
+ formData.append('action', 'cko_flow_create_payment_session');
+ formData.append('nonce', cko_flow_vars.payment_session_nonce);
+<<<<<<< HEAD
+ // CRITICAL: Final validation before API call - prevent invalid email from being sent
+ // Validate email format inline (don't rely on function that might not be available)
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ if (!paymentSessionRequest.customer.email || !emailRegex.test(paymentSessionRequest.customer.email.trim())) {
+ ckoLogger.error('❌ BLOCKED: Invalid email before API call', {
+ email: paymentSessionRequest.customer.email,
+ emailType: typeof paymentSessionRequest.customer.email,
+ emailLength: paymentSessionRequest.customer.email?.length
+ });
+ hideLoadingOverlay();
+ showError('Please enter a valid email address to continue with payment.');
+ return; // Exit - don't call API
+ }
+
+ // Trim email to remove any whitespace
+ paymentSessionRequest.customer.email = paymentSessionRequest.customer.email.trim();
+
+ ckoLogger.debug('✅ Email validated before API call', { email: paymentSessionRequest.customer.email });
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ formData.append('payment_session_request', JSON.stringify(paymentSessionRequest));
+
+ let response = await fetch(cko_flow_vars.ajax_url, {
+ method: "POST",
+ body: formData,
+ });
+
+ let responseData = await response.json();
+
+ // Declare paymentSession variable
+ let paymentSession;
+
+ // Check if AJAX response indicates success
+ if (!responseData.success) {
+ // Handle error response - format as API error response
+ paymentSession = {
+ error_type: responseData.data?.error_type || 'ajax_error',
+ error_codes: responseData.data?.error_codes || [responseData.data?.message || 'Unknown error'],
+ request_id: responseData.data?.request_id || null
+ };
+
+ // Create a mock response object with ok: false to trigger error handling below
+ response = {
+ ok: false,
+ status: response.status || 500
+ };
+ } else {
+ // Success - extract payment session from response
+ paymentSession = responseData.data;
+ // Ensure response.ok is true for success case
+ response = {
+ ok: true,
+ status: 200
+ };
+ }
+
+ // Validate payment session response
+ if (!paymentSession.payment_session_token) {
+ ckoLogger.warn('Payment session token not found in response');
+ }
+
+ // Check for API errors (422, 400, etc.)
+ if (!response.ok || paymentSession.error_type || paymentSession.error_codes) {
+ ckoLogger.error('Payment Session API Error:', {
+ status: response.status,
+ statusText: response.statusText,
+ error_type: paymentSession.error_type,
+ error_codes: paymentSession.error_codes,
+ request_id: paymentSession.request_id,
+ response: paymentSession
+ });
+
+ // Hide loading overlay and skeleton
+ hideLoadingOverlay();
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+
+ if (skeleton) {
+ skeleton.classList.remove("show");
+ }
+ if (placeOrderBtn) {
+ placeOrderBtn.classList.remove("flow-loading");
+ }
+
+ // Show user-friendly error message
+ let errorMessage = 'Error creating payment session. Please try again.';
+ if (paymentSession.error_codes && paymentSession.error_codes.length > 0) {
+ errorMessage = 'Payment session error: ' + paymentSession.error_codes.join(', ');
+ }
+
+ showError(errorMessage);
+ return;
+ }
+
+ // Performance: Track API request completion
+ const apiRequestEnd = performance.now();
+ const apiDuration = apiRequestEnd - apiRequestStart;
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance(`Payment session API completed in ${apiDuration.toFixed(2)}ms (${(apiDuration / 1000).toFixed(2)}s)`);
+ }
+
+ // Debug: Log payment session response
+ ckoLogger.payment('Payment Session Response:', paymentSession);
+
+ // Store payment session ID globally for access in callbacks
+ window.currentPaymentSessionId = paymentSession.id;
+<<<<<<< HEAD
+
+ // CRITICAL: Add payment session ID as hidden field to form for process_payment()
+ // This ensures payment session ID is available in POST data when form is submitted
+ // Function to add hidden field (can be called multiple times as fallback)
+ const addPaymentSessionIdField = () => {
+ if (!window.currentPaymentSessionId) {
+ return false;
+ }
+
+ // Remove existing hidden field if it exists
+ const existingField = document.getElementById('cko-flow-payment-session-id');
+ if (existingField) {
+ existingField.remove();
+ }
+
+ // Create hidden input field for payment session ID
+ const hiddenField = document.createElement('input');
+ hiddenField.type = 'hidden';
+ hiddenField.id = 'cko-flow-payment-session-id';
+ hiddenField.name = 'cko-flow-payment-session-id';
+ hiddenField.value = window.currentPaymentSessionId;
+
+ // Add to checkout form (or order-pay form)
+ const checkoutForm = document.querySelector('form.checkout');
+ const orderPayForm = document.querySelector('form#order_review');
+ const targetForm = checkoutForm || orderPayForm;
+
+ if (targetForm) {
+ targetForm.appendChild(hiddenField);
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Added hidden field to form:', {
+ form: checkoutForm ? 'checkout' : 'order-pay',
+ payment_session_id: window.currentPaymentSessionId
+ });
+ return true;
+ } else {
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Form not found yet - will retry on form submission');
+ return false;
+ }
+ };
+
+ // Try to add immediately
+ if (paymentSession.id) {
+ addPaymentSessionIdField();
+
+ // Also expose function globally so it can be called as fallback
+ window.ckoAddPaymentSessionIdField = addPaymentSessionIdField;
+ }
+
+ // PERFORMANCE: Save payment session ID to order immediately (asynchronously, non-blocking)
+ // This ensures order is linked to payment session even if user cancels after 3DS
+ // Get order ID from cartInfo (available earlier in function) or from URL (for order-pay pages)
+ let orderIdToSave = cartInfo["order_id"];
+ if (!orderIdToSave && window.location.pathname.includes('/order-pay/')) {
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ orderIdToSave = pathMatch ? pathMatch[1] : null;
+ }
+
+ // Save payment session ID asynchronously (fire and forget - don't wait for response)
+ // NOTE: This only works for order-pay pages where order already exists
+ // For regular checkout, payment session ID is saved via hidden field in process_payment()
+ if (paymentSession.id && orderIdToSave && cko_flow_vars && cko_flow_vars.ajax_url && cko_flow_vars.payment_session_nonce) {
+ const saveFormData = new FormData();
+ saveFormData.append('action', 'cko_flow_save_payment_session_id');
+ saveFormData.append('nonce', cko_flow_vars.payment_session_nonce);
+ saveFormData.append('order_id', orderIdToSave);
+ saveFormData.append('payment_session_id', paymentSession.id);
+
+ // Fire and forget - don't wait for response (non-blocking)
+ fetch(cko_flow_vars.ajax_url, {
+ method: 'POST',
+ body: saveFormData
+ }).then(response => {
+ if (response.ok) {
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Successfully saved payment session ID to order:', {
+ order_id: orderIdToSave,
+ payment_session_id: paymentSession.id
+ });
+ } else {
+ ckoLogger.warn('[SAVE PAYMENT SESSION ID] Failed to save payment session ID (non-critical):', {
+ order_id: orderIdToSave,
+ payment_session_id: paymentSession.id,
+ status: response.status
+ });
+ }
+ }).catch(err => {
+ // Log error but don't block flow (fallback exists in handle_3ds_return)
+ ckoLogger.warn('[SAVE PAYMENT SESSION ID] Error saving payment session ID (non-critical, fallback exists):', err);
+ });
+
+ // Continue immediately - don't wait for AJAX response
+ } else {
+ if (ckoLogger.debug) {
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Skipping AJAX save - missing order ID (normal for regular checkout):', {
+ has_payment_session_id: !!paymentSession.id,
+ has_order_id: !!orderIdToSave,
+ has_ajax_url: !!(cko_flow_vars && cko_flow_vars.ajax_url),
+ has_nonce: !!(cko_flow_vars && cko_flow_vars.payment_session_nonce),
+ note: 'Payment session ID will be saved via hidden field in process_payment()'
+ });
+ }
+ }
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+
+ /*
+ * Handle API Session errors returned from Checkout.com.
+ */
+ if (paymentSession.error_type) {
+ // Hide loading overlay.
+ hideLoadingOverlay();
+
+ // Check for 3DS specific errors
+ if (paymentSession.error_codes && paymentSession.error_codes.includes('three_ds_invalid')) {
+ ckoLogger.error('3DS Configuration Error:', paymentSession);
+ showError('3DS configuration error. Please check your 3DS settings in the admin panel.');
+ return;
+ }
+
+ const readableErrors = {
+ customer_email_invalid: wp.i18n.__(
+ "Please enter the email to proceed.",
+ "checkout-com-unified-payments-api"
+ ),
+ billing_phone_number_invalid: wp.i18n.__(
+ "Please enter the phone number to proceed.",
+ "checkout-com-unified-payments-api"
+ ),
+ };
+
+ let messages = (paymentSession.error_codes || []).map(
+ (code) => readableErrors[code] || code
+ );
+ showError(messages[0]);
+ return;
+ }
+
+ /*
+ * Successfully received a payment session.
+ * Load Checkout.com Web Component.
+ */
+ if (paymentSession.id) {
+ // Performance: Track component initialization start
+ const componentInitStart = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance('Initializing Checkout Web Component...');
+ }
+
+ // Debug: Log Flow component configuration
+ ckoLogger.debug('Flow Component Configuration:', {
+ publicKey: cko_flow_vars.PKey ? 'SET' : 'NOT SET',
+ publicKeyPreview: cko_flow_vars.PKey ? cko_flow_vars.PKey.substring(0, 10) + '...' : 'NOT SET',
+ environment: cko_flow_vars.env,
+ locale: window.locale,
+ paymentSessionId: paymentSession.id,
+ paymentSessionSecret: paymentSession.payment_session_secret ? 'SET' : 'NOT SET',
+ appearance: window.appearance ? 'SET' : 'NOT SET',
+ componentOptions: window.componentOptions ? 'SET' : 'NOT SET',
+ translations: window.translations ? 'SET' : 'NOT SET'
+ });
+
+ // Additional validation
+ if (!cko_flow_vars.PKey) {
+ ckoLogger.error('CRITICAL: Public key is missing!');
+ showError('Payment gateway configuration error. Please contact support.');
+ return;
+ }
+
+ if (!paymentSession.id) {
+ ckoLogger.error('CRITICAL: Payment session ID is missing!');
+ showError('Payment session error. Please try again.');
+ return;
+ }
+
+ // Define callback functions BEFORE passing them to CheckoutWebComponents
+ const onReady = () => {
+ try {
+ ckoLogger.debug('onReady callback fired! 🔥🔥🔥');
+ hideLoadingOverlay();
+
+ // Performance tracking: Mark when Flow is ready
+ ckoFlow.performanceMetrics.flowReadyTime = performance.now();
+
+ const pageLoadToReady = ckoFlow.performanceMetrics.flowReadyTime - ckoFlow.performanceMetrics.pageLoadTime;
+ const initToReady = ckoFlow.performanceMetrics.flowReadyTime - ckoFlow.performanceMetrics.flowInitStartTime;
+
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance('===== Flow Load Complete =====');
+ ckoLogger.performance(`Page Load → Flow Ready: ${pageLoadToReady.toFixed(2)}ms (${(pageLoadToReady / 1000).toFixed(2)}s)`);
+ ckoLogger.performance(`Flow Init → Flow Ready: ${initToReady.toFixed(2)}ms (${(initToReady / 1000).toFixed(2)}s)`);
+ ckoLogger.performance('================================');
+ }
+
+ // ============================================================
+ // SMOOTH CHECKOUT EXPERIENCE - onReady Handler
+ // ============================================================
+
+ const displayOrder = window.saved_payment || 'new_payment_first';
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+ const saveCardCheckbox = document.querySelector('.cko-save-card-checkbox');
+
+ ckoLogger.debug('onReady - Display order:', displayOrder);
+ ckoLogger.debug('onReady - Flow is fully loaded and ready');
+
+ // Step 1: Hide skeleton loader with smooth transition
+ ckoLogger.debug('onReady - Skeleton element found:', !!skeleton);
+ if (skeleton) {
+ ckoLogger.debug('onReady - Skeleton classes BEFORE:', skeleton.className);
+ skeleton.classList.remove("show");
+ ckoLogger.debug('onReady - Skeleton classes AFTER:', skeleton.className);
+ ckoLogger.debug('onReady - ✓ Skeleton loader hidden');
+ } else {
+ ckoLogger.debug('onReady - ❌ Skeleton element NOT FOUND');
+ }
+
+ // Step 2: Enable Place Order button (remove loading state)
+ ckoLogger.debug('onReady - Place Order button found:', !!placeOrderBtn);
+ if (placeOrderBtn) {
+ ckoLogger.debug('onReady - Button classes BEFORE:', placeOrderBtn.className);
+ placeOrderBtn.classList.remove("flow-loading");
+ ckoLogger.debug('onReady - Button classes AFTER:', placeOrderBtn.className);
+ placeOrderBtn.style.removeProperty('opacity');
+ placeOrderBtn.style.removeProperty('visibility');
+ ckoLogger.debug('onReady - ✓ Place Order button enabled');
+ } else {
+ ckoLogger.debug('onReady - ❌ Place Order button NOT FOUND');
+ }
+
+ // Step 3: Hide save card checkbox initially (onChange will show it for card payment type)
+ if (saveCardCheckbox) {
+ saveCardCheckbox.style.display = 'none';
+ ckoLogger.debug('onReady - ✓ Save card checkbox hidden (will show on card selection)');
+ } else {
+ ckoLogger.debug('onReady - Save card checkbox not available (feature disabled)');
+ }
+
+ // Step 4: Mark Flow as ready - triggers CSS animations and visibility rules
+ document.body.classList.add("flow-ready");
+ ckoLogger.debug('onReady - ✓ Flow marked as ready - Checkout is now fully interactive');
+
+
+<<<<<<< HEAD
+ // Step 5: Ensure no saved card is selected by default - user must explicitly select
+ // Remove any default selections to prevent issues with auto-detection
+ const anyDefaultCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"][checked="checked"]:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ if (anyDefaultCard.length > 0) {
+ ckoLogger.debug('onReady - Removing default saved card selection - user must explicitly select');
+ anyDefaultCard.prop('checked', false).removeAttr('checked');
+ // Ensure "new" card option is selected by default
+ const newCardRadio = jQuery('#wc-wc_checkout_com_flow-payment-token-new');
+ if (newCardRadio.length) {
+ newCardRadio.prop('checked', true);
+ ckoLogger.debug('onReady - ✓ "New card" option selected by default');
+ }
+ window.flowSavedCardSelected = false;
+ window.flowUserInteracted = false;
+=======
+ // Step 5: Restore saved card selection if in saved_cards_first mode
+ if (displayOrder === 'saved_cards_first') {
+ ckoLogger.debug('onReady - saved_cards_first mode: checking for default saved card');
+
+ // Find default card (has checked="checked" attribute or is marked as default)
+ const defaultCardRadio = jQuery('.saved-cards-accordion-panel input[name="wc-wc_checkout_com_flow-payment-token"][checked="checked"]:not(#wc-wc_checkout_com_flow-payment-token-new)').first();
+
+ if (defaultCardRadio.length) {
+ // Re-select the default card (in case Flow init deselected it)
+ defaultCardRadio.prop('checked', true);
+ window.flowSavedCardSelected = true;
+ window.flowUserInteracted = false;
+ ckoLogger.debug('onReady - ✓ Default saved card re-selected after Flow load');
+ ckoLogger.debug('onReady - Selected card ID:', defaultCardRadio.attr('id'));
+ } else {
+ ckoLogger.debug('onReady - No default saved card found');
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ }
+
+ // Note: Save card checkbox visibility is controlled by the onChange event
+ // It will only show when payment type is "card" and hide for other payment methods
+ } catch (error) {
+ ckoLogger.error('onReady ERROR:', error);
+ ckoLogger.error('Error stack:', error.stack);
+ }
+ };
+
+ /*
+ * Called when the payment is completed successfully.
+ */
+ const onPaymentCompleted = (_component, paymentResponse) => {
+
+ // Check if this is a 3DS authentication response
+ if (paymentResponse.threeDs && paymentResponse.threeDs.challenged) {
+ // 3DS challenge detected - user will be redirected to 3DS page
+ return;
+ }
+
+ if (paymentResponse.id) {
+ hideLoadingOverlay(2);
+
+ // Set the hidden input values.
+ jQuery("#cko-flow-payment-id").val(paymentResponse.id);
+ jQuery("#cko-flow-payment-type").val(paymentResponse?.type || "");
+
+ if ( ! orderId ) {
+ // Trigger WooCommerce order placement on checkout page.
+ jQuery("form.checkout").submit();
+ } else {
+ // For order-pay pages, use native DOM submit to bypass event handlers
+ ckoLogger.threeDS('Submitting order-pay form using native submit after payment completion');
+ const orderPayForm = document.querySelector('form#order_review');
+ if (orderPayForm) {
+ orderPayForm.submit();
+ } else {
+ ckoLogger.error('ERROR: form#order_review not found!');
+ }
+ }
+ }
+ };
+
+ /*
+ * Triggered when user submits the payment using Place Order Button of Woocommerce.
+ */
+ const onSubmit = async (component) => {
+ showLoadingOverlay(2);
+ return { continue: true };
+ };
+
+ /*
+ * Triggered on component state change.
+ */
+ const onChange = (component) => {
+ hideLoadingOverlay();
+
+ // Initialize tracking variables if not exists
+ if (!window.onChangeTracking) {
+ window.onChangeTracking = {
+ lastState: {},
+ lastProcessedTime: 0,
+ processingCount: 0
+ };
+ }
+
+ const now = Date.now();
+ const currentState = {
+ selectedType: component.selectedType,
+ componentType: component.type,
+ isValid: component.isValid ? component.isValid() : false
+ };
+
+ // Check if state has actually changed
+ const stateChanged = (
+ window.onChangeTracking.lastState.selectedType !== currentState.selectedType ||
+ window.onChangeTracking.lastState.componentType !== currentState.componentType ||
+ window.onChangeTracking.lastState.isValid !== currentState.isValid
+ );
+
+ // Rate limiting: don't process more than once every 50ms
+ const timeSinceLastProcess = now - window.onChangeTracking.lastProcessedTime;
+ const shouldRateLimit = timeSinceLastProcess < 50;
+
+ // Only process if state actually changed AND enough time has passed
+ if (!stateChanged || shouldRateLimit) {
+ window.onChangeTracking.processingCount++;
+ if (window.onChangeTracking.processingCount % 10 === 0) {
+ ckoLogger.debug(`onChange - Skipped ${window.onChangeTracking.processingCount} duplicate events`);
+ }
+ return;
+ }
+
+ // Update tracking
+ window.onChangeTracking.lastState = { ...currentState };
+ window.onChangeTracking.lastProcessedTime = now;
+ window.onChangeTracking.processingCount = 0;
+
+ ckoLogger.debug('===== onChange START =====');
+ ckoLogger.debug('onChange - Selected Type:', component.selectedType);
+ ckoLogger.debug('onChange - Component Type:', component.type);
+ ckoLogger.debug('onChange - Component valid:', component.isValid ? component.isValid() : 'unknown');
+ ckoLogger.debug('onChange - User interacted flag:', window.flowUserInteracted);
+ ckoLogger.debug('onChange - Body has flow-ready class:', document.body.classList.contains('flow-ready'));
+
+ // CRITICAL: Auto-deselect saved card when user interacts with Flow
+ // Check if a saved card is currently selected and Flow is de-emphasized
+ const flowContainer = document.getElementById("flow-container");
+ const anySavedCardSelected = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked').filter(function() {
+ return jQuery(this).attr('id') !== 'wc-wc_checkout_com_flow-payment-token-new';
+ }).length > 0;
+
+ if (anySavedCardSelected && flowContainer) {
+ ckoLogger.debug('onChange - User typing in Flow while saved card selected - auto-activating Flow');
+ // Call the activation function
+ if (typeof window.activateFlowPayment === 'function') {
+ window.activateFlowPayment();
+ } else {
+ // Fallback if function not available yet
+ jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked').prop('checked', false);
+ window.flowSavedCardSelected = false;
+ ckoLogger.debug('onChange - Deselected saved card and activated Flow (fallback)');
+ }
+ }
+
+ // Note: We don't set flowUserInteracted here anymore because onChange
+ // fires on initial load. Instead, we use click/focus/input listeners
+ // to detect actual user interaction with Flow fields.
+
+ const hiddenTypes = [
+ "applepay",
+ "googlepay",
+ "octopus",
+ "paypal",
+ "twint",
+ "venmo",
+ "wechatpay"
+ ];
+
+ const placeOrderButton = document.querySelector("#place_order");
+
+ // Hide place order button on digital wallets.
+ if (hiddenTypes.includes(component.selectedType)) {
+ if (placeOrderButton) placeOrderButton.style.display = "none";
+ ckoLogger.debug('onChange - Hiding Place Order button');
+ } else {
+ if (placeOrderButton) placeOrderButton.style.display = "block";
+ ckoLogger.debug('onChange - Showing Place Order button');
+ }
+
+ ckoLogger.debug('===== onChange END =====');
+
+ // Pre-validate for apple pay.
+ if ( component.selectedType === "applepay" ) {
+ const applePayButton = document.querySelector('button[aria-label="Apple Pay"]');
+ applePayButton.disabled = true;
+
+ const form = jQuery("form.checkout");
+
+ if ( ! orderId ) {
+ validateCheckout(form, function (response) {
+ applePayButton.disabled = false;
+ });
+ }
+ }
+
+ // Control Save to Account checkbox visibility based on payment type
+ const saveCardCheckbox = jQuery('.cko-save-card-checkbox');
+ if ( saveCardCheckbox.length > 0 ) {
+ if ( component.selectedType === "card" ) {
+ saveCardCheckbox.addClass('wc-cko-flow-card-on');
+ saveCardCheckbox.css('display', 'block'); // Use .css() to set inline style
+ saveCardCheckbox.show();
+<<<<<<< HEAD
+ // Also show the inner ").html(value));
+ });
+ }
+
+ let wcNoticeDiv = jQuery("
Processing your payment...
+ Meta Key:
+
+
+
+
+
+
+
+
+
+
+
+
+ div {
+ display: block !important;
+ visibility: visible !important;
+ opacity: 1 !important;
+}
+
+/* When saved cards exist, style Flow container as a simple bordered block */
+.saved-cards-accordion-container ~ * #flow-container,
+.payment_method_wc_checkout_com_flow:has(.saved-cards-accordion-container) #flow-container {
+ background: #ffffff;
+ border: 1px solid #186aff;
+ border-radius: 8px;
+ padding: 20px;
+ margin: 20px 0;
+}
+
+#flow-container.loading {
+ opacity: 0.6;
+ pointer-events: none;
+}
+
+/* Skeleton loader for Flow component */
+.flow-skeleton-loader {
+ display: none;
+ padding: 0;
+ background: transparent;
+ border-radius: 0;
+ margin: 0;
+ opacity: 0;
+ transition: opacity 0.3s ease-out;
+}
+
+.flow-skeleton-loader.show {
+ display: block;
+ opacity: 1;
+}
+
+.flow-skeleton-line {
+ height: 40px;
+ background: linear-gradient(90deg, #e0e0e0 25%, #f0f0f0 50%, #e0e0e0 75%);
+ background-size: 200% 100%;
+ border-radius: 4px;
+ margin-bottom: 15px;
+ animation: shimmer 1.5s infinite;
+}
+
+.flow-skeleton-line:last-child {
+ margin-bottom: 0;
+}
+
+.flow-skeleton-line.short {
+ width: 60%;
+}
+
+@keyframes shimmer {
+ 0% {
+ background-position: 200% 0;
+ }
+ 100% {
+ background-position: -200% 0;
+ }
+}
+
+@keyframes pulse {
+ 0%, 100% {
+ opacity: 1;
+ }
+ 50% {
+ opacity: 0.8;
+ }
+}
+
+/* CRITICAL: For single Flow payment method pages, hide button immediately via CSS
+ This prevents the flash before JavaScript executes */
+body.flow-method-single #place_order {
+ opacity: 0;
+ visibility: hidden;
+ transition: opacity 0.2s ease, visibility 0.2s ease;
+}
+
+/* Show button when Flow is ready (single payment method) */
+body.flow-method-single.flow-ready #place_order {
+ opacity: 1;
+ visibility: visible;
+}
+
+/* Hide button when Flow is selected from multiple payment methods */
+body.flow-method-selected:not(.flow-method-single) #place_order {
+ opacity: 0;
+ visibility: hidden;
+ transition: opacity 0.2s ease, visibility 0.2s ease;
+}
+
+/* Show button when Flow is ready (multiple payment methods) */
+body.flow-method-selected.flow-ready #place_order {
+ opacity: 1;
+ visibility: visible;
+}
+
+/* Save to Account checkbox - initially hidden, shown by JS when card payment type is selected */
+.cko-save-card-checkbox {
+ display: none;
+ transition: opacity 0.2s ease;
+}
+
+/* When card payment is selected, the checkbox will be shown by JS with display: block */
+.cko-save-card-checkbox.wc-cko-flow-card-on {
+ /* Additional styling when card is selected */
+ opacity: 1;
+}
+
+/* Hide place order button when Flow is loading */
+#place_order.flow-loading {
+ opacity: 0.5;
+ pointer-events: none;
+ position: relative;
+}
+
+#place_order.flow-loading::after {
+ content: '';
+ position: absolute;
+ top: 50%;
+ right: 15px;
+ width: 16px;
+ height: 16px;
+ margin-top: -8px;
+ border: 2px solid #ffffff;
+ border-radius: 50%;
+ border-top-color: transparent;
+ animation: spin 0.8s linear infinite;
+}
+
+@keyframes spin {
+ to {
+ transform: rotate(360deg);
+ }
+}
+
+/* Smooth fade-in for Flow component */
+#flow-container > div {
+ animation: fadeIn 0.3s ease-in;
+}
+
+@keyframes fadeIn {
+ from {
+ opacity: 0;
+ transform: translateY(10px);
+ }
+ to {
+ opacity: 1;
+ transform: translateY(0);
+ }
+}
+
+.button-container {
+ display: flex;
+ height: 100%;
+}
+
+.wp-style-button {
+ border: none;
+ padding: 10px 3px;
+ margin: 8px;
+ cursor: pointer;
+ transition: 0.2s ease-in-out;
+}
+
+#flow-container .woocommerce-SavedPaymentMethods {
+ margin-left: 1.5em !important;
+}
+
+#flow-container .cko-save-card-checkbox {
+ margin-left: 0.7em !important;
+}
+
+#flow-container .cko-save-card-checkbox label[for="wc-wc_checkout_com_flow-new-payment-method"] {
+ margin-left: 0.1em !important;
+}
+
+#flow-container ul.woocommerce-SavedPaymentMethods:nth-of-type(1) li.woocommerce-SavedPaymentMethods-new {
+ display: none !important;
+}
+
+#flow-container ul.woocommerce-SavedPaymentMethods:nth-of-type(2) {
+ padding-top: 0 !important;
+}
+
+/* Flow Accordion Style */
+.flow-accordion-container {
+ margin: 20px 0;
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+}
+
+.flow-accordion {
+ background: #ffffff;
+ border: 1px solid #186aff;
+ border-radius: 8px;
+ overflow: hidden;
+}
+
+.flow-accordion-header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 16px 20px;
+ background: #ffffff;
+ cursor: default;
+}
+
+.flow-accordion-left {
+ display: flex;
+ align-items: center;
+ gap: 12px;
+ flex: 1;
+}
+
+.flow-icon {
+ width: 40px;
+ height: 24px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+}
+
+.flow-icon svg {
+ width: 40px;
+ height: 24px;
+}
+
+.flow-label {
+ display: flex;
+ flex-direction: column;
+ gap: 2px;
+}
+
+.flow-label-text {
+ font-size: 14px;
+ font-weight: 500;
+ color: #27292d;
+ line-height: 1.4;
+}
+
+.flow-label-subtext {
+ font-size: 12px;
+ color: #68686c;
+ line-height: 1.3;
+}
+
+.flow-accordion-panel {
+ padding: 0 20px 16px 20px;
+ animation: flowFadeIn 0.3s ease-in;
+}
+
+@keyframes flowFadeIn {
+ from {
+ opacity: 0;
+ transform: translateY(-10px);
+ }
+ to {
+ opacity: 1;
+ transform: translateY(0);
+ }
+}
+
+/* Style the main payment method label - Customizable via CSS Variables */
+/* Defaults match standard WooCommerce appearance: transparent background, no border, icon on right */
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] {
+ display: flex !important;
+ align-items: center;
+ justify-content: space-between; /* For icon on right */
+ padding: var(--cko-payment-label-padding, 8px 12px); /* Standard WooCommerce padding */
+ background: var(--cko-payment-label-bg, transparent); /* Default: transparent (matches standard) */
+ border: var(--cko-payment-label-border-width, 0px) solid var(--cko-payment-label-border-color, transparent); /* Default: no border */
+ border-radius: var(--cko-payment-label-border-radius, 0px); /* Default: no rounding (matches standard) */
+ margin: 0 0 12px 0;
+ font-family: inherit; /* Inherit from theme (matches standard) */
+ cursor: pointer;
+ transition: all 0.2s ease;
+ text-align: var(--cko-payment-label-text-align, left); /* Default: left (matches standard WooCommerce) */
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"]:hover {
+ border-color: var(--cko-payment-label-border-color-hover, var(--cko-payment-label-border-color, transparent));
+ box-shadow: var(--cko-payment-label-box-shadow-hover, none);
+}
+
+/* Payment method icon/image - LEFT side (hidden by default, shown if icon_position = 'left') */
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"]::before {
+ content: '';
+ display: var(--cko-payment-label-icon-display-left, none); /* Default: hidden (icon on right) */
+ width: 40px;
+ height: 24px;
+ margin-right: 12px;
+ background-image: url('data:image/svg+xml;utf8,');
+ background-size: contain;
+ background-repeat: no-repeat;
+ background-position: center;
+ flex-shrink: 0;
+ order: var(--cko-payment-label-icon-order-left, 0);
+}
+
+/* Payment method icon/image - RIGHT side (shown by default, matches standard WooCommerce) */
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"]::after {
+ content: '';
+ display: var(--cko-payment-label-icon-display-right, inline-block); /* Default: shown (icon on right) */
+ width: 40px;
+ height: 24px;
+ margin-left: 12px;
+ background-image: url('data:image/svg+xml;utf8,');
+ background-size: contain;
+ background-repeat: no-repeat;
+ background-position: center;
+ flex-shrink: 0;
+ order: var(--cko-payment-label-icon-order-right, 2); /* Right side */
+}
+
+/* Custom image support - add this class to use custom image */
+.payment_method_wc_checkout_com_flow.has-custom-icon > label[for="payment_method_wc_checkout_com_flow"]::before,
+.payment_method_wc_checkout_com_flow.has-custom-icon > label[for="payment_method_wc_checkout_com_flow"]::after {
+ background-image: var(--checkout-payment-icon);
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] .payment-method-text {
+ display: flex;
+ flex-direction: column;
+ flex: 1;
+ order: 1; /* Text always on left */
+ text-align: var(--cko-payment-label-text-align, left); /* Default: left (matches standard WooCommerce) */
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] .payment-method-title {
+ font-size: var(--cko-payment-label-title-font-size, inherit); /* Default: inherit from theme */
+ font-weight: var(--cko-payment-label-title-font-weight, inherit); /* Default: inherit from theme */
+ color: var(--cko-payment-label-text-color, inherit); /* Default: inherit from theme (matches standard) */
+ line-height: 1.4;
+ text-align: var(--cko-payment-label-text-align, left); /* Default: left (matches standard WooCommerce) */
+}
+
+.payment_method_wc_checkout_com_flow > label[for="payment_method_wc_checkout_com_flow"] .payment-method-subtitle {
+ font-size: var(--cko-payment-label-subtitle-font-size, 0.9em); /* Slightly smaller */
+ color: var(--cko-payment-label-subtitle-color, inherit); /* Default: inherit from theme (matches standard) */
+ margin-top: 2px;
+ line-height: 1.3;
+ opacity: var(--cko-payment-label-subtitle-opacity, 0.7); /* Subtle by default */
+ text-align: var(--cko-payment-label-text-align, left); /* Default: left (matches standard WooCommerce) */
+}
+
+/* Saved Cards Accordion Style - Matches Flow Style */
+.saved-cards-accordion-container {
+ margin: 20px 0;
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+ min-height: 50px !important;
+}
+
+body[data-saved-payment-order="saved_cards_first"] .saved-cards-accordion-container {
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+ min-height: 50px !important;
+}
+
+body[data-saved-payment-order="new_payment_first"] .saved-cards-accordion-container {
+ display: none !important;
+}
+
+body[data-saved-payment-order="new_payment_first"].flow-ready .saved-cards-accordion-container {
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+ min-height: 50px !important;
+}
+
+.saved-cards-accordion {
+ background: #ffffff;
+ border: 1px solid #186aff;
+ border-radius: 8px;
+ overflow: visible !important;
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+}
+
+.saved-cards-accordion-header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 12px 16px;
+ background: #ffffff;
+ cursor: pointer;
+}
+
+.saved-cards-accordion-left {
+ display: flex;
+ align-items: center;
+ gap: 12px;
+ flex: 1;
+}
+
+.saved-cards-icon {
+ width: 40px;
+ height: 24px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+}
+
+.saved-cards-icon svg {
+ width: 40px;
+ height: 24px;
+}
+
+.saved-cards-label {
+ display: flex;
+ flex-direction: column;
+ gap: 2px;
+}
+
+.saved-cards-label-text {
+ font-size: 14px;
+ font-weight: 500;
+ color: #27292d;
+ line-height: 1.4;
+}
+
+.saved-cards-label-subtext {
+ font-size: 12px;
+ color: #68686c;
+ line-height: 1.3;
+}
+
+.saved-cards-accordion-panel {
+ padding: 0 16px 12px 16px;
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods {
+ margin: 0 !important;
+ padding: 0 !important;
+ list-style: none !important;
+ background: transparent !important;
+ border: none !important;
+ display: block !important;
+ opacity: 1 !important;
+ visibility: visible !important;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods-new,
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li.woocommerce-SavedPaymentMethods-new,
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods-tokenBase,
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li.woocommerce-SavedPaymentMethods-tokenBase,
+.saved-cards-accordion-panel input[value="new"],
+.saved-cards-accordion-panel li:has(input[value="new"]) {
+ display: none !important;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li {
+ padding: 10px 12px;
+ margin: 6px 0 !important;
+ background: #ffffff;
+ border: 1px solid #e9ebeb;
+ border-radius: 4px;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li:hover {
+ border-color: #186aff;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li input[type="radio"] {
+ margin-right: 10px;
+ accent-color: #186aff;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li label {
+ display: inline-flex;
+ align-items: center;
+ cursor: pointer;
+ font-size: 14px;
+ color: #27292d;
+ margin: 0;
+ width: 100%;
+ font-weight: 400;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li label::before {
+ content: '';
+ display: inline-block;
+ width: 32px;
+ height: 20px;
+ margin-right: 10px;
+ background: url('data:image/svg+xml,') center/contain no-repeat;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li input[type="radio"]:checked + label {
+ font-weight: 500;
+ color: #186aff;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li input[type="radio"]:checked + label::before {
+ background: url('data:image/svg+xml,') center/contain no-repeat;
+}
+
+.saved-cards-accordion-panel .woocommerce-SavedPaymentMethods li:has(input[type="radio"]:checked) {
+ background: #f0f6ff;
+ border-color: #186aff;
+ border-width: 1px;
+}
diff --git a/checkout-com-unified-payments-api/flow-integration/assets/js/flow-container.js b/checkout-com-unified-payments-api/flow-integration/assets/js/flow-container.js
new file mode 100644
index 00000000..95c44aef
--- /dev/null
+++ b/checkout-com-unified-payments-api/flow-integration/assets/js/flow-container.js
@@ -0,0 +1,164 @@
+// ALWAYS VISIBLE - Critical for diagnosing Flow disappearing issue
+console.log('[FLOW CONTAINER] Script loaded');
+
+// Define addPaymentMethod outside any event listener so it's always available
+function addPaymentMethod() {
+ // ALWAYS VISIBLE - Critical for diagnosing Flow disappearing issue
+ console.log('[FLOW CONTAINER] addPaymentMethod() called');
+
+ const paymentContainer = document.querySelector(
+ ".payment_method_wc_checkout_com_flow"
+ );
+
+ console.log('[FLOW CONTAINER] addPaymentMethod() state:', {
+ paymentContainerExists: !!paymentContainer,
+ existingContainerId: document.getElementById('flow-container') ? 'EXISTS' : 'NOT FOUND'
+ });
+
+ if (paymentContainer) {
+ // Add flow-container to the PAYMENT_BOX div, not the accordion!
+ // Skip any accordion divs and find the actual payment_box
+ const innerDiv = paymentContainer.querySelector("div.payment_box");
+
+ console.log('[FLOW CONTAINER] addPaymentMethod() - payment_box div:', {
+ innerDivExists: !!innerDiv,
+ innerDivHasId: innerDiv ? !!innerDiv.id : false,
+ innerDivId: innerDiv ? innerDiv.id : 'N/A'
+ });
+
+ if (innerDiv && !innerDiv.id) {
+ innerDiv.id = "flow-container";
+ innerDiv.style.padding = "0";
+ console.log('[FLOW CONTAINER] ✅ Created flow-container id on payment_box div');
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('Set flow-container id on payment_box div');
+ }
+ } else if (innerDiv && innerDiv.id === 'flow-container') {
+ console.log('[FLOW CONTAINER] ✅ Container already exists with correct ID');
+ } else if (!innerDiv) {
+ console.log('[FLOW CONTAINER] ❌ ERROR: payment_box div not found inside payment method container');
+ console.log('[FLOW CONTAINER] Payment container HTML:', paymentContainer.innerHTML.substring(0, 200));
+ }
+
+ // IMPORTANT: Check for saved payment methods (not accordion, which is created later)
+ // The .woocommerce-SavedPaymentMethods elements exist in DOM immediately (PHP rendered)
+ const savedPaymentMethods = document.querySelectorAll('.woocommerce-SavedPaymentMethods.wc-saved-payment-methods');
+ let hasSavedCards = false;
+
+ savedPaymentMethods.forEach(function(el) {
+ const count = parseInt(el.getAttribute("data-count") || '0', 10);
+ if (count > 0) {
+ hasSavedCards = true;
+ }
+ });
+
+ if (hasSavedCards) {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('Skipping Flow accordion - saved cards exist (count > 0), using simple layout');
+ }
+ return; // Don't wrap in accordion when saved cards are present
+ }
+
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('No saved cards found, using default label (no accordion wrapper)');
+ }
+
+ // DISABLED: Don't wrap Flow in accordion when no saved cards
+ // Use the default WooCommerce payment method label instead
+ // This ensures "Payment FLOW Payment" label is always visible
+ } else {
+ console.log('[FLOW CONTAINER] ❌ Payment method container not found');
+ }
+}
+
+// Run addPaymentMethod immediately if DOM is ready, otherwise wait
+if (document.readyState === 'loading') {
+ document.addEventListener("DOMContentLoaded", function () {
+ console.log('[FLOW CONTAINER] DOMContentLoaded - calling addPaymentMethod()');
+ addPaymentMethod();
+ });
+} else {
+ console.log('[FLOW CONTAINER] DOM already loaded - calling addPaymentMethod() immediately');
+ addPaymentMethod();
+}
+
+// Attach updated_checkout handler immediately (doesn't need to wait for DOMContentLoaded)
+jQuery(document).on("updated_checkout", function () {
+ // ALWAYS VISIBLE - Critical for diagnosing Flow disappearing issue
+ console.log('[FLOW CONTAINER] updated_checkout event fired, re-checking...');
+
+ // CRITICAL: Wait for WooCommerce to finish updating DOM before checking
+ // WooCommerce replaces HTML asynchronously, so we need to wait
+ setTimeout(function() {
+ const flowContainer = document.getElementById('flow-container');
+ const flowComponentRoot = document.querySelector('[data-testid="checkout-web-component-root"]');
+ const paymentMethod = document.querySelector('.payment_method_wc_checkout_com_flow');
+
+ console.log('[FLOW CONTAINER] After updated_checkout (100ms):', {
+ flowContainerExists: !!flowContainer,
+ flowComponentRootExists: !!flowComponentRoot,
+ paymentMethodExists: !!paymentMethod
+ });
+
+ // CRITICAL FIX: Always call addPaymentMethod() if payment method exists but container doesn't
+ // This ensures the container is recreated after WooCommerce destroys it
+ if (paymentMethod && !flowContainer) {
+ console.log('[FLOW CONTAINER] Payment method exists but container missing - creating container');
+ addPaymentMethod();
+ } else if (flowContainer && (!flowComponentRoot || !flowContainer.querySelector('[data-testid="checkout-web-component-root"]'))) {
+ console.log('[FLOW CONTAINER] Flow component not mounted after DOM update, calling addPaymentMethod');
+ addPaymentMethod();
+ } else if (flowContainer && flowComponentRoot) {
+ console.log('[FLOW CONTAINER] Flow component is still mounted, skipping addPaymentMethod');
+ } else if (!paymentMethod) {
+ console.log('[FLOW CONTAINER] Payment method not found - Flow not selected');
+ } else {
+ console.log('[FLOW CONTAINER] Container not found yet, will retry...');
+ // Container might not be ready yet, retry after a short delay
+ setTimeout(function() {
+ const flowContainerRetry = document.getElementById('flow-container');
+ const paymentMethodRetry = document.querySelector('.payment_method_wc_checkout_com_flow');
+ console.log('[FLOW CONTAINER] Retry check (300ms total):', {
+ flowContainerExists: !!flowContainerRetry,
+ paymentMethodExists: !!paymentMethodRetry
+ });
+ if (paymentMethodRetry && !flowContainerRetry) {
+ console.log('[FLOW CONTAINER] Payment method found on retry but container missing - creating container');
+ addPaymentMethod();
+ } else if (flowContainerRetry && !document.querySelector('[data-testid="checkout-web-component-root"]')) {
+ console.log('[FLOW CONTAINER] Flow container found on retry, calling addPaymentMethod');
+ addPaymentMethod();
+ }
+ }, 200);
+ }
+ }, 100); // Wait 100ms for WooCommerce to finish updating DOM
+});
+
+// Additional check after a delay to catch late-rendered saved cards
+setTimeout(function() {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('Delayed check for saved cards...');
+ }
+
+ // If saved cards accordion was created after initial load, remove Flow accordion if it exists
+ const savedCardsAccordion = document.querySelector('.saved-cards-accordion-container');
+ const flowAccordion = document.querySelector('.flow-accordion-container');
+
+ if (savedCardsAccordion && flowAccordion) {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('REMOVING Flow accordion - saved cards were created after initial load');
+ }
+
+ // Move flow-container out of the accordion
+ const flowContainer = document.getElementById('flow-container');
+ if (flowContainer) {
+ // Insert flow-container before the flow accordion
+ flowAccordion.parentNode.insertBefore(flowContainer, flowAccordion);
+ // Remove the flow accordion wrapper
+ flowAccordion.remove();
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('Flow accordion removed, using simple layout');
+ }
+ }
+ }
+}, 1000);
diff --git a/checkout-com-unified-payments-api/flow-integration/assets/js/flow-customization.js b/checkout-com-unified-payments-api/flow-integration/assets/js/flow-customization.js
new file mode 100644
index 00000000..725a1fc6
--- /dev/null
+++ b/checkout-com-unified-payments-api/flow-integration/assets/js/flow-customization.js
@@ -0,0 +1,181 @@
+/**
+ * Appearance, Button, Footnote, Label, Border and Subheading settings setion.
+ */
+
+window.appearance = {
+ colorAction: cko_flow_customization_vars.flow_appearance_color_action,
+ colorBackground: cko_flow_customization_vars.flow_appearance_color_background,
+ colorBorder: cko_flow_customization_vars.flow_appearance_color_border,
+ colorDisabled: cko_flow_customization_vars.flow_appearance_color_disabled,
+ colorError: cko_flow_customization_vars.flow_appearance_color_error,
+ colorFormBackground:
+ cko_flow_customization_vars.flow_appearance_color_form_background,
+ colorFormBorder:
+ cko_flow_customization_vars.flow_appearance_color_form_border,
+ colorInverse: cko_flow_customization_vars.flow_appearance_color_inverse,
+ colorOutline: cko_flow_customization_vars.flow_appearance_color_outline,
+ colorPrimary: cko_flow_customization_vars.flow_appearance_color_primary,
+ colorSecondary: cko_flow_customization_vars.flow_appearance_color_secondary,
+ colorSuccess: cko_flow_customization_vars.flow_appearance_color_success,
+ button: {
+ fontFamily: cko_flow_customization_vars.flow_button_font_family,
+ fontSize: cko_flow_customization_vars.flow_button_font_size,
+ fontWeight: cko_flow_customization_vars.flow_button_font_weight,
+ letterSpacing: cko_flow_customization_vars.flow_button_letter_spacing,
+ lineHeight: cko_flow_customization_vars.flow_button_line_height,
+ },
+ footnote: {
+ fontFamily: cko_flow_customization_vars.flow_footnote_font_family,
+ fontSize: cko_flow_customization_vars.flow_footnote_font_size,
+ fontWeight: cko_flow_customization_vars.flow_footnote_font_weight,
+ letterSpacing: cko_flow_customization_vars.flow_footnote_letter_spacing,
+ lineHeight: cko_flow_customization_vars.flow_footnote_line_height,
+ },
+ label: {
+ fontFamily: cko_flow_customization_vars.flow_label_font_family,
+ fontSize: cko_flow_customization_vars.flow_label_font_size,
+ fontWeight: cko_flow_customization_vars.flow_label_font_weight,
+ letterSpacing: cko_flow_customization_vars.flow_label_letter_spacing,
+ lineHeight: cko_flow_customization_vars.flow_label_line_height,
+ },
+ subheading: {
+ fontFamily: cko_flow_customization_vars.flow_subheading_font_family,
+ fontSize: cko_flow_customization_vars.flow_subheading_font_size,
+ fontWeight: cko_flow_customization_vars.flow_subheading_font_weight,
+ letterSpacing: cko_flow_customization_vars.flow_subheading_letter_spacing,
+ lineHeight: cko_flow_customization_vars.flow_subheading_line_height,
+ },
+ borderRadius: [
+ cko_flow_customization_vars.flow_form_border_radius,
+ cko_flow_customization_vars.flow_button_border_radius,
+ ],
+};
+
+/**
+ * Component Settings setion.
+ */
+
+// Expand first payment.
+let expand_first_payment_method =
+ cko_flow_customization_vars.flow_component_expand_first_payment_method;
+if (expand_first_payment_method === "yes") {
+ expand_first_payment_method = true;
+} else {
+ expand_first_payment_method = false;
+}
+
+window.componentOptions = {
+ flow: {
+ expandFirstPaymentMethod: expand_first_payment_method,
+ },
+ card: {
+ displayCardholderName:
+ cko_flow_customization_vars.flow_component_cardholder_name_position,
+ },
+};
+
+// Show card holder name.
+let show_card_holder_name =
+ cko_flow_customization_vars.flow_show_card_holder_name;
+
+// Saved Payment setting.
+window.saved_payment = cko_flow_customization_vars.flow_saved_payment;
+
+document.addEventListener("DOMContentLoaded", function () {
+ if (show_card_holder_name === "yes") {
+ // Function to set cardholder name
+ function setCardholderName() {
+ let family_name = "";
+ let given_name = "";
+
+ // Check if we're on order-pay page
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+
+ if (isOrderPayPage) {
+ // For order-pay pages, get billing info from order data instead of form fields
+ // The order data is available in the cart-info or order-pay-info data attribute
+ let orderData = null;
+
+ // Try to get order data from cart-info or order-pay-info
+ const cartInfoElement = document.getElementById("cart-info");
+ const orderPayInfoElement = document.getElementById("order-pay-info");
+
+ if (orderPayInfoElement) {
+ orderData = orderPayInfoElement.getAttribute("data-order-pay");
+ } else if (cartInfoElement) {
+ orderData = cartInfoElement.getAttribute("data-cart");
+ }
+
+ if (orderData) {
+ try {
+ const parsedData = JSON.parse(orderData);
+
+ // Get billing info from order data
+ if (parsedData.billing_address) {
+ given_name = parsedData.billing_address.given_name || "";
+ family_name = parsedData.billing_address.family_name || "";
+ }
+ } catch (e) {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.error('Error parsing order data for cardholder name:', e);
+ }
+ }
+ }
+
+ // Fallback: try to get from form fields (even if disabled)
+ if (!given_name && !family_name) {
+ family_name = document.getElementById("billing_last_name")?.value || "";
+ given_name = document.getElementById("billing_first_name")?.value || "";
+ }
+ } else {
+ // For regular checkout pages, get from form fields
+ family_name = document.getElementById("billing_last_name")?.value || "";
+ given_name = document.getElementById("billing_first_name")?.value || "";
+ }
+
+ const cardholderName = `${given_name} ${family_name}`.trim();
+
+ if (cardholderName) {
+ window.componentOptions.card.data = {
+ cardholderName: cardholderName,
+ };
+ }
+ }
+
+ // Set cardholder name immediately
+ setCardholderName();
+ }
+});
+
+// Component name section.
+window.componentName = cko_flow_customization_vars.flow_component_name || 'flow';
+
+// Locale and Translation section.
+window.locale = cko_flow_customization_vars.flow_component_locale;
+
+function isValidJson(str) {
+ try {
+ if (!str || str.trim() === '' || str === 'null' || str === 'undefined') {
+ return false;
+ }
+ JSON.parse(str);
+ return true;
+ } catch (error) {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.warn('Failed to parse translation data:', error);
+ }
+ return false;
+}
+}
+
+// Safely parse translation data with fallback
+window.translations = {};
+if (typeof cko_flow_customization_vars !== 'undefined' &&
+ cko_flow_customization_vars.flow_component_translation &&
+ isValidJson(cko_flow_customization_vars.flow_component_translation)) {
+ window.translations = JSON.parse(cko_flow_customization_vars.flow_component_translation);
+} else {
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.debug('No valid translation data found, using empty translations object');
+ }
+}
diff --git a/checkout-com-unified-payments-api/flow-integration/assets/js/payment-session.js b/checkout-com-unified-payments-api/flow-integration/assets/js/payment-session.js
new file mode 100644
index 00000000..12aa7187
--- /dev/null
+++ b/checkout-com-unified-payments-api/flow-integration/assets/js/payment-session.js
@@ -0,0 +1,4844 @@
+/*
+ * Centralized logging utility for Checkout.com Flow integration.
+ * Controls what logs appear in production vs debug mode.
+ */
+var ckoLogger = {
+ debugEnabled: (typeof cko_flow_vars !== 'undefined' && cko_flow_vars.debug_logging) || false,
+
+ // ALWAYS VISIBLE (Production + Debug) - Critical for payment troubleshooting
+ error: function(message, data) {
+ console.error('[FLOW ERROR] ' + message, data !== undefined ? data : '');
+ },
+
+ warn: function(message, data) {
+ console.warn('[FLOW WARNING] ' + message, data !== undefined ? data : '');
+ },
+
+ webhook: function(message, data) {
+ console.log('[FLOW WEBHOOK] ' + message, data !== undefined ? data : '');
+ },
+
+ threeDS: function(message, data) {
+ console.log('[FLOW 3DS] ' + message, data !== undefined ? data : '');
+ },
+
+ payment: function(message, data) {
+ console.log('[FLOW PAYMENT] ' + message, data !== undefined ? data : '');
+ },
+
+ version: function(version) {
+ console.log('🚀 Checkout.com Flow v' + version);
+ },
+
+ // DEBUG ONLY (Hidden in Production) - Enable via "Debug Logging" setting
+ debug: function(message, data) {
+ if (this.debugEnabled) {
+ console.log('[FLOW DEBUG] ' + message, data !== undefined ? data : '');
+ }
+ },
+
+ performance: function(message, data) {
+ if (this.debugEnabled) {
+ console.log('[FLOW PERFORMANCE] ' + message, data !== undefined ? data : '');
+ }
+ }
+};
+
+/*
+ * CRITICAL: Early 3DS Detection - MUST run before any other code
+ * This prevents Flow from initializing during 3DS returns
+ */
+(function() {
+ // Check URL parameters immediately (before any other code runs)
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ // Set flag IMMEDIATELY - this prevents ALL Flow initialization
+ window.ckoFlow3DSReturn = true;
+
+ // Log using console.log (always available, even before ckoLogger is defined)
+ console.log('[FLOW 3DS] ⚠️⚠️⚠️ EARLY DETECTION: 3DS return detected, preventing ALL Flow initialization', {
+ paymentId: paymentId,
+ sessionId: sessionId,
+ paymentSessionId: paymentSessionId,
+ timestamp: new Date().toISOString()
+ });
+ }
+})();
+
+/*
+ * The main object managing the Checkout.com flow payment integration.
+ */
+var ckoFlow = {
+ flowComponent: null, // Holds the reference to the Checkout Web Component.
+ performanceMetrics: {
+ pageLoadTime: null,
+ flowInitStartTime: null,
+ flowReadyTime: null,
+ },
+
+ /*
+ * Initializes the payment flow by loading the component.
+ */
+ init: () => {
+ // Don't initialize if 3DS return is in progress
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('Skipping ckoFlow.init() - 3DS return in progress');
+ return;
+ }
+
+ // Mark when Flow initialization starts
+ ckoFlow.performanceMetrics.flowInitStartTime = performance.now();
+ ckoLogger.performance('Flow initialization started');
+ ckoFlow.loadFlow();
+ },
+
+ /*
+ * Loads the Checkout.com payment flow by collecting cart and user info,
+ * creating a payment session, and mounting the Checkout component.
+ */
+ loadFlow: async () => {
+ // CRITICAL: Check for 3DS return FIRST - before any other checks
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('loadFlow: 3DS return in progress, aborting Flow initialization');
+ return; // Exit immediately
+ }
+
+ // Check if cko_flow_vars is available
+ if (typeof cko_flow_vars === 'undefined') {
+ ckoLogger.error('cko_flow_vars is not defined. Flow cannot be initialized.');
+ return;
+ }
+
+ // CRITICAL: Validate required fields BEFORE creating payment session
+ // This prevents API errors when fields aren't filled (defense-in-depth)
+ const fieldsFilled = requiredFieldsFilled();
+ const fieldsValid = requiredFieldsFilledAndValid();
+ const emailValue = getCheckoutFieldValue("billing_email");
+
+ ckoLogger.debug('loadFlow: Field validation check:', {
+ fieldsFilled: fieldsFilled,
+ fieldsValid: fieldsValid,
+ email: emailValue || '(empty)',
+ emailLength: emailValue?.length || 0
+ });
+
+ if (!fieldsValid) {
+ ckoLogger.debug('loadFlow: Required fields not filled - showing waiting message and aborting');
+ showFlowWaitingMessage();
+ // Reset initialization state so Flow can retry when fields are filled
+ ckoFlowInitialized = false;
+ ckoFlowInitializing = false;
+ return; // Exit - don't proceed with payment session creation
+ }
+
+ ckoLogger.debug('loadFlow: Validation passed - proceeding with payment session creation');
+
+ ckoLogger.version('2025-10-13-FINAL-E2E');
+
+ // Check if we're on a redirect page with payment parameters - if so, don't initialize Flow
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const status = urlParams.get("status");
+
+ // Detect 3DS redirect: if we have payment ID or session ID in URL, it's a 3DS return
+ // Don't require status parameter (some environments don't include it)
+ const is3DSReturn = (paymentId || sessionId);
+
+ if (is3DSReturn) {
+ ckoLogger.threeDS('3DS redirect detected - Server-side processing should handle this', {
+ paymentId: paymentId,
+ sessionId: sessionId,
+ status: status || 'detected_via_ids'
+ });
+
+ // Prevent Flow initialization and updated_checkout events during 3DS return
+ window.ckoFlow3DSReturn = true;
+
+ // Server-side should handle this, but if page loads, JavaScript can help as fallback
+ // Wait longer for slow environments - server-side processing might take time
+ setTimeout(() => {
+ // If we're still on checkout page after delay, server-side didn't redirect
+ // Fallback: submit form via JavaScript
+ if (window.location.pathname.includes('/checkout/') && !window.location.pathname.includes('/order-received/')) {
+ ckoLogger.threeDS('Server-side redirect did not occur, using JavaScript fallback');
+
+ // Set the payment ID in the hidden input
+ const paymentIdInput = document.getElementById('cko-flow-payment-id');
+ if (paymentIdInput && paymentId) {
+ paymentIdInput.value = paymentId;
+ ckoLogger.debug('Set payment ID in hidden input:', paymentId);
+ }
+
+ // Set payment type to card (most common)
+ const paymentTypeInput = document.getElementById('cko-flow-payment-type');
+ if (paymentTypeInput) {
+ paymentTypeInput.value = 'card';
+ ckoLogger.debug('Set payment type to: card');
+ }
+
+ // Submit the checkout form to complete the order
+ const checkoutForm = document.querySelector('form.checkout');
+ const orderPayForm = document.querySelector('form#order_review');
+
+ if (checkoutForm) {
+ ckoLogger.threeDS('Submitting checkout form to complete order (fallback)');
+ jQuery(checkoutForm).off('submit').submit();
+ } else if (orderPayForm) {
+ ckoLogger.threeDS('Submitting order-pay form to complete order (fallback)');
+ jQuery(orderPayForm).off('submit').submit();
+ } else {
+ ckoLogger.error('No checkout or order-pay form found after 3DS redirect');
+ }
+ } else {
+ ckoLogger.threeDS('Server-side redirect successful, no JavaScript action needed');
+ }
+ }, 5000); // Wait 5 seconds for server-side redirect (increased for slow environments)
+
+ return; // Don't initialize Flow component
+ }
+
+ // Show skeleton loader and disable place order button
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+
+ if (skeleton) {
+ skeleton.classList.add("show");
+ }
+ if (placeOrderBtn) {
+ placeOrderBtn.classList.add("flow-loading");
+ }
+
+ let cartInfo = jQuery("#cart-info").data("cart");
+
+ if ( ! cartInfo || jQuery.isEmptyObject( cartInfo ) ) {
+ cartInfo = jQuery("#order-pay-info").data("order-pay");
+ }
+
+ /*
+ * Extract information from cartInfo or fallback to DOM form inputs.
+ */
+ let amount = cartInfo["order_amount"];
+ let currency = cartInfo["purchase_currency"];
+
+ let reference = "WOO" + (cko_flow_vars.ref_session || 'default');
+
+ // CRITICAL: Check if billing_address exists before accessing properties
+ const billingAddress = cartInfo["billing_address"] || {};
+ let email =
+ billingAddress["email"] ||
+ (document.getElementById("billing_email") ? document.getElementById("billing_email").value : '');
+ let family_name =
+ billingAddress["family_name"] ||
+ (document.getElementById("billing_last_name") ? document.getElementById("billing_last_name").value : '');
+ let given_name =
+ billingAddress["given_name"] ||
+ (document.getElementById("billing_first_name") ? document.getElementById("billing_first_name").value : '');
+
+ // CRITICAL: Validate email before proceeding - prevent API call with invalid email
+ // Use inline validation to ensure it works even if isValidEmail() isn't available
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ if (!email || typeof email !== 'string' || !email.trim() || !emailRegex.test(email.trim())) {
+ ckoLogger.error('❌ BLOCKED: Invalid email at first check', {
+ email: email,
+ emailType: typeof email,
+ emailLength: email?.length,
+ isEmpty: !email || !email.trim()
+ });
+ hideLoadingOverlay();
+ showError('Please enter a valid email address to continue with payment.');
+ return; // Exit early - don't call API with invalid email
+ }
+
+ // Trim email to remove whitespace
+ email = email.trim();
+ let phone =
+ billingAddress["phone"] ||
+ (document.getElementById("billing_phone") ? document.getElementById("billing_phone").value : '');
+
+ let address1 = shippingAddress1 = billingAddress["street_address"] || '';
+ let address2 = shippingAddress2 = billingAddress["street_address2"] || '';
+ let city = shippingCity = billingAddress["city"] || '';
+ let zip = shippingZip = billingAddress["postal_code"] || '';
+ let country = shippingCountry = billingAddress["country"] || '';
+
+
+ let shippingElement = document.getElementById("ship-to-different-address-checkbox");
+ if ( shippingElement?.checked ) {
+ // CRITICAL: Check if shipping_address exists before accessing properties
+ const shippingAddress = cartInfo["shipping_address"] || {};
+ shippingAddress1 = shippingAddress["street_address"] || address1;
+ shippingAddress2 = shippingAddress["street_address2"] || address2;
+ shippingCity = shippingAddress["city"] || city;
+ shippingZip = shippingAddress["postal_code"] || zip;
+ shippingCountry = shippingAddress["country"] || country;
+ }
+
+ let orders = cartInfo["order_lines"];
+
+ // CLIENT-SIDE FIX: Check if shipping is missing from order_lines
+ // This handles cases where cart-info was populated before shipping was calculated
+ if (orders && Array.isArray(orders) && cartInfo["order_amount"]) {
+ const productsTotal = orders.reduce((sum, item) => {
+ return sum + (parseInt(item.total_amount) || 0);
+ }, 0);
+ const orderAmountCents = parseInt(cartInfo["order_amount"]) || 0;
+ const shippingDifference = orderAmountCents - productsTotal;
+
+ // If there's a positive difference (shipping amount) and no shipping item exists
+ if (shippingDifference > 0) {
+ const hasShipping = orders.some(item =>
+ item.type === 'shipping_fee' ||
+ item.reference === 'shipping' ||
+ (item.name && item.name.toLowerCase().includes('shipping'))
+ );
+
+ if (!hasShipping) {
+ // Try to get shipping method name from DOM or use default
+ let shippingMethodName = 'Shipping';
+ const shippingMethodElement = document.querySelector('.woocommerce-shipping-methods .shipping-method input:checked + label, .woocommerce-shipping-methods label');
+ if (shippingMethodElement) {
+ shippingMethodName = shippingMethodElement.textContent.trim() || 'Shipping';
+ }
+
+ // Add shipping to order_lines
+ orders.push({
+ name: shippingMethodName,
+ quantity: 1,
+ unit_price: shippingDifference,
+ total_amount: shippingDifference,
+ tax_amount: 0,
+ type: 'shipping_fee',
+ reference: 'shipping',
+ discount_amount: 0
+ });
+
+ ckoLogger.debug('[PAYMENT SESSION] [SHIPPING DEBUG] Added missing shipping to order_lines - Amount: ' + shippingDifference + ', Name: ' + shippingMethodName);
+ }
+ }
+ }
+
+ let products = orders
+ .map(line => line.name)
+ .join(', ');
+
+ let description = 'Payment from ' + cko_flow_vars.site_url + ' for [ ' + products + ' ]';
+
+ // Truncate description to 100 characters (Checkout.com API limit)
+ if (description.length > 100) {
+ description = description.substring(0, 97) + '...';
+ }
+
+ let orderId = cartInfo["order_id"];
+ ckoLogger.debug('Initial orderId from cartInfo:', orderId);
+ ckoLogger.debug('Current URL pathname:', window.location.pathname);
+ ckoLogger.debug('Current URL search:', window.location.search);
+
+ // For MOTO orders (order-pay page), get order ID from URL path if not in cartInfo
+ if ( ! orderId && window.location.pathname.includes('/order-pay/') ) {
+ // Extract order ID from URL path like /order-pay/4127/
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ orderId = pathMatch ? pathMatch[1] : null;
+ ckoLogger.debug('MOTO order detected - Order ID from URL path:', orderId);
+ }
+ ckoLogger.debug('Final orderId:', orderId);
+
+ let payment_type = cko_flow_vars.regular_payment_type;
+ let metadata = {
+ udf5: cko_flow_vars.udf5,
+ }
+
+ // Check for subscription product FIRST (before orderId check)
+ let containsSubscriptionProduct = cartInfo["contains_subscription_product"];
+ let cartInfoPaymentType = cartInfo["payment_type"];
+ let isSubscription = false;
+
+ // PRIORITY 1: Check cartInfo["payment_type"] if already set to Recurring by backend
+ if ( cartInfoPaymentType === cko_flow_vars.recurring_payment_type ) {
+ payment_type = cko_flow_vars.recurring_payment_type;
+ isSubscription = true;
+ ckoLogger.debug('Subscription detected via cartInfo["payment_type"] = Recurring');
+ }
+ // PRIORITY 2: Check containsSubscriptionProduct flag
+ else if ( containsSubscriptionProduct ) {
+ isSubscription = orders.some(order => order.is_subscription === true);
+ if ( isSubscription ) {
+ payment_type = cko_flow_vars.recurring_payment_type;
+ ckoLogger.debug('Subscription detected via containsSubscriptionProduct flag');
+ }
+ }
+
+ if ( orderId ) {
+ metadata = {
+ udf5: cko_flow_vars.udf5,
+ order_id: orderId,
+ }
+
+ ckoLogger.debug('🔍 OrderId exists - Checking cartInfo payment_type:', {
+ orderId: orderId,
+ cartInfo_payment_type: cartInfo["payment_type"],
+ isSubscription: isSubscription,
+ current_payment_type: payment_type
+ });
+
+ // Only use cartInfo payment_type if it's not already set to recurring by subscription check
+ if ( !isSubscription ) {
+ payment_type = cartInfo["payment_type"];
+ ckoLogger.debug('✅ Using cartInfo payment_type:', payment_type);
+ } else {
+ ckoLogger.debug('⏭️ Skipping cartInfo payment_type (subscription takes priority). Current payment_type:', payment_type);
+ }
+ } else {
+ ckoLogger.debug('🔍 No orderId - payment_type remains:', payment_type);
+ }
+
+ ckoLogger.debug('🔍 Payment Type - Final value before paymentSessionRequest:', payment_type);
+
+ // Remove is_subscription from all orders.
+ orders.forEach(order => {
+ delete order.is_subscription;
+ });
+
+ /*
+ * Helper to get a field value by ID from the DOM.
+ */
+ function getCheckoutField(fieldId) {
+ const el = document.getElementById(fieldId);
+ return el && el.value ? el.value : null;
+ }
+
+ if (!email) {
+ email = getCheckoutField("billing_email");
+ }
+
+ // CRITICAL: Validate email before proceeding - prevent API call with invalid email
+ // This is a safety check even though canInitializeFlow() should prevent this
+ // Use inline validation to ensure it works even if isValidEmail() isn't available
+ const emailRegex2 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ if (!email || typeof email !== 'string' || !email.trim() || !emailRegex2.test(email.trim())) {
+ ckoLogger.error('❌ BLOCKED: Invalid email at second check', {
+ email: email,
+ emailType: typeof email,
+ emailLength: email?.length,
+ isEmpty: !email || !email.trim()
+ });
+ hideLoadingOverlay();
+ showError('Please enter a valid email address to continue with payment.');
+ return; // Exit early - don't call API with invalid email
+ }
+
+ // Trim email to remove whitespace
+ email = email.trim();
+
+ if (!family_name) {
+ family_name = getCheckoutField("billing_first_name");
+ }
+
+ if (!given_name) {
+ given_name = getCheckoutField("billing_last_name");
+ }
+
+ if (!phone) {
+ phone = getCheckoutField("billing_phone");
+ }
+
+ /*
+ * Displays the loading overlay.
+ */
+ function showLoadingOverlay(arg) {
+ let overlay = document.getElementById("loading-overlay");
+ if (arg === 2) {
+ overlay = document.getElementById("loading-overlay2");
+ }
+ if (overlay) {
+ overlay.style.display = "flex";
+ }
+ }
+
+ /*
+ * Hides the loading overlay.
+ */
+ function hideLoadingOverlay(arg) {
+ let overlay = document.getElementById("loading-overlay");
+ if (arg === 2) {
+ overlay = document.getElementById("loading-overlay2");
+ }
+ if (overlay) {
+ overlay.style.display = "none";
+ }
+ }
+
+ try {
+ showLoadingOverlay();
+
+ // Performance: Track API request start
+ const apiRequestStart = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance('Starting payment session API request...');
+ }
+
+ /*
+ * Send request to Checkout.com to create a payment session.
+ */
+ // Debug: Log 3DS configuration
+ // Ensure proper boolean values - convert any truthy/falsy values to strict booleans
+ const three_ds_enabled = Boolean(cko_flow_vars.three_d_enabled === true || cko_flow_vars.three_d_enabled === "true" || cko_flow_vars.three_d_enabled === 1 || cko_flow_vars.three_d_enabled === "1");
+ const attempt_n3d = Boolean(cko_flow_vars.attempt_no_three_d === true || cko_flow_vars.attempt_no_three_d === "true" || cko_flow_vars.attempt_no_three_d === 1 || cko_flow_vars.attempt_no_three_d === "1");
+
+ // Valid exemption values according to Checkout.com API
+ const valid_exemptions = [
+ "low_value", "trusted_listing", "trusted_listing_prompt",
+ "transaction_risk_assessment", "3ds_outage", "sca_delegation",
+ "out_of_sca_scope", "low_risk_program", "recurring_operation",
+ "data_share", "other"
+ ];
+
+ // Use valid exemption or default to null (no exemption)
+ const exemption = (cko_flow_vars.exemption && valid_exemptions.includes(cko_flow_vars.exemption)) ? cko_flow_vars.exemption : null;
+
+ ckoLogger.debug('Exemption Processing:', {
+ 'Raw exemption from backend': cko_flow_vars.exemption,
+ 'Type of raw exemption': typeof cko_flow_vars.exemption,
+ 'Is exemption truthy': !!cko_flow_vars.exemption,
+ 'Is exemption valid': cko_flow_vars.exemption && valid_exemptions.includes(cko_flow_vars.exemption),
+ 'Processed exemption': exemption,
+ 'Will exemption be included': !!exemption,
+ 'Valid exemptions list': valid_exemptions
+ });
+
+ ckoLogger.threeDS('3DS Configuration (field name: "3ds"):', {
+ 'Raw three_d_enabled': cko_flow_vars.three_d_enabled,
+ 'Type of three_d_enabled': typeof cko_flow_vars.three_d_enabled,
+ 'Processed enabled': three_ds_enabled,
+ 'Type of processed enabled': typeof three_ds_enabled,
+ 'Raw attempt_no_three_d': cko_flow_vars.attempt_no_three_d,
+ 'Type of attempt_no_three_d': typeof cko_flow_vars.attempt_no_three_d,
+ 'Processed attempt_n3d': attempt_n3d,
+ 'Type of processed attempt_n3d': typeof attempt_n3d,
+ challenge_indicator: cko_flow_vars.challenge_indicator || "no_preference",
+ 'Raw exemption': cko_flow_vars.exemption,
+ 'Processed exemption': exemption,
+ 'Raw allow_upgrade': cko_flow_vars.allow_upgrade,
+ 'Type of allow_upgrade': typeof cko_flow_vars.allow_upgrade,
+ allow_upgrade: cko_flow_vars.allow_upgrade === true || cko_flow_vars.allow_upgrade === "true" || cko_flow_vars.allow_upgrade === "yes",
+ });
+
+ // CRITICAL: Log payment_type right before creating paymentSessionRequest
+ ckoLogger.debug('🔍 Payment Type Check - Right before paymentSessionRequest creation:', {
+ payment_type: payment_type,
+ regular_payment_type: cko_flow_vars.regular_payment_type,
+ recurring_payment_type: cko_flow_vars.recurring_payment_type,
+ isRecurring: payment_type === cko_flow_vars.recurring_payment_type,
+ isRegular: payment_type === cko_flow_vars.regular_payment_type
+ });
+
+ // Debug: Log complete payment session request
+ const paymentSessionRequest = {
+ amount: amount,
+ currency: currency,
+ payment_type: payment_type,
+ description: description,
+ customer: {
+ name: `${given_name} ${family_name}`,
+ email: email,
+ },
+ billing: {
+ address: {
+ address_line1: address1,
+ address_line2: address2,
+ city: city,
+ zip: zip,
+ country: country,
+ },
+ },
+ shipping: {
+ address: {
+ address_line1: shippingAddress1,
+ address_line2: shippingAddress2,
+ city: shippingCity,
+ zip: shippingZip,
+ country: shippingCountry,
+ },
+ },
+ // Determine success and failure URLs based on current page
+ // NOTE: success_url and failure_url are overridden below based on order-pay vs regular checkout
+ // These initial values are placeholders and will be replaced
+ // Use query string format (?wc-api=...) instead of path format (/wc-api/...) for WooCommerce API endpoints
+ success_url: window.location.origin + "/?wc-api=wc_checkoutcom_flow_process",
+ failure_url: window.location.origin + "/?wc-api=wc_checkoutcom_flow_process",
+ metadata: metadata,
+ payment_method_configuration: {
+ card: {
+ store_payment_details: "enabled",
+ },
+ },
+ capture: true,
+ items: orders,
+ integration: {
+ external_platform: {
+ name: "Woocomerce",
+ version: cko_flow_vars.woo_version,
+ },
+ },
+ "3ds": {
+ enabled: three_ds_enabled,
+ attempt_n3d: attempt_n3d,
+ challenge_indicator: cko_flow_vars.challenge_indicator || "no_preference",
+ ...(exemption && { exemption: exemption }),
+ allow_upgrade: cko_flow_vars.allow_upgrade === true || cko_flow_vars.allow_upgrade === "true" || cko_flow_vars.allow_upgrade === "yes",
+ },
+ };
+
+ // Check if this is a MOTO order (admin-created order + order-pay page + guest customer)
+ const orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ const isMotoOrder = orderPayInfo?.payment_type === 'MOTO';
+
+ ckoLogger.debug('MOTO Detection - Payment Type:', orderPayInfo?.payment_type, 'Is MOTO:', isMotoOrder);
+
+ // Override payment type for MOTO orders
+ if (isMotoOrder) {
+ payment_type = 'MOTO';
+ ckoLogger.debug('MOTO order detected - setting payment_type to MOTO');
+ ckoLogger.debug('MOTO conditions: Admin order + Order-pay page + Guest customer');
+ } else {
+ ckoLogger.debug('Not a MOTO order - current payment_type:', payment_type);
+ }
+
+ // CRITICAL: Log payment_type right before final assignment to paymentSessionRequest
+ ckoLogger.debug('🔍 Final Payment Type Assignment:', {
+ payment_type: payment_type,
+ regular_payment_type: cko_flow_vars.regular_payment_type,
+ recurring_payment_type: cko_flow_vars.recurring_payment_type,
+ isRecurring: payment_type === cko_flow_vars.recurring_payment_type,
+ isRegular: payment_type === cko_flow_vars.regular_payment_type,
+ isMOTO: payment_type === 'MOTO',
+ 'Will be assigned to paymentSessionRequest.payment_type': payment_type
+ });
+
+ // Update payment type in the request
+ paymentSessionRequest.payment_type = payment_type;
+
+ // Verify the assignment
+ ckoLogger.debug('✅ Verified paymentSessionRequest.payment_type after assignment:', paymentSessionRequest.payment_type);
+
+ // SIMPLIFIED: All flows go directly to PHP endpoint which processes payment and redirects to success/failure page
+ // This provides a smooth transition: 3DS → PHP Endpoint → Success/Failure Page (no checkout page in between)
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+
+ // Get save card preference to include in redirect URL (for 3DS flow)
+ const saveCardCheckbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ const saveCardValue = (saveCardCheckbox && saveCardCheckbox.checked) ? 'yes' : 'no';
+
+ ckoLogger.debug('[SAVE CARD DEBUG] Early checkbox read:', {
+ checkboxId: 'wc-wc_checkout_com_flow-new-payment-method',
+ checkboxFound: !!saveCardCheckbox,
+ checkboxChecked: saveCardCheckbox ? saveCardCheckbox.checked : false,
+ saveCardValue: saveCardValue
+ });
+
+ if (isOrderPayPage) {
+ // For order-pay pages, include order_id and key in URL so PHP endpoint can find the order
+ const orderId = window.location.pathname.match(/\/order-pay\/(\d+)\//)?.[1];
+ const orderKey = new URLSearchParams(window.location.search).get('key');
+
+ if (orderId && orderKey) {
+ // Use query string format (?wc-api=...) for WooCommerce API endpoints
+ // Include save card preference in URL for 3DS flow
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&order_id=" + orderId + "&key=" + orderKey + "&cko-save-card=" + saveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&order_id=" + orderId + "&key=" + orderKey + "&cko-save-card=" + saveCardValue;
+ ckoLogger.debug('Order-pay - using PHP endpoint with order_id, key, and save card preference: ' + saveCardValue);
+ } else {
+ ckoLogger.error('❌ ERROR: Could not extract order ID or key from order-pay URL');
+ // Fallback to PHP endpoint without order_id (will try to find order by payment session ID)
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + saveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + saveCardValue;
+ ckoLogger.debug('Order-pay fallback - using PHP endpoint without order_id, save card preference: ' + saveCardValue);
+ }
+ } else {
+ // For regular checkout, redirect directly to PHP endpoint which processes payment and redirects to success page
+ // Use query string format (?wc-api=...) for WooCommerce API endpoints
+ // Include save card preference in URL for 3DS flow
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + saveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + saveCardValue;
+ ckoLogger.debug('Regular checkout - using PHP endpoint for direct redirect to success page, save card preference: ' + saveCardValue);
+ }
+
+ // Add enabled_payment_methods if specified by merchant
+ // Only send if array has items (empty array means show all methods)
+ // For MOTO orders, hardcode to only show card payment method
+ if (isMotoOrder) {
+ ckoLogger.debug('MOTO order detected - hardcoding to show only card payment method');
+ paymentSessionRequest.enabled_payment_methods = ['card'];
+ ckoLogger.debug('MOTO: Set enabled_payment_methods to:', paymentSessionRequest.enabled_payment_methods);
+ } else if (cko_flow_vars.enabled_payment_methods &&
+ Array.isArray(cko_flow_vars.enabled_payment_methods) &&
+ cko_flow_vars.enabled_payment_methods.length > 0) {
+ paymentSessionRequest.enabled_payment_methods = cko_flow_vars.enabled_payment_methods;
+ ckoLogger.debug('Regular: Enabled payment methods (sent to API):', cko_flow_vars.enabled_payment_methods);
+ } else {
+ ckoLogger.debug('No payment methods filter - all available methods will be shown');
+ ckoLogger.debug('cko_flow_vars.enabled_payment_methods:', cko_flow_vars.enabled_payment_methods);
+ }
+
+ // Update save card value right before sending request to ensure latest checkbox state
+ // Check multiple sources: checkbox state, sessionStorage, hidden field
+ const currentSaveCardCheckbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ const checkboxFound = !!currentSaveCardCheckbox;
+ const checkboxChecked = currentSaveCardCheckbox ? currentSaveCardCheckbox.checked : false;
+
+ // Also check sessionStorage and hidden field as fallbacks
+ const sessionStorageValue = sessionStorage.getItem('cko_flow_save_card');
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ const hiddenFieldValue = hiddenField ? hiddenField.value : '';
+
+ // Determine final value: checkbox > sessionStorage > hidden field > 'no'
+ let currentSaveCardValue = 'no';
+ if (checkboxChecked) {
+ currentSaveCardValue = 'yes';
+ } else if (sessionStorageValue === 'yes') {
+ currentSaveCardValue = 'yes';
+ } else if (hiddenFieldValue === 'yes') {
+ currentSaveCardValue = 'yes';
+ }
+
+ ckoLogger.debug('[SAVE CARD DEBUG] Reading checkbox before API call:', {
+ checkboxId: 'wc-wc_checkout_com_flow-new-payment-method',
+ checkboxFound: checkboxFound,
+ checkboxChecked: checkboxChecked,
+ sessionStorageValue: sessionStorageValue,
+ hiddenFieldValue: hiddenFieldValue,
+ finalSaveCardValue: currentSaveCardValue,
+ checkboxElement: currentSaveCardCheckbox ? 'found' : 'NOT FOUND'
+ });
+
+ // Update success_url and failure_url with current checkbox value
+ const currentIsOrderPayPage = window.location.pathname.includes('/order-pay/');
+ if (currentIsOrderPayPage) {
+ const orderId = window.location.pathname.match(/\/order-pay\/(\d+)\//)?.[1];
+ const orderKey = new URLSearchParams(window.location.search).get('key');
+ if (orderId && orderKey) {
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&order_id=" + orderId + "&key=" + orderKey + "&cko-save-card=" + currentSaveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&order_id=" + orderId + "&key=" + orderKey + "&cko-save-card=" + currentSaveCardValue;
+ } else {
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + currentSaveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + currentSaveCardValue;
+ }
+ } else {
+ paymentSessionRequest.success_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + currentSaveCardValue;
+ paymentSessionRequest.failure_url = window.location.origin + "/?wc-api=wc_checkoutcom_flow_process&cko-save-card=" + currentSaveCardValue;
+ }
+
+ ckoLogger.debug('[SAVE CARD DEBUG] Final URLs set:', {
+ success_url: paymentSessionRequest.success_url,
+ failure_url: paymentSessionRequest.failure_url,
+ containsSaveCardYes: paymentSessionRequest.success_url.includes('cko-save-card=yes')
+ });
+
+ ckoLogger.debug('Complete Payment Session Request:', paymentSessionRequest);
+
+ // SECURITY: Use secure backend AJAX endpoint instead of exposing secret key to frontend
+ const formData = new FormData();
+ formData.append('action', 'cko_flow_create_payment_session');
+ formData.append('nonce', cko_flow_vars.payment_session_nonce);
+ // CRITICAL: Final validation before API call - prevent invalid email from being sent
+ // Validate email format inline (don't rely on function that might not be available)
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ const emailValue = paymentSessionRequest.customer?.email || '';
+ const emailTrimmed = emailValue.trim();
+
+ // Check if email is missing or invalid
+ if (!emailValue || !emailTrimmed || !emailRegex.test(emailTrimmed)) {
+ ckoLogger.error('❌ BLOCKED: Invalid or missing email before API call', {
+ email: emailValue,
+ emailType: typeof emailValue,
+ emailLength: emailValue?.length,
+ emailTrimmed: emailTrimmed,
+ emailRegexTest: emailRegex.test(emailTrimmed)
+ });
+ hideLoadingOverlay();
+
+ // Check if required fields are filled - if not, show waiting message instead of error
+ const fieldsFilledCheck = requiredFieldsFilled();
+ const fieldsValidCheck = requiredFieldsFilledAndValid();
+
+ ckoLogger.debug('Email validation failed - checking field status:', {
+ fieldsFilled: fieldsFilledCheck,
+ fieldsValid: fieldsValidCheck,
+ willShowWaitingMessage: !fieldsValidCheck
+ });
+
+ if (!fieldsValidCheck) {
+ ckoLogger.debug('Required fields not filled - showing waiting message instead of error');
+ showFlowWaitingMessage();
+ // Reset initialization state so Flow can retry when fields are filled
+ ckoFlowInitialized = false;
+ ckoFlowInitializing = false;
+ return; // Exit - don't call API
+ } else {
+ // Fields are filled but email is invalid - show error
+ ckoLogger.debug('Fields are filled but email is invalid - showing error message');
+ showError('Please enter a valid email address to continue with payment.');
+ return; // Exit - don't call API
+ }
+ }
+
+ // Trim email to remove any whitespace
+ paymentSessionRequest.customer.email = paymentSessionRequest.customer.email.trim();
+
+ ckoLogger.debug('✅ Email validated before API call', { email: paymentSessionRequest.customer.email });
+
+ formData.append('payment_session_request', JSON.stringify(paymentSessionRequest));
+
+ let response = await fetch(cko_flow_vars.ajax_url, {
+ method: "POST",
+ body: formData,
+ });
+
+ let responseData = await response.json();
+
+ // Declare paymentSession variable
+ let paymentSession;
+
+ // Check if AJAX response indicates success
+ if (!responseData.success) {
+ // Handle error response - format as API error response
+ paymentSession = {
+ error_type: responseData.data?.error_type || 'ajax_error',
+ error_codes: responseData.data?.error_codes || [responseData.data?.message || 'Unknown error'],
+ request_id: responseData.data?.request_id || null
+ };
+
+ // Create a mock response object with ok: false to trigger error handling below
+ response = {
+ ok: false,
+ status: response.status || 500
+ };
+ } else {
+ // Success - extract payment session from response
+ paymentSession = responseData.data;
+ // Ensure response.ok is true for success case
+ response = {
+ ok: true,
+ status: 200
+ };
+ }
+
+ // Validate payment session response
+ if (!paymentSession.payment_session_token) {
+ ckoLogger.warn('Payment session token not found in response');
+ }
+
+ // Check for API errors (422, 400, etc.)
+ if (!response.ok || paymentSession.error_type || paymentSession.error_codes) {
+ ckoLogger.error('Payment Session API Error:', {
+ status: response.status,
+ statusText: response.statusText,
+ error_type: paymentSession.error_type,
+ error_codes: paymentSession.error_codes,
+ request_id: paymentSession.request_id,
+ response: paymentSession
+ });
+
+ // Hide loading overlay and skeleton
+ hideLoadingOverlay();
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+
+ if (skeleton) {
+ skeleton.classList.remove("show");
+ }
+ if (placeOrderBtn) {
+ placeOrderBtn.classList.remove("flow-loading");
+ }
+
+ // Show user-friendly error message
+ let errorMessage = 'Error creating payment session. Please try again.';
+ if (paymentSession.error_codes && paymentSession.error_codes.length > 0) {
+ errorMessage = 'Payment session error: ' + paymentSession.error_codes.join(', ');
+ }
+
+ showError(errorMessage);
+ return;
+ }
+
+ // Performance: Track API request completion
+ const apiRequestEnd = performance.now();
+ const apiDuration = apiRequestEnd - apiRequestStart;
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance(`Payment session API completed in ${apiDuration.toFixed(2)}ms (${(apiDuration / 1000).toFixed(2)}s)`);
+ }
+
+ // Debug: Log payment session response
+ ckoLogger.payment('Payment Session Response:', paymentSession);
+
+ // Store payment session ID globally for access in callbacks
+ window.currentPaymentSessionId = paymentSession.id;
+
+ // CRITICAL: Add payment session ID as hidden field to form for process_payment()
+ // This ensures payment session ID is available in POST data when form is submitted
+ // Function to add hidden field (can be called multiple times as fallback)
+ const addPaymentSessionIdField = () => {
+ if (!window.currentPaymentSessionId) {
+ return false;
+ }
+
+ // Remove existing hidden field if it exists
+ const existingField = document.getElementById('cko-flow-payment-session-id');
+ if (existingField) {
+ existingField.remove();
+ }
+
+ // Create hidden input field for payment session ID
+ const hiddenField = document.createElement('input');
+ hiddenField.type = 'hidden';
+ hiddenField.id = 'cko-flow-payment-session-id';
+ hiddenField.name = 'cko-flow-payment-session-id';
+ hiddenField.value = window.currentPaymentSessionId;
+
+ // Add to checkout form (or order-pay form)
+ const checkoutForm = document.querySelector('form.checkout');
+ const orderPayForm = document.querySelector('form#order_review');
+ const targetForm = checkoutForm || orderPayForm;
+
+ if (targetForm) {
+ targetForm.appendChild(hiddenField);
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Added hidden field to form:', {
+ form: checkoutForm ? 'checkout' : 'order-pay',
+ payment_session_id: window.currentPaymentSessionId
+ });
+ return true;
+ } else {
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Form not found yet - will retry on form submission');
+ return false;
+ }
+ };
+
+ // Try to add immediately
+ if (paymentSession.id) {
+ addPaymentSessionIdField();
+
+ // Also expose function globally so it can be called as fallback
+ window.ckoAddPaymentSessionIdField = addPaymentSessionIdField;
+ }
+
+ // PERFORMANCE: Save payment session ID to order immediately (asynchronously, non-blocking)
+ // This ensures order is linked to payment session even if user cancels after 3DS
+ // Get order ID from cartInfo (available earlier in function) or from URL (for order-pay pages)
+ let orderIdToSave = cartInfo["order_id"];
+ if (!orderIdToSave && window.location.pathname.includes('/order-pay/')) {
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ orderIdToSave = pathMatch ? pathMatch[1] : null;
+ }
+
+ // Save payment session ID asynchronously (fire and forget - don't wait for response)
+ // NOTE: This only works for order-pay pages where order already exists
+ // For regular checkout, payment session ID is saved via hidden field in process_payment()
+ if (paymentSession.id && orderIdToSave && cko_flow_vars && cko_flow_vars.ajax_url && cko_flow_vars.payment_session_nonce) {
+ const saveFormData = new FormData();
+ saveFormData.append('action', 'cko_flow_save_payment_session_id');
+ saveFormData.append('nonce', cko_flow_vars.payment_session_nonce);
+ saveFormData.append('order_id', orderIdToSave);
+ saveFormData.append('payment_session_id', paymentSession.id);
+
+ // Fire and forget - don't wait for response (non-blocking)
+ fetch(cko_flow_vars.ajax_url, {
+ method: 'POST',
+ body: saveFormData
+ }).then(response => {
+ if (response.ok) {
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Successfully saved payment session ID to order:', {
+ order_id: orderIdToSave,
+ payment_session_id: paymentSession.id
+ });
+ } else {
+ ckoLogger.warn('[SAVE PAYMENT SESSION ID] Failed to save payment session ID (non-critical):', {
+ order_id: orderIdToSave,
+ payment_session_id: paymentSession.id,
+ status: response.status
+ });
+ }
+ }).catch(err => {
+ // Log error but don't block flow (fallback exists in handle_3ds_return)
+ ckoLogger.warn('[SAVE PAYMENT SESSION ID] Error saving payment session ID (non-critical, fallback exists):', err);
+ });
+
+ // Continue immediately - don't wait for AJAX response
+ } else {
+ if (ckoLogger.debug) {
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Skipping AJAX save - missing order ID (normal for regular checkout):', {
+ has_payment_session_id: !!paymentSession.id,
+ has_order_id: !!orderIdToSave,
+ has_ajax_url: !!(cko_flow_vars && cko_flow_vars.ajax_url),
+ has_nonce: !!(cko_flow_vars && cko_flow_vars.payment_session_nonce),
+ note: 'Payment session ID will be saved via hidden field in process_payment()'
+ });
+ }
+ }
+
+ /*
+ * Handle API Session errors returned from Checkout.com.
+ */
+ if (paymentSession.error_type) {
+ // Hide loading overlay.
+ hideLoadingOverlay();
+
+ // Check for 3DS specific errors
+ if (paymentSession.error_codes && paymentSession.error_codes.includes('three_ds_invalid')) {
+ ckoLogger.error('3DS Configuration Error:', paymentSession);
+ showError('3DS configuration error. Please check your 3DS settings in the admin panel.');
+ return;
+ }
+
+ const readableErrors = {
+ customer_email_invalid: wp.i18n.__(
+ "Please enter the email to proceed.",
+ "checkout-com-unified-payments-api"
+ ),
+ billing_phone_number_invalid: wp.i18n.__(
+ "Please enter the phone number to proceed.",
+ "checkout-com-unified-payments-api"
+ ),
+ };
+
+ let messages = (paymentSession.error_codes || []).map(
+ (code) => readableErrors[code] || code
+ );
+ showError(messages[0]);
+ return;
+ }
+
+ /*
+ * Successfully received a payment session.
+ * Load Checkout.com Web Component.
+ */
+ if (paymentSession.id) {
+ // Performance: Track component initialization start
+ const componentInitStart = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance('Initializing Checkout Web Component...');
+ }
+
+ // Debug: Log Flow component configuration
+ ckoLogger.debug('Flow Component Configuration:', {
+ publicKey: cko_flow_vars.PKey ? 'SET' : 'NOT SET',
+ publicKeyPreview: cko_flow_vars.PKey ? cko_flow_vars.PKey.substring(0, 10) + '...' : 'NOT SET',
+ environment: cko_flow_vars.env,
+ locale: window.locale,
+ paymentSessionId: paymentSession.id,
+ paymentSessionSecret: paymentSession.payment_session_secret ? 'SET' : 'NOT SET',
+ appearance: window.appearance ? 'SET' : 'NOT SET',
+ componentOptions: window.componentOptions ? 'SET' : 'NOT SET',
+ translations: window.translations ? 'SET' : 'NOT SET'
+ });
+
+ // Additional validation
+ if (!cko_flow_vars.PKey) {
+ ckoLogger.error('CRITICAL: Public key is missing!');
+ showError('Payment gateway configuration error. Please contact support.');
+ return;
+ }
+
+ if (!paymentSession.id) {
+ ckoLogger.error('CRITICAL: Payment session ID is missing!');
+ showError('Payment session error. Please try again.');
+ return;
+ }
+
+ // Define callback functions BEFORE passing them to CheckoutWebComponents
+ const onReady = () => {
+ try {
+ ckoLogger.debug('onReady callback fired! 🔥🔥🔥');
+ hideLoadingOverlay();
+
+ // Performance tracking: Mark when Flow is ready
+ ckoFlow.performanceMetrics.flowReadyTime = performance.now();
+
+ const pageLoadToReady = ckoFlow.performanceMetrics.flowReadyTime - ckoFlow.performanceMetrics.pageLoadTime;
+ const initToReady = ckoFlow.performanceMetrics.flowReadyTime - ckoFlow.performanceMetrics.flowInitStartTime;
+
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance('===== Flow Load Complete =====');
+ ckoLogger.performance(`Page Load → Flow Ready: ${pageLoadToReady.toFixed(2)}ms (${(pageLoadToReady / 1000).toFixed(2)}s)`);
+ ckoLogger.performance(`Flow Init → Flow Ready: ${initToReady.toFixed(2)}ms (${(initToReady / 1000).toFixed(2)}s)`);
+ ckoLogger.performance('================================');
+ }
+
+ // ============================================================
+ // SMOOTH CHECKOUT EXPERIENCE - onReady Handler
+ // ============================================================
+
+ const displayOrder = window.saved_payment || 'new_payment_first';
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+ const saveCardCheckbox = document.querySelector('.cko-save-card-checkbox');
+
+ ckoLogger.debug('onReady - Display order:', displayOrder);
+ ckoLogger.debug('onReady - Flow is fully loaded and ready');
+
+ // Step 1: Hide skeleton loader with smooth transition
+ ckoLogger.debug('onReady - Skeleton element found:', !!skeleton);
+ if (skeleton) {
+ ckoLogger.debug('onReady - Skeleton classes BEFORE:', skeleton.className);
+ skeleton.classList.remove("show");
+ ckoLogger.debug('onReady - Skeleton classes AFTER:', skeleton.className);
+ ckoLogger.debug('onReady - ✓ Skeleton loader hidden');
+ } else {
+ ckoLogger.debug('onReady - ❌ Skeleton element NOT FOUND');
+ }
+
+ // Step 2: Enable Place Order button (remove loading state)
+ ckoLogger.debug('onReady - Place Order button found:', !!placeOrderBtn);
+ if (placeOrderBtn) {
+ ckoLogger.debug('onReady - Button classes BEFORE:', placeOrderBtn.className);
+ placeOrderBtn.classList.remove("flow-loading");
+ ckoLogger.debug('onReady - Button classes AFTER:', placeOrderBtn.className);
+ placeOrderBtn.style.removeProperty('opacity');
+ placeOrderBtn.style.removeProperty('visibility');
+ ckoLogger.debug('onReady - ✓ Place Order button enabled');
+ } else {
+ ckoLogger.debug('onReady - ❌ Place Order button NOT FOUND');
+ }
+
+ // Step 3: Hide save card checkbox initially (onChange will show it for card payment type)
+ if (saveCardCheckbox) {
+ saveCardCheckbox.style.display = 'none';
+ ckoLogger.debug('onReady - ✓ Save card checkbox hidden (will show on card selection)');
+ } else {
+ ckoLogger.debug('onReady - Save card checkbox not available (feature disabled)');
+ }
+
+ // Step 4: Mark Flow as ready - triggers CSS animations and visibility rules
+ document.body.classList.add("flow-ready");
+ ckoLogger.debug('onReady - ✓ Flow marked as ready - Checkout is now fully interactive');
+
+
+ // Step 5: Ensure no saved card is selected by default - user must explicitly select
+ // Remove any default selections to prevent issues with auto-detection
+ const anyDefaultCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"][checked="checked"]:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ if (anyDefaultCard.length > 0) {
+ ckoLogger.debug('onReady - Removing default saved card selection - user must explicitly select');
+ anyDefaultCard.prop('checked', false).removeAttr('checked');
+ // Ensure "new" card option is selected by default
+ const newCardRadio = jQuery('#wc-wc_checkout_com_flow-payment-token-new');
+ if (newCardRadio.length) {
+ newCardRadio.prop('checked', true);
+ ckoLogger.debug('onReady - ✓ "New card" option selected by default');
+ }
+ window.flowSavedCardSelected = false;
+ window.flowUserInteracted = false;
+ }
+
+ // Note: Save card checkbox visibility is controlled by the onChange event
+ // It will only show when payment type is "card" and hide for other payment methods
+ } catch (error) {
+ ckoLogger.error('onReady ERROR:', error);
+ ckoLogger.error('Error stack:', error.stack);
+ }
+ };
+
+ /*
+ * Called when the payment is completed successfully.
+ */
+ const onPaymentCompleted = (_component, paymentResponse) => {
+
+ // Check if this is a 3DS authentication response
+ if (paymentResponse.threeDs && paymentResponse.threeDs.challenged) {
+ // 3DS challenge detected - user will be redirected to 3DS page
+ return;
+ }
+
+ if (paymentResponse.id) {
+ hideLoadingOverlay(2);
+
+ // Set the hidden input values.
+ jQuery("#cko-flow-payment-id").val(paymentResponse.id);
+ jQuery("#cko-flow-payment-type").val(paymentResponse?.type || "");
+
+ // Check if this is an APM payment (Alternative Payment Method)
+ // APM payments should submit form normally instead of redirecting
+ // This is because handle_3ds_return() tries to fetch payment details which may fail for APM
+ const paymentType = paymentResponse?.type || "";
+ const isAPMPayment = paymentType && !['card', ''].includes(paymentType.toLowerCase());
+ const apmTypes = ['googlepay', 'applepay', 'paypal', 'octopus', 'twint', 'klarna', 'sofort', 'ideal', 'giropay', 'bancontact', 'eps', 'p24', 'knet', 'fawry', 'qpay', 'multibanco', 'stcpay', 'alipay', 'wechatpay'];
+ const isKnownAPM = apmTypes.includes(paymentType.toLowerCase());
+
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment type check:', {
+ paymentType: paymentType,
+ isAPMPayment: isAPMPayment,
+ isKnownAPM: isKnownAPM
+ });
+
+ // CRITICAL: Check form field for order ID (set by createOrderBeforePayment())
+ // Don't use orderId from loadFlow() scope - it's only set for order-pay pages
+ const formOrderId = jQuery('input[name="order_id"]').val();
+ const sessionOrderId = sessionStorage.getItem('cko_flow_order_id');
+ const hasOrderId = formOrderId || sessionOrderId || orderId; // orderId is fallback for order-pay pages
+
+ ckoLogger.debug('[PAYMENT COMPLETED] Order ID check:', {
+ formOrderId: formOrderId || 'NOT SET',
+ sessionOrderId: sessionOrderId || 'NOT SET',
+ loadFlowOrderId: orderId || 'NOT SET',
+ hasOrderId: !!hasOrderId
+ });
+
+ if ( ! hasOrderId ) {
+ // No order exists - trigger WooCommerce order placement on checkout page.
+ ckoLogger.debug('[PAYMENT COMPLETED] No order ID found - submitting form to create order');
+
+ // CRITICAL: Ensure payment session ID is in form before submitting
+ // This ensures payment_session_id is saved to order metadata
+ const existingSessionIdField = document.getElementById('cko-flow-payment-session-id');
+ const existingSessionIdValue = existingSessionIdField ? existingSessionIdField.value : '';
+
+ if (!existingSessionIdField || !existingSessionIdValue) {
+ if (window.ckoAddPaymentSessionIdField) {
+ const added = window.ckoAddPaymentSessionIdField();
+ if (added) {
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment session ID added to form before submission (no order ID)');
+ } else if (window.currentPaymentSessionId) {
+ // Fallback: Try to manually add
+ const checkoutForm = document.querySelector('form.checkout');
+ if (checkoutForm) {
+ const manualField = document.createElement('input');
+ manualField.type = 'hidden';
+ manualField.id = 'cko-flow-payment-session-id';
+ manualField.name = 'cko-flow-payment-session-id';
+ manualField.value = window.currentPaymentSessionId;
+ checkoutForm.appendChild(manualField);
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment session ID manually added (fallback)');
+ }
+ }
+ } else if (window.currentPaymentSessionId) {
+ // Fallback: Try to manually add if function not available
+ const checkoutForm = document.querySelector('form.checkout');
+ if (checkoutForm) {
+ const manualField = document.createElement('input');
+ manualField.type = 'hidden';
+ manualField.id = 'cko-flow-payment-session-id';
+ manualField.name = 'cko-flow-payment-session-id';
+ manualField.value = window.currentPaymentSessionId;
+ checkoutForm.appendChild(manualField);
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment session ID manually added (no function available)');
+ }
+ }
+ }
+
+ jQuery("form.checkout").submit();
+ } else {
+ // Order already exists (created via AJAX)
+ const orderIdToUse = formOrderId || sessionOrderId || orderId;
+
+ // For APM payments, always submit form instead of redirecting
+ // This prevents payment details fetch errors in handle_3ds_return()
+ if (isKnownAPM || isAPMPayment) {
+ ckoLogger.debug('[PAYMENT COMPLETED] APM payment detected (' + paymentType + ') - submitting form instead of redirecting');
+
+ // CRITICAL: Ensure payment session ID is in form before submitting
+ // This ensures payment_session_id is saved to order metadata
+ const existingSessionIdField = document.getElementById('cko-flow-payment-session-id');
+ const existingSessionIdValue = existingSessionIdField ? existingSessionIdField.value : '';
+
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment session ID check:', {
+ hasExistingField: !!existingSessionIdField,
+ existingValue: existingSessionIdValue || 'EMPTY',
+ hasWindowFunction: !!window.ckoAddPaymentSessionIdField,
+ hasWindowSessionId: !!window.currentPaymentSessionId,
+ windowSessionId: window.currentPaymentSessionId || 'NOT SET'
+ });
+
+ // If field doesn't exist or is empty, try to add it
+ if (!existingSessionIdField || !existingSessionIdValue) {
+ if (window.ckoAddPaymentSessionIdField) {
+ const added = window.ckoAddPaymentSessionIdField();
+ if (added) {
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment session ID added to form before APM submission');
+ } else {
+ ckoLogger.warn('[PAYMENT COMPLETED] Failed to add payment session ID to form - window.currentPaymentSessionId: ' + (window.currentPaymentSessionId || 'NOT SET'));
+
+ // Fallback: Try to manually add if we have the session ID
+ if (window.currentPaymentSessionId) {
+ const checkoutForm = document.querySelector('form.checkout');
+ if (checkoutForm) {
+ const manualField = document.createElement('input');
+ manualField.type = 'hidden';
+ manualField.id = 'cko-flow-payment-session-id';
+ manualField.name = 'cko-flow-payment-session-id';
+ manualField.value = window.currentPaymentSessionId;
+ checkoutForm.appendChild(manualField);
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment session ID manually added to form (fallback)');
+ }
+ }
+ }
+ } else {
+ ckoLogger.warn('[PAYMENT COMPLETED] window.ckoAddPaymentSessionIdField not available');
+
+ // Fallback: Try to manually add if we have the session ID
+ if (window.currentPaymentSessionId) {
+ const checkoutForm = document.querySelector('form.checkout');
+ if (checkoutForm) {
+ const manualField = document.createElement('input');
+ manualField.type = 'hidden';
+ manualField.id = 'cko-flow-payment-session-id';
+ manualField.name = 'cko-flow-payment-session-id';
+ manualField.value = window.currentPaymentSessionId;
+ checkoutForm.appendChild(manualField);
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment session ID manually added to form (fallback - no function)');
+ }
+ } else {
+ ckoLogger.error('[PAYMENT COMPLETED] CRITICAL: Payment session ID cannot be added - window.currentPaymentSessionId is not set!');
+ }
+ }
+ } else {
+ ckoLogger.debug('[PAYMENT COMPLETED] Payment session ID already in form: ' + existingSessionIdValue.substring(0, 20) + '...');
+ }
+
+ jQuery("form.checkout").submit();
+ return;
+ }
+
+ ckoLogger.debug('[PAYMENT COMPLETED] Order already exists (ID: ' + orderIdToUse + ') - redirecting to process payment endpoint');
+
+ // For order-pay pages, use native DOM submit to bypass event handlers
+ if (orderId && window.location.pathname.includes('/order-pay/')) {
+ ckoLogger.threeDS('Submitting order-pay form using native submit after payment completion');
+ const orderPayForm = document.querySelector('form#order_review');
+ if (orderPayForm) {
+ orderPayForm.submit();
+ } else {
+ ckoLogger.error('ERROR: form#order_review not found!');
+ }
+ } else {
+ // For regular checkout with card payments, redirect to process payment endpoint with order ID and payment ID
+ // This ensures process_payment() is called with the existing order
+ // CRITICAL: handle_3ds_return() requires cko-payment-id in GET params
+ const redirectUrl = window.location.origin + '/?wc-api=wc_checkoutcom_flow_process&order_id=' + orderIdToUse + '&cko-payment-id=' + paymentResponse.id;
+ ckoLogger.debug('[PAYMENT COMPLETED] Redirecting to process payment endpoint: ' + redirectUrl);
+ window.location.href = redirectUrl;
+ }
+ }
+ }
+ };
+
+ /*
+ * Triggered when user submits the payment using Place Order Button of Woocommerce.
+ */
+ const onSubmit = async (component) => {
+ showLoadingOverlay(2);
+ return { continue: true };
+ };
+
+ /*
+ * Triggered on component state change.
+ */
+ const onChange = (component) => {
+ hideLoadingOverlay();
+
+ // Initialize tracking variables if not exists
+ if (!window.onChangeTracking) {
+ window.onChangeTracking = {
+ lastState: {},
+ lastProcessedTime: 0,
+ processingCount: 0
+ };
+ }
+
+ const now = Date.now();
+ const currentState = {
+ selectedType: component.selectedType,
+ componentType: component.type,
+ isValid: component.isValid ? component.isValid() : false
+ };
+
+ // Check if state has actually changed
+ const stateChanged = (
+ window.onChangeTracking.lastState.selectedType !== currentState.selectedType ||
+ window.onChangeTracking.lastState.componentType !== currentState.componentType ||
+ window.onChangeTracking.lastState.isValid !== currentState.isValid
+ );
+
+ // Rate limiting: don't process more than once every 50ms
+ const timeSinceLastProcess = now - window.onChangeTracking.lastProcessedTime;
+ const shouldRateLimit = timeSinceLastProcess < 50;
+
+ // Only process if state actually changed AND enough time has passed
+ if (!stateChanged || shouldRateLimit) {
+ window.onChangeTracking.processingCount++;
+ if (window.onChangeTracking.processingCount % 10 === 0) {
+ ckoLogger.debug(`onChange - Skipped ${window.onChangeTracking.processingCount} duplicate events`);
+ }
+ return;
+ }
+
+ // Update tracking
+ window.onChangeTracking.lastState = { ...currentState };
+ window.onChangeTracking.lastProcessedTime = now;
+ window.onChangeTracking.processingCount = 0;
+
+ ckoLogger.debug('===== onChange START =====');
+ ckoLogger.debug('onChange - Selected Type:', component.selectedType);
+ ckoLogger.debug('onChange - Component Type:', component.type);
+ ckoLogger.debug('onChange - Component valid:', component.isValid ? component.isValid() : 'unknown');
+ ckoLogger.debug('onChange - User interacted flag:', window.flowUserInteracted);
+ ckoLogger.debug('onChange - Body has flow-ready class:', document.body.classList.contains('flow-ready'));
+
+ // CRITICAL: Auto-deselect saved card when user interacts with Flow
+ // Check if a saved card is currently selected and Flow is de-emphasized
+ const flowContainer = document.getElementById("flow-container");
+ const anySavedCardSelected = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked').filter(function() {
+ return jQuery(this).attr('id') !== 'wc-wc_checkout_com_flow-payment-token-new';
+ }).length > 0;
+
+ if (anySavedCardSelected && flowContainer) {
+ ckoLogger.debug('onChange - User typing in Flow while saved card selected - auto-activating Flow');
+ // Call the activation function
+ if (typeof window.activateFlowPayment === 'function') {
+ window.activateFlowPayment();
+ } else {
+ // Fallback if function not available yet
+ jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked').prop('checked', false);
+ window.flowSavedCardSelected = false;
+ ckoLogger.debug('onChange - Deselected saved card and activated Flow (fallback)');
+ }
+ }
+
+ // Note: We don't set flowUserInteracted here anymore because onChange
+ // fires on initial load. Instead, we use click/focus/input listeners
+ // to detect actual user interaction with Flow fields.
+
+ const hiddenTypes = [
+ "applepay",
+ "googlepay",
+ "octopus",
+ "paypal",
+ "twint",
+ "venmo",
+ "wechatpay"
+ ];
+
+ const placeOrderButton = document.querySelector("#place_order");
+
+ // Hide place order button on digital wallets.
+ if (hiddenTypes.includes(component.selectedType)) {
+ if (placeOrderButton) placeOrderButton.style.display = "none";
+ ckoLogger.debug('onChange - Hiding Place Order button');
+ } else {
+ if (placeOrderButton) placeOrderButton.style.display = "block";
+ ckoLogger.debug('onChange - Showing Place Order button');
+ }
+
+ ckoLogger.debug('===== onChange END =====');
+
+ // Pre-validate for apple pay.
+ if ( component.selectedType === "applepay" ) {
+ const applePayButton = document.querySelector('button[aria-label="Apple Pay"]');
+ applePayButton.disabled = true;
+
+ const form = jQuery("form.checkout");
+
+ if ( ! orderId ) {
+ validateCheckout(form, function (response) {
+ applePayButton.disabled = false;
+ });
+ }
+ }
+
+ // Control Save to Account checkbox visibility based on payment type
+ const saveCardCheckbox = jQuery('.cko-save-card-checkbox');
+ if ( saveCardCheckbox.length > 0 ) {
+ if ( component.selectedType === "card" ) {
+ saveCardCheckbox.addClass('wc-cko-flow-card-on');
+ saveCardCheckbox.css('display', 'block'); // Use .css() to set inline style
+ saveCardCheckbox.show();
+ // Also show the inner Database Index Check - Checkout.com Flow
+ +Meta Key:
+ Table:
1. Index Status
+ +
+ Composite Index:
+
+
+ 2. Query Performance Test
+ +| Metric | +Value | +Status | +
|---|---|---|
| Query Time | +ms | ++ 20 ) { + echo '⚠️ SLOW'; + } elseif ( $results['query_performance']['query_time_ms'] > 15 ) { + echo '⚠️ MODERATE'; + } else { + echo '✅ GOOD'; + } + ?> + | +
| Results Found | ++ | - | +
+
+
+
+
+ 3. Table Statistics
+| Metric | +Value | +
|---|---|
| Total Rows in postmeta | ++ |
| Rows with | ++ |
4. Recommendations
+-
+
+
- + ⚠️ CRITICAL: WordPress should automatically index meta_key, but it's missing. + This may indicate a database issue. Please check your WordPress installation. + + + + 100 ) : ?> +
-
+ ✅ RECOMMENDED: Consider creating a composite index for better performance
+ with rows.
+
+ SQL Command:
++ CREATE INDEX idx_ckopaymentsessionid ON (meta_key(191), meta_value(191)); ++
+
+ - + ℹ️ INFO: Composite index not needed yet (low data volume: + rows). + + + + 20 ) : ?> +
- + ⚠️ PERFORMANCE: Query time is high (>20ms). Adding an index is recommended + to improve performance. + + +
5. Existing Indexes
+ +| Index Name | +Column | +Non-Unique | +Cardinality | +
|---|---|---|---|
| Key_name ); ?> | +Column_name ); ?> | +Non_unique ); ?> | +Cardinality ); ?> | +
No indexes found.
+
+ element that contains the actual checkbox + const saveNewElement = saveCardCheckbox.find('.woocommerce-SavedPaymentMethods-saveNew'); + if ( saveNewElement.length > 0 ) { + saveNewElement.css('display', 'block'); + saveNewElement.show(); + } + ckoLogger.debug('onChange - Showing Save to Account checkbox for CARD'); + } else { + saveCardCheckbox.removeClass('wc-cko-flow-card-on'); + saveCardCheckbox.css('display', 'none'); // Use .css() to set inline style + saveCardCheckbox.hide(); + ckoLogger.debug('onChange - Hiding Save to Account checkbox for', component.selectedType); + } + } else { + ckoLogger.debug('onChange - Save card checkbox not available (feature disabled)'); + } + + console.log( + `[FLOW] onChange() -> isValid: "${component.isValid()}" for "${ + component.type + }"` + ); + + // Additional debugging for Flow component validation issues + if (component.type === 'flow' && !component.isValid()) { + ckoLogger.debug('Flow component validation failed - checking component state:', { + componentType: component.type, + isValid: component.isValid(), + componentState: component.state || 'no state available', + componentErrors: component.errors || 'no errors available' + }); + } + }; + + /* + * Triggered on component click. + */ + const handleClick = (component) => { + + if(component.type==="applepay") { + return {continue: true}; + } + + if ( orderId ) { + return {continue: true}; + } + + return new Promise((resolve) => { + const form = jQuery("form.checkout"); + + validateCheckout(form, function (response) { + resolve({ continue: true }); + }); + }); + }; + + /* + * Triggered on any error in the component. + */ + const onError = (component, error) => { + ckoLogger.error("onError", error, "Component", component.type); + + // Hide loading overlay and skeleton. + hideLoadingOverlay(); + hideLoadingOverlay(2); + + const skeleton = document.getElementById("flow-skeleton"); + const placeOrderBtn = document.getElementById("place_order"); + + if (skeleton) { + skeleton.classList.remove("show"); + } + if (placeOrderBtn) { + placeOrderBtn.classList.remove("flow-loading"); + } + + // Extract error message from various error object formats + // CheckoutError objects might have message in different places + let errorMessage = ''; + if (error.message) { + errorMessage = error.message; + } else if (error.toString && typeof error.toString === 'function') { + errorMessage = error.toString(); + } else if (typeof error === 'string') { + errorMessage = error; + } else { + errorMessage = JSON.stringify(error); + } + + // Handle specific error types with user-friendly messages + let userFriendlyMessage = null; + let isPaymentDeclined = false; + + if (errorMessage.includes("[Request]: Network request failed [payment_request_failed]")) { + ckoLogger.error("Payment request failed - checking configuration:"); + ckoLogger.error("Public Key:", cko_flow_vars.PKey ? 'SET' : 'NOT SET'); + ckoLogger.error("Environment:", cko_flow_vars.env); + ckoLogger.error("Payment Session ID:", paymentSession ? paymentSession.id : 'N/A'); + userFriendlyMessage = "Payment request failed. Please check your payment gateway configuration or try again."; + } else if (errorMessage.includes("[Request]: Payment request declined [payment_request_declined]") || + errorMessage.includes("payment_request_declined")) { + ckoLogger.error("Payment request declined by Checkout.com"); + ckoLogger.error("Error details:", error); + // User-friendly message for payment decline + userFriendlyMessage = "Your payment was declined. Please check your card details and try again, or use a different payment method."; + isPaymentDeclined = true; + } else if (errorMessage === "[Submit]: Component is invalid [component_invalid]") { + userFriendlyMessage = "Please complete your payment before placing the order."; + } else if (errorMessage.includes("declined")) { + // Catch any other decline-related errors + ckoLogger.error("Payment declined (generic decline error)"); + ckoLogger.error("Error details:", error); + userFriendlyMessage = "Your payment was declined. Please check your card details and try again, or use a different payment method."; + isPaymentDeclined = true; + } + + // Use user-friendly message if available, otherwise use original or fallback + const finalErrorMessage = userFriendlyMessage || errorMessage || wp.i18n.__( + "Something went wrong. Please try again.", + "checkout-com-unified-payments-api" + ); + + // Always show error message to user + ckoLogger.error("Displaying error to user:", finalErrorMessage); + showError(finalErrorMessage); + + // CRITICAL: Create order for declined payments if Place Order was clicked + // This ensures failed payment attempts are tracked even when payment fails before form submission + ckoLogger.error("[ORDER CREATION DEBUG] Checking conditions:"); + ckoLogger.error("[ORDER CREATION DEBUG] isPaymentDeclined:", isPaymentDeclined); + ckoLogger.error("[ORDER CREATION DEBUG] window.ckoPlaceOrderClicked:", window.ckoPlaceOrderClicked); + ckoLogger.error("[ORDER CREATION DEBUG] cko_flow_vars:", typeof cko_flow_vars !== 'undefined' ? 'defined' : 'undefined'); + ckoLogger.error("[ORDER CREATION DEBUG] ajax_url:", typeof cko_flow_vars !== 'undefined' ? cko_flow_vars.ajax_url : 'N/A'); + + if (isPaymentDeclined && window.ckoPlaceOrderClicked) { + ckoLogger.error("[ORDER CREATION] Payment declined AFTER Place Order clicked - creating failed order for tracking"); + + const form = jQuery("form.checkout"); + ckoLogger.error("[ORDER CREATION DEBUG] Form found:", form.length > 0); + + if (form.length > 0) { + const formData = form.serialize(); + ckoLogger.error("[ORDER CREATION DEBUG] Form data serialized, length:", formData.length); + + // Check if nonce exists in form + const nonceField = jQuery('input[name="woocommerce-process-checkout-nonce"]'); + const nonceValue = nonceField.length > 0 ? nonceField.val() : ''; + ckoLogger.error("[ORDER CREATION DEBUG] Nonce field found:", nonceField.length > 0); + ckoLogger.error("[ORDER CREATION DEBUG] Nonce value:", nonceValue ? nonceValue.substring(0, 10) + '...' : 'EMPTY'); + + // Parse form data into object + const formDataObj = Object.fromEntries(new URLSearchParams(formData)); + + // Ensure nonce is explicitly included + if (!formDataObj['woocommerce-process-checkout-nonce'] && nonceValue) { + formDataObj['woocommerce-process-checkout-nonce'] = nonceValue; + ckoLogger.error("[ORDER CREATION DEBUG] Added nonce explicitly to data"); + } + + // Create order via AJAX to track failed payment attempt + jQuery.ajax({ + url: cko_flow_vars.ajax_url, + type: "POST", + data: { + action: "cko_flow_create_failed_order", + error_reason: "payment_request_declined", + error_message: finalErrorMessage, + ...formDataObj + }, + success: function(response) { + ckoLogger.error("[ORDER CREATION] AJAX Success Response:", response); + if (response.success && response.data && response.data.order_id) { + ckoLogger.error("[ORDER CREATION] ✅ Failed order created successfully - Order ID: " + response.data.order_id); + } else { + ckoLogger.error("[ORDER CREATION] ❌ Failed to create order for declined payment:", response); + } + }, + error: function(xhr, status, error) { + ckoLogger.error("[ORDER CREATION] ❌ AJAX Error:", error); + ckoLogger.error("[ORDER CREATION] ❌ Status:", status); + ckoLogger.error("[ORDER CREATION] ❌ XHR Response:", xhr.responseText); + ckoLogger.error("[ORDER CREATION] ❌ XHR Status Code:", xhr.status); + ckoLogger.error("[ORDER CREATION] ❌ XHR Response Headers:", xhr.getAllResponseHeaders()); + + // Try to parse response if available + if (xhr.responseText) { + try { + const responseData = JSON.parse(xhr.responseText); + ckoLogger.error("[ORDER CREATION] ❌ Parsed Response:", responseData); + } catch (e) { + ckoLogger.error("[ORDER CREATION] ❌ Response is not JSON:", xhr.responseText.substring(0, 500)); + } + } + } + }); + } else { + ckoLogger.error("[ORDER CREATION] ❌ Form not found - cannot create order"); + } + + // Clear the flag + window.ckoPlaceOrderClicked = false; + } else { + ckoLogger.error("[ORDER CREATION] ⚠️ Conditions not met - order NOT created"); + if (!isPaymentDeclined) { + ckoLogger.error("[ORDER CREATION] ⚠️ Reason: Payment not declined"); + } + if (!window.ckoPlaceOrderClicked) { + ckoLogger.error("[ORDER CREATION] ⚠️ Reason: Place Order not clicked"); + } + } + + // Log the error for debugging + ckoLogger.error("Flow component error:", { + component: component.type, + originalMessage: errorMessage, + userFriendlyMessage: userFriendlyMessage, + finalErrorMessage: finalErrorMessage, + isPaymentDeclined: isPaymentDeclined, + placeOrderClicked: window.ckoPlaceOrderClicked || false, + fullError: error + }); + }; + + // Debug: Log callback functions + ckoLogger.debug('Callback Functions:', { + onReady: typeof onReady, + onPaymentCompleted: typeof onPaymentCompleted, + onSubmit: typeof onSubmit, + onChange: typeof onChange, + handleClick: typeof handleClick, + onError: typeof onError + }); + + // Note: onPaymentCompleted is internal - not exposed globally for security + + // WORKAROUND: Add URL fields to paymentSession object based on environment + // This helps SDK construct correct URLs even if token is missing URL fields + // SDK might check these fields before/after decoding the token + const baseUrl = cko_flow_vars.env === 'sandbox' + ? 'https://api.sandbox.checkout.com' + : 'https://api.checkout.com'; + const cdnUrl = cko_flow_vars.env === 'sandbox' + ? 'https://cdn.sandbox.checkout.com' + : 'https://cdn.checkout.com'; + const devicesUrl = cko_flow_vars.env === 'sandbox' + ? 'https://devices.api.sandbox.checkout.com' + : 'https://devices.api.checkout.com'; + + // Add URL fields to paymentSession object (SDK might use these) + // Note: SDK decodes token internally, but might fall back to these if token URLs are missing + if (!paymentSession._urls) { + paymentSession._urls = { + api_url: baseUrl, + cdn_url: cdnUrl, + devices_url: devicesUrl, + base_url: baseUrl + }; + ckoLogger.debug('Added URL fields to paymentSession:', paymentSession._urls); + } + + // NOTE: We cannot pre-load risk.js manually because: + // 1. The SDK constructs the risk.js URL internally from the payment session token + // 2. The SDK decodes the token and extracts URLs (cdn_url, etc.) + // 3. If token is missing URL fields, SDK constructs incorrect URLs + // 4. We cannot modify the token without decoding it (which we're avoiding) + // 5. The SDK must load risk.js itself - we can't intercept or pre-load it + // + // SOLUTION: The payment session token MUST include URL fields (cdn_url, api_url, etc.) + // This is an API issue that needs to be fixed by Checkout.com + // + // We've added URL fields to paymentSession._urls as a fallback, but the SDK + // primarily uses URLs from the decoded token, so this may not help. + + const checkout = await CheckoutWebComponents({ + publicKey: cko_flow_vars.PKey, + environment: cko_flow_vars.env, + locale: window.locale, + paymentSession, + appearance: window.appearance, + componentOptions: window.componentOptions, + translations: window.translations, + onReady, + onPaymentCompleted, + onSubmit, + onChange, + handleClick, + onError + }); + + // Log SDK initialization (debug mode only) + ckoLogger.debug('SDK initialized:', { + hasCreate: typeof checkout.create === 'function', + paymentSessionId: paymentSession.id, + environment: cko_flow_vars.env + }); + + + // Ensure component name is defined + const componentName = window.componentName || 'flow'; + ckoLogger.debug('Creating Flow component with name:', componentName); + + let flowComponent; + try { + flowComponent = checkout.create(componentName, { + showPayButton: false, + }); + + ckoLogger.debug('Flow component created successfully:', { + componentName: componentName, + componentType: flowComponent.type + }); + } catch (error) { + ckoLogger.error('Error creating Flow component:', error); + showError('Failed to initialize payment component. Please try again.'); + return; + } + + // Performance: Track component creation + const componentInitEnd = performance.now(); + const componentInitDuration = componentInitEnd - componentInitStart; + if (ckoFlow.performanceMetrics.enableLogging) { + ckoLogger.performance(`Component initialized in ${componentInitDuration.toFixed(2)}ms (${(componentInitDuration / 1000).toFixed(2)}s)`); + } + + ckoFlow.flowComponent = flowComponent; + + /* + * Check if the component is available. Mount component only if available. + */ + flowComponent.isAvailable().then((available) => { + // Log component availability (debug mode only) + ckoLogger.debug('Component availability:', { + available: available, + componentType: flowComponent.type, + environment: cko_flow_vars.env + }); + + if (available) { + // Performance: Track component mount + const mountStart = performance.now(); + if (ckoFlow.performanceMetrics.enableLogging) { + ckoLogger.performance('Mounting component to DOM...'); + } + flowComponent.mount(document.getElementById("flow-container")); + const mountEnd = performance.now(); + if (ckoFlow.performanceMetrics.enableLogging) { + ckoLogger.performance(`Component mounted in ${(mountEnd - mountStart).toFixed(2)}ms`); + } + + // Mark Flow as initialized and clear guard flag now that component is mounted + ckoFlowInitialized = true; + ckoFlowInitializing = false; + + // ============================================================ + // SMOOTH CHECKOUT EXPERIENCE - Enable UI after mount + // ============================================================ + ckoLogger.debug('Component mounted - enabling UI! 🔥🔥🔥'); + + const skeleton = document.getElementById("flow-skeleton"); + const placeOrderBtn = document.getElementById("place_order"); + const saveCardCheckbox = document.querySelector('.cko-save-card-checkbox'); + + // Step 1: Hide skeleton loader + if (skeleton) { + skeleton.classList.remove("show"); + ckoLogger.debug('✓ Skeleton loader hidden'); + } + + // Step 2: Enable Place Order button + if (placeOrderBtn) { + placeOrderBtn.classList.remove("flow-loading"); + placeOrderBtn.style.removeProperty('opacity'); + placeOrderBtn.style.removeProperty('visibility'); + console.log('[FLOW] ✓ Place Order button enabled'); + } + + // Step 3: Hide save card checkbox initially + if (saveCardCheckbox) { + saveCardCheckbox.style.display = 'none'; + } else { + console.log('[FLOW] Mount - Save card checkbox not available (feature disabled)'); + } + + // Step 4: Mark Flow as ready + document.body.classList.add("flow-ready"); + console.log('[FLOW] ✓ Checkout is now fully interactive'); + + // CRITICAL: Listen for user interaction with Flow fields (click, focus, input) + // This detects when user actually starts using Flow (not just onChange firing on load) + setTimeout(() => { + const flowContainer = document.getElementById("flow-container"); + if (flowContainer) { + // Listen for any interaction with Flow component + flowContainer.addEventListener('click', function() { + if (!window.flowUserInteracted) { + console.log('[FLOW] User clicked on Flow component - marking as interacted'); + window.flowUserInteracted = true; + window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow + } + }, { once: false }); + + flowContainer.addEventListener('focus', function(e) { + if (!window.flowUserInteracted) { + console.log('[FLOW] User focused on Flow field - marking as interacted'); + window.flowUserInteracted = true; + window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow + } + }, { capture: true }); + + flowContainer.addEventListener('input', function(e) { + if (!window.flowUserInteracted) { + console.log('[FLOW] User typing in Flow field - marking as interacted'); + window.flowUserInteracted = true; + window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow + } + }, { capture: true }); + + console.log('[FLOW] Flow interaction listeners attached'); + } + }, 500); + + } else { + // Hide loading overlay. + hideLoadingOverlay(); + ckoLogger.error("Component is not available."); + console.error('[FLOW UI ERROR] Component is not available - showing error message'); + console.error('[FLOW UI ERROR] This is a CLIENT-SIDE (JavaScript) error'); + + showError( + wp.i18n.__( + "The selected payment method is not available at this time.", + "checkout-com-unified-payments-api" + ) + ); + } + }); + } + } catch (error) { + // Clear initialization guard flag on error + ckoFlowInitializing = false; + ckoFlowInitialized = false; + + // Hide loading overlay and skeleton. + hideLoadingOverlay(); + + const skeleton = document.getElementById("flow-skeleton"); + const placeOrderBtn = document.getElementById("place_order"); + + if (skeleton) { + skeleton.classList.remove("show"); + } + if (placeOrderBtn) { + placeOrderBtn.classList.remove("flow-loading"); + } + + ckoLogger.error("Error creating payment session:", error); + + showError( + error.message || + wp.i18n.__( + "Error creating payment session.", + "checkout-com-unified-payments-api" + ) + ); + } + }, +}; + +/* + * Displays error messages at the top of the WooCommerce form. + */ +let showError = function (error_message) { + ckoLogger.error("showError() called with message:", error_message); + + if (!error_message) { + ckoLogger.error("showError() called with empty/null message"); + return; + } + + if ("string" === typeof error_message) { + error_message = [error_message]; + } + + let ulWrapper = jQuery("
")
+ .addClass("woocommerce-NoticeGroup woocommerce-NoticeGroup-checkout")
+ .append(ulWrapper);
+
+ let scrollTarget;
+ let errorDisplayed = false;
+
+ // Try form.checkout first
+ if (jQuery("form.checkout").length) {
+ ckoLogger.error("showError() - Found form.checkout, displaying error");
+ jQuery("form.checkout .woocommerce-NoticeGroup").remove();
+ jQuery("form.checkout").prepend(wcNoticeDiv);
+ jQuery(".woocommerce, .form.checkout").removeClass("processing").unblock();
+ scrollTarget = jQuery("form.checkout");
+ errorDisplayed = true;
+ }
+ // Try .woocommerce-order-pay
+ else if (jQuery(".woocommerce-order-pay").length) {
+ ckoLogger.error("showError() - Found .woocommerce-order-pay, displaying error");
+ jQuery(".woocommerce-order-pay .woocommerce-NoticeGroup").remove();
+ jQuery(".woocommerce-order-pay").prepend(wcNoticeDiv);
+ jQuery(".woocommerce, .woocommerce-order-pay")
+ .removeClass("processing")
+ .unblock();
+ scrollTarget = jQuery(".woocommerce-order-pay");
+ errorDisplayed = true;
+ }
+ // Try .woocommerce-checkout (block theme)
+ else if (jQuery(".woocommerce-checkout").length) {
+ ckoLogger.error("showError() - Found .woocommerce-checkout, displaying error");
+ jQuery(".woocommerce-checkout .woocommerce-NoticeGroup").remove();
+ jQuery(".woocommerce-checkout").prepend(wcNoticeDiv);
+ jQuery(".woocommerce-checkout").removeClass("processing").unblock();
+ scrollTarget = jQuery(".woocommerce-checkout");
+ errorDisplayed = true;
+ }
+ // Fallback: Try to use WooCommerce's notice system
+ else if (typeof wc_add_to_notices === 'function') {
+ ckoLogger.error("showError() - Using WooCommerce notice system");
+ wc_add_to_notices(error_message, 'error');
+ errorDisplayed = true;
+ }
+ // Last resort: Display at top of body
+ else {
+ ckoLogger.error("showError() - No form found, displaying error at top of body");
+ jQuery("body").prepend(wcNoticeDiv);
+ errorDisplayed = true;
+ }
+
+ if (errorDisplayed) {
+ ckoLogger.error("showError() - Error displayed successfully");
+
+ // Store error message to persist through updated_checkout events
+ // WooCommerce's updated_checkout event replaces the form HTML, clearing our error
+ if (error_message && error_message.length > 0) {
+ window.ckoLastError = Array.isArray(error_message) ? error_message[0] : error_message;
+ ckoLogger.error("showError() - Stored error message for persistence:", window.ckoLastError);
+ }
+ } else {
+ ckoLogger.error("showError() - ERROR: Failed to display error message!");
+ }
+
+ // Scroll to top of checkout form or error message
+ if (scrollTarget && scrollTarget.length) {
+ jQuery("html, body").animate(
+ {
+ scrollTop: scrollTarget.offset().top - 100,
+ },
+ 1000
+ );
+ } else if (wcNoticeDiv.length) {
+ // Scroll to the error message itself
+ jQuery("html, body").animate(
+ {
+ scrollTop: wcNoticeDiv.offset().top - 100,
+ },
+ 1000
+ );
+ }
+};
+
+// Re-display error messages after WooCommerce's updated_checkout event
+// This ensures payment decline errors persist even when WooCommerce refreshes the checkout form
+jQuery(document.body).on('updated_checkout', function() {
+ if (window.ckoLastError) {
+ ckoLogger.error("updated_checkout fired - Re-displaying stored error:", window.ckoLastError);
+ // Use a small delay to ensure form is fully updated
+ setTimeout(function() {
+ showError(window.ckoLastError);
+ // Verify error is visible in DOM
+ setTimeout(function() {
+ const errorElement = jQuery("form.checkout .woocommerce-NoticeGroup, .woocommerce-order-pay .woocommerce-NoticeGroup, .woocommerce-checkout .woocommerce-NoticeGroup");
+ if (errorElement.length > 0) {
+ ckoLogger.error("Error element found in DOM:", errorElement.length, "elements");
+ // Make sure it's visible
+ errorElement.css('display', 'block').css('visibility', 'visible');
+ // Scroll to it
+ jQuery("html, body").animate({
+ scrollTop: errorElement.offset().top - 100
+ }, 500);
+ } else {
+ ckoLogger.error("ERROR: Error element NOT found in DOM after re-display!");
+ }
+ }, 200);
+ // Clear the stored error after displaying (user can dismiss it manually)
+ // Don't clear immediately - let it persist for a few seconds
+ setTimeout(function() {
+ window.ckoLastError = null;
+ ckoLogger.error("Cleared stored error message");
+ }, 5000);
+ }, 100);
+ }
+});
+
+/**
+ * Initialize Flow interaction tracking flag
+ * This flag tracks whether the user has actively interacted with the Flow component
+ * to differentiate between saved card payments and new Flow payments
+ */
+window.flowUserInteracted = false;
+
+/**
+ * Initializes the observer to monitor the presence of the Flow checkout component in the DOM.
+ *
+ * - Sets the `ckoFlowInitialized` flag to `false` on page load.
+ * - Observes the DOM for any changes using `MutationObserver`.
+ * - If the Flow checkout component (identified by `data-testid="checkout-web-component-root"`)
+ * is removed from the DOM, the flag `ckoFlowInitialized` is reset to `false`.
+ *
+ * This helps ensure that the Flow component can be re-initialized when needed.
+ */
+
+let ckoFlowInitialized = false;
+let ckoFlowInitializing = false; // Guard flag to prevent multiple simultaneous initializations
+let ckoOrderCreationInProgress = false; // Guard flag to prevent multiple simultaneous order creation calls
+
+// Note: Early 3DS detection is now at the top of the file (right after ckoLogger definition)
+// This ensures it runs before any other code that might initialize Flow
+
+document.addEventListener("DOMContentLoaded", function () {
+ // CRITICAL: Check for 3DS return FIRST - before any other checks
+ // Check flag first (set by early detection)
+ if (window.ckoFlow3DSReturn) {
+ console.log('[FLOW 3DS] ⚠️ DOMContentLoaded: Blocked by 3DS return flag');
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.threeDS('DOMContentLoaded: 3DS return in progress, skipping all Flow initialization');
+ }
+ return;
+ }
+
+ // Also check URL parameters directly as fallback (in case early detection didn't run)
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ console.log('[FLOW 3DS] ⚠️ DOMContentLoaded: Blocked by 3DS return URL parameters', {
+ paymentId: paymentId,
+ sessionId: sessionId,
+ paymentSessionId: paymentSessionId
+ });
+ window.ckoFlow3DSReturn = true;
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.threeDS('DOMContentLoaded: 3DS return detected in URL, skipping all Flow initialization');
+ }
+ return;
+ }
+
+ // Track page load time for performance metrics
+ ckoFlow.performanceMetrics.pageLoadTime = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance('Page DOMContentLoaded at:', ckoFlow.performanceMetrics.pageLoadTime.toFixed(2) + 'ms');
+ }
+
+ const element = document.querySelector(
+ '[data-testid="checkout-web-component-root"]'
+ );
+ ckoFlowInitialized = false;
+
+ const observer = new MutationObserver(() => {
+ const element = document.querySelector(
+ '[data-testid="checkout-web-component-root"]'
+ );
+
+ // If the element is not present, update ckoFlowInitialized.
+ if (!element) {
+ ckoFlowInitialized = false;
+ }
+ });
+
+ // Observe the entire document for any changes in the DOM.
+ observer.observe(document.body, {
+ childList: true,
+ subtree: true,
+ });
+});
+
+/*
+ * Listens to changes in the payment method radio buttons
+ * and initializes the Flow payment method if selected.
+ *
+ * This function handles the logic for showing or hiding the Flow payment container
+ * and initializing the Flow checkout component when the Flow payment method is selected.
+ * It also manages the visibility of saved payment methods and ensures the Flow component is
+ * initialized when needed.
+ */
+/**
+ * Validation Helper Functions
+ * These functions check if Flow can be initialized based on required fields
+ */
+
+/**
+ * Check if user is logged in
+ * @returns {boolean}
+ */
+function isUserLoggedIn() {
+ return cko_flow_vars.is_user_logged_in === true ||
+ cko_flow_vars.is_user_logged_in === "1" ||
+ cko_flow_vars.is_user_logged_in === 1 ||
+ document.querySelector('.woocommerce-form-login') === null;
+}
+
+/**
+ * Get checkout field value by ID
+ * @param {string} fieldId - Field ID
+ * @returns {string|null}
+ */
+function getCheckoutFieldValue(fieldId) {
+ const el = document.getElementById(fieldId);
+ return el && el.value ? el.value.trim() : null;
+}
+
+/**
+ * Validate email format
+ * @param {string} email - Email address
+ * @returns {boolean}
+ */
+function isValidEmail(email) {
+ if (!email) return false;
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ return emailRegex.test(email);
+}
+
+/**
+ * Check if postcode is required for a country
+ * @param {string} country - Country code
+ * @returns {boolean}
+ */
+function isPostcodeRequiredForCountry(country) {
+ if (!country) return true; // Default to required if unknown
+ // Countries that don't require postcode
+ const noPostcodeCountries = ['AE', 'AO', 'AG', 'AW', 'BS', 'BZ', 'BJ', 'BW', 'BF', 'BI', 'CM', 'CF', 'KM', 'CG', 'CD', 'CK', 'CI', 'DJ', 'DM', 'GQ', 'ER', 'FJ', 'TF', 'GM', 'GH', 'GD', 'GN', 'GY', 'HK', 'IE', 'JM', 'KE', 'KI', 'LS', 'LR', 'MW', 'ML', 'MR', 'MU', 'MS', 'NR', 'NU', 'KP', 'PA', 'QA', 'RW', 'KN', 'LC', 'ST', 'SC', 'SL', 'SB', 'SO', 'SR', 'SZ', 'TJ', 'TZ', 'TL', 'TG', 'TO', 'TT', 'TV', 'UG', 'VU', 'YE', 'ZW'];
+ return !noPostcodeCountries.includes(country.toUpperCase());
+}
+
+/**
+ * Check if billing address is present
+ * For order-pay pages, checks order data first (cartInfo), then falls back to form fields
+ * @returns {boolean}
+ */
+function hasBillingAddress() {
+ // Check if we're on order-pay page and have order data
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ let orderPayInfo = null;
+ if (isOrderPayPage) {
+ orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ }
+
+ // If order-pay page and order data exists, use it for validation
+ if (isOrderPayPage && orderPayInfo && orderPayInfo.billing_address) {
+ const billing = orderPayInfo.billing_address;
+ const email = billing.email || billing.Email || '';
+ const address1 = billing.street_address || billing.address_line1 || '';
+ const city = billing.city || '';
+ const country = billing.country || '';
+
+ if (email && address1 && city && country) {
+ ckoLogger.debug('hasBillingAddress: Using order data (order-pay page)', {
+ email: email ? 'SET' : 'EMPTY',
+ address1: address1 ? 'SET' : 'EMPTY',
+ city: city ? 'SET' : 'EMPTY',
+ country: country ? 'SET' : 'EMPTY'
+ });
+ return true;
+ }
+ }
+
+ // Fallback to form fields (regular checkout or if order data not available)
+ const email = getCheckoutFieldValue("billing_email");
+ const address1 = getCheckoutFieldValue("billing_address_1");
+ const city = getCheckoutFieldValue("billing_city");
+ const country = getCheckoutFieldValue("billing_country");
+
+ return !!(email && address1 && city && country);
+}
+
+/**
+ * Check if billing address is complete
+ * For order-pay pages, checks order data first (cartInfo), then falls back to form fields
+ * @returns {boolean}
+ */
+function hasCompleteBillingAddress() {
+ // Check if we're on order-pay page and have order data
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ let orderPayInfo = null;
+ if (isOrderPayPage) {
+ orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ }
+
+ // If order-pay page and order data exists, use it for validation
+ if (isOrderPayPage && orderPayInfo && orderPayInfo.billing_address) {
+ const billing = orderPayInfo.billing_address;
+ const address1 = billing.street_address || billing.address_line1 || '';
+ const city = billing.city || '';
+ const country = billing.country || '';
+ const postcode = billing.postal_code || billing.postcode || '';
+
+ if (!address1 || !city || !country) {
+ return false;
+ }
+
+ // Check if postcode is required for country
+ const postcodeRequired = isPostcodeRequiredForCountry(country);
+ if (postcodeRequired && !postcode) {
+ return false;
+ }
+
+ return true;
+ }
+
+ // Fallback to form fields (regular checkout or if order data not available)
+ const address1 = getCheckoutFieldValue("billing_address_1");
+ const city = getCheckoutFieldValue("billing_city");
+ const country = getCheckoutFieldValue("billing_country");
+ const postcode = getCheckoutFieldValue("billing_postcode");
+
+ if (!address1 || !city || !country) {
+ return false;
+ }
+
+ // Check if postcode is required for country
+ const postcodeRequired = isPostcodeRequiredForCountry(country);
+ if (postcodeRequired && !postcode) {
+ return false;
+ }
+
+ return true;
+}
+
+/**
+ * Enhanced required fields check with email validation
+ * For order-pay pages, checks order data first (cartInfo), then falls back to form fields
+ * @returns {boolean}
+ */
+function requiredFieldsFilledAndValid() {
+ // Check if we're on order-pay page and have order data
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ let orderPayInfo = null;
+ if (isOrderPayPage) {
+ orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ }
+
+ // If order-pay page and order data exists, use it for validation
+ if (isOrderPayPage && orderPayInfo && orderPayInfo.billing_address) {
+ const billing = orderPayInfo.billing_address;
+ const email = billing.email || billing.Email || '';
+ const address1 = billing.street_address || billing.address_line1 || '';
+ const city = billing.city || '';
+ const country = billing.country || '';
+ const postcode = billing.postal_code || billing.postcode || '';
+
+ // Check if all required fields are filled
+ if (!email || !address1 || !city || !country) {
+ ckoLogger.debug('requiredFieldsFilledAndValid: Order data missing required fields', {
+ email: email ? 'SET' : 'EMPTY',
+ address1: address1 ? 'SET' : 'EMPTY',
+ city: city ? 'SET' : 'EMPTY',
+ country: country ? 'SET' : 'EMPTY'
+ });
+ return false;
+ }
+
+ // Validate email format
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ if (!emailRegex.test(email.trim())) {
+ ckoLogger.debug('requiredFieldsFilledAndValid: Order data email invalid', { email: email });
+ return false;
+ }
+
+ // Check postcode if required for country
+ const postcodeRequired = isPostcodeRequiredForCountry(country);
+ if (postcodeRequired && !postcode) {
+ ckoLogger.debug('requiredFieldsFilledAndValid: Order data missing postcode for country', { country: country });
+ return false;
+ }
+
+ ckoLogger.debug('requiredFieldsFilledAndValid: Order data validation passed (order-pay page)', {
+ email: email ? 'SET' : 'EMPTY',
+ address1: address1 ? 'SET' : 'EMPTY',
+ city: city ? 'SET' : 'EMPTY',
+ country: country ? 'SET' : 'EMPTY',
+ postcode: postcode ? 'SET' : 'EMPTY'
+ });
+ return true;
+ }
+
+ // Fallback to form fields (regular checkout or if order data not available)
+ // First check if all required fields are filled
+ ckoLogger.debug('requiredFieldsFilledAndValid: Calling requiredFieldsFilled()...');
+ const fieldsFilled = requiredFieldsFilled();
+ ckoLogger.debug('requiredFieldsFilledAndValid: requiredFieldsFilled() returned:', fieldsFilled);
+ if (!fieldsFilled) {
+ ckoLogger.debug('requiredFieldsFilledAndValid: requiredFieldsFilled() returned false - fields not filled');
+ return false;
+ }
+
+ // Validate email format
+ const email = getCheckoutFieldValue("billing_email");
+ if (!email || !isValidEmail(email)) {
+ return false;
+ }
+
+ // Check billing address is complete
+ if (!hasCompleteBillingAddress()) {
+ return false;
+ }
+
+ return true;
+}
+
+/**
+ * Check if Flow can be initialized
+ * Validates all requirements before allowing Flow initialization
+ * @returns {boolean}
+ */
+function canInitializeFlow() {
+ // Check if Flow payment method is selected
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (!flowPayment || !flowPayment.checked) {
+ ckoLogger.debug('canInitializeFlow: Flow payment method not selected');
+ return false;
+ }
+
+ // Check if container exists
+ const flowContainer = document.getElementById("flow-container");
+ if (!flowContainer) {
+ ckoLogger.debug('canInitializeFlow: Flow container not found');
+ return false;
+ }
+
+ // Check if already initialized
+ if (ckoFlowInitialized && ckoFlow.flowComponent) {
+ ckoLogger.debug('canInitializeFlow: Already initialized');
+ return true; // Already initialized
+ }
+
+ // Check cart has items
+ // Note: cart_total might not be available in cko_flow_vars
+ // If we're on checkout page, WooCommerce ensures cart has items (redirects empty carts)
+ // So we can skip strict cart validation and let the API handle it if cart is truly empty
+ const cartTotal = cko_flow_vars?.cart_total ? parseFloat(cko_flow_vars.cart_total) : null;
+ const isOnCheckoutPage = window.location.pathname.includes('/checkout') || window.location.pathname.includes('/order-pay/');
+
+ if (cartTotal !== null && cartTotal <= 0 && !isOnCheckoutPage) {
+ ckoLogger.debug('canInitializeFlow: Cart is empty', {
+ cartTotal: cartTotal,
+ isOnCheckoutPage: isOnCheckoutPage
+ });
+ return false;
+ }
+
+ // If cart_total not available but we're on checkout page, assume cart has items
+ if (cartTotal === null && isOnCheckoutPage) {
+ ckoLogger.debug('canInitializeFlow: cart_total not available, but on checkout page - assuming cart has items');
+ }
+
+ // Check if user is logged in
+ const userLoggedIn = isUserLoggedIn();
+
+ // Check if we're on order-pay page (special handling)
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ let orderPayInfo = null;
+ if (isOrderPayPage) {
+ orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ }
+
+ ckoLogger.debug('canInitializeFlow: User status', {
+ isLoggedIn: userLoggedIn,
+ isOrderPayPage: isOrderPayPage,
+ hasOrderData: !!orderPayInfo,
+ hasBillingAddress: !!(orderPayInfo && orderPayInfo.billing_address)
+ });
+
+ if (userLoggedIn) {
+ // Logged-in users can initialize if billing address exists
+ // But still check if address is filled (user might have cleared it)
+ // On order-pay pages, hasBillingAddress() now checks order data first
+ const hasAddress = hasBillingAddress();
+ ckoLogger.debug('canInitializeFlow: Logged-in user address check', {
+ hasAddress: hasAddress,
+ isOrderPayPage: isOrderPayPage,
+ usingOrderData: !!(isOrderPayPage && orderPayInfo && orderPayInfo.billing_address)
+ });
+ if (hasAddress) {
+ return true;
+ }
+ // Address was cleared - wait for user to fill it
+ ckoLogger.debug('Cannot initialize Flow - logged-in user but billing address not filled');
+ return false;
+ }
+
+ // Guest users: Check ALL required fields are filled and valid
+ // On order-pay pages, requiredFieldsFilledAndValid() now checks order data first
+ const requiredFilled = requiredFieldsFilled();
+ const requiredValid = requiredFieldsFilledAndValid();
+
+ // Get field values for logging (prefer order data on order-pay pages)
+ let email, address1, city, country;
+ if (isOrderPayPage && orderPayInfo && orderPayInfo.billing_address) {
+ const billing = orderPayInfo.billing_address;
+ email = billing.email || billing.Email || '';
+ address1 = billing.street_address || billing.address_line1 || '';
+ city = billing.city || '';
+ country = billing.country || '';
+ } else {
+ email = getCheckoutFieldValue("billing_email");
+ address1 = getCheckoutFieldValue("billing_address_1");
+ city = getCheckoutFieldValue("billing_city");
+ country = getCheckoutFieldValue("billing_country");
+ }
+
+ // DETAILED LOGGING: Log each field individually
+ const emailField = document.getElementById("billing_email");
+ const addressField = document.getElementById("billing_address_1");
+ const cityField = document.getElementById("billing_city");
+ const countryField = document.getElementById("billing_country");
+ const postcodeField = document.getElementById("billing_postcode");
+
+ ckoLogger.debug('===== canInitializeFlow: Guest user validation DETAILED =====');
+ ckoLogger.debug('Field-by-field analysis:', {
+ email: {
+ fieldExists: !!emailField,
+ value: email || 'EMPTY',
+ rawValue: emailField?.value || 'EMPTY',
+ disabled: emailField?.disabled || false,
+ display: emailField?.style.display || 'default',
+ offsetParent: !!emailField?.offsetParent,
+ valid: email && isValidEmail(email)
+ },
+ address1: {
+ fieldExists: !!addressField,
+ value: address1 || 'EMPTY',
+ rawValue: addressField?.value || 'EMPTY',
+ disabled: addressField?.disabled || false,
+ display: addressField?.style.display || 'default',
+ offsetParent: !!addressField?.offsetParent
+ },
+ city: {
+ fieldExists: !!cityField,
+ value: city || 'EMPTY',
+ rawValue: cityField?.value || 'EMPTY',
+ disabled: cityField?.disabled || false,
+ display: cityField?.style.display || 'default',
+ offsetParent: !!cityField?.offsetParent
+ },
+ country: {
+ fieldExists: !!countryField,
+ value: country || 'EMPTY',
+ rawValue: countryField?.value || 'EMPTY',
+ disabled: countryField?.disabled || false,
+ display: countryField?.style.display || 'default',
+ offsetParent: !!countryField?.offsetParent
+ },
+ postcode: {
+ fieldExists: !!postcodeField,
+ value: getCheckoutFieldValue("billing_postcode") || 'EMPTY',
+ rawValue: postcodeField?.value || 'EMPTY',
+ disabled: postcodeField?.disabled || false,
+ display: postcodeField?.style.display || 'default',
+ offsetParent: !!postcodeField?.offsetParent
+ }
+ });
+
+ ckoLogger.debug('Validation results:', {
+ requiredFilled: requiredFilled,
+ requiredValid: requiredValid,
+ isOrderPayPage: isOrderPayPage,
+ usingOrderData: !!(isOrderPayPage && orderPayInfo && orderPayInfo.billing_address),
+ email: email ? 'SET' : 'EMPTY',
+ address1: address1 ? 'SET' : 'EMPTY',
+ city: city ? 'SET' : 'EMPTY',
+ country: country ? 'SET' : 'EMPTY',
+ hasBillingAddress: hasBillingAddress(),
+ hasCompleteBillingAddress: hasCompleteBillingAddress()
+ });
+
+ // Additional validation: Check email format and billing address
+ // This function now checks order data first on order-pay pages
+ if (!requiredFieldsFilledAndValid()) {
+ ckoLogger.debug('Cannot initialize Flow - required fields not filled or invalid');
+ return false;
+ }
+
+ ckoLogger.debug('canInitializeFlow: All checks passed - Flow can initialize');
+ return true;
+}
+
+/**
+ * Show waiting message in Flow container
+ */
+function showFlowWaitingMessage() {
+ let flowContainer = document.getElementById("flow-container");
+
+ // If container doesn't exist, try to create it or find the payment method container
+ if (!flowContainer) {
+ // Try to find the payment method container
+ const paymentContainer = document.querySelector(".payment_method_wc_checkout_com_flow");
+ if (paymentContainer) {
+ // Find or create the payment_box div
+ let paymentBox = paymentContainer.querySelector("div.payment_box");
+ if (!paymentBox) {
+ // Create payment_box if it doesn't exist
+ paymentBox = document.createElement('div');
+ paymentBox.className = 'payment_box';
+ paymentContainer.appendChild(paymentBox);
+ }
+
+ // Set the id if not already set
+ if (!paymentBox.id) {
+ paymentBox.id = "flow-container";
+ paymentBox.style.padding = "0";
+ }
+
+ flowContainer = paymentBox;
+ } else {
+ // Payment method container not found - can't show message
+ ckoLogger.debug('Cannot show Flow waiting message - payment method container not found');
+ return;
+ }
+ }
+
+ // Show container but with waiting message
+ flowContainer.style.display = "block";
+
+ // Check if waiting message already exists
+ let waitingMessage = flowContainer.querySelector('.flow-waiting-message');
+ if (!waitingMessage) {
+ waitingMessage = document.createElement('div');
+ waitingMessage.className = 'flow-waiting-message';
+ waitingMessage.innerHTML = `
+ } Order ID if successful, null if failed
+ */
+ async function createOrderBeforePayment() {
+ // CRITICAL: Prevent multiple simultaneous order creation calls (race condition protection)
+ if (ckoOrderCreationInProgress) {
+ ckoLogger.warn('[CREATE ORDER] ⚠️ Order creation already in progress - preventing duplicate call');
+ // Wait a bit and check if order was created
+ await new Promise(resolve => setTimeout(resolve, 500));
+ const orderIdField = jQuery('input[name="order_id"]');
+ if (orderIdField.length && orderIdField.val()) {
+ const existingOrderId = orderIdField.val();
+ ckoLogger.debug('[CREATE ORDER] Order was created by previous call - Order ID: ' + existingOrderId);
+ return parseInt(existingOrderId);
+ }
+ // If still in progress after wait, return null to prevent duplicate
+ if (ckoOrderCreationInProgress) {
+ ckoLogger.error('[CREATE ORDER] ❌ Order creation still in progress after wait - aborting duplicate call');
+ return null;
+ }
+ }
+
+ // Set lock flag to prevent multiple simultaneous calls
+ ckoOrderCreationInProgress = true;
+
+ // Disable place order button to prevent multiple clicks
+ const placeOrderButton = jQuery('#place_order');
+ const originalButtonText = placeOrderButton.length ? placeOrderButton.text() : '';
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', true);
+ placeOrderButton.addClass('processing');
+ if (placeOrderButton.text().trim() !== '') {
+ placeOrderButton.data('original-text', placeOrderButton.text());
+ placeOrderButton.text('Processing...');
+ }
+ ckoLogger.debug('[CREATE ORDER] Place Order button disabled to prevent multiple clicks');
+ }
+
+ try {
+ // Check if order already exists (for order-pay page) - check BEFORE form lookup
+ const orderIdField = jQuery('input[name="order_id"]');
+ if (orderIdField.length && orderIdField.val()) {
+ const existingOrderId = orderIdField.val();
+ ckoLogger.debug('[CREATE ORDER] Order already exists (order-pay page) - Order ID: ' + existingOrderId);
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return parseInt(existingOrderId);
+ }
+
+ // Try to find form - checkout form or order-pay form
+ let form = jQuery("form.checkout");
+ if (!form.length) {
+ // Try order-pay form (form#order_review)
+ form = jQuery("form#order_review");
+ if (form.length) {
+ ckoLogger.debug('[CREATE ORDER] Found order-pay form (form#order_review)');
+ }
+ }
+
+ if (!form.length) {
+ ckoLogger.debug('[CREATE ORDER] No checkout form or order-pay form found - skipping order creation');
+ // For order-pay pages, order already exists, so return order ID from URL
+ if (window.location.pathname.includes('/order-pay/')) {
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ if (pathMatch && pathMatch[1]) {
+ const orderId = parseInt(pathMatch[1]);
+ ckoLogger.debug('[CREATE ORDER] Order-pay page detected - using order ID from URL: ' + orderId);
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return orderId;
+ }
+ }
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return null;
+ }
+
+ ckoLogger.debug('[CREATE ORDER] Creating order before payment processing...');
+
+ // Get form data
+ const formData = form.serialize();
+ const formDataObj = Object.fromEntries(new URLSearchParams(formData));
+
+ // Get nonce from form or page
+ let nonceValue = '';
+ const nonceField = jQuery('input[name="woocommerce-process-checkout-nonce"]');
+ if (nonceField.length > 0) {
+ nonceValue = nonceField.val();
+ }
+
+ // Fallback: Try to get nonce from form data
+ if (!nonceValue && formDataObj['woocommerce-process-checkout-nonce']) {
+ nonceValue = formDataObj['woocommerce-process-checkout-nonce'];
+ }
+
+ // Fallback: Try to get from meta tag or other sources
+ if (!nonceValue) {
+ const metaNonce = jQuery('meta[name="woocommerce-process-checkout-nonce"]');
+ if (metaNonce.length > 0) {
+ nonceValue = metaNonce.attr('content');
+ }
+ }
+
+ // For order-pay pages, order already exists, so we don't need to create it
+ // Just return the order ID from URL if nonce is missing
+ if (!nonceValue) {
+ if (window.location.pathname.includes('/order-pay/')) {
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ if (pathMatch && pathMatch[1]) {
+ const orderId = parseInt(pathMatch[1]);
+ ckoLogger.debug('[CREATE ORDER] Order-pay page - nonce missing but order exists, using order ID from URL: ' + orderId);
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return orderId;
+ }
+ }
+ ckoLogger.error('[CREATE ORDER] ERROR: Nonce not found in form or page');
+ ckoLogger.error('[CREATE ORDER] Form data keys:', Object.keys(formDataObj));
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return null;
+ }
+
+ ckoLogger.debug('[CREATE ORDER] Nonce found:', nonceValue.substring(0, 10) + '...');
+
+ // Ensure nonce is included in form data
+ formDataObj['woocommerce-process-checkout-nonce'] = nonceValue;
+
+ // Get payment session ID if available
+ const paymentSessionIdField = jQuery('input[name="cko-flow-payment-session-id"]');
+ const paymentSessionId = paymentSessionIdField.length > 0 ? paymentSessionIdField.val() : '';
+
+ // Get save card preference
+ const saveCardField = jQuery('input[name="cko-flow-save-card-persist"]');
+ const saveCardValue = saveCardField.length > 0 ? saveCardField.val() : '';
+
+ // Build data object ensuring nonce is included
+ const ajaxData = {
+ action: "cko_flow_create_order",
+ 'cko-flow-payment-session-id': paymentSessionId,
+ 'cko-flow-save-card-persist': saveCardValue
+ };
+
+ // Add all form data (including nonce)
+ Object.assign(ajaxData, formDataObj);
+
+ // Ensure nonce is explicitly included
+ if (nonceValue && !ajaxData['woocommerce-process-checkout-nonce']) {
+ ajaxData['woocommerce-process-checkout-nonce'] = nonceValue;
+ ckoLogger.debug('[CREATE ORDER] Explicitly added nonce to AJAX data');
+ }
+
+ ckoLogger.debug('[CREATE ORDER] AJAX data keys:', Object.keys(ajaxData));
+ ckoLogger.debug('[CREATE ORDER] Nonce in data:', !!ajaxData['woocommerce-process-checkout-nonce']);
+
+ const response = await jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: "POST",
+ data: ajaxData
+ }).fail(function(xhr, status, error) {
+ ckoLogger.error('[CREATE ORDER] ❌ AJAX Request Failed');
+ ckoLogger.error('[CREATE ORDER] Status:', status);
+ ckoLogger.error('[CREATE ORDER] Error:', error);
+ ckoLogger.error('[CREATE ORDER] Response Text:', xhr.responseText);
+ ckoLogger.error('[CREATE ORDER] Status Code:', xhr.status);
+ ckoLogger.error('[CREATE ORDER] Request Data:', ajaxData);
+ });
+
+ ckoLogger.debug('[CREATE ORDER] ========== PROCESSING AJAX RESPONSE ==========');
+ ckoLogger.debug('[CREATE ORDER] Response received:', response);
+ ckoLogger.debug('[CREATE ORDER] Response.success:', response?.success);
+ ckoLogger.debug('[CREATE ORDER] Response.data:', response?.data);
+ ckoLogger.debug('[CREATE ORDER] Response.data.order_id:', response?.data?.order_id);
+
+ if (response && response.success && response.data && response.data.order_id) {
+ const orderId = response.data.order_id;
+ ckoLogger.debug('[CREATE ORDER] ========== ORDER CREATED SUCCESSFULLY ==========');
+ ckoLogger.debug('[CREATE ORDER] ✅✅✅ Order created successfully - Order ID: ' + orderId + ' ✅✅✅');
+ ckoLogger.debug('[CREATE ORDER] Order ID type:', typeof orderId);
+ ckoLogger.debug('[CREATE ORDER] Order ID value:', orderId);
+
+ // Store order ID in form for process_payment()
+ if (!orderIdField.length) {
+ form.append('');
+ } else {
+ orderIdField.val(orderId);
+ }
+
+ // Store in session for fallback
+ sessionStorage.setItem('cko_flow_order_id', orderId);
+
+ // Clear lock flag on success
+ ckoOrderCreationInProgress = false;
+
+ // Re-enable place order button
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+
+ return parseInt(orderId);
+ } else {
+ // Check if this is a validation error
+ ckoLogger.error('[CREATE ORDER] ========== ORDER CREATION FAILED ==========');
+ ckoLogger.error('[CREATE ORDER] Response received:', response);
+ ckoLogger.error('[CREATE ORDER] Response type:', typeof response);
+ ckoLogger.error('[CREATE ORDER] Response.success:', response?.success);
+ ckoLogger.error('[CREATE ORDER] Response.data:', response?.data);
+
+ if (response && response.data && response.data.message) {
+ ckoLogger.error('[CREATE ORDER] ❌❌❌ VALIDATION FAILED - ORDER NOT CREATED ❌❌❌');
+ ckoLogger.error('[CREATE ORDER] Error message:', response.data.message);
+ ckoLogger.error('[CREATE ORDER] This is a validation error - order was NOT created');
+ showError(response.data.message);
+ } else {
+ ckoLogger.error('[CREATE ORDER] ❌❌❌ FAILED TO CREATE ORDER ❌❌❌');
+ ckoLogger.error('[CREATE ORDER] Full response:', JSON.stringify(response, null, 2));
+ ckoLogger.error('[CREATE ORDER] Order creation failed for unknown reason');
+ showError('Failed to create order. Please check your form and try again.');
+ }
+
+ // Clear lock flag on failure
+ ckoOrderCreationInProgress = false;
+
+ // Re-enable place order button on failure
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+
+ return null;
+ }
+ } catch (error) {
+ ckoLogger.error('[CREATE ORDER] ❌ AJAX Error:', error);
+
+ // Clear lock flag on error
+ ckoOrderCreationInProgress = false;
+
+ // Re-enable place order button on error
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+
+ return null;
+ } finally {
+ // Ensure lock flag is cleared even if something unexpected happens
+ // This is a safety net - the flag should already be cleared in success/error handlers
+ if (ckoOrderCreationInProgress) {
+ ckoLogger.warn('[CREATE ORDER] ⚠️ Lock flag still set in finally block - clearing it');
+ ckoOrderCreationInProgress = false;
+
+ // Re-enable button as safety measure
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ }
+ }
+ }
+
+ document.addEventListener("click", function (event) {
+ const flowPayment = document.getElementById(
+ "payment_method_wc_checkout_com_flow"
+ );
+
+ // If the Place Order button is clicked, proceed.
+ if (event.target && event.target.id === "place_order") {
+ // CRITICAL: Prevent multiple clicks if order creation is already in progress
+ if (ckoOrderCreationInProgress) {
+ ckoLogger.warn('[PLACE ORDER] ⚠️ Order creation already in progress - ignoring duplicate click');
+ event.preventDefault();
+ return;
+ }
+
+ // Track that Place Order was clicked (for order creation on payment decline)
+ window.ckoPlaceOrderClicked = true;
+ ckoLogger.debug("Place Order button clicked - tracking for order creation on payment decline");
+
+ // If the Flow payment method is selected, proceed with validation and order placement.
+ if (flowPayment && flowPayment.checked) {
+ event.preventDefault();
+
+ // Check if saved card is selected BEFORE creating order
+ // For saved card payments, WooCommerce will create order on form submission
+ // So we should NOT create order via AJAX to prevent duplicates
+ // Check if saved card is selected (only by property - no defaults anymore)
+ let selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ let savedCardSelected = selectedSavedCard.length > 0;
+ let savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]')?.classList.contains('saved-card-is-enabled') || false;
+
+ if (savedCardSelected || savedCardEnabled) {
+ ckoLogger.debug('[CREATE ORDER] Saved card selected - bypassing Flow component (direct API call via WooCommerce)');
+ // For saved cards, let WooCommerce handle order creation and payment via direct API call
+ // Flow component is NOT used for saved cards - payment is processed server-side via API
+ const form = jQuery("form.checkout");
+
+ // Handle payment for order-pay page.
+ if (form.length === 0) {
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+ const orderPayForm = jQuery('form#order_review');
+
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+ // CRITICAL: Ensure payment session ID is in form before submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+ // Submit directly - no Flow component needed for saved cards
+ ckoLogger.debug('[SAVED CARD] Submitting order-pay form directly (bypassing Flow component)');
+ orderPayForm.submit();
+ }
+ } else {
+ // For saved cards, submit form directly to WooCommerce
+ // WooCommerce will call process_payment() which makes direct API call
+ // No Flow component validation needed
+ ckoLogger.debug('[SAVED CARD] Submitting checkout form directly (bypassing Flow component)');
+
+ // CRITICAL: Ensure payment session ID is in form before submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+ // Submit directly - no validateCheckout needed for saved cards
+ form.submit();
+ }
+ return; // Exit early - don't create order via AJAX, don't use Flow component
+ }
+
+ // CRITICAL: Validate checkout form FIRST before creating order
+ // This ensures orders are only created when form is valid
+ const form = jQuery("form.checkout");
+
+ // Handle payment for order-pay page (order already exists, skip validation)
+ if ( form.length === 0 ) {
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+ const orderPayForm = jQuery('form#order_review');
+
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+ // Order-pay page: Order already exists, proceed with payment processing
+ document.getElementById("flow-container").style.display = "block";
+
+ // Place order for FLOW.
+ if (ckoFlow.flowComponent) {
+ // Check if a saved card is actually selected (only by property - no defaults anymore)
+ // Re-check saved card status (may have changed)
+ selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ savedCardSelected = selectedSavedCard.length > 0;
+ savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]')?.classList.contains('saved-card-is-enabled') || false;
+
+ // ALWAYS persist save card checkbox on order-pay page (for new card payments)
+ if (!savedCardSelected) {
+ persistSaveCardCheckbox();
+ console.log('[FLOW] Order-pay: Persisted save card checkbox for new card payment');
+ }
+
+ if( savedCardSelected || savedCardEnabled ) {
+ ckoLogger.debug('[SAVED CARD] Saved card selected - submitting order-pay form directly (bypassing Flow component)');
+ // CRITICAL: Ensure payment session ID is in form before submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+ // Submit directly - Flow component NOT used for saved cards
+ orderPayForm.submit();
+ } else {
+ // CRITICAL: Ensure payment session ID is in form before Flow component submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+
+ // Check if component is valid before submitting
+ // Note: isValid() returns a boolean, not a Promise
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.isValid === 'function') {
+ const isValid = ckoFlow.flowComponent.isValid();
+ if (isValid) {
+ ckoLogger.debug('Flow component is valid, submitting...');
+ try {
+ ckoFlow.flowComponent.submit();
+ } catch (error) {
+ ckoLogger.error('Flow component submit failed:', error);
+ showError('Payment processing failed. Please try again.');
+ }
+ } else {
+ ckoLogger.error('Flow component is invalid, cannot submit');
+ showError('Payment form is not valid. Please check your payment details and try again.');
+ }
+ } else {
+ // Fallback: submit without validation check
+ ckoLogger.debug('Flow component validity check not available, submitting directly...');
+ try {
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.submit === 'function') {
+ ckoFlow.flowComponent.submit();
+ } else {
+ ckoLogger.error('Flow component submit method not available');
+ showError('Payment component not ready. Please refresh the page and try again.');
+ }
+ } catch (error) {
+ ckoLogger.error('Flow component submit failed (fallback):', error);
+ showError('Payment processing failed. Please try again.');
+ }
+ }
+ }
+ } else {
+ // No flow component - submit order-pay form for saved card
+ orderPayForm.submit();
+ }
+ }
+ return; // Exit early for order-pay page
+ }
+
+ // Regular checkout: Check Flow component validity BEFORE creating order
+ // This prevents creating orders when payment form is invalid
+ ckoLogger.debug('[VALIDATION] Checking Flow component validity before order creation...');
+
+ // Check if saved card is selected (saved cards don't need Flow component validation)
+ // Re-check saved card status (may have changed)
+ selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ savedCardSelected = selectedSavedCard.length > 0;
+ savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]')?.classList.contains('saved-card-is-enabled') || false;
+
+ // For new card payments, validate Flow component BEFORE creating order
+ if (!savedCardSelected && !savedCardEnabled && ckoFlow.flowComponent) {
+ if (typeof ckoFlow.flowComponent.isValid === 'function') {
+ const isValid = ckoFlow.flowComponent.isValid();
+ if (!isValid) {
+ ckoLogger.error('[VALIDATION] ❌ Flow component is invalid - blocking order creation');
+ showError('Payment form is not valid. Please check your payment details and try again.');
+ return; // Exit early - don't create order
+ }
+ ckoLogger.debug('[VALIDATION] ✅ Flow component is valid - proceeding with order creation');
+ } else {
+ ckoLogger.warn('[VALIDATION] ⚠️ Flow component isValid() method not available - proceeding with order creation');
+ }
+ }
+
+ // Create order (which includes server-side validation)
+ // OPTIMIZATION: Combined validation + order creation into single AJAX call
+ // This reduces latency by ~100-200ms compared to separate validation call
+ ckoLogger.debug('[CREATE ORDER] Creating order with built-in validation...');
+ (async function() {
+ const orderId = await createOrderBeforePayment();
+ if (!orderId) {
+ // Order creation failed - error already shown by createOrderBeforePayment()
+ // This could be due to validation errors or other issues
+ ckoLogger.error('[CREATE ORDER] Failed to create order - cannot proceed with payment');
+ return;
+ }
+
+ ckoLogger.debug('[CREATE ORDER] ✅ Order created successfully - Order ID: ' + orderId);
+
+ // CRITICAL: Ensure payment session ID is added to form before submission
+ // This is a fallback in case form wasn't available when payment session was created
+ if (window.ckoAddPaymentSessionIdField) {
+ const added = window.ckoAddPaymentSessionIdField();
+ if (added) {
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Hidden field added on Place Order click (fallback)');
+ }
+ }
+
+ // Persist save card checkbox before form submission
+ persistSaveCardCheckbox();
+
+ // Show flow container
+ document.getElementById("flow-container").style.display = "block";
+
+ // Place order for FLOW.
+ if (ckoFlow.flowComponent) {
+ if( savedCardSelected || savedCardEnabled ) {
+ ckoLogger.debug('[SAVED CARD] Saved card selected - submitting checkout form directly (bypassing Flow component)');
+ // CRITICAL: Ensure payment session ID is in form before submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+ // Submit directly - Flow component NOT used for saved cards
+ // WooCommerce will call process_payment() which makes direct API call
+ form.submit();
+ } else {
+ // CRITICAL: Ensure payment session ID is in form before Flow component submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+
+ // Double-check component validity before submitting (defense-in-depth)
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.isValid === 'function') {
+ const isValid = ckoFlow.flowComponent.isValid();
+ if (isValid) {
+ ckoLogger.debug('Flow component is valid, submitting...');
+ try {
+ ckoFlow.flowComponent.submit();
+ } catch (error) {
+ ckoLogger.error('Flow component submit failed:', error);
+ showError('Payment processing failed. Please try again.');
+ }
+ } else {
+ ckoLogger.error('Flow component became invalid after order creation - cannot submit');
+ showError('Payment form is not valid. Please check your payment details and try again.');
+ // Note: Order was created but payment cannot proceed
+ // The order will remain in "pending" status
+ }
+ } else {
+ // Fallback: submit without validation check
+ ckoLogger.debug('Flow component validity check not available, submitting directly...');
+ try {
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.submit === 'function') {
+ ckoFlow.flowComponent.submit();
+ } else {
+ ckoLogger.error('Flow component submit method not available');
+ showError('Payment component not ready. Please refresh the page and try again.');
+ }
+ } catch (error) {
+ ckoLogger.error('Flow component submit failed (fallback):', error);
+ showError('Payment processing failed. Please try again.');
+ }
+ }
+ }
+ } else {
+ ckoLogger.error('[CREATE ORDER] Flow component not found - cannot process payment');
+ showError('Payment component not loaded. Please refresh the page and try again.');
+ }
+
+ // Place order for saved card.
+ if (!ckoFlow.flowComponent) {
+ form.submit();
+ }
+ })(); // Close async IIFE for order creation
+ } else {
+ // console.log('[CURRENT VERSION] Flow payment method not selected or not found');
+ }
+ }
+ });
+});
+
+// Removed complex 3DS redirect handling - keeping it simple like the working version
+
+let virtual = false;
+/**
+ * Handle checkout flow-container rendering on various field changes.
+ * Attaches debounced event listeners to checkout inputs to update flow state and cart info dynamically.
+ */
+jQuery(function ($) {
+
+ /**
+ * Main handler function triggered on input/change events.
+ * It performs field checks and updates the checkout flow and cart info accordingly.
+ *
+ * @param {Event} event - The input or change event.
+ */
+ const handleTyping = (event) => {
+
+ let isShippingField = false;
+
+ // Check if the changed field belongs to shipping info.
+ if (event) {
+ const $target = jQuery(event.target);
+ isShippingField = $target.is('[id^="shipping"]');
+ }
+
+ // If the field is a shipping-related field, trigger WooCommerce checkout update and exit early.
+ if (isShippingField) {
+ console.log("Triggered by a shipping field, skipping...");
+ $("body").trigger("update_checkout");
+ return;
+ }
+
+ // Check if this is a critical field that requires Flow reload
+ const criticalFields = [
+ 'billing_email',
+ 'billing_country',
+ 'billing_address_1',
+ 'billing_city',
+ 'billing_postcode',
+ 'billing_state'
+ ];
+
+ const fieldName = event.target.name || event.target.id || '';
+ const fieldId = event.target.id || '';
+ const isCriticalField = criticalFields.some(field =>
+ fieldName.includes(field.replace('billing_', '')) ||
+ fieldId.includes(field.replace('billing_', ''))
+ );
+
+ // Store previous values to detect changes
+ if (isCriticalField && ckoFlowInitialized) {
+ const currentValue = event.target.value || '';
+ const fieldKey = fieldId || fieldName;
+ const previousValue = window.ckoFlowFieldValues?.[fieldKey] || '';
+
+ // If value actually changed (not just typing)
+ if (currentValue !== previousValue) {
+ // Update stored value
+ if (!window.ckoFlowFieldValues) {
+ window.ckoFlowFieldValues = {};
+ }
+ window.ckoFlowFieldValues[fieldKey] = currentValue;
+
+ // Debounce the reload check
+ debouncedCheckFlowReload(fieldKey, currentValue);
+ }
+ }
+
+ // Only proceed if all required fields are filled.
+ if (requiredFieldsFilled()) {
+ $("body").trigger("update_checkout");
+
+ // If the event is from checking 'ship to different address' or 'create account', return early.
+ if (
+ jQuery(event.target).is(
+ "#ship-to-different-address-checkbox, #createaccount"
+ ) &&
+ jQuery(event.target).is(":checked")
+ ) {
+ console.log("User just checked the checkbox. Returning early...");
+ return;
+ }
+
+ var targetName = event.target.name || "";
+
+ // If the event is not from billing fields or key checkboxes, exit early.
+ if (
+ !targetName.startsWith("billing") &&
+ !jQuery(event.target).is(
+ "#ship-to-different-address-checkbox, #terms, #createaccount, #coupon_code"
+ )
+ ) {
+ let cartData = $("#cart-info").data("cart");
+ if ( !cartData || !cartData["contains_virtual_product"] ) {
+ console.log(
+ "Neither billing nor the shipping checkbox. Returning early..."
+ );
+ return;
+ }
+ console.log(
+ "Virtual Product found. Triggering FLOW..."
+ );
+ }
+
+ // Check required fields status (for initialization/reload)
+ checkRequiredFieldsStatus();
+ } else {
+ // Required fields not filled - check status anyway
+ // This ensures Flow initializes when fields become filled
+ checkRequiredFieldsStatus();
+ }
+
+ // Always check field status on any field change (for initialization)
+ // This ensures Flow initializes as soon as all fields are filled
+ if (!ckoFlowInitialized) {
+ checkRequiredFieldsStatus();
+
+ // Also directly check if we can initialize now
+ if (canInitializeFlow()) {
+ ckoLogger.debug('Field change detected - all fields now valid, initializing Flow');
+ initializeFlowIfNeeded();
+ }
+ }
+ };
+
+ // Debounce the handler to limit how often it's triggered during typing.
+ const debouncedTyping = debounce(handleTyping, 2000);
+
+ // Attach debounced handler to key billing fields.
+ $(
+ "#billing_first_name, #billing_last_name, #billing_email, #billing_phone"
+ ).on("input", function (e) {
+ debouncedTyping(e);
+ });
+
+ // Attach to all other inputs/selects, excluding the key billing fields above.
+ $(
+ "input:not(#billing_first_name, #billing_last_name, #billing_email, #billing_phone), select"
+ ).on("input change", function (e) {
+ debouncedTyping(e);
+ });
+
+ // Attach handler to all input/selects, but ignore payment method fields.
+ $(document).on("input change", "input, select", function (e) {
+ if ($(this).closest(".wc_payment_method").length === 0) {
+
+ debouncedTyping(e);
+
+ }
+
+ let cartData = $("#cart-info").data("cart");
+ if ( !virtual && cartData && cartData["contains_virtual_product"] && $('#ship-to-different-address-checkbox').length === 0 ) {
+ debouncedTyping(e);
+ virtual = true;
+ }
+ });
+
+ // Watch country field specifically for Flow reload
+ jQuery('#billing_country').on('change.flow-reload', function() {
+ ckoLogger.debug('Billing country changed - will reload Flow after checkout update');
+
+ // Wait for WooCommerce to update fields
+ jQuery(document).one('updated_checkout', function() {
+ // Small delay to ensure fields are updated
+ setTimeout(() => {
+ if (ckoFlowInitialized && ckoFlow.flowComponent) {
+ // Store country value
+ const countryValue = jQuery('#billing_country').val();
+ if (!window.ckoFlowFieldValues) {
+ window.ckoFlowFieldValues = {};
+ }
+ window.ckoFlowFieldValues['billing_country'] = countryValue;
+
+ // Reload Flow
+ reloadFlowComponent();
+ } else if (canInitializeFlow()) {
+ initializeFlowIfNeeded();
+ }
+ }, 500);
+ });
+ });
+});
+
+/**
+ *
+ * Debounce utility function.
+ * Delays the execution of a function until after a specified delay
+ * has passed since the last time it was invoked.
+ *
+ * @param {Function} func - The function to debounce.
+ * @param {number} delay - Delay in milliseconds.
+ *
+ * @returns {Function} - A debounced version of the original function.
+ */
+function debounce(func, delay) {
+ let timer;
+
+ return function (...args) {
+
+ // Clear the existing timer, if any.
+ clearTimeout(timer);
+
+ // Set a new timer to call the function after the delay.
+ timer = setTimeout(() => {
+
+ // Call the original function with the correct context and arguments.
+ func.apply(this, args);
+ }, delay);
+ };
+}
+
+/**
+ * Checks if all non-shipping required fields in the WooCommerce checkout form are filled.
+ *
+ * This function looks for elements marked with a `.required` span inside labels
+ * within the `.woocommerce-checkout` form, extracts the associated input field IDs,
+ * filters out those related to shipping, and then verifies that the corresponding
+ * fields are not empty.
+ *
+ * @returns {boolean} - Returns true if all non-shipping required fields are filled; otherwise, false.
+ */
+function requiredFieldsFilled() {
+ // Select all required field indicators within WooCommerce checkout labels.
+ const requiredLabels = document.querySelectorAll(
+ ".woocommerce-checkout label .required"
+ );
+
+ const fieldIds = [];
+
+ requiredLabels.forEach((label) => {
+ const fieldId = label.closest("label").getAttribute("for");
+ if (fieldId) {
+ fieldIds.push(fieldId);
+ }
+ });
+
+ // Filter out fieldIds that start with "shipping".
+ let filteredFieldIds = fieldIds.filter((id) => !id.startsWith("shipping"));
+
+ // CRITICAL: Filter out payment gateway fields from OTHER payment methods
+ // When Checkout.com is selected, PayPal/Stripe fields are still in DOM but empty
+ // We should only check fields relevant to Checkout.com or general checkout fields
+ // Strategy: Check if field is inside another payment gateway's container OR has gateway prefix
+ filteredFieldIds = filteredFieldIds.filter((id) => {
+ const field = document.getElementById(id);
+ if (!field) {
+ return false; // Field doesn't exist
+ }
+
+ // First check: If field ID starts with known payment gateway prefixes, exclude it
+ // This catches fields like ppcp-credit-card-gateway-card-number that might not be in containers
+ const paymentGatewayPrefixes = ['ppcp-', 'stripe-', 'wc-stripe-', 'square-', 'authorize-'];
+ const isOtherGatewayField = paymentGatewayPrefixes.some(prefix => id.startsWith(prefix));
+ if (isOtherGatewayField) {
+ return false;
+ }
+
+ // Second check: Check if field is inside a payment gateway container
+ // WooCommerce payment gateways are wrapped in: .payment_method_{gateway_id}
+ const paymentMethodContainer = field.closest('.payment_method');
+
+ if (paymentMethodContainer) {
+ // Field is inside a payment gateway container
+ const containerClass = paymentMethodContainer.className;
+
+ // Check if it's Checkout.com Flow container
+ if (containerClass.includes('payment_method_wc_checkout_com_flow')) {
+ // This is a Checkout.com field - include it
+ return true;
+ } else {
+ // Field is inside another payment gateway container (PayPal, Stripe, etc.)
+ // Exclude it - we only want Checkout.com fields or general checkout fields
+ return false;
+ }
+ }
+
+ // Field is NOT inside any payment gateway container and doesn't have gateway prefix
+ // This means it's a general checkout field (billing_email, billing_address, etc.)
+ // Include it - these are always relevant
+ return true;
+ });
+
+ // Check if login form is hidden.
+ const loginForm = document.querySelector(".woocommerce-form-login");
+ const loginFormHidden = loginForm && loginForm.style.display === "none";
+
+ if (loginFormHidden) {
+ // Remove username and password fields if form is hidden.
+ filteredFieldIds = filteredFieldIds.filter(
+ (id) => id !== "username" && id !== "password"
+ );
+ }
+
+ // CRITICAL: Filter out account creation fields unless account creation is enabled
+ // Account fields (account_username, account_password) should only be required if:
+ // 1. The "Create an account?" checkbox exists and is checked
+ // 2. The account fields are visible
+ const createAccountCheckbox = document.querySelector('#createaccount');
+ const isCreatingAccount = createAccountCheckbox && createAccountCheckbox.checked;
+
+ if (!isCreatingAccount) {
+ // Remove account creation fields if account creation is not enabled
+ filteredFieldIds = filteredFieldIds.filter(
+ (id) => id !== "account_username" && id !== "account_password"
+ );
+ if (window.flowDebugLogging) {
+ ckoLogger.debug('requiredFieldsFilled: Account creation not enabled - filtered out account_username and account_password');
+ }
+ } else {
+ // Account creation is enabled - check if fields are visible
+ const accountUsernameField = document.getElementById('account_username');
+ const accountPasswordField = document.getElementById('account_password');
+ const accountFieldsVisible = accountUsernameField && accountPasswordField &&
+ accountUsernameField.offsetParent !== null &&
+ accountPasswordField.offsetParent !== null;
+
+ if (!accountFieldsVisible) {
+ // Account fields exist but are hidden - remove them
+ filteredFieldIds = filteredFieldIds.filter(
+ (id) => id !== "account_username" && id !== "account_password"
+ );
+ if (window.flowDebugLogging) {
+ ckoLogger.debug('requiredFieldsFilled: Account creation enabled but fields are hidden - filtered out account fields');
+ }
+ } else {
+ if (window.flowDebugLogging) {
+ ckoLogger.debug('requiredFieldsFilled: Account creation enabled and fields visible - including account_username and account_password');
+ }
+ }
+ }
+
+ // FALLBACK: If no fields found via .required selector, check common required fields directly
+ // This handles cases where:
+ // 1. Site uses Blocks checkout (different structure)
+ // 2. Theme doesn't use .required class
+ // 3. Fields are required but not marked with .required
+ if (filteredFieldIds.length === 0) {
+ if (window.flowDebugLogging) {
+ ckoLogger.debug('requiredFieldsFilled: No fields found via .required selector, using fallback');
+ }
+
+ // Common required billing fields
+ const commonRequiredFields = [
+ 'billing_email',
+ 'billing_first_name',
+ 'billing_last_name',
+ 'billing_address_1',
+ 'billing_city',
+ 'billing_country'
+ ];
+
+ // Check which of these fields exist and are required
+ filteredFieldIds = commonRequiredFields.filter((id) => {
+ const field = document.getElementById(id);
+ if (!field) {
+ return false;
+ }
+
+ // Check if field has required attribute or is inside a required label
+ const isRequired = field.hasAttribute('required') ||
+ field.hasAttribute('aria-required') ||
+ field.closest('label')?.querySelector('.required') !== null ||
+ field.closest('.form-row')?.classList.contains('validate-required');
+
+ // Also check if field is visible (not hidden)
+ const isVisible = field.offsetParent !== null &&
+ field.style.display !== 'none' &&
+ !field.hasAttribute('disabled');
+
+ return isRequired && isVisible;
+ });
+
+ if (window.flowDebugLogging) {
+ ckoLogger.debug('requiredFieldsFilled: Fallback found fields:', filteredFieldIds);
+ }
+ }
+
+ // DEBUG: Log field validation details
+ if (window.flowDebugLogging) {
+ ckoLogger.debug('requiredFieldsFilled: Checking ' + filteredFieldIds.length + ' fields:', filteredFieldIds.join(', '));
+ }
+
+ // Check that each field is present and not empty.
+ const fieldResults = {};
+ const failedFields = [];
+ const result = filteredFieldIds.every((id) => {
+ const field = document.getElementById(id);
+ const fieldExists = !!field;
+ const fieldValue = field?.value || '';
+ const fieldValueTrimmed = fieldValue.trim();
+ const isEmpty = fieldValueTrimmed === "";
+ const isValid = fieldExists && !isEmpty;
+
+ // Store result for debugging
+ if (window.flowDebugLogging) {
+ fieldResults[id] = {
+ exists: fieldExists,
+ value: fieldValueTrimmed || '(empty)',
+ isEmpty: isEmpty,
+ isValid: isValid
+ };
+
+ if (!isValid) {
+ failedFields.push(id + ' (' + (fieldExists ? (isEmpty ? 'empty' : 'invalid') : 'not found') + ')');
+ }
+ }
+
+ return isValid;
+ });
+
+ // DEBUG: Log field validation results with expanded details
+ if (window.flowDebugLogging) {
+ if (failedFields.length > 0) {
+ ckoLogger.debug('requiredFieldsFilled: ❌ FAILED fields: ' + failedFields.join(', '));
+ }
+ // Log each field's status individually for better visibility
+ Object.keys(fieldResults).forEach(id => {
+ const result = fieldResults[id];
+ if (!result.isValid) {
+ ckoLogger.debug('requiredFieldsFilled: Field "' + id + '" - exists: ' + result.exists + ', value: "' + result.value + '", isEmpty: ' + result.isEmpty);
+ }
+ });
+ ckoLogger.debug('requiredFieldsFilled: Final result: ' + (result ? '✅ PASSED' : '❌ FAILED') + ' (' + filteredFieldIds.length + ' fields checked, ' + failedFields.length + ' failed)');
+ }
+
+ return result;
+}
+
+/**
+ * Validates the checkout form by sending serialized form data to the server
+ * using an AJAX POST request. Executes callback functions based on the response.
+ *
+ * @param {jQuery} form - The jQuery-wrapped form element to be validated.
+ * @param {Function} onSuccess - Callback function executed when validation is successful.
+ * @param {Function} onError - Optional callback function executed when validation fails or an error occurs.
+ */
+function validateCheckout(form, onSuccess, onError) {
+
+ const formData = form.serialize(); // Serialize the form.
+
+ // Perform AJAX POST request for server-side validation.
+ jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: "POST",
+ data: {
+ action: "cko_validate_checkout",
+ ...Object.fromEntries(new URLSearchParams(formData)),
+ },
+ success: function (response) {
+
+ // If the response indicates success, trigger the onSuccess callback.
+ if (response.success) {
+ onSuccess(response);
+ } else {
+
+ // Show an error message and trigger the onError callback if provided.
+ showError(response.data.message);
+ if (onError) onError(response);
+ }
+ },
+ error: function () {
+
+ // If the request fails, display the flow container and show a generic error message.
+ document.getElementById("flow-container").style.display = "block";
+ showError(
+ wp.i18n.__(
+ "An error occurred. Please try again.",
+ "checkout-com-unified-payments-api"
+ )
+ );
+
+ // Trigger onError callback if provided.
+ if (onError) onError();
+ },
+ });
+}
+
+/**
+ * Handles radio button selection across multiple saved payment method lists.
+ *
+ * This script ensures that only one radio button across multiple
+ * `.woocommerce-SavedPaymentMethods` lists can be selected at a time.
+ *
+ * Behavior:
+ * - If a radio button inside one list is selected, all radios in the other lists are deselected.
+ * - Supports dynamically added elements by using event delegation on `document`.
+ *
+ * Implementation details:
+ * - Uses jQuery's `on('change')` with delegation to handle dynamically loaded content.
+ * - `currentUl` stores the UL containing the selected radio.
+ * - `otherUls` targets all other ULs to clear their selected radios.
+ *
+ * Example:
+ * If the user selects a radio in the first UL and then selects a radio in the second UL,
+ * the first UL's selected radio is automatically deselected.
+ */
+jQuery(function($) {
+ $(document).on('change', '.woocommerce-SavedPaymentMethods input[type="radio"]', function() {
+ const currentUl = $(this).closest('.woocommerce-SavedPaymentMethods'); // Current UL.
+ const otherUls = $('.woocommerce-SavedPaymentMethods').not(currentUl); // All other ULs.
+
+ // Uncheck all radios in the other ULs.
+ otherUls.find('input[type="radio"]').prop('checked', false);
+ });
+});
+
+/**
+ * Toggles the visibility of the Checkout Payment FLOW label based on the presence
+ * of the 'saved-card-is-enabled' class on the web component root.
+ *
+ * Behavior:
+ * 1. Initially hides the label if the body has class 'flow-method-single' and the
+ * root element exists without 'saved-card-is-enabled'.
+ * 2. Shows the label if 'saved-card-is-enabled' class is present on the root element.
+ * 3. Dynamically observes the root element:
+ * - Detects when the root element appears in the DOM.
+ * - Watches for class changes on the root to toggle the label visibility in real-time.
+ *
+ * Uses MutationObserver to handle dynamically loaded elements and class changes.
+ */
+document.addEventListener('DOMContentLoaded', function () {
+ const labelSelector = 'label[for="payment_method_wc_checkout_com_flow"]';
+ const rootSelector = '[data-testid="checkout-web-component-root"]';
+
+ const checkAndToggle = () => {
+ const label = document.querySelector(labelSelector);
+ const rootElement = document.querySelector(rootSelector);
+
+ // Check if we have saved cards (new behavior)
+ const hasSavedCards = document.querySelector('.saved-cards-accordion-container');
+
+ if (label) {
+ // ALWAYS show the label (either with saved cards or without)
+ label.style.removeProperty('display');
+
+ if (hasSavedCards) {
+ console.log('[FLOW LABEL] Label shown - saved cards present');
+ } else {
+ console.log('[FLOW LABEL] Label shown - no saved cards (default label)');
+ }
+
+ /* DISABLED - Old behavior that was hiding the label
+ // Old behavior: only for flow-method-single (no saved cards)
+ if (document.body.classList.contains('flow-method-single') && rootElement) {
+ if (rootElement.classList.contains('saved-card-is-enabled')) {
+ label.style.removeProperty('display'); // Show again.
+ } else {
+ label.style.setProperty('display', 'none', 'important'); // Hide.
+ }
+ }
+ */
+ }
+ };
+
+ // Watch for root element and its class changes.
+ const observer = new MutationObserver(() => {
+ const rootElement = document.querySelector(rootSelector);
+
+ if (rootElement) {
+ // Run once when root appears.
+ checkAndToggle();
+
+ // Now watch the root for class changes.
+ const classObserver = new MutationObserver(checkAndToggle);
+ classObserver.observe(rootElement, { attributes: true, attributeFilter: ['class'] });
+
+ observer.disconnect(); // Stop watching for root element.
+ }
+ });
+
+ observer.observe(document.body, { childList: true, subtree: true });
+
+ // Also check immediately and after a delay for saved cards
+ checkAndToggle();
+ setTimeout(checkAndToggle, 500);
+ setTimeout(checkAndToggle, 1000);
+});
+
+/**
+ * On DOMContentLoaded, checks if the current order payment type is "MOTO".
+ * If so, it ensures that no saved payment tokens are pre-selected.
+ *
+ * - Looks for the #order-pay-info element and reads its "order-pay" data attribute.
+ * - If payment_type is "MOTO" (Admin order + Order-pay page + Guest customer):
+ * - Finds all saved payment token radio inputs from Checkout.com (Flow & Cards).
+ * - Iterates through them and unchecks each one, forcing the user to actively select a payment method.
+ */
+document.addEventListener('DOMContentLoaded', function () {
+ const orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ if ( orderPayInfo?.payment_type === 'MOTO' ) {
+ console.log('here');
+ const radios = document.querySelectorAll(
+ 'input[name="wc-wc_checkout_com_flow-payment-token"], input[name="wc-wc_checkout_com_cards-payment-token"]'
+ );
+ radios.forEach(radio => {
+ radio.checked = false;
+ });
+ }
+});
+
+/**
+ * REMOVED: JavaScript AJAX handler for 3DS redirects
+ *
+ * The 3DS redirect now goes directly to the PHP endpoint (handle_3ds_return)
+ * which processes the payment and redirects to the success page.
+ * This provides a smoother transition without showing the checkout page.
+ *
+ * The success_url in the payment session request points to:
+ * /wc-api/wc_checkoutcom_flow_process?cko-payment-id=XXX
+ *
+ * This endpoint processes the payment and redirects directly to order-received page.
+ */
diff --git a/checkout-com-unified-payments-api/flow-integration/class-wc-gateway-checkout-com-flow.php b/checkout-com-unified-payments-api/flow-integration/class-wc-gateway-checkout-com-flow.php
new file mode 100644
index 00000000..b0ffee62
--- /dev/null
+++ b/checkout-com-unified-payments-api/flow-integration/class-wc-gateway-checkout-com-flow.php
@@ -0,0 +1,6013 @@
+id = 'wc_checkout_com_flow';
+ $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' );
+ $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' );
+ $this->title = !empty( $core_settings['title'] ) ? trim( __( $core_settings['title'], 'checkout-com-unified-payments-api' ) ) : __( 'Checkout.com', 'checkout-com-unified-payments-api' );
+ $this->has_fields = true;
+ $this->supports = array(
+ 'products',
+ 'refunds',
+ 'tokenization',
+ 'subscriptions',
+ 'subscription_cancellation',
+ 'subscription_suspension',
+ 'subscription_reactivation',
+ 'subscription_date_changes',
+ );
+
+ $this->init_form_fields();
+ $this->init_settings();
+
+ $this->flow_enabled();
+
+ // Turn these settings into variables we can use.
+ foreach ( $this->settings as $setting_key => $value ) {
+ $this->$setting_key = $value;
+ }
+
+ add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, array( $this, 'process_admin_options' ) );
+
+ // Webhook handler hook - ENABLED for Flow integration
+ // Flow integration uses direct redirect for successful payments, but webhooks for 3DS, failures, etc.
+ add_action( 'woocommerce_api_wc_checkoutcom_webhook', [ $this, 'webhook_handler' ] );
+
+ // WC API endpoint for processing 3DS returns (similar to PayPal)
+ // This allows direct redirect to order-received page without showing checkout page
+ add_action( 'woocommerce_api_wc_checkoutcom_flow_process', [ $this, 'handle_3ds_return' ] );
+
+ // Detect 3DS return on checkout page load and process server-side (no AJAX)
+ // This handles cases where user returns to checkout page with 3DS parameters
+ // Priority 1 ensures it runs very early, before other template_redirect hooks
+ add_action( 'template_redirect', [ $this, 'detect_and_process_3ds_return_on_checkout' ], 1 );
+
+ // Meta field on subscription edit.
+ add_filter( 'woocommerce_subscription_payment_meta', [ $this, 'add_payment_meta_field' ], 10, 2 );
+
+ // Store save card preference in order metadata when order is created (before 3DS redirect)
+ add_action( 'woocommerce_checkout_create_order', [ $this, 'store_save_card_preference_in_order' ], 10, 2 );
+
+ // Secure AJAX handler for creating payment sessions (prevents secret key exposure to frontend)
+ add_action( 'wp_ajax_cko_flow_create_payment_session', [ $this, 'ajax_create_payment_session' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_create_payment_session', [ $this, 'ajax_create_payment_session' ] );
+
+ // AJAX handler for creating orders before payment processing (early order creation)
+ add_action( 'wp_ajax_cko_flow_create_order', [ $this, 'ajax_create_order' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_create_order', [ $this, 'ajax_create_order' ] );
+
+ // AJAX handler for creating failed orders when payment is declined before form submission
+ add_action( 'wp_ajax_cko_flow_create_failed_order', [ $this, 'ajax_create_failed_order' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_create_failed_order', [ $this, 'ajax_create_failed_order' ] );
+
+ // AJAX handler for storing save card preference in WooCommerce session
+ add_action( 'wp_ajax_cko_flow_store_save_card_preference', [ $this, 'ajax_store_save_card_preference' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_store_save_card_preference', [ $this, 'ajax_store_save_card_preference' ] );
+
+ // AJAX handler for saving payment session ID to order immediately after payment session creation
+ add_action( 'wp_ajax_cko_flow_save_payment_session_id', [ $this, 'ajax_save_payment_session_id' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_save_payment_session_id', [ $this, 'ajax_save_payment_session_id' ] );
+ }
+
+ /**
+ * Check if the gateway is available.
+ *
+ * Override parent method to ensure gateway is available when enabled and checkout mode is 'flow'.
+ * This bypasses WooCommerce's default currency/country restrictions.
+ *
+ * @return bool
+ */
+ public function is_available() {
+ // Log availability check start (only in debug mode to reduce log spam)
+ $is_debug = defined( 'WP_DEBUG' ) && WP_DEBUG;
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Checking if Flow gateway is available...' );
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway enabled setting: ' . ( isset( $this->enabled ) ? $this->enabled : 'NOT SET' ) );
+ }
+
+ // First check if gateway is enabled
+ if ( 'yes' !== $this->enabled ) {
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway is NOT available - enabled setting is not "yes"' );
+ }
+ return false;
+ }
+
+ // Check if checkout mode is set to 'flow'
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Checkout mode: ' . $checkout_mode );
+ }
+
+ if ( 'flow' !== $checkout_mode ) {
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway is NOT available - checkout mode is not "flow" (current: ' . $checkout_mode . ')' );
+ }
+ return false;
+ }
+
+ // Check if API credentials are set
+ $secret_key = isset( $checkout_setting['ckocom_secret_key'] ) ? $checkout_setting['ckocom_secret_key'] : '';
+ $public_key = isset( $checkout_setting['ckocom_public_key'] ) ? $checkout_setting['ckocom_public_key'] : '';
+
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Secret key: ' . ( ! empty( $secret_key ) ? 'SET (' . substr( $secret_key, 0, 10 ) . '...)' : 'NOT SET' ) );
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Public key: ' . ( ! empty( $public_key ) ? 'SET (' . substr( $public_key, 0, 10 ) . '...)' : 'NOT SET' ) );
+ }
+
+ if ( empty( $secret_key ) || empty( $public_key ) ) {
+ // Log warning but don't block availability (credentials might be set later)
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] WARNING: API credentials not set, but gateway is still available' );
+ }
+ }
+
+ // Gateway is available if enabled and checkout mode is 'flow'
+ // We bypass currency/country restrictions as Flow supports all currencies/countries
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway IS available - all checks passed' );
+ }
+ return true;
+ }
+
+ /**
+ * Check if the gateway is valid for use.
+ *
+ * Override parent method to bypass currency/country restrictions.
+ * Flow supports all currencies and countries, so we always return true
+ * when the gateway is enabled and checkout mode is 'flow'.
+ *
+ * @return bool
+ */
+ public function valid_for_use() {
+ // Log valid_for_use check start
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Checking if Flow gateway is valid for use...' );
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Gateway enabled setting: ' . ( isset( $this->enabled ) ? $this->enabled : 'NOT SET' ) );
+
+ // Check if gateway is enabled
+ if ( 'yes' !== $this->enabled ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Gateway is NOT valid - enabled setting is not "yes"' );
+ return false;
+ }
+
+ // Check if checkout mode is set to 'flow'
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Checkout mode: ' . $checkout_mode );
+
+ if ( 'flow' !== $checkout_mode ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Gateway is NOT valid - checkout mode is not "flow" (current: ' . $checkout_mode . ')' );
+ return false;
+ }
+
+ // Flow supports all currencies and countries, so always return true
+ // This bypasses WooCommerce's default currency/country restrictions
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Gateway IS valid for use - all checks passed' );
+ return true;
+ }
+
+ /**
+ * Add subscription order payment meta field.
+ *
+ * @param array $payment_meta associative array of meta data required for automatic payments.
+ * @param WC_Subscription $subscription An instance of a subscription object.
+ * @return array
+ */
+ /**
+ * Store save card preference in order metadata when order is created.
+ * This ensures the preference survives 3DS redirects.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $data The order data.
+ * @return void
+ */
+ public function store_save_card_preference_in_order( $order, $data ) {
+ // Only process if this is a Flow payment
+ if ( $this->id !== $order->get_payment_method() ) {
+ return;
+ }
+
+ // Check if customer wants to save card (from POST data during order creation)
+ $save_card_hidden = isset( $_POST['cko-flow-save-card-persist'] ) ? sanitize_text_field( $_POST['cko-flow-save-card-persist'] ) : '';
+ $save_card_post = isset( $_POST['wc-wc_checkout_com_flow-new-payment-method'] ) ? sanitize_text_field( $_POST['wc-wc_checkout_com_flow-new-payment-method'] ) : '';
+ $save_card_session = WC()->session->get( 'wc-wc_checkout_com_flow-new-payment-method' );
+
+ // Determine if checkbox was checked
+ $save_card_preference = 'no';
+ if ( 'yes' === $save_card_hidden ) {
+ $save_card_preference = 'yes';
+ } elseif ( 'true' === $save_card_post || 'yes' === $save_card_post ) {
+ $save_card_preference = 'yes';
+ } elseif ( 'yes' === $save_card_session ) {
+ $save_card_preference = 'yes';
+ }
+
+ // Store in order metadata
+ $order->update_meta_data( '_cko_save_card_preference', $save_card_preference );
+ WC_Checkoutcom_Utility::logger( '[FLOW SAVE CARD] Stored save card preference in order metadata: ' . $save_card_preference . ' (Order ID: ' . $order->get_id() . ')' );
+ }
+
+ public function add_payment_meta_field( $payment_meta, $subscription ) {
+ $source_id = $subscription->get_meta( '_cko_source_id' );
+
+ $payment_meta[ $this->id ] = [
+ 'post_meta' => [
+ '_cko_source_id' => [
+ 'value' => $source_id,
+ 'label' => 'Checkout.com FLOW Source ID',
+ ],
+ ],
+ ];
+
+ return $payment_meta;
+ }
+
+ /**
+ * Show module configuration in backend.
+ *
+ * @return string|void
+ */
+ public function init_form_fields() {
+ $this->form_fields = WC_Checkoutcom_Cards_Settings::flow_settings();
+ $this->form_fields = array_merge(
+ $this->form_fields,
+ array(
+ 'screen_button' => array(
+ 'id' => 'screen_button',
+ 'type' => 'screen_button',
+ 'title' => __( 'Other Settings', 'checkout-com-unified-payments-api' ),
+ ),
+ )
+ );
+ }
+
+ /**
+ * Generate links for the admin page.
+ *
+ * @param string $key The key.
+ * @param array $value The value.
+ */
+ public function generate_screen_button_html( $key, $value ) {
+ WC_Checkoutcom_Admin::generate_links( $key, $value );
+ }
+
+ /**
+ * Show frames js on checkout page.
+ */
+ public function payment_fields() {
+
+ $save_card = WC_Admin_Settings::get_option( 'ckocom_card_saved' );
+
+ // Safely get flow saved card setting with fallback
+ $flow_settings = get_option( 'woocommerce_wc_checkout_com_flow_settings', array() );
+ $flow_saved_card = isset( $flow_settings['flow_saved_payment'] ) ? $flow_settings['flow_saved_payment'] : 'saved_cards_first';
+ $flow_debug_logging = isset( $flow_settings['flow_debug_logging'] ) && 'yes' === $flow_settings['flow_debug_logging'];
+
+ $order_pay_order_id = null;
+ $order_pay_order = null;
+ if ( is_wc_endpoint_url( 'order-pay' ) ) {
+ global $wp;
+ // We are on the order-pay page. Retrives order_id from order-pay page
+ $order_pay_order_id = absint( $wp->query_vars['order-pay'] ?? 0 );
+ $order_pay_order = wc_get_order( $order_pay_order_id );
+ }
+
+ if ( ! empty( $this->get_option( 'description' ) ) ) {
+ echo esc_html( $this->get_option( 'description' ) );
+ }
+ ?>
+
+
+
+
+
+
+ is_created_via( 'admin' );
+ $is_guest_customer = $order_pay_order->get_customer_id() == 0;
+ $is_moto_order = $is_admin_created && $is_guest_customer;
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
';
+ } );
+ }
+ }
+ }
+
+ /**
+ * Render admin page.
+ */
+ public static function render_admin_page() {
+ global $wpdb;
+
+ if ( ! class_exists( 'WC_Checkout_Com_Webhook_Queue' ) ) {
+ echo '
+
+ `;
+ flowContainer.appendChild(waitingMessage);
+ }
+
+ ckoLogger.debug('Showing Flow waiting message');
+}
+
+/**
+ * Hide waiting message in Flow container
+ */
+function hideFlowWaitingMessage() {
+ const flowContainer = document.getElementById("flow-container");
+ if (!flowContainer) {
+ return;
+ }
+
+ const waitingMessage = flowContainer.querySelector('.flow-waiting-message');
+ if (waitingMessage) {
+ waitingMessage.remove();
+ ckoLogger.debug('Hiding Flow waiting message');
+ }
+}
+
+/**
+ * Destroy Flow component
+ */
+function destroyFlowComponent() {
+ if (ckoFlow.flowComponent) {
+ try {
+ // Unmount component if method exists
+ if (typeof ckoFlow.flowComponent.unmount === 'function') {
+ ckoFlow.flowComponent.unmount();
+ }
+ } catch (error) {
+ ckoLogger.error('Error destroying Flow component:', error);
+ }
+ ckoFlow.flowComponent = null;
+ }
+
+ // Clear component root
+ const flowComponentRoot = document.querySelector('[data-testid="checkout-web-component-root"]');
+ if (flowComponentRoot) {
+ flowComponentRoot.innerHTML = '';
+ }
+
+ ckoLogger.debug('Flow component destroyed');
+}
+
+/**
+ * Reload Flow component
+ */
+function reloadFlowComponent() {
+ if (!ckoFlow.flowComponent) {
+ try {
+ initializeFlowIfNeeded();
+ } catch (error) {
+ ckoLogger.error('Error reloading Flow component:', error);
+ }
+ return;
+ }
+
+ ckoLogger.debug('Reloading Flow component due to field change');
+
+ // Destroy existing component
+ destroyFlowComponent();
+
+ // Reset initialization flag
+ ckoFlowInitialized = false;
+
+ // Re-initialize Flow
+ try {
+ initializeFlowIfNeeded();
+ } catch (error) {
+ ckoLogger.error('Error re-initializing Flow:', error);
+ }
+}
+
+/**
+ * Check required fields status and handle Flow accordingly
+ */
+function checkRequiredFieldsStatus() {
+ const wereFilled = window.ckoFlowFieldsWereFilled || false;
+ const areFilled = requiredFieldsFilledAndValid();
+
+ ckoLogger.debug('checkRequiredFieldsStatus:', {
+ wereFilled: wereFilled,
+ areFilled: areFilled,
+ flowInitialized: ckoFlowInitialized,
+ flowComponentExists: !!ckoFlow.flowComponent
+ });
+
+ if (wereFilled && !areFilled) {
+ // Fields became unfilled
+ ckoLogger.debug('Required fields became unfilled - destroying Flow');
+ if (ckoFlowInitialized && ckoFlow.flowComponent) {
+ destroyFlowComponent();
+ showFlowWaitingMessage();
+ ckoFlowInitialized = false;
+ }
+ } else if (!wereFilled && areFilled) {
+ // Fields became filled - initialize Flow
+ ckoLogger.debug('Required fields became filled - initializing Flow');
+ if (!ckoFlowInitialized && !ckoFlowInitializing) {
+ initializeFlowIfNeeded();
+ } else if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow initialization already in progress, skipping');
+ }
+ } else if (areFilled && !ckoFlowInitialized && !ckoFlowInitializing) {
+ // Fields are filled but Flow not initialized - try to initialize
+ ckoLogger.debug('Fields are filled but Flow not initialized - attempting initialization');
+ initializeFlowIfNeeded();
+ } else if (areFilled && ckoFlowInitializing) {
+ ckoLogger.debug('Flow initialization already in progress, skipping duplicate call');
+ }
+
+ window.ckoFlowFieldsWereFilled = areFilled;
+}
+
+/**
+ * Debounced check for Flow reload when critical fields change
+ */
+let reloadFlowTimeout = null;
+function debouncedCheckFlowReload(fieldName, newValue) {
+ // Clear existing timeout
+ if (reloadFlowTimeout) {
+ clearTimeout(reloadFlowTimeout);
+ }
+
+ // Set new timeout
+ reloadFlowTimeout = setTimeout(() => {
+ // Only reload if Flow is initialized and field is actually filled
+ if (!ckoFlowInitialized || !ckoFlow.flowComponent) {
+ return;
+ }
+
+ // Check if all required fields are still filled
+ if (!requiredFieldsFilledAndValid()) {
+ // Fields became invalid - destroy Flow
+ destroyFlowComponent();
+ showFlowWaitingMessage();
+ ckoFlowInitialized = false;
+ return;
+ }
+
+ // Critical field changed - reload Flow
+ ckoLogger.debug(`Critical field ${fieldName} changed - reloading Flow`);
+ reloadFlowComponent();
+ }, 1000); // 1 second debounce for reload check
+}
+
+/**
+ * SIMPLIFIED: Single function to initialize Flow when needed
+ * Only initializes if:
+ * 1. Flow payment method is selected
+ * 2. Flow is not already initialized
+ * 3. Container exists
+ * 4. All required fields are filled (NEW)
+ */
+function initializeFlowIfNeeded() {
+ // CRITICAL: Prevent multiple simultaneous initializations
+ if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow initialization already in progress, skipping duplicate call');
+ return;
+ }
+
+ // CRITICAL: Don't initialize if we're handling a 3DS return
+ // Check flag first (set by early detection)
+ if (window.ckoFlow3DSReturn) {
+ console.log('[FLOW 3DS] ⚠️ initializeFlowIfNeeded: Blocked by 3DS return flag');
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.threeDS('Skipping Flow initialization - 3DS return in progress');
+ }
+ return;
+ }
+
+ // Also check URL parameters as fallback
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ console.log('[FLOW 3DS] ⚠️ initializeFlowIfNeeded: Blocked by 3DS return URL parameters');
+ window.ckoFlow3DSReturn = true;
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.threeDS('Skipping Flow initialization - 3DS return detected in URL');
+ }
+ return;
+ }
+
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ const flowContainer = document.getElementById("flow-container");
+ const flowComponentRoot = document.querySelector('[data-testid="checkout-web-component-root"]');
+
+ ckoLogger.debug('initializeFlowIfNeeded() state check:', {
+ flowPaymentExists: !!flowPayment,
+ flowPaymentChecked: flowPayment?.checked || false,
+ flowContainerExists: !!flowContainer,
+ flowComponentRootExists: !!flowComponentRoot,
+ flowInitialized: ckoFlowInitialized,
+ flowInitializing: ckoFlowInitializing,
+ flowComponentExists: !!ckoFlow.flowComponent
+ });
+
+ // Check if Flow payment method is selected
+ if (!flowPayment || !flowPayment.checked) {
+ ckoLogger.debug('Flow payment method not selected, skipping initialization');
+ return;
+ }
+
+ // Check if container exists
+ if (!flowContainer) {
+ ckoLogger.debug('Flow container not found, skipping initialization');
+ return;
+ }
+
+ // Check if already initialized and component is mounted
+ if (ckoFlowInitialized && ckoFlow.flowComponent && flowComponentRoot) {
+ ckoLogger.debug('Flow already initialized and mounted, skipping');
+ // Just ensure container is visible
+ flowContainer.style.display = "block";
+ document.body.classList.add("flow-method-selected");
+ hideFlowWaitingMessage(); // Hide waiting message if shown
+ return;
+ }
+
+ // NEW: Check if Flow can be initialized (validation check)
+ const canInit = canInitializeFlow();
+ ckoLogger.debug('canInitializeFlow() check result:', {
+ canInit: canInit,
+ flowPaymentSelected: !!flowPayment && flowPayment.checked,
+ containerExists: !!flowContainer,
+ cartTotal: cko_flow_vars?.cart_total,
+ isLoggedIn: isUserLoggedIn(),
+ hasBillingAddress: hasBillingAddress(),
+ requiredFieldsFilled: requiredFieldsFilled(),
+ requiredFieldsValid: requiredFieldsFilledAndValid()
+ });
+
+ if (!canInit) {
+ ckoLogger.debug('Cannot initialize Flow - validation failed');
+ // Show waiting message
+ document.body.classList.add("flow-method-selected");
+ showFlowWaitingMessage();
+ // Setup field watchers to check again when fields are filled
+ setupFieldWatchersForInitialization();
+ return;
+ }
+
+ // Hide waiting message if it was shown
+ hideFlowWaitingMessage();
+
+ // Initialize Flow
+ ckoLogger.debug('Initializing Flow - payment selected, container exists, validation passed');
+ document.body.classList.add("flow-method-selected");
+ flowContainer.style.display = "block";
+
+ // Mark fields as filled
+ window.ckoFlowFieldsWereFilled = true;
+
+ // Only initialize if not already initialized
+ if (!ckoFlowInitialized || !ckoFlow.flowComponent) {
+ // Set guard flag to prevent multiple simultaneous initializations
+ // NOTE: This flag will be cleared when component is mounted (in loadFlow callback)
+ // or on error (in catch block of loadFlow)
+ ckoFlowInitializing = true;
+
+ try {
+ ckoLogger.debug('Calling ckoFlow.init()...');
+ ckoFlow.init();
+ // Don't set ckoFlowInitialized = true here - it will be set when component mounts
+ // Don't clear ckoFlowInitializing here - it will be cleared when component mounts
+ } catch (error) {
+ ckoLogger.debug('Error during Flow initialization:', error);
+ ckoFlowInitialized = false;
+ ckoFlowInitializing = false; // Clear guard flag on error
+ throw error; // Re-throw to allow caller to handle
+ }
+ } else {
+ ckoLogger.debug('Skipping ckoFlow.init() - already initialized');
+ }
+}
+
+/**
+ * Setup field watchers for initialization
+ * Watches required fields and initializes Flow when they become filled
+ */
+function setupFieldWatchersForInitialization() {
+ // Only setup if Flow is not initialized
+ if (ckoFlowInitialized) {
+ return;
+ }
+
+ // Get all required field selectors
+ const requiredLabels = document.querySelectorAll(".woocommerce-checkout label .required");
+ const fieldSelectors = [];
+
+ requiredLabels.forEach((label) => {
+ const fieldId = label.closest("label").getAttribute("for");
+ if (fieldId && !fieldId.startsWith("shipping")) {
+ fieldSelectors.push('#' + fieldId);
+ }
+ });
+
+ // FALLBACK: If no fields found via .required selector, use common required fields
+ // This matches the fallback logic in requiredFieldsFilled()
+ if (fieldSelectors.length === 0) {
+ if (window.flowDebugLogging) {
+ ckoLogger.debug('setupFieldWatchersForInitialization: No fields found via .required, using fallback fields');
+ }
+
+ const commonRequiredFields = [
+ '#billing_email',
+ '#billing_first_name',
+ '#billing_last_name',
+ '#billing_address_1',
+ '#billing_city',
+ '#billing_country'
+ ];
+
+ // Check which fields exist and are required
+ commonRequiredFields.forEach(selector => {
+ const field = document.querySelector(selector);
+ if (field) {
+ const isRequired = field.hasAttribute('required') ||
+ field.hasAttribute('aria-required') ||
+ field.closest('label')?.querySelector('.required') !== null ||
+ field.closest('.form-row')?.classList.contains('validate-required');
+
+ const isVisible = field.offsetParent !== null &&
+ field.style.display !== 'none' &&
+ !field.hasAttribute('disabled');
+
+ if (isRequired && isVisible) {
+ fieldSelectors.push(selector);
+ }
+ }
+ });
+
+ if (window.flowDebugLogging) {
+ ckoLogger.debug('setupFieldWatchersForInitialization: Fallback fields to watch:', fieldSelectors);
+ }
+ }
+
+ // Add critical fields if not already included
+ const criticalFields = ['#billing_email', '#billing_country', '#billing_address_1', '#billing_city', '#billing_postcode'];
+ criticalFields.forEach(selector => {
+ if (!fieldSelectors.includes(selector)) {
+ fieldSelectors.push(selector);
+ }
+ });
+
+ // Setup watchers with debouncing
+ const debouncedCheck = debounce(() => {
+ ckoLogger.debug('Field watcher triggered - checking if Flow can initialize');
+ checkRequiredFieldsStatus();
+
+ // Also directly check if we can initialize now
+ if (!ckoFlowInitialized && canInitializeFlow()) {
+ ckoLogger.debug('Field watcher - all fields valid, initializing Flow');
+ initializeFlowIfNeeded();
+ }
+ }, 300); // Reduced debounce to 300ms for faster response
+
+ // Attach watchers to all required fields
+ fieldSelectors.forEach(selector => {
+ const field = document.querySelector(selector);
+ if (field) {
+ // Remove existing listener to avoid duplicates
+ jQuery(field).off('input change.flow-init');
+ // Add new listener
+ jQuery(field).on('input change.flow-init', debouncedCheck);
+ ckoLogger.debug('Field watcher attached:', selector);
+ }
+ });
+
+ // CRITICAL: Watch the account creation checkbox
+ // When this changes, account_username/account_password become required/not required
+ const createAccountCheckbox = document.querySelector('#createaccount');
+ if (createAccountCheckbox) {
+ jQuery(createAccountCheckbox).off('change.flow-init');
+ jQuery(createAccountCheckbox).on('change.flow-init', debouncedCheck);
+ ckoLogger.debug('Field watcher attached: #createaccount');
+ }
+
+ ckoLogger.debug('Field watchers setup for initialization', { fieldCount: fieldSelectors.length });
+
+ // Also check immediately if fields are already filled
+ setTimeout(() => {
+ if (!ckoFlowInitialized && canInitializeFlow()) {
+ ckoLogger.debug('Immediate check after watcher setup - fields already filled, initializing Flow');
+ initializeFlowIfNeeded();
+ }
+ }, 100);
+}
+
+/**
+ * Legacy function name for compatibility
+ * Now just calls the simplified initializeFlowIfNeeded()
+ */
+function handleFlowPaymentSelection() {
+ initializeFlowIfNeeded();
+}
+
+
+/**
+ * SIMPLIFIED: Protect Flow from updated_checkout destruction
+ * When WooCommerce updates checkout, it replaces the HTML which can destroy Flow component
+ * This handler checks if Flow was destroyed AFTER DOM update and re-initializes only if needed
+ */
+// Track previous cart total for change detection
+let previousCartTotal = typeof cko_flow_vars !== 'undefined' && cko_flow_vars.cart_total ? parseFloat(cko_flow_vars.cart_total) : 0;
+
+jQuery(document).on("updated_checkout", function () {
+ ckoLogger.debug('===== updated_checkout EVENT FIRED =====');
+
+ // Log field values BEFORE DOM update
+ const emailBefore = getCheckoutFieldValue("billing_email");
+ const addressBefore = getCheckoutFieldValue("billing_address_1");
+ const cityBefore = getCheckoutFieldValue("billing_city");
+ const countryBefore = getCheckoutFieldValue("billing_country");
+ const flowPaymentBefore = document.getElementById("payment_method_wc_checkout_com_flow");
+
+ ckoLogger.debug('State BEFORE updated_checkout:', {
+ email: emailBefore || 'EMPTY',
+ address1: addressBefore || 'EMPTY',
+ city: cityBefore || 'EMPTY',
+ country: countryBefore || 'EMPTY',
+ flowPaymentChecked: flowPaymentBefore?.checked || false,
+ flowInitialized: ckoFlowInitialized
+ });
+
+ // CRITICAL: Skip if we're handling a 3DS return (don't re-initialize Flow)
+ // Check both the flag and URL parameters
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('Skipping updated_checkout handler - 3DS return flag is set');
+ return;
+ }
+
+ // Also check URL parameters as fallback
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ ckoLogger.threeDS('Skipping updated_checkout handler - 3DS return detected in URL');
+ window.ckoFlow3DSReturn = true;
+ return;
+ }
+
+ // Check if cart total changed
+ if (typeof cko_flow_vars !== 'undefined' && cko_flow_vars.cart_total) {
+ const currentCartTotal = parseFloat(cko_flow_vars.cart_total) || 0;
+
+ // Check if cart total changed significantly (> 0.01 to avoid floating point issues)
+ if (Math.abs(currentCartTotal - previousCartTotal) > 0.01) {
+ ckoLogger.debug('Cart total changed - will reload Flow', {
+ previous: previousCartTotal,
+ current: currentCartTotal
+ });
+
+ // Update stored total
+ previousCartTotal = currentCartTotal;
+
+ // Reload Flow if initialized (after a small delay to let checkout update complete)
+ setTimeout(() => {
+ if (ckoFlowInitialized && ckoFlow.flowComponent && canInitializeFlow()) {
+ reloadFlowComponent();
+ }
+ }, 300);
+ }
+ }
+
+ ckoLogger.debug('updated_checkout event fired');
+ ckoLogger.debug('Flow state BEFORE updated_checkout:', {
+ flowInitialized: ckoFlowInitialized,
+ flowComponentExists: !!ckoFlow.flowComponent,
+ flowComponentRootExists: !!document.querySelector('[data-testid="checkout-web-component-root"]'),
+ flowContainerExists: !!document.getElementById("flow-container"),
+ flowPaymentChecked: document.getElementById("payment_method_wc_checkout_com_flow")?.checked || false
+ });
+
+ // CRITICAL: Wait for DOM to be updated by WooCommerce before checking
+ // WooCommerce replaces the HTML asynchronously, so we need to check after it completes
+ setTimeout(function() {
+ // CRITICAL: Check for 3DS return again in setTimeout callback
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('Skipping updated_checkout setTimeout callback - 3DS return in progress');
+ return;
+ }
+
+ // Also check URL parameters as fallback
+ const urlParamsCheck = new URLSearchParams(window.location.search);
+ const paymentIdCheck = urlParamsCheck.get("cko-payment-id");
+ const sessionIdCheck = urlParamsCheck.get("cko-session-id");
+ const paymentSessionIdCheck = urlParamsCheck.get("cko-payment-session-id");
+
+ if (paymentIdCheck || sessionIdCheck || paymentSessionIdCheck) {
+ ckoLogger.threeDS('Skipping updated_checkout setTimeout callback - 3DS return detected in URL');
+ window.ckoFlow3DSReturn = true;
+ return;
+ }
+
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ const flowComponentRoot = document.querySelector('[data-testid="checkout-web-component-root"]');
+ const flowContainer = document.getElementById("flow-container");
+
+ // Log field values AFTER DOM update (capture before values from closure)
+ const emailAfter = getCheckoutFieldValue("billing_email");
+ const addressAfter = getCheckoutFieldValue("billing_address_1");
+ const cityAfter = getCheckoutFieldValue("billing_city");
+ const countryAfter = getCheckoutFieldValue("billing_country");
+
+ ckoLogger.debug('===== updated_checkout: State AFTER 100ms delay =====');
+ ckoLogger.debug('Field values AFTER updated_checkout:', {
+ email: emailAfter || 'EMPTY',
+ address1: addressAfter || 'EMPTY',
+ city: cityAfter || 'EMPTY',
+ country: countryAfter || 'EMPTY',
+ fieldsChanged: {
+ email: emailBefore !== emailAfter,
+ address1: addressBefore !== addressAfter,
+ city: cityBefore !== cityAfter,
+ country: countryBefore !== countryAfter
+ }
+ });
+
+ ckoLogger.debug('Flow state AFTER updated_checkout (100ms delay):', {
+ flowPaymentExists: !!flowPayment,
+ flowPaymentChecked: flowPayment?.checked || false,
+ flowComponentRootExists: !!flowComponentRoot,
+ flowContainerExists: !!flowContainer,
+ flowInitialized: ckoFlowInitialized,
+ flowComponentExists: !!ckoFlow.flowComponent,
+ requiredFieldsFilled: requiredFieldsFilled(),
+ requiredFieldsValid: requiredFieldsFilledAndValid(),
+ canInitialize: canInitializeFlow()
+ });
+
+ // Only re-initialize if:
+ // 1. Flow payment method is still selected
+ // 2. Flow component is NOT mounted (was destroyed by updated_checkout)
+ // 3. Flow container exists (DOM was updated)
+ // 4. Flow is NOT currently initializing (prevent duplicate calls)
+ if (flowPayment && flowPayment.checked && flowContainer) {
+ if (!flowComponentRoot) {
+ // Check if initialization is already in progress
+ if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow component not mounted but initialization already in progress, skipping duplicate call');
+ return;
+ }
+
+ ckoLogger.debug('Flow component was destroyed by updated_checkout, re-initializing...');
+ // Reset flag so Flow can be re-initialized
+ ckoFlowInitialized = false;
+ ckoFlow.flowComponent = null;
+ // Re-initialize
+ initializeFlowIfNeeded();
+ } else {
+ ckoLogger.debug('Flow component still mounted after updated_checkout, no action needed');
+ }
+ } else if (flowPayment && flowPayment.checked && !flowContainer) {
+ // Check if initialization is already in progress
+ if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow container not found but initialization already in progress, skipping duplicate call');
+ return;
+ }
+
+ ckoLogger.debug('Flow payment selected but container not found yet, waiting...');
+ // Container might not be ready yet, check again after a short delay
+ setTimeout(function() {
+ const flowContainerRetry = document.getElementById("flow-container");
+ const flowComponentRootRetry = document.querySelector('[data-testid="checkout-web-component-root"]');
+ ckoLogger.debug('Retry check (300ms total):', {
+ flowContainerExists: !!flowContainerRetry,
+ flowComponentRootExists: !!flowComponentRootRetry,
+ flowInitializing: ckoFlowInitializing
+ });
+ if (flowContainerRetry && !flowComponentRootRetry && !ckoFlowInitializing) {
+ ckoLogger.debug('Flow container found on retry, re-initializing...');
+ ckoFlowInitialized = false;
+ ckoFlow.flowComponent = null;
+ initializeFlowIfNeeded();
+ } else if (flowContainerRetry && flowComponentRootRetry) {
+ ckoLogger.debug('Flow component found on retry, no re-initialization needed');
+ } else if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow initialization already in progress on retry, skipping');
+ } else {
+ ckoLogger.debug('Flow container still not found on retry');
+ }
+ }, 200);
+ } else {
+ ckoLogger.debug('Conditions not met for re-initialization:', {
+ flowPaymentExists: !!flowPayment,
+ flowPaymentChecked: flowPayment?.checked || false,
+ flowContainerExists: !!flowContainer
+ });
+ }
+ }, 100); // Wait 100ms for WooCommerce to finish updating DOM
+});
+
+/**
+ * Global handler for saved card selection (works in both new_payment_first and saved_cards_first modes)
+ * When a saved card is selected, show the Place Order button
+ * When new payment method is selected, ensure Flow container is visible and interactive
+ */
+jQuery(document).on(
+ "change",
+ 'input[name="wc-wc_checkout_com_flow-payment-token"]',
+ function () {
+ const selectedToken = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked');
+ const flowContainer = document.getElementById("flow-container");
+ const selectedId = selectedToken.attr('id');
+
+ // If "Use new payment method" is selected
+ if (selectedId === 'wc-wc_checkout_com_flow-payment-token-new') {
+ ckoLogger.debug('New payment method selected - showing Flow container');
+
+ // Show Flow container
+ if (flowContainer) {
+ flowContainer.style.display = "block";
+ }
+
+ // Mark as ready when Flow component is valid
+ if (ckoFlow.flowComponent) {
+ document.body.classList.add("flow-ready");
+ } else {
+ // Flow not initialized yet, wait for it
+ document.body.classList.remove("flow-ready");
+ }
+
+ // Scroll to Flow container
+ setTimeout(() => {
+ if (flowContainer) {
+ flowContainer.scrollIntoView({ behavior: 'smooth', block: 'nearest' });
+ }
+ }, 100);
+ }
+ // If a saved card is selected
+ else if (selectedToken.length > 0) {
+ ckoLogger.debug('Saved card selected - making Place Order button visible');
+ document.body.classList.add("flow-ready");
+
+ // Keep Flow container visible
+ if (flowContainer) {
+ flowContainer.style.display = "block";
+ }
+ }
+ }
+);
+
+/**
+ * Listen for changes in the payment method selection and handle the Flow payment method.
+ *
+ * This event listener listens for changes to the payment method selection form (typically a radio button).
+ * When a change is detected in the selection of the payment method, it checks if the selected input is
+ * the payment method field and triggers the Flow payment selection handler.
+ */
+document.addEventListener("change", function (event) {
+ if (event.target && event.target.name === "payment_method") {
+ ckoLogger.debug('===== PAYMENT METHOD CHANGE EVENT =====');
+ ckoLogger.debug('Changed payment method:', {
+ targetId: event.target.id,
+ targetValue: event.target.value,
+ targetChecked: event.target.checked
+ });
+
+ // Log all payment methods
+ const allPaymentMethods = document.querySelectorAll('input[name="payment_method"]');
+ const paymentMethodsState = [];
+ allPaymentMethods.forEach(pm => {
+ paymentMethodsState.push({
+ id: pm.id,
+ value: pm.value,
+ checked: pm.checked
+ });
+ });
+ ckoLogger.debug('All payment methods state:', paymentMethodsState);
+
+ // Immediately add flow-method-selected class if Flow is selected
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (flowPayment && flowPayment.checked) {
+ ckoLogger.debug('Checkout.com payment method SELECTED');
+ document.body.classList.add("flow-method-selected");
+ // Remove flow-ready until component is actually ready
+ document.body.classList.remove("flow-ready");
+ } else {
+ ckoLogger.debug('Checkout.com payment method NOT selected - other method selected');
+ // Remove Flow classes for other payment methods
+ document.body.classList.remove("flow-method-selected", "flow-ready");
+ // Reset Flow interaction flags when switching to other payment methods
+ window.flowUserInteracted = false;
+ window.flowSavedCardSelected = false;
+ }
+
+ handleFlowPaymentSelection();
+ }
+});
+
+/**
+ * SIMPLIFIED: Single DOMContentLoaded handler
+ * Handles initial Flow setup when page loads
+ */
+document.addEventListener("DOMContentLoaded", function () {
+ // CRITICAL: Check for 3DS return FIRST - before any other checks
+ // This must be the very first thing we check
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('DOMContentLoaded: 3DS return in progress, skipping ALL Flow initialization');
+ return; // Exit immediately - don't do anything else
+ }
+
+ // Also check URL parameters as a fallback (in case early detection didn't run)
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ ckoLogger.threeDS('DOMContentLoaded: 3DS return detected in URL, skipping Flow initialization');
+ window.ckoFlow3DSReturn = true;
+ return; // Don't initialize Flow during 3DS return
+ }
+
+ // Check if Flow payment method is selected on page load
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+
+ // If Flow is selected, check if we can initialize it
+ if (flowPayment && flowPayment.checked) {
+ ckoLogger.debug('DOMContentLoaded: Flow payment method is selected');
+ // Try to initialize - validation will happen inside initializeFlowIfNeeded()
+ initializeFlowIfNeeded();
+
+ // Also setup field watchers in case fields aren't filled yet
+ if (!ckoFlowInitialized) {
+ setupFieldWatchersForInitialization();
+
+ // Set up periodic check as fallback (every 2 seconds)
+ // This ensures Flow initializes even if field watchers don't trigger
+ const periodicCheck = setInterval(() => {
+ if (ckoFlowInitialized) {
+ clearInterval(periodicCheck);
+ return;
+ }
+
+ if (canInitializeFlow()) {
+ ckoLogger.debug('Periodic check - Flow can initialize, initializing now');
+ initializeFlowIfNeeded();
+ clearInterval(periodicCheck);
+ }
+ }, 2000);
+
+ // Clear interval after 30 seconds to avoid infinite checking
+ setTimeout(() => {
+ clearInterval(periodicCheck);
+ }, 30000);
+ }
+ }
+
+ // Handle order-pay page
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+ // Check if Flow payment method is selected before initializing
+ const orderPayFlowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (orderPayFlowPayment && orderPayFlowPayment.checked) {
+ ckoLogger.debug('DOMContentLoaded: Order-pay page detected, Flow payment method selected, initializing Flow...');
+ initializeFlowIfNeeded();
+ } else {
+ ckoLogger.debug('DOMContentLoaded: Order-pay page detected, but Flow payment method not selected');
+ }
+ }
+});
+
+/**
+ * Handle Place Order Button with Flow Checkout when ShowPayButton is False.
+ *
+ * This function listens for a click event on the "Place Order" button. If the checkout method
+ * is "Flow" and the user is using the checkout component, it validates the form and proceeds
+ * with the appropriate order placement, either using the Flow component or submitting the form directly.
+ *
+ */
+document.addEventListener("DOMContentLoaded", function () {
+
+ // Listen for saved card clicks to de-emphasize Flow
+ jQuery(document).on('click', 'input[name="wc-wc_checkout_com_flow-payment-token"]', function() {
+ const selectedId = jQuery(this).attr('id');
+ const flowContainer = document.getElementById("flow-container");
+
+ if (selectedId && selectedId !== 'wc-wc_checkout_com_flow-payment-token-new') {
+ ckoLogger.debug('Saved card selected');
+ window.flowUserInteracted = false;
+ window.flowSavedCardSelected = true;
+
+ // Remove the hidden override input if it exists (user switched back to saved card)
+ jQuery('#flow-new-payment-override').remove();
+ } else if (selectedId === 'wc-wc_checkout_com_flow-payment-token-new') {
+ ckoLogger.debug('New payment method selected - activating Flow');
+ window.activateFlowPayment();
+ }
+ });
+
+ // Function to activate Flow and deselect saved cards
+ // Make it globally accessible so onChange callback can use it
+ window.activateFlowPayment = function() {
+ console.log('[FLOW] Activating Flow payment method');
+
+ const flowContainer = document.getElementById("flow-container");
+ if (!flowContainer) return;
+
+ // Uncheck all saved card radio buttons (including any that might be hidden)
+ jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]').each(function() {
+ const radioId = jQuery(this).attr('id');
+ // Don't uncheck the "new payment method" radio
+ if (radioId !== 'wc-wc_checkout_com_flow-payment-token-new') {
+ jQuery(this).prop('checked', false);
+ jQuery(this).removeAttr('checked');
+ }
+ });
+
+ // Try to select "Use new payment method" radio button if it exists
+ const newPaymentRadio = document.getElementById('wc-wc_checkout_com_flow-payment-token-new');
+ if (newPaymentRadio) {
+ newPaymentRadio.checked = true;
+ jQuery(newPaymentRadio).attr('checked', 'checked');
+ jQuery(newPaymentRadio).trigger('change');
+ } else {
+ // If the "new payment method" radio doesn't exist, add a hidden input
+ jQuery('#flow-new-payment-override').remove();
+
+ const overrideInput = jQuery('', {
+ type: 'hidden',
+ id: 'flow-new-payment-override',
+ name: 'wc-wc_checkout_com_flow-payment-token',
+ value: 'new'
+ });
+ jQuery('form.checkout, form#order_review').append(overrideInput);
+ }
+
+ // Flow container is now active for new payment
+
+ // Clear saved card flag and mark for new Flow payment
+ window.flowSavedCardSelected = false;
+ window.flowUserInteracted = false; // Reset to allow user to interact with Flow
+ document.body.classList.add("flow-ready");
+
+ // Ensure Place Order button is visible
+ const placeOrderButton = document.getElementById('place_order');
+ if (placeOrderButton) {
+ placeOrderButton.style.display = 'block';
+ placeOrderButton.style.opacity = '1';
+ placeOrderButton.style.visibility = 'visible';
+ }
+ }
+
+ // Listen for clicks/focus on Flow component fields to auto-activate Flow
+ jQuery(document).on('click focus', '#flow-container input, #flow-container iframe, #flow-container', function(e) {
+ const flowContainer = document.getElementById("flow-container");
+
+ // Only activate if Flow is currently de-emphasized (saved card selected)
+ if (flowContainer && flowContainer.classList.contains('flow-de-emphasized')) {
+ console.log('[FLOW] User clicked on Flow field - auto-activating Flow');
+ window.activateFlowPayment();
+ }
+ });
+
+ /**
+ * Helper function to persist the save card checkbox value to sessionStorage
+ * This ensures the value survives 3DS redirects
+ */
+ function persistSaveCardCheckbox() {
+ const checkbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+
+ if (checkbox) {
+ // Store in sessionStorage to survive 3DS redirects
+ const value = checkbox.checked ? 'yes' : 'no';
+ sessionStorage.setItem('cko_flow_save_card', value);
+ ckoLogger.debug('SAVE CARD: Persisted checkbox value to sessionStorage:', value);
+ ckoLogger.debug('SAVE CARD: Checkbox found:', checkbox);
+ ckoLogger.debug('SAVE CARD: Checkbox checked:', checkbox.checked);
+ ckoLogger.debug('SAVE CARD: Checkbox visible:', checkbox.offsetParent !== null);
+
+ // Also set hidden field as backup
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ if (hiddenField) {
+ hiddenField.value = value;
+ ckoLogger.debug('SAVE CARD: Set hidden field value:', value);
+ } else {
+ ckoLogger.debug('SAVE CARD: WARNING: Hidden field not found!');
+ }
+
+ // Store in cookie as fallback (survives 3DS redirects)
+ // Set cookie with 1 hour expiry
+ const cookieName = 'cko_flow_save_card_preference';
+ document.cookie = cookieName + '=' + value + '; path=/; max-age=3600; SameSite=Lax';
+ ckoLogger.debug('SAVE CARD: Stored in cookie:', value);
+
+ // Also try to store in WooCommerce session via AJAX (survives 3DS redirects)
+ if (cko_flow_vars && cko_flow_vars.ajax_url && cko_flow_vars.payment_session_nonce) {
+ jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: 'POST',
+ data: {
+ action: 'cko_flow_store_save_card_preference',
+ nonce: cko_flow_vars.payment_session_nonce,
+ save_card_value: value
+ },
+ success: function(response) {
+ if (response.success) {
+ ckoLogger.debug('SAVE CARD: Stored in WooCommerce session:', value);
+ } else {
+ ckoLogger.debug('SAVE CARD: Failed to store in WooCommerce session:', response.data?.message);
+ }
+ },
+ error: function(xhr, status, error) {
+ ckoLogger.debug('SAVE CARD: AJAX error storing in WooCommerce session - Status:', status, 'Error:', error);
+ // Cookie fallback already set above
+ }
+ });
+ }
+ } else {
+ ckoLogger.debug('SAVE CARD: WARNING: Checkbox element not found in DOM!');
+ }
+ }
+
+ /**
+ * Restore save card checkbox value from sessionStorage after 3DS redirect
+ * This runs on every page load
+ */
+ function restoreSaveCardCheckbox() {
+ const savedValue = sessionStorage.getItem('cko_flow_save_card');
+
+ if (savedValue) {
+ ckoLogger.debug('SAVE CARD: Restoring checkbox value from sessionStorage:', savedValue);
+
+ // Set the hidden field value
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ if (hiddenField) {
+ hiddenField.value = savedValue;
+ ckoLogger.debug('SAVE CARD: Set hidden field to:', savedValue);
+ }
+
+ // Also check the checkbox if it exists
+ const checkbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ if (checkbox && savedValue === 'yes') {
+ checkbox.checked = true;
+ ckoLogger.debug('SAVE CARD: Checked the save card checkbox');
+ }
+
+ // Clear sessionStorage after restoring (optional - only clear after successful order)
+ // sessionStorage.removeItem('cko_flow_save_card');
+ }
+ }
+
+ // Restore checkbox value on page load (for 3DS returns)
+ document.addEventListener('DOMContentLoaded', function() {
+ // Check if we're on the order received page
+ const isOrderReceivedPage = window.location.pathname.includes('/order-received/') ||
+ window.location.pathname.includes('/checkout/thank-you/');
+
+ if (isOrderReceivedPage) {
+ // Clear the saved checkbox value after successful order
+ ckoLogger.debug('SAVE CARD: Order completed - clearing sessionStorage');
+ sessionStorage.removeItem('cko_flow_save_card');
+ } else {
+ // Restore checkbox value (for 3DS return to checkout page)
+ restoreSaveCardCheckbox();
+ }
+ });
+
+ // Listen for checkbox changes to update payment session URLs dynamically
+ jQuery(document).on('change', '#wc-wc_checkout_com_flow-new-payment-method', function() {
+ const checkbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ if (checkbox) {
+ const value = checkbox.checked ? 'yes' : 'no';
+ ckoLogger.debug('[SAVE CARD DEBUG] Checkbox changed - updating sessionStorage, hidden field, and WooCommerce session:', {
+ checked: checkbox.checked,
+ value: value
+ });
+
+ // Update sessionStorage
+ sessionStorage.setItem('cko_flow_save_card', value);
+
+ // Update hidden field
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ if (hiddenField) {
+ hiddenField.value = value;
+ ckoLogger.debug('[SAVE CARD DEBUG] Hidden field updated:', value);
+ }
+
+ // Store in cookie as fallback (survives 3DS redirects)
+ // Set cookie with 1 hour expiry
+ const cookieName = 'cko_flow_save_card_preference';
+ document.cookie = cookieName + '=' + value + '; path=/; max-age=3600; SameSite=Lax';
+ ckoLogger.debug('[SAVE CARD DEBUG] Stored in cookie:', value);
+
+ // Also try to store in WooCommerce session via AJAX (survives 3DS redirects)
+ if (cko_flow_vars && cko_flow_vars.ajax_url && cko_flow_vars.payment_session_nonce) {
+ jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: 'POST',
+ data: {
+ action: 'cko_flow_store_save_card_preference',
+ nonce: cko_flow_vars.payment_session_nonce,
+ save_card_value: value
+ },
+ success: function(response) {
+ if (response.success) {
+ ckoLogger.debug('[SAVE CARD DEBUG] Stored in WooCommerce session:', value);
+ } else {
+ ckoLogger.debug('[SAVE CARD DEBUG] Failed to store in WooCommerce session:', response.data?.message);
+ }
+ },
+ error: function(xhr, status, error) {
+ ckoLogger.debug('[SAVE CARD DEBUG] AJAX error storing in WooCommerce session - Status:', status, 'Error:', error, 'Response:', xhr.responseText);
+ // Cookie fallback already set above
+ }
+ });
+ }
+
+ // Note: Payment session URLs cannot be updated after creation,
+ // but backend will read from WooCommerce session as fallback
+ ckoLogger.debug('[SAVE CARD DEBUG] Checkbox value updated - will be read from WooCommerce session after 3DS redirect');
+ }
+ });
+
+ // Also try to restore immediately in case DOM is already loaded
+ if (document.readyState === 'loading') {
+ // DOM still loading, listener above will handle it
+ } else {
+ // DOM already loaded, check now
+ const isOrderReceivedPage = window.location.pathname.includes('/order-received/') ||
+ window.location.pathname.includes('/checkout/thank-you/');
+ if (isOrderReceivedPage) {
+ ckoLogger.debug('SAVE CARD: Order completed - clearing sessionStorage');
+ sessionStorage.removeItem('cko_flow_save_card');
+ } else {
+ restoreSaveCardCheckbox();
+ }
+ }
+
+ /**
+ * Create order before payment processing via AJAX.
+ * This ensures order exists before webhook arrives, preventing race conditions.
+ *
+ * @returns {PromisePlease fill in all required fields to continue with payment.
+Required fields: Email, Billing Address
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ saved_payment_methods();
+ }
+
+ // Render Save Card input.
+ $this->element_form_save_card( $save_card );
+ }
+
+ /**
+ * Override saved_payment_methods to show tokens from BOTH Flow and Classic Cards gateways.
+ * This allows merchants upgrading from Classic Cards to Flow to see their existing saved cards.
+ * No migration needed - the backend already handles both token types seamlessly.
+ *
+ * @since 5.0.0
+ * @return void
+ */
+ public function saved_payment_methods() {
+ if ( ! is_user_logged_in() ) {
+ return;
+ }
+
+ $user_id = get_current_user_id();
+
+ // Get tokens from BOTH gateways
+ $flow_tokens = WC_Payment_Tokens::get_customer_tokens( $user_id, $this->id );
+
+ $classic_gateway = new WC_Gateway_Checkout_Com_Cards();
+ $classic_tokens = WC_Payment_Tokens::get_customer_tokens( $user_id, $classic_gateway->id );
+
+ // Merge both token arrays
+ $all_tokens = array_merge( $flow_tokens, $classic_tokens );
+
+ // Log token retrieval for debugging
+ WC_Checkoutcom_Utility::logger( '=== MULTI-GATEWAY TOKEN RETRIEVAL ===' );
+ WC_Checkoutcom_Utility::logger( 'User ID: ' . $user_id );
+ WC_Checkoutcom_Utility::logger( 'Flow tokens found: ' . count( $flow_tokens ) );
+ WC_Checkoutcom_Utility::logger( 'Classic Cards tokens found: ' . count( $classic_tokens ) );
+ WC_Checkoutcom_Utility::logger( 'Total tokens (before dedup): ' . count( $all_tokens ) );
+
+ if ( empty( $all_tokens ) ) {
+ WC_Checkoutcom_Utility::logger( 'No saved cards found - skipping display' );
+ return;
+ }
+
+ // Remove duplicates based on token value (source ID)
+ $unique_tokens = array();
+ $seen_tokens = array();
+ foreach ( $all_tokens as $token ) {
+ $token_value = $token->get_token();
+ if ( ! in_array( $token_value, $seen_tokens, true ) ) {
+ $unique_tokens[] = $token;
+ $seen_tokens[] = $token_value;
+ }
+ }
+
+ WC_Checkoutcom_Utility::logger( 'Unique tokens (after dedup): ' . count( $unique_tokens ) );
+ WC_Checkoutcom_Utility::logger( '=== END MULTI-GATEWAY TOKEN RETRIEVAL ===' );
+
+ // Display saved payment methods (without extra label - already handled by accordion)
+ ?>
+ -
+ get_id() == $default_token_id );
+ $gateway_source = ( $token->get_gateway_id() === $this->id ) ? 'Flow' : 'Classic';
+ ?>
+
- + + class="woocommerce-SavedPaymentMethods-tokenInput" + data-gateway-source="" /> + + + +
- + /> + + +
' . esc_html__( 'Old webhooks cleaned up successfully.', 'checkout-com-unified-payments-api' ) . '
' . esc_html__( 'Webhook Queue', 'checkout-com-unified-payments-api' ) . '
'; + echo '' . esc_html__( 'Webhook Queue class not found.', 'checkout-com-unified-payments-api' ) . '
' . esc_html__( 'Webhook Queue', 'checkout-com-unified-payments-api' ) . '
'; + echo '' . sprintf(
+ esc_html__( 'Table %s does not exist. Please ensure the plugin is activated.', 'checkout-com-unified-payments-api' ),
+ '' . esc_html( $table_name ) . ''
+ ) . '
+
+
+
+
+
+ 100 ) : ?>
+
+ get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( "Checkout.com SDK not initialized - cannot perform $operation" );
+ return null;
+ }
+ return $builder;
+ }
+
+ /**
+ * Create payment and return response.
+ *
+ * @param WC_Order $order Order object.
+ * @param array $arg Arguments.
+ * @param string $subscription Subscription renewal flag.
+ * @param bool $retry_idempotency_key Retry idempotency.
+ *
+ * @return array
+ */
+ public static function create_payment( WC_Order $order, $arg, $subscription = null, $retry_idempotency_key = false ) {
+ // Get payment request parameter.
+ $request_param = WC_Checkoutcom_Api_Request::get_request_param( $order, $arg, $subscription );
+
+ $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+
+ $order_payment_method = $order->get_payment_method();
+
+ $is_sepa_renewal = ( 'wc_checkout_com_alternative_payments_sepa' === $order_payment_method ) && ( ! is_null( $subscription ) );
+ $is_google_pay_renewal = ( 'wc_checkout_com_google_pay' === $order_payment_method ) && ( ! is_null( $subscription ) );
+ $is_apple_pay_renewal = ( 'wc_checkout_com_apple_pay' === $order_payment_method ) && ( ! is_null( $subscription ) );
+ $is_paypal_renewal = ( 'wc_checkout_com_paypal' === $order_payment_method ) && ( ! is_null( $subscription ) );
+
+ // Initialize the Checkout Api.
+ $checkout = new Checkout_SDK();
+
+ try {
+ $three_ds_action_id = ( ! empty( WC()->session ) ) ? WC()->session->get( '3ds_action_id' ) : null;
+
+ $cko_idempotency_key = sprintf(
+ '%s-%s-%s',
+ $request_param->metadata['order_id'],
+ $order->get_order_key(),
+ $three_ds_action_id
+ );
+
+ // Append time.
+ if ( true === $retry_idempotency_key ) {
+ $cko_idempotency_key .= '-' . gmdate( 'Y-m-d h:i:s' );
+ }
+
+ // Call to create charge.
+ $builder = $checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot request payment' );
+ return array( 'error' => 'Payment gateway not properly configured. Please contact support.' );
+ }
+ $response = $builder->getPaymentsClient()->requestPayment( $request_param, $cko_idempotency_key );
+
+ // Check if payment successful.
+ if ( WC_Checkoutcom_Utility::is_successful( $response ) ) {
+ // Check if payment is 3D secure.
+ if ( WC_Checkoutcom_Utility::is_pending( $response ) ) {
+ // Check if SEPA renewal order.
+ if ( $is_sepa_renewal || $is_google_pay_renewal || $is_apple_pay_renewal || $is_paypal_renewal ) {
+
+ return $response;
+ }
+ // Check if redirection link exist.
+ if ( WC_Checkoutcom_Utility::get_redirect_url( $response ) ) {
+
+ if ( ! self::is_url_response_ok( WC_Checkoutcom_Utility::get_redirect_url( $response ) ) ) {
+ return [ '3d_redirection_error' => true ];
+ }
+
+ // return 3d redirection url.
+ return [ '3d' => WC_Checkoutcom_Utility::get_redirect_url( $response ) ];
+
+ } else {
+ $error_message = __( 'An error has occurred while processing your payment. Redirection link not found', 'checkout-com-unified-payments-api' );
+
+ WC_Checkoutcom_Utility::logger( $error_message, null );
+
+ return [ 'error' => $error_message ];
+ }
+ } else {
+
+ return $response;
+ }
+ } else {
+
+ // Set payment id post meta if the payment id declined.
+ if ( 'Declined' === $response['status'] ) {
+ $order->update_meta_data( '_cko_payment_id', $response['id'] );
+ $order->save();
+ }
+
+ $error_message = __( 'An error has occurred while processing your payment. Please check your card details and try again. ', 'checkout-com-unified-payments-api' );
+
+ // If the merchant enabled gateway response.
+ if ( $gateway_debug ) {
+ // Only show the decline reason in case the response code is not from a risk rule.
+ if ( ! preg_match( '/^(?:40)\d+$/', $response['response_code'] ) ) {
+ /* translators: 1: Response status, 2: Summary. */
+ $error_message .= sprintf( __( 'Status : %1$s, Response summary : %2$s', 'checkout-com-unified-payments-api' ), $response['status'], $response['response_summary'] );
+ }
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $response );
+
+ WC()->session->set( '3ds_action_id', $response['action_id'] );
+
+ return [ 'error' => $error_message ];
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $error_message = __( 'An error has occurred while processing your payment. ', 'checkout-com-unified-payments-api' );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ return [ 'error' => $error_message ];
+ }
+ }
+
+ /**
+ * Build payment request parameter.
+ *
+ * @param WC_Order $order Order object.
+ * @param string|array $arg Arguments.
+ * @param string $subscription Subscription renewal flag.
+ *
+ * @return PaymentRequest
+ */
+ private static function get_request_param( WC_Order $order, $arg, $subscription = null ) {
+ global $woocommerce, $wp_version;
+
+ $auto_capture = '1' === WC_Admin_Settings::get_option( 'ckocom_card_autocap', '1' );
+ $amount = $order->get_total();
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $amount, $order->get_currency() );
+ $three_d = '1' === WC_Admin_Settings::get_option( 'ckocom_card_threed', '0' ) && null === $subscription;
+ $attempt_no_three_d = '1' === WC_Admin_Settings::get_option( 'ckocom_card_notheed', '0' );
+ $dynamic_descriptor = '1' === WC_Admin_Settings::get_option( 'ckocom_card_desctiptor', '0' );
+ $mada_enable = '1' === WC_Admin_Settings::get_option( 'ckocom_card_mada', '0' );
+ $save_card = WC_Admin_Settings::get_option( 'ckocom_card_saved' );
+ $google_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings' );
+ $is_google_threeds = ! empty( $google_settings['ckocom_google_threed'] ) && 1 === absint( $google_settings['ckocom_google_threed'] ) && null === $subscription;
+ $is_paypal_renewal = ( 'wc_checkout_com_paypal' === $order->get_payment_method() ) && ( ! is_null( $subscription ) );
+
+ $is_save_card = false;
+ $payment_option = 'FramesJs';
+ $apms_settings = get_option( 'woocommerce_wc_checkout_com_alternative_payments_settings' );
+ $apms_selected = ! empty( $apms_settings['ckocom_apms_selector'] ) ? $apms_settings['ckocom_apms_selector'] : [];
+
+ $post_data = sanitize_post( $_POST );
+ $get_data = sanitize_post( $_GET );
+
+ // Cartes Bancaires card scheme.
+ $card_scheme = null;
+ if ( isset( $post_data['cko-card-scheme'] ) ) {
+ $card_scheme = $post_data['cko-card-scheme'];
+ } elseif ( isset( $arg['preferred_scheme'] ) ) {
+ $card_scheme = $arg['preferred_scheme'];
+ }
+
+ // For express checkout, if POST data doesn't have address info, get it from order
+ $customer_address = WC_Checkoutcom_Api_Request::customer_address( $post_data, $order );
+
+ // Prepare payment parameters.
+ if ( 'wc_checkout_com_cards' === $post_data['payment_method'] ) {
+
+ if ( self::is_using_saved_payment_method() ) {
+ // Saved card used.
+ // Load token id ($arg).
+ $token = WC_Payment_Tokens::get( $arg );
+
+ $card_scheme = $token->get_meta( 'preferred_scheme' );
+
+ // Get source_id from $token.
+ $source_id = $token->get_token();
+
+ $method = new RequestIdSource();
+ $method->id = $source_id;
+
+ $is_save_card = true;
+
+ if ( WC_Admin_Settings::get_option( 'ckocom_card_require_cvv' ) ) {
+ $method->cvv = $post_data['wc_checkout_com_cards-card-cvv'];
+ }
+ } else {
+ // New card used.
+ $method = new RequestTokenSource();
+ $method->token = $arg;
+ }
+ } elseif ( 'wc_checkout_com_google_pay' === $post_data['payment_method'] ) {
+ $payment_option = 'Google Pay';
+
+ $method = new RequestTokenSource();
+ $method->token = trim( $arg['token'] );
+
+ } elseif ( 'wc_checkout_com_apple_pay' === $post_data['payment_method'] ) {
+ $payment_option = 'Apple Pay';
+
+ $method = new RequestTokenSource();
+ $method->token = trim( $arg );
+
+ } elseif ( 'wc_checkout_com_paypal' === $post_data['payment_method'] ) {
+ $payment_option = 'PayPal';
+
+ $method = new RequestPayPalSource();
+
+ } elseif ( 'wc_checkout_com_flow' === $post_data['payment_method'] ) {
+ $payment_option = 'Flow';
+
+ if ( self::is_using_saved_payment_method() ) {
+ // Saved card used with Flow.
+ // Load token id ($arg).
+ $token = WC_Payment_Tokens::get( $arg );
+
+ // Enhanced error handling for old saved cards
+ if ( ! $token ) {
+ WC_Checkoutcom_Utility::logger( 'Error: Token not found for ID: ' . $arg );
+ return array(
+ 'error' => array(
+ 'type' => 'token_error',
+ 'message' => 'Saved payment method not found. Please try using a new payment method.',
+ ),
+ );
+ }
+
+ // Get source_id from $token with validation
+ $source_id = $token->get_token();
+ if ( empty( $source_id ) ) {
+ WC_Checkoutcom_Utility::logger( 'Error: Empty source_id for token ID: ' . $arg );
+ return array(
+ 'error' => array(
+ 'type' => 'token_error',
+ 'message' => 'Invalid saved payment method. Please try using a new payment method.',
+ ),
+ );
+ }
+
+ // Safely get card scheme metadata (may not exist in old tokens)
+ $card_scheme = $token->get_meta( 'preferred_scheme' );
+ if ( empty( $card_scheme ) ) {
+ WC_Checkoutcom_Utility::logger( 'Warning: No preferred_scheme metadata for token ID: ' . $arg . ' (likely old saved card)' );
+ }
+
+ $method = new RequestIdSource();
+ $method->id = $source_id;
+
+ $is_save_card = true;
+
+ if ( WC_Admin_Settings::get_option( 'ckocom_card_require_cvv' ) ) {
+ $method->cvv = $post_data['wc_checkout_com_flow-card-cvv'];
+ }
+
+ WC_Checkoutcom_Utility::logger( 'Flow saved card processing - Token ID: ' . $arg . ', Source ID: ' . $source_id . ', Card Scheme: ' . ( $card_scheme ?: 'none' ) );
+ } else {
+ // New payment via Flow - this shouldn't happen as Flow handles new payments differently
+ // But we need to handle it to prevent null method
+ $method = new RequestTokenSource();
+ $method->token = $arg;
+ }
+
+ } elseif ( in_array( $arg, $apms_selected, true ) ) {
+ // Alternative payment method selected.
+ $method = WC_Checkoutcom_Api_Request::get_apm_method( $post_data, $order, $arg );
+
+ $payment_option = $method->type;
+ } elseif ( ! is_null( $subscription ) ) {
+
+ $method = new RequestIdSource();
+ $method->id = $arg['source_id'];
+ }
+
+ // Safety check to prevent null method error
+ if ( null === $method ) {
+ WC_Checkoutcom_Utility::logger( 'Error: Payment method is null in get_request_param' );
+ return array(
+ 'error' => array(
+ 'type' => 'request_error',
+ 'message' => 'Payment method not supported or invalid.',
+ ),
+ );
+ }
+
+ if ( 'klarna' !== $method->type ) {
+ // Set billing address in $method.
+ if ( ! empty( $customer_address['billing_address_1'] ) && ! empty( $customer_address['billing_country'] ) ) {
+ $billing_address_param = new Address();
+ $billing_address_param->address_line1 = $customer_address['billing_address_1'];
+ $billing_address_param->address_line2 = $customer_address['billing_address_2'];
+ $billing_address_param->city = $customer_address['billing_city'];
+ $billing_address_param->state = $customer_address['billing_state'];
+ $billing_address_param->zip = $customer_address['billing_postcode'];
+ $billing_address_param->country = $customer_address['billing_country'];
+ $method->billing_address = $billing_address_param;
+ }
+ }
+
+ $checkout = new Checkout_SDK();
+ $payment = $checkout->get_payment_request();
+ $payment->capture = $auto_capture;
+ $payment->amount = $amount_cents;
+ $payment->currency = $order->get_currency();
+ $payment->reference = $order->get_order_number();
+ $payment->payment_type = PaymentType::$regular;
+
+ $payment->source = $method;
+
+ // Get email and name from POST data or order (for express checkout)
+ $email = isset( $post_data['billing_email'] ) ? $post_data['billing_email'] : '';
+ $name = isset( $post_data['billing_first_name'] ) && isset( $post_data['billing_last_name'] )
+ ? $post_data['billing_first_name'] . ' ' . $post_data['billing_last_name']
+ : '';
+
+ // Pay Order Page.
+ $is_pay_order = ! empty( $get_data['pay_for_order'] ) && (bool) $get_data['pay_for_order'];
+
+ // Check if this is express checkout (POST data doesn't have address info)
+ $is_express_checkout = empty( $customer_address['billing_address_1'] ) && empty( $customer_address['billing_city'] ) && ! empty( $order );
+
+ if ( $is_pay_order ) {
+ if ( ! empty( $get_data['order_id'] ) ) {
+ $order_id = $get_data['order_id'];
+ } elseif ( ! empty( $get_data['key'] ) ) {
+ $order_id = wc_get_order_id_by_order_key( $get_data['key'] );
+ }
+
+ $order = wc_get_order( $order_id );
+
+ $email = $order->get_billing_email();
+ $name = $order->get_billing_first_name() . ' ' . $order->get_billing_last_name();
+ } elseif ( $is_express_checkout && ! empty( $order ) ) {
+ // Express checkout: Get email and name from order when POST data is empty
+ $email = $order->get_billing_email();
+ $name = $order->get_billing_first_name() . ' ' . $order->get_billing_last_name();
+ }
+
+ // Customer.
+ $customer = new CustomerRequest();
+ $customer->email = $email;
+ $customer->name = $name;
+
+ $payment->customer = $customer;
+
+ // Check for the subscription flag.
+ if ( ! is_null( $subscription ) ) {
+ $payment->merchant_initiated = true;
+ $payment->payment_type = PaymentType::$recurring;
+ $payment->capture = true;
+
+ if ( 'wc_checkout_com_alternative_payments_sepa' !== $order->get_payment_method() ) {
+ $parent_order = wc_get_order( $arg['parent_order_id'] );
+ $payment->previous_payment_id = $parent_order->get_meta( '_cko_payment_id', true ) ?? null;
+ }
+ } elseif ( function_exists( 'wcs_order_contains_subscription' ) ) {
+ if ( wcs_order_contains_subscription( $order, 'parent' ) ) {
+ $payment->merchant_initiated = false;
+ $payment->payment_type = PaymentType::$recurring;
+
+ // For PayPal subscription order.
+ if ( 'paypal' === $method->type ) {
+ $method->plan = [ 'type' => 'MERCHANT_INITIATED_BILLING' ];
+ }
+ }
+ }
+
+ $three_ds = new ThreeDsRequest();
+ $three_ds->enabled = $three_d;
+ $three_ds->attempt_n3d = $attempt_no_three_d;
+
+ if ( 'wc_checkout_com_cards' === $post_data['payment_method']
+ && $three_d
+ && $save_card
+ && (
+ isset( $post_data['wc-wc_checkout_com_cards-new-payment-method'] )
+ && sanitize_text_field( $post_data['wc-wc_checkout_com_cards-new-payment-method'] )
+ )
+ ) {
+ $three_ds->challenge_indicator = ChallengeIndicatorType::$challenge_requested_mandate;
+ }
+
+ if ( $dynamic_descriptor ) {
+ $descriptor_name = WC_Admin_Settings::get_option( 'ckocom_card_desctiptor_name' );
+ $descriptor_city = WC_Admin_Settings::get_option( 'ckocom_card_desctiptor_city' );
+
+ $descriptor = new BillingDescriptor();
+ $descriptor->name = $descriptor_name;
+ $descriptor->city = $descriptor_city;
+
+ $payment->billing_descriptor = $descriptor;
+ }
+
+ // Set 3Ds to payment request.
+ if ( 'wc_checkout_com_google_pay' === $post_data['payment_method'] && ( $is_google_threeds && 'pan_only' === $arg['token_format'] ) ) {
+ $payment->three_ds = new ThreeDsRequest();
+ } elseif ( 'wc_checkout_com_google_pay' !== $post_data['payment_method'] ) {
+ $payment->three_ds = $three_ds;
+ }
+
+ // Set shipping Address.
+ if ( ! empty( $customer_address['shipping_address_1'] ) && ! empty( $customer_address['shipping_country'] ) ) {
+ $shipping_address_param = new Address();
+ $shipping_address_param->address_line1 = $customer_address['shipping_address_1'];
+ $shipping_address_param->address_line2 = $customer_address['shipping_address_2'];
+ $shipping_address_param->city = $customer_address['shipping_city'];
+ $shipping_address_param->state = $customer_address['shipping_state'];
+ $shipping_address_param->zip = $customer_address['shipping_postcode'];
+ $shipping_address_param->country = $customer_address['shipping_country'];
+
+ $shipping_details = new ShippingDetails();
+ $shipping_details->address = $shipping_address_param;
+
+ $payment->shipping = $shipping_details;
+ }
+
+ // Set redirection url in payment request.
+ $redirection_url = add_query_arg( 'wc-api', 'wc_checkoutcom_callback', home_url( '/' ) );
+
+ if ( cko_is_nas_account() ) {
+ $redirection_url = home_url( '/checkoutcom-callback' );
+ }
+
+ $payment->success_url = $redirection_url;
+ $payment->failure_url = $redirection_url;
+
+ $udf5 = sprintf(
+ 'Platform Data - WordPress %s / Woocommerce %s, Integration Data - Checkout.com %s, SDK Data - PHP SDK %s, Order ID - %s, Server - %s',
+ $wp_version,
+ $woocommerce->version,
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ CheckoutUtils::PROJECT_VERSION,
+ $order->get_order_number(),
+ get_site_url()
+ );
+
+ $metadata = [
+ 'udf5' => $udf5,
+ 'order_id' => $order->get_id(),
+ ];
+
+ // set capture delay if payment action is authorise and capture.
+ if ( $auto_capture ) {
+ $payment->capture_on = WC_Checkoutcom_Utility::get_delayed_capture_timestamp();
+ }
+
+ // check if mada is enabled in module setting.
+ if ( $mada_enable ) {
+ $is_mada = false;
+
+ if ( ! empty( $post_data['cko-card-bin'] ) ) {
+ $is_mada = WC_Checkoutcom_Utility::is_mada_card( $post_data['cko-card-bin'] );
+ } else {
+
+ if ( $is_save_card ) {
+ // check if souce_id is a mada card.
+ // load token by id ($arg).
+ $token = WC_Payment_Tokens::get( $arg );
+ // check if source_id is mada.
+ $is_mada = $token->get_meta( 'is_mada' );
+
+ if ( $is_mada ) {
+ $method->cvv = $post_data['wc_checkout_com_cards-card-cvv'];
+ }
+ }
+ }
+
+ if ( $is_mada ) {
+ $payment->capture = true;
+ $payment->capture_on = null;
+ $payment->three_ds = new ThreeDsRequest();
+ $metadata = array_merge( $metadata, [ 'udf1' => 'Mada' ] );
+ }
+
+ // Set is_mada in session.
+ $_SESSION['cko-is-mada'] = $is_mada;
+ }
+
+ // Cartes Bancaires card scheme.
+ if ( ! empty( $card_scheme ) ) {
+ $processing_settings = new ProcessingSettings();
+
+ if ( in_array(
+ $card_scheme,
+ [
+ PreferredSchema::$visa,
+ PreferredSchema::$mastercard,
+ PreferredSchema::$cartes_bancaires,
+ ],
+ true
+ ) ) {
+ $processing_settings->preferred_scheme = $card_scheme;
+ $payment->processing = $processing_settings;
+ }
+ }
+
+ // If this is MOTO order (Admin-created order + Order-pay page + Guest customer).
+ $is_order_pay_page = ! empty( $_GET['pay_for_order'] ) && (bool) $_GET['pay_for_order'];
+ $is_guest_customer = $order->get_customer_id() == 0; // Guest customer = no customer account
+
+ if ( $order->is_created_via( 'admin' ) && $is_order_pay_page && $is_guest_customer ) {
+ $payment->payment_type = PaymentType::$moto;
+ unset( $payment->three_ds );
+ WC_Checkoutcom_Utility::logger( 'MOTO payment type set - Admin order + Order-pay page + Guest customer. Order ID: ' . $order->get_id() );
+ }
+
+ // PayPal add items to payment.
+ if ( 'paypal' === $method->type || $is_paypal_renewal ) {
+ $payment->items = self::get_paypal_products( $order );
+ }
+
+ // Set metadata info in payment request.
+ $payment->metadata = $metadata;
+
+ // Set customer ip address in payment request.
+ $payment->payment_ip = $order->get_customer_ip_address();
+
+ return $payment;
+ }
+
+ /**
+ * Return customer address.
+ *
+ * @param array $data Post data.
+ * @param WC_Order $order Order object (optional, used for express checkout when POST data is empty).
+ *
+ * @return array
+ */
+ private static function customer_address( $data, $order = null ) {
+ // Pay Order Page.
+ $is_pay_order = ! empty( $_GET['pay_for_order'] ) ? (bool) $_GET['pay_for_order'] : false;
+
+ $billing_first_name = empty( $data['billing_first_name'] ) ? '' : wc_clean( $data['billing_first_name'] );
+ $billing_last_name = empty( $data['billing_last_name'] ) ? '' : wc_clean( $data['billing_last_name'] );
+ $billing_address_1 = empty( $data['billing_address_1'] ) ? '' : wc_clean( $data['billing_address_1'] );
+ $billing_address_2 = empty( $data['billing_address_2'] ) ? '' : wc_clean( $data['billing_address_2'] );
+ $billing_city = empty( $data['billing_city'] ) ? '' : wc_clean( $data['billing_city'] );
+ $billing_state = empty( $data['billing_state'] ) ? '' : wc_clean( $data['billing_state'] );
+ $billing_postcode = empty( $data['billing_postcode'] ) ? '' : wc_clean( $data['billing_postcode'] );
+ $billing_country = empty( $data['billing_country'] ) ? '' : wc_clean( $data['billing_country'] );
+
+ // Check if POST data is empty (express checkout scenario) and we have an order
+ $is_express_checkout = empty( $billing_address_1 ) && empty( $billing_city ) && ! empty( $order );
+
+ if ( isset( $data['ship_to_different_address'] ) ) {
+ $shipping_first_name = empty( $data['shipping_first_name'] ) ? '' : wc_clean( $data['shipping_first_name'] );
+ $shipping_last_name = empty( $data['shipping_last_name'] ) ? '' : wc_clean( $data['shipping_last_name'] );
+ $shipping_address_1 = empty( $data['shipping_address_1'] ) ? '' : wc_clean( $data['shipping_address_1'] );
+ $shipping_address_2 = empty( $data['shipping_address_2'] ) ? '' : wc_clean( $data['shipping_address_2'] );
+ $shipping_city = empty( $data['shipping_city'] ) ? '' : wc_clean( $data['shipping_city'] );
+ $shipping_state = empty( $data['shipping_state'] ) ? '' : wc_clean( $data['shipping_state'] );
+ $shipping_postcode = empty( $data['shipping_postcode'] ) ? '' : wc_clean( $data['shipping_postcode'] );
+ $shipping_country = empty( $data['shipping_country'] ) ? '' : wc_clean( $data['shipping_country'] );
+ } elseif ( $is_pay_order ) {
+
+ // In case payment is from pay_order.
+ // Get billing and shipping details from order.
+ if ( ! empty( $_GET['order_id'] ) ) {
+ $order_id = $_GET['order_id'];
+ } elseif ( ! empty( $_GET['key'] ) ) {
+ $order_id = wc_get_order_id_by_order_key( $_GET['key'] );
+ }
+
+ $order = wc_get_order( $order_id );
+
+ $billing_first_name = $order->get_billing_first_name();
+ $billing_last_name = $order->get_billing_last_name();
+ $billing_address_1 = $order->get_billing_address_1();
+ $billing_address_2 = $order->get_billing_address_2();
+ $billing_city = $order->get_billing_city();
+ $billing_state = $order->get_billing_state();
+ $billing_postcode = $order->get_billing_postcode();
+ $billing_country = $order->get_billing_country();
+
+ $shipping_first_name = $order->get_shipping_first_name();
+ $shipping_last_name = $order->get_shipping_last_name();
+ $shipping_address_1 = $order->get_shipping_address_1();
+ $shipping_address_2 = $order->get_shipping_address_2();
+ $shipping_city = $order->get_shipping_city();
+ $shipping_state = $order->get_shipping_state();
+ $shipping_postcode = $order->get_shipping_postcode();
+ $shipping_country = $order->get_shipping_country();
+
+ } elseif ( $is_express_checkout && ! empty( $order ) ) {
+ // Express checkout: Get billing and shipping details from order when POST data is empty
+ $billing_first_name = $order->get_billing_first_name();
+ $billing_last_name = $order->get_billing_last_name();
+ $billing_address_1 = $order->get_billing_address_1();
+ $billing_address_2 = $order->get_billing_address_2();
+ $billing_city = $order->get_billing_city();
+ $billing_state = $order->get_billing_state();
+ $billing_postcode = $order->get_billing_postcode();
+ $billing_country = $order->get_billing_country();
+
+ $shipping_first_name = $order->get_shipping_first_name();
+ $shipping_last_name = $order->get_shipping_last_name();
+ $shipping_address_1 = $order->get_shipping_address_1();
+ $shipping_address_2 = $order->get_shipping_address_2();
+ $shipping_city = $order->get_shipping_city();
+ $shipping_state = $order->get_shipping_state();
+ $shipping_postcode = $order->get_shipping_postcode();
+ $shipping_country = $order->get_shipping_country();
+ } else {
+ $shipping_first_name = $billing_first_name;
+ $shipping_last_name = $billing_last_name;
+ $shipping_address_1 = $billing_address_1;
+ $shipping_address_2 = $billing_address_2;
+ $shipping_city = $billing_city;
+ $shipping_state = $billing_state;
+ $shipping_postcode = $billing_postcode;
+ $shipping_country = $billing_country;
+ }
+
+ return [
+ 'billing_first_name' => $billing_first_name,
+ 'billing_last_name' => $billing_last_name,
+ 'billing_address_1' => $billing_address_1,
+ 'billing_address_2' => $billing_address_2,
+ 'billing_city' => $billing_city,
+ 'billing_state' => $billing_state,
+ 'billing_postcode' => $billing_postcode,
+ 'billing_country' => $billing_country,
+ 'shipping_first_name' => $shipping_first_name,
+ 'shipping_last_name' => $shipping_last_name,
+ 'shipping_address_1' => $shipping_address_1,
+ 'shipping_address_2' => $shipping_address_2,
+ 'shipping_city' => $shipping_city,
+ 'shipping_state' => $shipping_state,
+ 'shipping_postcode' => $shipping_postcode,
+ 'shipping_country' => $shipping_country,
+ ];
+ }
+
+ /**
+ * Verify session id given by checkout api on checkout.
+ *
+ * @param string $session_id Session id.
+ *
+ * @return array|mixed
+ */
+ public static function verify_session( $session_id ) {
+ $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+
+ // Initialize the Checkout Api.
+ $checkout = new Checkout_SDK();
+
+ try {
+
+ // Get payment response.
+ $builder = $checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot get payment details' );
+ return array( 'error' => 'Payment gateway not properly configured. Please contact support.' );
+ }
+ $response = $builder->getPaymentsClient()->getPaymentDetails( $session_id );
+
+ // Check if payment is successful.
+ if ( WC_Checkoutcom_Utility::is_successful( $response ) ) {
+
+ return $response;
+ } else {
+
+ // Set payment id post meta if the payment id declined.
+ if ( 'Declined' === $response['status'] ) {
+ $order = wc_get_order( $response['metadata']['order_id'] );
+ $order->update_meta_data( '_cko_payment_id', $response['id'] );
+ $order->save();
+ }
+
+ $error_message = __( 'An error has occurred while processing your payment. Please check your card details and try again.', 'checkout-com-unified-payments-api' );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ if ( ! empty( $response['actions'] ) ) {
+ $action = $response['actions'][0];
+
+ /* translators: 1: Response status, 2: Summary. */
+ $error_message .= sprintf( __( 'Status : %1$s, Response summary : %2$s', 'checkout-com-unified-payments-api' ), $response['status'], $action['response_summary'] );
+ }
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $response );
+
+ WC()->session->set( '3ds_action_id', $response['actions'][0]['id'] );
+
+ $arr = [ 'error' => $error_message ];
+
+ $metadata = $response['metadata'];
+
+ // Check if card verification.
+ if ( isset( $metadata['card_verification'] ) ) {
+ $arr = [
+ 'card_verification' => 'error',
+ 'redirection_url' => $metadata['redirection_url'],
+ ];
+ }
+
+ return $arr;
+ }
+ } catch ( CheckoutApiException $ex ) {
+
+ $error_message = __( 'An error has occurred while processing your payment. ', 'checkout-com-unified-payments-api' );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ return [ 'error' => $error_message ];
+ }
+ }
+
+ /**
+ * Generate the Google token from Google payment data
+ *
+ * @return mixed
+ */
+ public static function generate_google_token() {
+ // Protocol version is safe to sanitize
+ $protocol_version = sanitize_text_field( $_POST['cko-google-protocolVersion'] );
+
+ // Signature and signedMessage are base64-encoded strings that should NOT be sanitized
+ // as sanitize_text_field can corrupt base64 data.
+ // IMPORTANT: For classic Google Pay, form POST data is automatically processed by WordPress
+ // For express AJAX, the data comes directly and may already be in the correct format
+ // wp_unslash on signedMessage can reduce it from 672 to 658 chars, corrupting it
+ // So we should check if wp_unslash changes the length, and if so, use the original
+ $signature_raw = $_POST['cko-google-signature'];
+ $signed_message_raw = $_POST['cko-google-signedMessage'];
+
+ // Apply wp_unslash to match classic Google Pay form POST behavior
+ $signature = wp_unslash( $signature_raw );
+ $signed_message_unslashed = wp_unslash( $signed_message_raw );
+
+ // If wp_unslash reduced the signedMessage length, it's corrupting it
+ // Use the original instead (for express AJAX, it's already in the correct format)
+ if ( strlen( $signed_message_unslashed ) < strlen( $signed_message_raw ) ) {
+ $signed_message = $signed_message_raw;
+
+ // Check if signedMessage has escaped quotes (from AJAX POST)
+ // If signedMessage has \" instead of ", we need to unescape it
+ if ( strpos( $signed_message, '\\"' ) !== false ) {
+ // Unescape quotes: \" -> "
+ $signed_message = str_replace( '\\"', '"', $signed_message );
+ // Also unescape backslashes: \\ -> \
+ $signed_message = str_replace( '\\\\', '\\', $signed_message );
+ }
+ } else {
+ $signed_message = $signed_message_unslashed;
+ }
+
+ $checkout = new Checkout_SDK();
+
+ $google_pay = new GooglePayTokenData();
+ $google_pay->signature = $signature;
+
+ // PHPCS:disable WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
+ $google_pay->protocolVersion = $protocol_version;
+ $google_pay->signedMessage = $signed_message;
+ // PHPCS:enable WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
+
+ try {
+
+ $google_pay_token_request = new GooglePayTokenRequest();
+ $google_pay_token_request->token_data = $google_pay;
+
+ $builder = $checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot request Google Pay token' );
+ return array( 'error' => 'Payment gateway not properly configured. Please contact support.' );
+ }
+ $token = $builder->getTokensClient()->requestWalletToken( $google_pay_token_request );
+
+ return [
+ 'token' => $token['token'],
+ 'token_format' => $token['token_format'],
+ ];
+ } catch ( CheckoutApiException $ex ) {
+ $error_message = __( 'An error has occurred while processing your Google pay payment.', 'checkout-com-unified-payments-api' );
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ return array( 'error' => $error_message . ' ' . $ex->getMessage() );
+ }
+ }
+
+ /**
+ * Perform capture.
+ *
+ * @param int $order_id Order ID.
+ *
+ * @return array|mixed
+ */
+ public static function capture_payment( $order_id ) {
+ $order = wc_get_order( $order_id );
+ $cko_payment_id = $order->get_meta( '_cko_payment_id' );
+
+ // Check if cko_payment_id is empty.
+ if ( empty( $cko_payment_id ) ) {
+ $error_message = esc_html__( 'An error has occurred. No Cko Payment Id', 'checkout-com-unified-payments-api' );
+
+ return [ 'error' => $error_message ];
+ }
+
+ $amount = $order->get_total();
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $amount, $order->get_currency() );
+ $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+
+ // Initialize the Checkout Api.
+ $checkout = new Checkout_SDK();
+
+ try {
+ // Check if payment is already voided or captured on checkout.com hub.
+ $details = $checkout->get_builder()->getPaymentsClient()->getPaymentDetails( $cko_payment_id );
+
+ if ( 'Voided' === $details['status'] || 'Captured' === $details['status'] ) {
+ $error_message = sprintf(
+ /* translators: 1: Order ID. */
+ esc_html__( 'Payment has already been voided or captured on Checkout.com hub for order Id : %s', 'checkout-com-unified-payments-api' ),
+ $order_id
+ );
+
+ return [ 'error' => $error_message ];
+ }
+
+ // Get capture request object for NAS or ABC.
+ $capture_request = $checkout->get_capture_request();
+ $capture_request->amount = $amount_cents;
+ $capture_request->reference = $order->get_order_number();
+
+ $response = $checkout->get_builder()->getPaymentsClient()->capturePayment( $cko_payment_id, $capture_request );
+
+ if ( ! WC_Checkoutcom_Utility::is_successful( $response ) ) {
+ $error_message = sprintf(
+ /* translators: 1: Order ID. */
+ esc_html__( 'An error has occurred while processing your capture payment on Checkout.com hub. Order Id : %s', 'checkout-com-unified-payments-api' ),
+ $order_id
+ );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $response;
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $response );
+
+ return [ 'error' => $error_message ];
+ } else {
+ return $response;
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $error_message = esc_html__( 'An error has occurred while processing your capture request.', 'checkout-com-unified-payments-api' );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ return [ 'error' => $error_message ];
+ }
+ }
+
+ /**
+ * Perform Void.
+ *
+ * @param int $order_id Order ID.
+ *
+ * @return array|mixed
+ */
+ public static function void_payment( $order_id ) {
+ $order = wc_get_order( $order_id );
+ $cko_payment_id = $order->get_meta( '_cko_payment_id' );
+
+ // Check if cko_payment_id is empty.
+ if ( empty( $cko_payment_id ) ) {
+ $error_message = esc_html__( 'An error has occurred. No Cko Payment Id', 'checkout-com-unified-payments-api' );
+
+ return [ 'error' => $error_message ];
+ }
+
+ $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+
+ // Initialize the Checkout Api.
+ $checkout = new Checkout_SDK();
+
+ try {
+ // Check if payment is already voided or captured on checkout.com hub.
+ $details = $checkout->get_builder()->getPaymentsClient()->getPaymentDetails( $cko_payment_id );
+
+ if ( 'Voided' === $details['status'] || 'Captured' === $details['status'] ) {
+ $error_message = sprintf(
+ /* translators: 1: Order ID. */
+ esc_html__( 'Payment has already been voided or captured on Checkout.com hub for order Id : %s', 'checkout-com-unified-payments-api' ),
+ $order_id
+ );
+
+ return [ 'error' => $error_message ];
+ }
+
+ // Prepare void payload.
+ $void_request = new VoidRequest();
+ $void_request->reference = $order_id;
+
+ // Process void payment on checkout.com.
+ $response = $checkout->get_builder()->getPaymentsClient()->voidPayment( $cko_payment_id, $void_request );
+
+ if ( ! WC_Checkoutcom_Utility::is_successful( $response ) ) {
+ $error_message = sprintf(
+ /* translators: 1: Order ID. */
+ esc_html__( 'An error has occurred while processing your void payment on Checkout.com hub. Order Id : %s', 'checkout-com-unified-payments-api' ),
+ $order_id
+ );
+
+ // check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $response;
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $response );
+
+ return [ 'error' => $error_message ];
+ } else {
+ return $response;
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $error_message = esc_html__( 'An error has occurred while processing your void request.', 'checkout-com-unified-payments-api' );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ return [ 'error' => $error_message ];
+ }
+ }
+
+ /**
+ * Perform Refund.
+ *
+ * @param int $order_id Order ID.
+ * @param WC_Order $order Order object.
+ *
+ * @return array|mixed
+ */
+ public static function refund_payment( $order_id, $order ) {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $is_fallback_active = ( 'yes' === ( $core_settings['enable_fallback_ac'] ?? 'no' ) );
+
+ $cko_payment_id = $order->get_meta( '_cko_payment_id' );
+
+ // Check if cko_payment_id is empty.
+ if ( empty( $cko_payment_id ) ) {
+ $error_message = __( 'An error has occurred. No Cko Payment Id', 'checkout-com-unified-payments-api' );
+
+ return [ 'error' => $error_message ];
+ }
+
+ // check for decimal separator.
+ $order_amount = str_replace( ',', '.', $order->get_total() );
+ $order_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $order_amount, $order->get_currency() );
+ $refund_amount = str_replace( ',', '.', sanitize_text_field( $_POST['refund_amount'] ) );
+ $refund_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $refund_amount, $order->get_currency() );
+
+ // Check if refund amount is less than order amount.
+ $refund_is_less = $refund_amount_cents < $order_amount_cents;
+
+ $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+
+ // Initialize the Checkout Api.
+ $checkout = new Checkout_SDK();
+
+ try {
+
+ try {
+ // Check if payment is already voided or captured on checkout.com hub.
+ $details = $checkout->get_builder()->getPaymentsClient()->getPaymentDetails( $cko_payment_id );
+
+ } catch ( CheckoutApiException $ex ) {
+
+ // Handle above try block exception.
+ if ( ! $is_fallback_active ) {
+ $error_message = esc_html__( 'An error has occurred while processing your refund. ', 'checkout-com-unified-payments-api' );
+
+ // check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ return [ 'error' => $error_message ];
+ }
+
+ // Handle Retry with fallback account.
+ $checkout = new Checkout_SDK( true );
+ $details = $checkout->get_builder()->getPaymentsClient()->getPaymentDetails( $cko_payment_id );
+
+ if ( 'Refunded' === $details['status'] && ! $refund_is_less ) {
+ $error_message = 'Payment has already been refunded on Checkout.com hub for order Id : ' . $order_id;
+
+ return [ 'error' => $error_message ];
+ }
+
+ $refund_request = new RefundRequest();
+ $refund_request->reference = $order->get_order_number();
+
+ // Process partial refund if amount is less than order amount.
+ if ( $refund_is_less ) {
+ $refund_request->amount = $refund_amount_cents;
+
+ $_SESSION['cko-refund-is-less'] = $refund_is_less;
+ }
+
+ $order->add_order_note( esc_html__( 'Checkout.com Refund : Process via fallback account.', 'checkout-com-unified-payments-api' ) );
+
+ $response = $checkout->get_builder()->getPaymentsClient()->refundPayment( $cko_payment_id, $refund_request );
+
+ if ( ! WC_Checkoutcom_Utility::is_successful( $response ) ) {
+ /* translators: 1: Order ID. */
+ $error_message = sprintf( esc_html__( 'An error has occurred while processing your refund payment on Checkout.com hub. Order Id : %s', 'checkout-com-unified-payments-api' ), $order_id );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $response;
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $response );
+
+ return [ 'error' => $error_message ];
+ } else {
+ return $response;
+ }
+ }
+
+ if ( 'Refunded' === $details['status'] && ! $refund_is_less ) {
+ $error_message = 'Payment has already been refunded on Checkout.com hub for order Id : ' . $order_id;
+
+ return [ 'error' => $error_message ];
+ }
+
+ $refund_request = new RefundRequest();
+ $refund_request->reference = $order->get_order_number();
+
+ // Process partial refund if amount is less than order amount.
+ if ( $refund_is_less ) {
+ $refund_request->amount = $refund_amount_cents;
+
+ $_SESSION['cko-refund-is-less'] = $refund_is_less;
+ }
+
+ $response = $checkout->get_builder()->getPaymentsClient()->refundPayment( $cko_payment_id, $refund_request );
+
+ if ( ! WC_Checkoutcom_Utility::is_successful( $response ) ) {
+ /* translators: 1: Order ID. */
+ $error_message = sprintf( esc_html__( 'An error has occurred while processing your refund payment on Checkout.com hub. Order Id : %s', 'checkout-com-unified-payments-api' ), $order_id );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $response;
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $response );
+
+ return [ 'error' => $error_message ];
+ } else {
+ return $response;
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $error_message = esc_html__( 'An error has occurred while processing your refund. ', 'checkout-com-unified-payments-api' );
+
+ // check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ return [ 'error' => $error_message ];
+ }
+ }
+
+ /**
+ * Create APM payment.
+ *
+ * @param WC_Order $order Order object.
+ * @param string $payment_method Payment method.
+ *
+ * @return array
+ */
+ public static function create_apm_payment( WC_Order $order, $payment_method ) {
+ // Get payment request parameter.
+ $request_param = WC_Checkoutcom_Api_Request::get_request_param( $order, $payment_method );
+
+ WC_Checkoutcom_Utility::logger( 'Apm request payload,', $request_param );
+
+ $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+
+ // Initialize the Checkout Api.
+ $checkout = new Checkout_SDK();
+
+ try {
+ // Call to create charge.
+ $response = $checkout->get_builder()->getPaymentsClient()->requestPayment( $request_param );
+
+ // Check if payment successful.
+ if ( WC_Checkoutcom_Utility::is_successful( $response ) ) {
+ // Check if payment is 3Dsecure.
+ if ( WC_Checkoutcom_Utility::is_pending( $response ) || 'Authorized' === $response['status'] ) {
+ // Check if redirection link exist.
+ if ( WC_Checkoutcom_Utility::get_redirect_url( $response ) ) {
+
+ // Return apm redirection url.
+ return [ 'apm_redirection' => WC_Checkoutcom_Utility::get_redirect_url( $response ) ];
+
+ } else {
+
+ // Verify payment id.
+ $verify_payment = $checkout->get_builder()->getPaymentsClient()->getPaymentDetails( $response['id'] );
+ $source = $verify_payment['source'];
+
+ // Check if payment source is Fawry or SEPA.
+ if ( 'fawry' === $source['type'] || 'sepa' === $source['type'] ) {
+ return $verify_payment;
+ }
+
+ $error_message = esc_html__( 'An error has occurred while processing your payment. Redirection link not found', 'checkout-com-unified-payments-api' );
+
+ return [ 'error' => $error_message ];
+ }
+ } else {
+
+ return $response;
+ }
+ } else {
+ $error_message = esc_html__( 'An error has occurred while processing your payment. Please check your card details and try again.', 'checkout-com-unified-payments-api' );
+
+ // check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $response;
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $response );
+
+ return [ 'error' => $error_message ];
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $error_message = esc_html__( 'An error has occurred while creating apm payments. ', 'checkout-com-unified-payments-api' );
+
+ // Check if gateway response is enabled from module settings.
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+
+ return [ 'error' => $error_message ];
+ }
+ }
+
+ /**
+ * Get APM payment method source.
+ *
+ * @param array $data Post data.
+ * @param WC_Order $order Order object.
+ * @param string|array $payment_method Arguments.
+ *
+ * @return array
+ */
+ public static function get_apm_method( $data, $order, $payment_method ) {
+ if ( ! session_id() ) {
+ session_start();
+ }
+
+ $obj = new WC_Checkoutcom_APM_Method( $data, $order );
+ $method = $obj->$payment_method();
+
+ return $method;
+ }
+
+ /**
+ * Return klarna session.
+ *
+ * @return array|mixed
+ */
+ public static function klarna_session() {
+ $items = WC()->cart->get_cart();
+ $products = [];
+
+ $total_amount = WC()->cart->total;
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_amount, get_woocommerce_currency() );
+
+ $woo_locale = str_replace( '_', '-', get_locale() );
+ $locale = substr( $woo_locale, 0, 5 );
+
+ $processing = new Checkout\Payments\Contexts\PaymentContextsProcessing();
+ $processing->locale = strtolower( $locale );
+
+ $billing_address = new Address();
+ $billing_address->country = WC()->customer->get_billing_country();
+
+ $account_holder = new AccountHolder();
+ $account_holder->billing_address = $billing_address;
+
+ $source = new PaymentContextsKlarnaSource();
+ $source->account_holder = $account_holder;
+
+
+ foreach ( $items as $item => $values ) {
+ $_product = wc_get_product( $values['data']->get_id() );
+ $wc_product = wc_get_product( $values['product_id'] );
+ $price_excl_tax = wc_get_price_excluding_tax( $wc_product );
+ $unit_price_cents = WC_Checkoutcom_Utility::value_to_decimal( $price_excl_tax, get_woocommerce_currency() );
+
+ if ( $wc_product->is_taxable() ) {
+
+ $price_incl_tax = wc_get_price_including_tax( $wc_product );
+ $unit_price_cents = WC_Checkoutcom_Utility::value_to_decimal( $price_incl_tax, get_woocommerce_currency() );
+ $tax_amount = $price_incl_tax - $price_excl_tax;
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $tax_amount, get_woocommerce_currency() );
+ } else {
+ $total_tax_amount_cents = 0;
+ }
+
+ $item = new Checkout\Payments\Contexts\PaymentContextsItems();
+ $item->name = $_product->get_title();
+ $item->unit_price = $unit_price_cents;
+ $item->quantity = $values['quantity'];
+ $item->total_amount = $unit_price_cents * $values['quantity'];
+ $item->reference = $_product->get_sku();
+ $item->tax_amount = $total_tax_amount_cents;
+ $item->discount_amount = 0;
+
+ $products[] = $item;
+ }
+
+ $chosen_methods = wc_get_chosen_shipping_method_ids();
+ $chosen_shipping = $chosen_methods[0];
+
+ if ( 'free_shipping' !== $chosen_shipping ) {
+ $shipping_amount = WC()->cart->get_shipping_total();
+ $shipping_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $shipping_amount, get_woocommerce_currency() );
+
+ if ( WC()->cart->get_shipping_tax() > 0 ) {
+ $shipping_amount = WC()->cart->get_shipping_total() + WC()->cart->get_shipping_tax();
+ $shipping_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $shipping_amount, get_woocommerce_currency() );
+
+ $total_tax_amount = WC()->cart->get_shipping_tax();
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_tax_amount, get_woocommerce_currency() );
+ } else {
+ $total_tax_amount_cents = 0;
+ }
+
+ $item = new Checkout\Payments\Contexts\PaymentContextsItems();
+ $item->name = $chosen_shipping;
+ $item->unit_price = $shipping_amount_cents;
+ $item->quantity = 1;
+ $item->total_amount = $shipping_amount_cents;
+ $item->reference = $chosen_shipping;
+ $item->tax_amount = $total_tax_amount_cents;
+ $item->discount_amount = 0;
+
+ $products[] = $item;
+ }
+
+ $paymentContextsRequest = new Checkout\Payments\Contexts\PaymentContextsRequest();
+ $paymentContextsRequest->source = $source;
+ $paymentContextsRequest->amount = $amount_cents;
+ $paymentContextsRequest->currency = get_woocommerce_currency();
+ $paymentContextsRequest->payment_type = PaymentType::$regular;
+ $paymentContextsRequest->items = $products;
+ $paymentContextsRequest->processing = $processing;
+
+ // Initialize the Checkout Api.
+ $checkout = new Checkout_SDK();
+
+ try {
+ $response = $checkout->get_builder()->getPaymentContextsClient()->createPaymentContexts( $paymentContextsRequest );
+
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_klarna_pc_id', $response['id'] );
+
+ return $response;
+
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = 'An error has occurred while processing Klarna createPaymentContexts request. ';
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex->error_details );
+
+ return [ 'error' => $error_message ];
+ }
+ }
+
+ /**
+ * Return cart information.
+ *
+ * @return array
+ */
+ public static function get_cart_info( $flow = false ) {
+
+ if ( ! WC()->cart ) {
+ return [];
+ }
+
+ $items = WC()->cart->get_cart();
+ $products = [];
+
+ $total_amount = WC()->cart->total;
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_amount, get_woocommerce_currency() );
+
+ // Initialize virtual product flag
+ $contains_virtual_product = false;
+ // Initialize subscription flags
+ $contains_subscription_product = false;
+ $regular_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$regular : 'Regular';
+ $recurring_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$recurring : 'Recurring';
+
+ foreach ( $items as $item => $values ) {
+
+ $_product = wc_get_product( $values['data']->get_id() );
+ $wc_product = wc_get_product( $values['product_id'] );
+ $price_excl_tax = wc_get_price_excluding_tax( $wc_product );
+ $unit_price_cents = WC_Checkoutcom_Utility::value_to_decimal( $price_excl_tax, get_woocommerce_currency() );
+
+ if ( $wc_product->is_taxable() ) {
+
+ $price_incl_tax = wc_get_price_including_tax( $wc_product );
+ $unit_price_cents = WC_Checkoutcom_Utility::value_to_decimal( $price_incl_tax, get_woocommerce_currency() );
+ $tax_amount = $price_incl_tax - $price_excl_tax;
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $tax_amount, get_woocommerce_currency() );
+
+ $tax = WC_Tax::get_rates();
+ $reset_tax = reset( $tax )['rate'];
+ $tax_rate = round( $reset_tax );
+
+ } else {
+ $tax_rate = 0;
+ $total_tax_amount_cents = 0;
+ }
+
+ // Check if product is virtual
+ if ( $_product->is_virtual() ) {
+ $contains_virtual_product = true;
+ }
+
+ // Check if product is a subscription product
+ $is_subscription_product = false;
+ $product_id = $_product->get_id();
+ $product_type = $_product->get_type();
+
+ if ( function_exists( 'wcs_is_subscription_product' ) ) {
+ $is_subscription_product = wcs_is_subscription_product( $_product );
+ if ( $is_subscription_product ) {
+ $contains_subscription_product = true;
+ }
+ } else {
+ // Fallback: Check if product has subscription meta
+ $subscription_period = get_post_meta( $product_id, '_subscription_period', true );
+ $subscription_price = get_post_meta( $product_id, '_subscription_price', true );
+ if ( ! empty( $subscription_period ) || ! empty( $subscription_price ) ) {
+ $is_subscription_product = true;
+ $contains_subscription_product = true;
+ }
+ }
+
+ // Additional check: product type might be 'subscription' or 'variable-subscription'
+ if ( ! $is_subscription_product && ( $product_type === 'subscription' || $product_type === 'variable-subscription' ) ) {
+ $is_subscription_product = true;
+ $contains_subscription_product = true;
+ }
+
+ if( $flow ) {
+ $quantity = $values['quantity'];
+ $line_subtotal = $values['line_subtotal'];
+ $line_total = $values['line_total'];
+
+ // Discount Price
+ $unit_discount = ( $line_subtotal - $line_total ) / $quantity;
+ $discount_total_cents = WC_Checkoutcom_Utility::value_to_decimal( $unit_discount * $quantity, get_woocommerce_currency() );
+
+ // Flow-specific logic for cart items
+ $product_data = [
+ 'name' => $_product->get_title(),
+ 'quantity' => $quantity,
+ 'unit_price' => $unit_price_cents,
+ 'total_amount' => ( $unit_price_cents * $quantity ) - $discount_total_cents,
+ 'tax_amount' => $total_tax_amount_cents,
+ 'type' => 'physical',
+ 'reference' => $_product->get_sku(),
+ 'discount_amount' => $discount_total_cents,
+ ];
+
+ // Add subscription flag to product data if it's a subscription product
+ if ( $is_subscription_product ) {
+ $product_data['is_subscription'] = true;
+ }
+
+ $products[] = $product_data;
+ } else {
+ $products[] = [
+ 'name' => $_product->get_title(),
+ 'quantity' => $values['quantity'],
+ 'unit_price' => $unit_price_cents,
+ 'tax_rate' => $tax_rate * 100,
+ 'total_amount' => $unit_price_cents * $values['quantity'],
+ 'total_tax_amount' => $total_tax_amount_cents,
+ 'type' => 'physical',
+ 'reference' => $_product->get_sku(),
+ 'total_discount_amount' => 0,
+ ];
+ }
+ }
+
+ $chosen_methods = wc_get_chosen_shipping_method_ids();
+ $chosen_shipping = $chosen_methods[0];
+
+ if ( 'free_shipping' !== $chosen_shipping ) {
+ $shipping_amount = WC()->cart->get_shipping_total();
+ $shipping_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $shipping_amount, get_woocommerce_currency() );
+
+ if ( $shipping_amount_cents > 0 ) {
+ if ( WC()->cart->get_shipping_tax() > 0 ) {
+ $shipping_amount = WC()->cart->get_shipping_total() + WC()->cart->get_shipping_tax();
+ $shipping_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $shipping_amount, get_woocommerce_currency() );
+
+ $total_tax_amount = WC()->cart->get_shipping_tax();
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_tax_amount, get_woocommerce_currency() );
+
+ $shipping_rates = WC_Tax::get_shipping_tax_rates();
+ $vat = array_shift( $shipping_rates );
+
+ if ( isset( $vat['rate'] ) ) {
+ $shipping_tax_rate = round( $vat['rate'] * 100 );
+ } else {
+ $shipping_tax_rate = 0;
+ }
+ } else {
+ $shipping_tax_rate = 0;
+ $total_tax_amount_cents = 0;
+ }
+
+ // Only add total_tax_amount and total_discount_amount if flow is false.
+ if ( ! $flow ) {
+ $products[] = [
+ 'name' => $chosen_shipping,
+ 'quantity' => 1,
+ 'unit_price' => $shipping_amount_cents,
+ 'tax_rate' => $shipping_tax_rate,
+ 'total_amount' => $shipping_amount_cents,
+ 'total_tax_amount' => $total_tax_amount_cents,
+ 'type' => 'shipping_fee',
+ 'reference' => $chosen_shipping,
+ 'total_discount_amount' => 0,
+ ];
+ } else {
+ $products[] = [
+ 'name' => $chosen_shipping,
+ 'quantity' => 1,
+ 'unit_price' => $shipping_amount_cents,
+ 'total_amount' => $shipping_amount_cents,
+ 'tax_amount' => $total_tax_amount_cents,
+ 'reference' => $chosen_shipping,
+ 'discount_amount' => 0,
+ ];
+ }
+ }
+ }
+
+ $woo_locale = str_replace( '_', '-', get_locale() );
+ $locale = substr( $woo_locale, 0, 5 );
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( WC()->cart->get_total_tax(), get_woocommerce_currency() );
+
+ // Determine payment type based on subscription detection
+ $payment_type = $regular_payment_type;
+ if ( $contains_subscription_product ) {
+ $payment_type = $recurring_payment_type;
+ }
+
+ $cart_info = [
+ 'purchase_country' => WC()->customer->get_billing_country(),
+ 'purchase_currency' => get_woocommerce_currency(),
+ 'locale' => strtolower( $locale ),
+ 'billing_address' => [
+ 'given_name' => WC()->customer->get_billing_first_name(),
+ 'family_name' => WC()->customer->get_billing_last_name(),
+ 'email' => WC()->customer->get_billing_email(),
+ 'street_address' => WC()->customer->get_billing_address_1(),
+ 'street_address2' => WC()->customer->get_billing_address_2(),
+ 'postal_code' => WC()->customer->get_billing_postcode(),
+ 'city' => WC()->customer->get_billing_city(),
+ 'region' => WC()->customer->get_billing_city(),
+ 'phone' => WC()->customer->get_billing_phone(),
+ 'country' => WC()->customer->get_billing_country(),
+ ],
+ 'order_amount' => $amount_cents,
+ 'order_tax_amount' => $total_tax_amount_cents,
+ 'order_lines' => $products,
+ 'contains_virtual_product' => $contains_virtual_product,
+ ];
+
+ // Add subscription flags and payment type for Flow integration
+ if ( $flow ) {
+ $cart_info['contains_subscription_product'] = $contains_subscription_product;
+ $cart_info['payment_type'] = $payment_type;
+ }
+
+ return $cart_info;
+}
+
+ /**
+ * Get order information for Flow integration.
+ * Similar to get_cart_info() but for existing orders.
+ *
+ * @param int $order_id Order ID.
+ * @param bool $flow Whether this is for Flow integration (affects field names).
+ *
+ * @return array
+ */
+ public static function get_order_info( $order_id, $flow = false ) {
+ $order = wc_get_order( $order_id );
+
+ if ( ! $order ) {
+ return [];
+ }
+
+ $items = $order->get_items();
+ $products = [];
+
+ $total_amount = $order->get_total();
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_amount, $order->get_currency() );
+
+ // Initialize subscription flags
+ $contains_subscription_product = false;
+ $regular_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$regular : 'Regular';
+ $recurring_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$recurring : 'Recurring';
+
+ foreach ( $items as $item ) {
+ $product = $item->get_product();
+
+ if ( ! $product ) {
+ continue;
+ }
+
+ // Check if product is a subscription product
+ $is_subscription_product = false;
+ if ( function_exists( 'wcs_is_subscription_product' ) ) {
+ $is_subscription_product = wcs_is_subscription_product( $product );
+ if ( $is_subscription_product ) {
+ $contains_subscription_product = true;
+ }
+ }
+
+ $line_subtotal = $item->get_subtotal();
+ $quantity = $item->get_quantity();
+ $line_total = $item->get_total();
+
+ if ( $flow ) {
+ $unit_price = $line_subtotal / $quantity;
+ $unit_discount = ( $line_subtotal - $line_total ) / $quantity;
+ $discounted_unit = $unit_price - $unit_discount;
+ $unit_price_cents = WC_Checkoutcom_Utility::value_to_decimal( $discounted_unit, $order->get_currency() );
+ $discount_total_cents = WC_Checkoutcom_Utility::value_to_decimal( $unit_discount * $quantity, $order->get_currency() );
+ $tax_amount = $item->get_subtotal_tax();
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $tax_amount, $order->get_currency() );
+
+ $product_data = [
+ 'name' => $item->get_name(),
+ 'quantity' => $quantity,
+ 'unit_price' => $unit_price_cents,
+ 'total_amount' => $unit_price_cents * $quantity,
+ 'tax_amount' => $total_tax_amount_cents,
+ 'type' => 'physical',
+ 'reference' => $product->get_sku() ?: $product->get_id(),
+ 'discount_amount' => $discount_total_cents,
+ ];
+
+ // Add subscription flag to product data if it's a subscription product
+ if ( $is_subscription_product ) {
+ $product_data['is_subscription'] = true;
+ }
+
+ $products[] = $product_data;
+ } else {
+ $price_excl_tax = $item->get_subtotal();
+ $unit_price_cents = WC_Checkoutcom_Utility::value_to_decimal( $price_excl_tax / $item->get_quantity(), $order->get_currency() );
+
+ $tax_amount = $item->get_subtotal_tax();
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $tax_amount, $order->get_currency() );
+
+ // Calculate tax rate
+ $tax_rate = 0;
+ if ( $price_excl_tax > 0 ) {
+ $tax_rate = round( ( $tax_amount / $price_excl_tax ) * 100 );
+ }
+
+ $products[] = [
+ 'name' => $item->get_name(),
+ 'quantity' => $item->get_quantity(),
+ 'unit_price' => $unit_price_cents,
+ 'tax_rate' => $tax_rate * 100,
+ 'total_amount' => WC_Checkoutcom_Utility::value_to_decimal( $price_excl_tax, $order->get_currency() ),
+ 'total_tax_amount' => $total_tax_amount_cents,
+ 'type' => 'physical',
+ 'reference' => $product->get_sku() ?: $product->get_id(),
+ 'total_discount_amount' => WC_Checkoutcom_Utility::value_to_decimal( $item->get_subtotal() - $item->get_total(), $order->get_currency() ),
+ ];
+ }
+ }
+
+ // Add shipping if present
+ $shipping_total = $order->get_shipping_total();
+ if ( $shipping_total > 0 ) {
+ $shipping_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $shipping_total, $order->get_currency() );
+ $shipping_tax = $order->get_shipping_tax();
+ $shipping_tax_cents = WC_Checkoutcom_Utility::value_to_decimal( $shipping_tax, $order->get_currency() );
+
+ $shipping_tax_rate = 0;
+ if ( $shipping_total > 0 ) {
+ $shipping_tax_rate = round( ( $shipping_tax / $shipping_total ) * 100 );
+ }
+
+ // Only add total_tax_amount and total_discount_amount if flow is false.
+ if ( ! $flow ) {
+ $products[] = [
+ 'name' => 'Shipping',
+ 'quantity' => 1,
+ 'unit_price' => $shipping_amount_cents,
+ 'tax_rate' => $shipping_tax_rate * 100,
+ 'total_amount' => $shipping_amount_cents,
+ 'total_tax_amount' => $shipping_tax_cents,
+ 'type' => 'shipping_fee',
+ 'reference' => 'shipping',
+ 'total_discount_amount' => 0,
+ ];
+ } else {
+ $products[] = [
+ 'name' => 'Shipping',
+ 'quantity' => 1,
+ 'unit_price' => $shipping_amount_cents,
+ 'total_amount' => $shipping_amount_cents,
+ 'tax_amount' => $shipping_tax_cents,
+ 'reference' => 'shipping',
+ 'discount_amount' => 0,
+ ];
+ }
+ }
+
+ $woo_locale = str_replace( '_', '-', get_locale() );
+ $locale = substr( $woo_locale, 0, 5 );
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $order->get_total_tax(), $order->get_currency() );
+
+ $order_info = [
+ 'purchase_country' => $order->get_billing_country(),
+ 'purchase_currency' => $order->get_currency(),
+ 'locale' => strtolower( $locale ),
+ 'billing_address' => [
+ 'given_name' => $order->get_billing_first_name(),
+ 'family_name' => $order->get_billing_last_name(),
+ 'email' => $order->get_billing_email(),
+ 'street_address' => $order->get_billing_address_1(),
+ 'street_address2' => $order->get_billing_address_2(),
+ 'postal_code' => $order->get_billing_postcode(),
+ 'city' => $order->get_billing_city(),
+ 'region' => $order->get_billing_state(),
+ 'phone' => $order->get_billing_phone(),
+ 'country' => $order->get_billing_country(),
+ ],
+ 'order_amount' => $amount_cents,
+ 'order_tax_amount' => $total_tax_amount_cents,
+ 'order_lines' => $products,
+ ];
+
+ // Add payment type information if requested (for MOTO orders and subscriptions)
+ if ( $flow ) {
+ // MOTO only for: Admin-created order + Order-pay page + Guest customer
+ $is_order_pay_page = ! empty( $_GET['pay_for_order'] ) && (bool) $_GET['pay_for_order'];
+ $is_guest_customer = $order->get_customer_id() == 0; // Guest customer = no customer account
+ $is_admin_created = $order->is_created_via( 'admin' );
+ $is_moto_payment = $is_admin_created && $is_order_pay_page && $is_guest_customer;
+
+ // Check if order contains subscription (using WooCommerce Subscriptions function)
+ $order_contains_subscription = false;
+ if ( function_exists( 'wcs_order_contains_subscription' ) ) {
+ $order_contains_subscription = wcs_order_contains_subscription( $order, 'parent' );
+ }
+
+ // Determine payment type: Priority: MOTO > Subscription > Regular
+ if ( $is_moto_payment ) {
+ $payment_type = 'MOTO';
+ } elseif ( $order_contains_subscription || $contains_subscription_product ) {
+ $payment_type = $recurring_payment_type;
+ } else {
+ $payment_type = $regular_payment_type;
+ }
+
+ // Enhanced debug logging with more details
+ WC_Checkoutcom_Utility::logger( 'Order info payment type detection - Order ID: ' . $order->get_id() .
+ ', Admin created: ' . ($is_admin_created ? 'YES' : 'NO') .
+ ', Order-pay page: ' . ($is_order_pay_page ? 'YES' : 'NO') .
+ ', Guest customer: ' . ($is_guest_customer ? 'YES' : 'NO') .
+ ', Contains subscription product: ' . ($contains_subscription_product ? 'YES' : 'NO') .
+ ', Order contains subscription: ' . ($order_contains_subscription ? 'YES' : 'NO') .
+ ', Payment type: ' . $payment_type
+ );
+
+ $order_info['payment_type'] = $payment_type;
+ $order_info['contains_subscription_product'] = $contains_subscription_product || $order_contains_subscription;
+
+ if ( $is_moto_payment ) {
+ WC_Checkoutcom_Utility::logger( 'Order info: MOTO payment type set - Admin order + Order-pay page + Guest customer. Order ID: ' . $order->get_id() );
+ } elseif ( $order_contains_subscription || $contains_subscription_product ) {
+ WC_Checkoutcom_Utility::logger( 'Order info: Recurring payment type set - Order contains subscription. Order ID: ' . $order->get_id() );
+ }
+ }
+
+ return $order_info;
+ }
+
+ /**
+ * Return order product information.
+ * Docs: https://www.checkout.com/docs/payments/payment-methods/paypal#Request_example
+ *
+ * @param WC_Order $order Order object.
+ *
+ * @return array
+ */
+ public static function get_paypal_products( $order ) {
+ $cart_info = WC_Checkoutcom_Api_Request::get_cart_info(false);
+ $products = [];
+
+ if ( $cart_info ) {
+ // Subscription parent order.
+ $product_info = $cart_info['order_lines'];
+ $order_amount = $cart_info['order_amount'];
+ $total_product_amount = 0;
+
+ foreach ( $product_info as $item ) {
+
+ $product = new Product();
+ $product->name = $item['name'];
+ $product->unit_price = $item['unit_price'];
+ $product->quantity = $item['quantity'];
+
+ $products[] = $product;
+
+ $total_product_amount += $item['unit_price'] * $item['quantity'];
+ }
+
+ if ( $total_product_amount !== $order_amount ) {
+
+ $product = new Product();
+ $product->name = 'All Products';
+ $product->unit_price = $order_amount;
+ $product->quantity = 1;
+
+ $products = [ $product ];
+ }
+ } else {
+ // Subscription renewal.
+ $total_amount = $order->get_total();
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_amount, get_woocommerce_currency() );
+
+ $product = new Product();
+ $product->name = 'All Products';
+ $product->unit_price = $amount_cents;
+ $product->quantity = 1;
+
+ $products = [ $product ];
+ }
+
+ return $products;
+ }
+
+ /**
+ * Generate apple token.
+ *
+ * @return mixed|void
+ */
+ public static function generate_apple_token() {
+ $apple_token = $_POST['token'];
+ $transaction_id = $apple_token['header']['transactionId'];
+ $public_key_hash = $apple_token['header']['publicKeyHash'];
+ $ephemeral_public_key = $apple_token['header']['ephemeralPublicKey'];
+ $version = $apple_token['version'];
+ $signature = $apple_token['signature'];
+ $data = $apple_token['data'];
+
+ $checkout = new Checkout_SDK();
+
+ $header = [
+ 'transactionId' => $transaction_id,
+ 'publicKeyHash' => $public_key_hash,
+ 'ephemeralPublicKey' => $ephemeral_public_key,
+ ];
+
+ try {
+ $apple_pay_token_data = new ApplePayTokenData();
+ $apple_pay_token_data->data = $data;
+ $apple_pay_token_data->header = $header;
+ $apple_pay_token_data->signature = $signature;
+ $apple_pay_token_data->version = $version;
+
+ $apple_pay_token_request = new ApplePayTokenRequest();
+ $apple_pay_token_request->token_data = $apple_pay_token_data;
+
+ $token = $checkout->get_builder()->getTokensClient()->requestWalletToken( $apple_pay_token_request );
+
+ return $token['token'];
+
+ } catch ( CheckoutApiException $ex ) {
+ $error_message = esc_html__( 'An error has occurred while processing your payment.', 'checkout-com-unified-payments-api' );
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ die( 'here' );
+ }
+ }
+
+ /**
+ * Format fawry product.
+ *
+ * @param mixed $products Products array.
+ * @param mixed $amount Amount.
+ *
+ * @return FawryProduct
+ */
+ public static function format_fawry_product( $products, $amount ) {
+ $fawry_product = new FawryProduct();
+
+ $fawry_product->product_id = 'All_Products';
+ $fawry_product->quantity = 1;
+
+ foreach ( $products as $product ) {
+ $fawry_product->price = $amount;
+ $fawry_product->description .= $product['description'] . ',';
+ }
+
+ return $fawry_product;
+ }
+
+ /**
+ * Mandate cancel request.
+ *
+ * @param string $url URL.
+ * @param int $subscription_id Subscription ID.
+ *
+ * @return bool
+ */
+ public static function mandate_cancel_request( $url, $subscription_id ) {
+
+ if ( empty( $url ) || empty( $subscription_id ) ) {
+ return false;
+ }
+
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $is_fallback_active = ( 'yes' === ( $core_settings['enable_fallback_ac'] ?? 'no' ) );
+
+ $core_settings['ckocom_sk'] = cko_is_nas_account() ? 'Bearer ' . $core_settings['ckocom_sk'] : $core_settings['ckocom_sk'];
+
+ $wp_response = wp_remote_post(
+ $url,
+ [
+ 'headers' => [ 'Authorization' => $core_settings['ckocom_sk'] ],
+ ]
+ );
+
+ // If unauthorized & fallback ABC setup retry with those cred.
+ if ( 401 === wp_remote_retrieve_response_code( $wp_response ) && $is_fallback_active ) {
+
+ $wp_response = wp_remote_post(
+ $url,
+ [
+ 'headers' => [ 'Authorization' => $core_settings['fallback_ckocom_sk'] ],
+ ]
+ );
+
+ } elseif ( 200 !== wp_remote_retrieve_response_code( $wp_response ) ) {
+
+ WC_Checkoutcom_Utility::logger(
+ sprintf(
+ 'An error has occurred while mandate cancel Order # %d request. Response code: %d',
+ $subscription_id,
+ wp_remote_retrieve_response_code( $wp_response )
+ ),
+ null
+ );
+ }
+
+ return 'OK' === wp_remote_retrieve_response_message( $wp_response ) && 200 === wp_remote_retrieve_response_code( $wp_response );
+ }
+
+
+ /**
+ * Checks if payment is via saved payment source.
+ *
+ * @return bool
+ */
+ public static function is_using_saved_payment_method() {
+ $payment_method = isset( $_POST['payment_method'] ) ? wc_clean( wp_unslash( $_POST['payment_method'] ) ) : 'wc_checkout_com_cards';
+
+ $payment_method = 'wc-' . $payment_method . '-payment-token';
+
+ return ( isset( $_POST[ $payment_method ] ) && 'new' !== $_POST[ $payment_method ] );
+ }
+
+ /**
+ * Checks if URL is giving 200 OK response by pinging.
+ *
+ * @param string $url URL.
+ *
+ * @return bool
+ */
+ public static function is_url_response_ok( $url ) {
+ $response = wp_remote_get( $url );
+
+ return ! is_wp_error( $response ) && 200 === wp_remote_retrieve_response_code( $response );
+ }
+}
diff --git a/checkout-com-unified-payments-api/includes/api/class-wc-checkoutcom-apm-method.php b/checkout-com-unified-payments-api/includes/api/class-wc-checkoutcom-apm-method.php
new file mode 100644
index 00000000..2e68e88a
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/api/class-wc-checkoutcom-apm-method.php
@@ -0,0 +1,431 @@
+description = get_bloginfo( 'name' );
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the boleto APM.
+ *
+ * @return RequestBoletoSource
+ */
+ public function boleto() {
+
+ $payer = new Payer();
+ $payer->name = self::$data_info['name'];
+ $payer->email = self::$data_info['billing_email'];
+ $payer->document = self::$data_info['cpf'];
+
+ $method = new RequestBoletoSource();
+ $method->integration_type = IntegrationType::$redirect;
+ $method->country = self::$post['billing_country'];
+ $method->payer = $payer;
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the knet APM.
+ *
+ * @return RequestKnetSource
+ */
+ public function knet() {
+
+ $language = get_locale();
+
+ switch ( $language ) {
+ case 'ar_SA':
+ $language = 'ar';
+ break;
+ default:
+ $language = 'en';
+ break;
+ }
+
+ $method = new RequestKnetSource();
+ $method->language = $language;
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the eps APM.
+ *
+ * @return RequestEpsSource
+ */
+ public function eps() {
+
+ $method = new RequestEpsSource();
+ $method->purpose = get_bloginfo( 'name' );
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the bancontact APM.
+ *
+ * @return RequestBancontactSource
+ */
+ public function bancontact() {
+
+ $method = new RequestBancontactSource();
+ $method->account_holder_name = self::$post['billing_first_name'] . ' ' . self::$post['billing_last_name'];
+ $method->payment_country = self::$post['billing_country'];
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the sepa APM.
+ *
+ * @return RequestSepaSource
+ */
+ public function sepa() {
+
+ $details = self::get_sepa_info();
+
+ $method = new RequestSepaSource();
+
+ $method->id = $details['id'];
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the ideal APM.
+ *
+ * @return RequestIdealSource
+ */
+ public function ideal() {
+
+ $method = new RequestIdealSource();
+ $method->description = self::$order_info->get_order_number();
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the fawry APM.
+ *
+ * @return RequestFawrySource
+ */
+ public function fawry() {
+
+ $fawry_info = self::get_fawry_info();
+
+ $method = new RequestFawrySource();
+ $method->customer_email = $fawry_info['email'];
+ $method->customer_mobile = $fawry_info['phone'];
+ $method->description = self::$order_info->get_order_number();
+ $method->products = $fawry_info['products'];
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the multibanco APM.
+ *
+ * @return RequestMultiBancoSource
+ */
+ public function multibanco() {
+
+ $method = new RequestMultiBancoSource();
+ $method->account_holder_name = self::$post['billing_first_name'] . ' ' . self::$post['billing_last_name'];
+ $method->payment_country = self::$post['billing_country'];
+
+ return $method;
+ }
+
+ /**
+ * Returns the source data for the klarna APM.
+ *
+ * @return RequestKlarnaSource
+ */
+ public function klarna() {
+
+ $klarna_info = self::get_klarna_info();
+ $cart_info = WC_Checkoutcom_Api_Request::get_cart_info();
+
+ $method = new RequestKlarnaSource();
+ $method->authorization_token = self::$post['cko-klarna-token'];
+ $method->purchase_country = self::$post['billing_country'];
+ $method->locale = strtolower( $cart_info['locale'] );
+ $method->tax_amount = $cart_info['order_tax_amount'];
+ $method->products = $cart_info['order_lines'];
+ $method->billing_address = $klarna_info['billingAddress'];
+
+ return $method;
+ }
+
+ /**
+ * GET APM INFO
+ */
+
+ /**
+ * Gather fawry info.
+ *
+ * @return array
+ */
+ public static function get_fawry_info() {
+
+ $fawry_info = [];
+
+ $fawry_info['email'] = self::$post['billing_email'];
+ $fawry_info['phone'] = self::$post['billing_phone'];
+
+ $cart_info = WC_Checkoutcom_Api_Request::get_cart_info();
+
+ $product_info = $cart_info['order_lines'];
+ $order_amount = $cart_info['order_amount'];
+ $products = [];
+ $total_product_amount = 0;
+
+ foreach ( $product_info as $item ) {
+
+ $fawry_product = new FawryProduct();
+ $fawry_product->product_id = $item['name'];
+ $fawry_product->quantity = $item['quantity'];
+ $fawry_product->price = $item['unit_price'];
+ $fawry_product->description = $item['name'];
+
+ $products[] = $fawry_product;
+
+ $total_product_amount += $item['unit_price'] * $item['quantity'];
+ }
+
+ if ( $total_product_amount !== $order_amount ) {
+
+ WC_Checkoutcom_Utility::logger( "Total product amount {$total_product_amount} does not match order amount {$order_amount}", null );
+
+ $product[] = WC_Checkoutcom_Api_Request::format_fawry_product( $products, $order_amount );
+
+ $products = $product;
+ }
+
+ $fawry_info['products'] = $products;
+
+ return $fawry_info;
+ }
+
+ /**
+ * Gather info for sepa payment and create source ID.
+ *
+ * @return array
+ */
+ public static function get_sepa_info() {
+
+ // phpcs:ignore WordPress.Security.NonceVerification.Recommended
+ $get_data = sanitize_post( $_GET );
+ $items = WC()->cart->get_cart();
+ $is_subscription = false;
+ $is_pay_order = ! empty( $get_data['pay_for_order'] ) && (bool) $get_data['pay_for_order'];
+
+ foreach ( $items as $item => $values ) {
+ $_product = wc_get_product( $values['data']->get_id() );
+ $is_subscription = WC_Subscriptions_Product::is_subscription( $_product );
+
+ if ( $is_subscription ) {
+ break;
+ }
+ }
+
+ if ( $is_pay_order ) {
+ self::$post['billing_address_1'] = self::$order_info->get_billing_address_1();
+ self::$post['billing_address_2'] = self::$order_info->get_billing_address_2();
+ self::$post['billing_city'] = self::$order_info->get_billing_city();
+ self::$post['billing_postcode'] = self::$order_info->get_billing_postcode();
+ self::$post['billing_country'] = self::$order_info->get_billing_country();
+ self::$post['billing_first_name'] = self::$order_info->get_billing_first_name();
+ self::$post['billing_last_name'] = self::$order_info->get_billing_last_name();
+ self::$post['billing_email'] = self::$order_info->get_billing_email();
+ }
+
+ $address = new Address();
+ $address->address_line1 = self::$post['billing_address_1'];
+ $address->address_line2 = self::$post['billing_address_2'];
+ $address->city = self::$post['billing_city'];
+ $address->zip = self::$post['billing_postcode'];
+ $address->country = self::$post['billing_country'];
+
+ $address = apply_filters( 'checkout_apm_sepa_address', $address );
+
+ $source_data = new SourceData();
+ $source_data->first_name = self::$post['billing_first_name'];
+ $source_data->last_name = self::$post['billing_last_name'];
+ $source_data->account_iban = self::$post['sepa-iban'];
+ $source_data->bic = ! empty( self::$post['sepa-bic'] ) ? self::$post['sepa-bic'] : '';
+ $source_data->billing_descriptor = 'Thanks for shopping.';
+ $source_data->mandate_type = $is_subscription ? 'recurring' : 'single';
+
+ $customer_request = new CustomerRequest();
+ $customer_request->email = self::$post['billing_email'];
+ $customer_request->name = self::$post['billing_first_name'] . ' ' . self::$post['billing_last_name'];
+
+ $sepa_source_request = new SepaSourceRequest();
+ $sepa_source_request->billing_address = $address;
+ $sepa_source_request->source_data = $source_data;
+ $sepa_source_request->customer = $customer_request;
+
+ $checkout = new Checkout_SDK();
+
+ $response = [];
+
+ try {
+ $builder = $checkout->get_builder();
+
+ // SEPA support for ABC AC type only.
+ if ( method_exists( $builder, 'getSourcesClient' ) ) {
+
+ $response = $builder->getSourcesClient()->createSepaSource( $sepa_source_request );
+
+ $response_data = $response['response_data'];
+
+ WC()->session->set( 'mandate_reference', $response_data['mandate_reference'] );
+
+ if ( isset( $response['_links']['sepa:mandate-cancel']['href'] ) ) {
+ WC()->session->set( 'mandate_cancel', $response['_links']['sepa:mandate-cancel']['href'] );
+ }
+ }
+ } catch ( CheckoutApiException $ex ) {
+ // Unset any old value if source creation failed.
+ WC()->session->__unset( 'mandate_reference' );
+
+ $error_message = __( 'An error has occurred while getting sepa info.', 'checkout-com-unified-payments-api' );
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ }
+
+ return $response;
+ }
+
+ /**
+ * Gather billing info from Address instance
+ *
+ * @return array
+ */
+ public static function get_klarna_info() {
+
+ $klarna_info = [];
+
+ // Set Billing address.
+ $billing_address_param = new Address();
+ $billing_address_param->given_name = self::$post['billing_first_name'];
+ $billing_address_param->family_name = self::$post['billing_last_name'];
+ $billing_address_param->email = self::$post['billing_email'];
+ $billing_address_param->street_address = self::$post['billing_address_1'];
+ $billing_address_param->postal_code = self::$post['billing_postcode'];
+ $billing_address_param->city = self::$post['billing_city'];
+ $billing_address_param->region = self::$post['billing_city'];
+ $billing_address_param->phone = self::$post['billing_phone'];
+ $billing_address_param->country = self::$post['billing_country'];
+
+ $klarna_info['billingAddress'] = $billing_address_param;
+
+ return $klarna_info;
+ }
+}
diff --git a/checkout-com-unified-payments-api/includes/api/class-wc-checkoutcom-utility.php b/checkout-com-unified-payments-api/includes/api/class-wc-checkoutcom-utility.php
new file mode 100644
index 00000000..249059d5
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/api/class-wc-checkoutcom-utility.php
@@ -0,0 +1,740 @@
+add_error( $message );
+ break;
+ case 'notice':
+ $woocommerce->add_message( $message );
+ break;
+ default:
+ $woocommerce->add_error( $message );
+ break;
+ }
+ }
+ }
+
+ /**
+ * Log data to file using WC logger.
+ *
+ * @param string $error_message Error message to log.
+ * @param Exception $exception Exception object.
+ */
+ public static function logger( $error_message, $exception = null ) {
+ $logger = wc_get_logger();
+ $context = [ 'source' => 'wc_checkoutcom_gateway_log' ];
+
+ // Get file logging from module setting.
+ $file_logging = 'yes' === WC_Admin_Settings::get_option( 'cko_file_logging', 'no' );
+
+ // Determine log level from message prefix
+ $log_level = 'error'; // Default to error for backward compatibility
+
+ // Check for debug/info prefixes (case-insensitive)
+ if ( preg_match( '/\[FLOW\s+DEBUG\]|\[DEBUG\]|\[ADDRESS\s+DEBUG\]/i', $error_message ) ) {
+ $log_level = 'debug';
+ } elseif ( preg_match( '/\[FLOW\s+INFO\]|\[INFO\]/i', $error_message ) ) {
+ $log_level = 'info';
+ } elseif ( preg_match( '/\[FLOW\s+WARNING\]|\[WARNING\]|\[WARN\]/i', $error_message ) ) {
+ $log_level = 'warning';
+ } elseif ( preg_match( '/\[FLOW\s+ERROR\]|\[ERROR\]/i', $error_message ) ) {
+ $log_level = 'error';
+ } elseif ( preg_match( '/\[FLOW\s+SERVER\]|\[VALIDATE\s+CHECKOUT\]|\[PROCESS\s+PAYMENT\]|\[CREATE\s+ORDER\]|\[FLOW\s+VALID\s+FOR\s+USE\]|\[FLOW\s+AVAILABILITY\]|\[FLOW\s+SAVE\s+CARD\]/i', $error_message ) ) {
+ // Server-side informational logs - use info level
+ $log_level = 'info';
+ }
+
+ // Check if file logging is enabled.
+ if ( $file_logging ) {
+ // Log message with appropriate level
+ $logger->log( $log_level, $error_message, $context );
+ if ( null !== $exception ) {
+ // If exception is an array, print it properly
+ if ( is_array( $exception ) ) {
+ $logger->log( $log_level, $error_message . ' Data: ' . wc_print_r( $exception, true ), $context );
+ } else {
+ $logger->log( $log_level, wc_print_r( $exception, true ), $context );
+ }
+ }
+ } else {
+ // Log only message (still respect log level)
+ $logger->log( $log_level, $error_message, $context );
+ }
+ }
+
+ /**
+ * Returns available alternative payment methods APMs.
+ *
+ * @return array
+ */
+ public static function get_alternative_payment_methods() {
+ $currency_code = get_woocommerce_currency();
+ $apm_setting = get_option( 'woocommerce_wc_checkout_com_alternative_payments_settings' );
+ $apm = ! empty( $apm_setting['ckocom_apms_selector'] ) ? $apm_setting['ckocom_apms_selector'] : [];
+ $country_code = WC()->customer->get_billing_country();
+
+ $abc_apms = [ 'alipay', 'bancontact', 'boleto', 'eps', 'fawry', 'ideal', 'knet', 'multibanco', 'poli', 'qpay', 'sepa', 'sofort' ];
+ $nas_apms = [ 'ideal', 'bancontact', 'eps', 'fawry', 'klarna', 'knet', 'multibanco', 'qpay', 'sort' ];
+
+ if ( cko_is_nas_account() ) {
+ $apm = array_intersect( $apm, $nas_apms );
+ } else {
+ $apm = array_intersect( $apm, $abc_apms );
+ }
+
+ $apm_array = [];
+ if ( 0 !== $apm ) {
+
+ foreach ( $apm as $value ) {
+ // PHPCS:disable WordPress.PHP.YodaConditions.NotYoda
+ if ( $value === 'ideal' && $currency_code === 'EUR' && $country_code === 'NL' ) {
+ array_push( $apm_array, $value );
+ }
+
+ if ( $value === 'sofort' && $currency_code === 'EUR' ) {
+
+ if ( $country_code === 'BE'
+ || $country_code === 'DE'
+ || $country_code === 'IT'
+ || $country_code === 'NL'
+ || $country_code === 'AT'
+ || $country_code === 'ES'
+ ) {
+ array_push( $apm_array, $value );
+ }
+ }
+
+ if ( $value === 'boleto' && $country_code === 'BR' ) {
+ if ( $currency_code === 'BRL' || $currency_code === 'USD' ) {
+ array_push( $apm_array, $value );
+ }
+ }
+
+ if ( $value === 'poli' ) {
+ if ( $currency_code === 'AUD' || $currency_code === 'NZD' ) {
+ if ( $country_code === 'AU' || $country_code === 'NZ' ) {
+ array_push( $apm_array, $value );
+ }
+ }
+ }
+
+ if ( $value === 'klarna' ) {
+ if ( $currency_code === 'EUR'
+ || $currency_code === 'DKK'
+ || $currency_code === 'GBP'
+ || $currency_code === 'NOR'
+ || $currency_code === 'SEK'
+ ) {
+ if ( $country_code === 'AU'
+ || $country_code === 'AT'
+ || $country_code === 'BE'
+ || $country_code === 'CA'
+ || $country_code === 'CZ'
+ || $country_code === 'DK'
+ || $country_code === 'FI'
+ || $country_code === 'FR'
+ || $country_code === 'DE'
+ || $country_code === 'GR'
+ || $country_code === 'IE'
+ || $country_code === 'IT'
+ || $country_code === 'MX'
+ || $country_code === 'NL'
+ || $country_code === 'NZ'
+ || $country_code === 'NO'
+ || $country_code === 'PL'
+ || $country_code === 'PT'
+ || $country_code === 'RO'
+ || $country_code === 'ES'
+ || $country_code === 'SE'
+ || $country_code === 'CH'
+ || $country_code === 'GB'
+ || $country_code === 'US'
+ ) {
+ array_push( $apm_array, $value );
+ }
+ }
+ }
+
+ if ( $value === 'sepa' && $currency_code === 'EUR' ) {
+
+ if ( $country_code === 'AD'
+ || $country_code === 'AT'
+ || $country_code === 'BE'
+ || $country_code === 'CY'
+ || $country_code === 'EE'
+ || $country_code === 'FI'
+ || $country_code === 'DE'
+ || $country_code === 'GR'
+ || $country_code === 'IE'
+ || $country_code === 'IT'
+ || $country_code === 'LV'
+ || $country_code === 'LT'
+ || $country_code === 'LU'
+ || $country_code === 'MT'
+ || $country_code === 'MC'
+ || $country_code === 'NL'
+ || $country_code === 'PT'
+ || $country_code === 'SM'
+ || $country_code === 'SK'
+ || $country_code === 'SI'
+ || $country_code === 'ES'
+ || $country_code === 'VA'
+ || $country_code === 'BG'
+ || $country_code === 'HR'
+ || $country_code === 'CZ'
+ || $country_code === 'DK'
+ || $country_code === 'HU'
+ || $country_code === 'IS'
+ || $country_code === 'LI'
+ || $country_code === 'NO'
+ || $country_code === 'PL'
+ || $country_code === 'RO'
+ || $country_code === 'SE'
+ || $country_code === 'CH'
+ || $country_code === 'GB'
+ ) {
+ array_push( $apm_array, $value );
+ }
+ }
+
+ if ( $value === 'eps' && $currency_code === 'EUR' && $country_code === 'AT' ) {
+ array_push( $apm_array, $value );
+ }
+
+ if ( $value === 'bancontact' && $currency_code === 'EUR' && $country_code === 'BE' ) {
+ array_push( $apm_array, $value );
+ }
+
+ if ( 'multibanco' === $value && 'EUR' === $currency_code && 'PT' === $country_code ) {
+ array_push( $apm_array, $value );
+ }
+
+ if ( $value === 'knet' && $currency_code === 'KWD' && $country_code === 'KW' ) {
+ array_push( $apm_array, $value );
+ }
+
+ if ( $value === 'fawry' && $currency_code === 'EGP' && $country_code === 'EG' ) {
+ array_push( $apm_array, $value );
+ }
+
+ if ( $value === 'alipay' && $currency_code === 'USD' && $country_code === 'CN' ) {
+ array_push( $apm_array, $value );
+ }
+
+ if ( $value === 'qpay' && $currency_code === 'QAR' && $country_code === 'QA' ) {
+ array_push( $apm_array, $value );
+ }
+ // PHPCS:enable WordPress.PHP.YodaConditions.NotYoda
+ }
+ }
+
+ return $apm_array;
+ }
+
+ /**
+ * Get redirect url for the payment.
+ *
+ * @param array $data Response data.
+ *
+ * @return false|mixed
+ */
+ public static function get_redirect_url( $data ) {
+
+ if ( empty( $data['_links'] ) ) {
+ return false;
+ }
+
+ if ( empty( $data['_links']['redirect'] ) ) {
+ return false;
+ }
+
+ if ( ! empty( $data['_links']['redirect']['href'] ) ) {
+ return $data['_links']['redirect']['href'];
+ }
+
+ return false;
+ }
+
+ /**
+ * Check is successful.
+ *
+ * @param array $data Response data.
+ *
+ * @return bool
+ */
+ public static function is_successful( $data ) {
+
+ if ( ! empty( $data['http_metadata'] ) ) {
+ return $data['http_metadata']->getStatusCode() < 400 && self::is_approved( $data );
+ }
+
+ return false;
+ }
+
+ /**
+ * Check is pending.
+ *
+ * @param array $data Response data.
+ *
+ * @return bool
+ */
+ public static function is_pending( $data ) {
+ return $data['http_metadata']->getStatusCode() === 202;
+ }
+
+ /**
+ * Check data contains approved key.
+ *
+ * @param array $data Response data.
+ *
+ * @return bool|mixed
+ */
+ public static function is_approved( $data ) {
+ $approved = true;
+ if ( isset( $data['approved'] ) ) {
+ $approved = $data['approved'];
+ }
+
+ return $approved;
+ }
+
+
+ /**
+ * Set WC session value by key.
+ *
+ * @param string $key Session key.
+ * @param string $value Session value.
+ *
+ * @return false|void
+ */
+ public static function cko_set_session( $key, $value ) {
+ if ( ! class_exists( 'WooCommerce' ) || null == WC()->session ) {
+ return false;
+ }
+
+ $cko_session = WC()->session->get( 'cko_session' );
+
+ if ( ! is_array( $cko_session ) ) {
+ $cko_session = [];
+ }
+
+ $cko_session[ $key ] = $value;
+
+ WC()->session->set( 'cko_session', $cko_session );
+ }
+
+ /**
+ * Get WC session value by key.
+ *
+ * @param string $key Session key.
+ *
+ * @return false|mixed
+ */
+ public static function cko_get_session( $key ) {
+ if ( ! class_exists( 'WooCommerce' ) || null == WC()->session ) {
+ return false;
+ }
+
+ $cko_session = WC()->session->get( 'cko_session' );
+
+ if ( ! empty( $cko_session[ $key ] ) ) {
+ return $cko_session[ $key ];
+ }
+
+ return false;
+ }
+
+ /**
+ * Check if cart has subscription item.
+ *
+ * @return bool
+ */
+ public static function is_cart_contains_subscription() {
+ $cart = WC()->cart;
+
+ if ( $cart->is_empty() ) {
+ return false;
+ }
+
+ foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
+ $product = $cart_item['data'];
+
+ if ( $product->is_type( 'subscription' ) ) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Track if unified express checkout container has been rendered.
+ *
+ * @param bool $set Optional. Set the flag to true.
+ * @return bool True if container has been rendered, false otherwise.
+ */
+ public static function express_checkout_container_rendered( $set = false ) {
+ static $rendered = false;
+
+ if ( $set ) {
+ $rendered = true;
+ }
+
+ return $rendered;
+ }
+
+ public static function is_paypal_express_available() {
+ $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings' );
+
+ $is_express_enable = ! empty( $paypal_settings['paypal_express'] ) && 'yes' === $paypal_settings['paypal_express'];
+
+ $available_payment_methods = WC()->payment_gateways()->get_available_payment_gateways();
+
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ if ( $checkout_mode === 'classic' ) {
+ /**
+ * If checkout_mode is classic, show express-paypal if enabled and
+ * if 'wc_checkout_com_paypal' is an available payment method on checkout.
+ *
+ * Note: On shop/cart pages, gateways might not be "available" yet, so we also
+ * check if the gateway exists in all gateways (not just available ones).
+ */
+ $all_gateways = WC()->payment_gateways()->payment_gateways();
+ $paypal_exists = isset( $all_gateways['wc_checkout_com_paypal'] );
+
+ if ( ( isset( $available_payment_methods['wc_checkout_com_paypal'] ) || $paypal_exists ) && $is_express_enable ) {
+ return true;
+ }
+ }
+ else {
+ /**
+ * If checkout_mode is flow, show express-paypal if enabled.
+ */
+ if ( $is_express_enable ) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Check if Google Pay Express is available.
+ *
+ * @return bool True if Google Pay Express is available, false otherwise.
+ */
+ public static function is_google_pay_express_available() {
+ $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings' );
+
+ $is_express_enable = ! empty( $google_pay_settings['google_pay_express'] ) && 'yes' === $google_pay_settings['google_pay_express'];
+
+ $available_payment_methods = WC()->payment_gateways()->get_available_payment_gateways();
+
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ if ( $checkout_mode === 'classic' ) {
+ /**
+ * If checkout_mode is classic, show express-google-pay if enabled and
+ * if 'wc_checkout_com_google_pay' is an available payment method on checkout.
+ *
+ * Note: On shop/cart pages, gateways might not be "available" yet, so we also
+ * check if the gateway exists in all gateways (not just available ones).
+ */
+ $all_gateways = WC()->payment_gateways()->payment_gateways();
+ $google_pay_exists = isset( $all_gateways['wc_checkout_com_google_pay'] );
+
+ if ( ( isset( $available_payment_methods['wc_checkout_com_google_pay'] ) || $google_pay_exists ) && $is_express_enable ) {
+ return true;
+ }
+ }
+ else {
+ /**
+ * If checkout_mode is flow, show express-google-pay if enabled.
+ */
+ if ( $is_express_enable ) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Check if Apple Pay Express is available.
+ *
+ * @return bool True if Apple Pay Express is available, false otherwise.
+ */
+ public static function is_apple_pay_express_available() {
+ $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings' );
+
+ $is_express_enable = ! empty( $apple_pay_settings['apple_pay_express'] ) && 'yes' === $apple_pay_settings['apple_pay_express'];
+
+ $available_payment_methods = WC()->payment_gateways()->get_available_payment_gateways();
+
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ if ( $checkout_mode === 'classic' ) {
+ /**
+ * If checkout_mode is classic, show express-apple-pay if enabled and
+ * if 'wc_checkout_com_apple_pay' is an available payment method on checkout.
+ *
+ * Note: On shop/cart pages, gateways might not be "available" yet, so we also
+ * check if the gateway exists in all gateways (not just available ones).
+ */
+ $all_gateways = WC()->payment_gateways()->payment_gateways();
+ $apple_pay_exists = isset( $all_gateways['wc_checkout_com_apple_pay'] );
+
+ if ( ( isset( $available_payment_methods['wc_checkout_com_apple_pay'] ) || $apple_pay_exists ) && $is_express_enable ) {
+ return true;
+ }
+ }
+ else {
+ /**
+ * If checkout_mode is flow, show express-apple-pay if enabled.
+ */
+ if ( $is_express_enable ) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Get express button height from settings.
+ *
+ * @param string $payment_method Payment method: 'apple_pay', 'google_pay', or 'paypal'.
+ * @return array Returns array with 'height' (in pixels or 'native') and 'use_native' (boolean).
+ */
+ public static function get_express_button_height( $payment_method = 'apple_pay' ) {
+ // Map payment method to settings key
+ $settings_key_map = array(
+ 'apple_pay' => 'woocommerce_wc_checkout_com_apple_pay_settings',
+ 'google_pay' => 'woocommerce_wc_checkout_com_google_pay_settings',
+ 'paypal' => 'woocommerce_wc_checkout_com_paypal_settings',
+ );
+
+ $settings_key = isset( $settings_key_map[ $payment_method ] )
+ ? $settings_key_map[ $payment_method ]
+ : 'woocommerce_wc_checkout_com_apple_pay_settings';
+
+ $settings = get_option( $settings_key, array() );
+
+ $size_preset = isset( $settings[ $payment_method . '_express_button_size_preset' ] )
+ ? $settings[ $payment_method . '_express_button_size_preset' ]
+ : 'native';
+
+ // If native, return native
+ if ( 'native' === $size_preset ) {
+ return array(
+ 'height' => 'native',
+ 'use_native' => true,
+ );
+ }
+
+ // Map presets to heights (matching Stripe's approach)
+ $preset_heights = array(
+ 'small' => 40, // Small (40px) - matching Stripe
+ 'default' => 48, // Default (48px) - matching Stripe
+ 'large' => 56, // Large (56px) - matching Stripe
+ );
+
+ // If custom, get custom height
+ if ( 'custom' === $size_preset ) {
+ $custom_height = isset( $settings[ $payment_method . '_express_button_custom_height' ] )
+ ? absint( $settings[ $payment_method . '_express_button_custom_height' ] )
+ : 40;
+
+ // Validate custom height (36-60px)
+ $custom_height = max( 36, min( 60, $custom_height ) );
+
+ return array(
+ 'height' => $custom_height,
+ 'use_native' => false,
+ );
+ }
+
+ // Use preset height
+ $height = isset( $preset_heights[ $size_preset ] ) ? $preset_heights[ $size_preset ] : 40;
+
+ return array(
+ 'height' => $height,
+ 'use_native' => false,
+ );
+ }
+}
diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-alipay.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-alipay.php
new file mode 100644
index 00000000..442e8961
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-alipay.php
@@ -0,0 +1,85 @@
+id = 'wc_checkout_com_alternative_payments_alipay';
+ $this->title = __( 'Alipay', 'checkout-com-unified-payments-api' );
+ $this->has_fields = true;
+ $this->supports = [ 'products', 'refunds' ];
+
+ $this->init_form_fields();
+
+ add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] );
+ }
+
+ /**
+ * Payment fields to be displayed.
+ */
+ public function payment_fields() {
+ // get available apms depending on currency.
+ $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods();
+ $message = __( 'Pay with Alipay. You will be redirected upon place order', 'checkout-com-unified-payments-api' );
+
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 0 ) : ?>
+
+
+
+
+
+
+
+
+
+
+
+
+ | + | + | + | + | + | + | + | + | + |
|---|---|---|---|---|---|---|---|---|
| id ); ?> | +payment_id ); ?> |
+ order_id ?: '—' ); ?> | +payment_session_id ?: '—' ); ?> |
+ + + | ++ processed_at ) : ?> + + + + + | +created_at ); ?> | +processed_at ?: '—' ); ?> | +
+
+
+
+ + + |
+
+ +
+ + ++ + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-bancontact.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-bancontact.php new file mode 100644 index 00000000..bdc79f45 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-bancontact.php @@ -0,0 +1,101 @@ +id = 'wc_checkout_com_alternative_payments_bancontact'; + $this->title = __( 'Bancontact', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + $message = __( 'Pay with Bancontact. You will be redirected upon place order', 'checkout-com-unified-payments-api' ); + + ?> +
+ + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-boleto.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-boleto.php new file mode 100644 index 00000000..82c567f4 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-boleto.php @@ -0,0 +1,118 @@ +id = 'wc_checkout_com_alternative_payments_boleto'; + $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' ); + $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' ); + $this->title = __( 'Boleto', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + + if ( ! in_array( self::PAYMENT_METHOD, $apm_available, true ) ) { + ?> + + + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-eps.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-eps.php new file mode 100644 index 00000000..2674c150 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-eps.php @@ -0,0 +1,101 @@ +id = 'wc_checkout_com_alternative_payments_eps'; + $this->title = __( 'EPS', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + $message = __( 'Pay with EPS. You will be redirected upon place order', 'checkout-com-unified-payments-api' ); + + ?> +
+ + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-fawry.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-fawry.php new file mode 100644 index 00000000..d2f50dab --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-fawry.php @@ -0,0 +1,135 @@ +id = 'wc_checkout_com_alternative_payments_fawry'; + $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' ); + $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' ); + $this->title = __( 'Fawry', 'checkout-com-unified-payments-api' ); + $this->supports = [ 'products', 'refunds' ]; + $this->has_fields = true; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + $message = __( 'Pay with Fawry', 'checkout-com-unified-payments-api' ); + + ?> +
+ + + update_meta_data( 'cko_fawry_reference_number', $result['source']['reference_number'] ); + $order->update_meta_data( 'cko_payment_authorized', true ); + + // Get cko auth status configured in admin. + $message = sprintf( + /* translators: 1: Result ID, 2: Payment reference number. */ + esc_html__( 'Checkout.com - Fawry payment - Action ID : %1$s - Fawry reference number : %2$s', 'checkout-com-unified-payments-api' ), + $result['id'], + $result['source']['reference_number'] + ); + + if ( 'Captured' === $result['status'] ) { + $status = WC_Admin_Settings::get_option( 'ckocom_order_captured', 'processing' ); + $message = sprintf( + /* translators: %s: Result ID. */ + esc_html__( 'Checkout.com Payment Captured - Action ID - %s', 'checkout-com-unified-payments-api' ), + $result['id'] + ); + } + } + + $order->set_transaction_id( $result['id'] ); + $order->update_meta_data( '_cko_payment_id', $result['id'] ); + + // add notes for the order and update status. + $order->add_order_note( $message ); + $order->update_status( $status ); + + // Reduce stock levels. + wc_reduce_stock_levels( $order_id ); + + // Remove cart. + WC()->cart->empty_cart(); + + // Return thank you page. + return [ + 'result' => 'success', + 'redirect' => $this->get_return_url( $order ), + ]; + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-ideal.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-ideal.php new file mode 100755 index 00000000..2c886e20 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-ideal.php @@ -0,0 +1,103 @@ +id = 'wc_checkout_com_alternative_payments_ideal'; + $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' ); + $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' ); + $this->title = __( 'Ideal', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + $message = __( 'Pay with iDEAL. You will be redirected upon place order', 'checkout-com-unified-payments-api' ); + + ?> +
+ + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-klarna.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-klarna.php new file mode 100644 index 00000000..e5f45c57 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-klarna.php @@ -0,0 +1,244 @@ +id = 'wc_checkout_com_alternative_payments_klarna'; + $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' ); + $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' ); + $this->title = __( 'Klarna', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + + ?> + + + + ', $client_token ); + } else { + ?> + + + + + + + + + + + + create_payment( $order, self::PAYMENT_METHOD ); + + // check if result has error and return error message. + if ( ! empty( $result['error'] ) ) { + WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'], 'error' ); + return; + } + + // redirect to apm if redirection url is available. + if ( ! empty( $result['redirect'] ) ) { + return [ + 'result' => 'success', + 'redirect' => $result['redirect'], + ]; + } + } + + /** + * Create payment. + * + * @param WC_Order $order The order object. + * @param string $payment_method The payment method. + * + * @return array + */ + private function create_payment( WC_Order $order, $payment_method ) { + $payment_context_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_klarna_pc_id' ); + + try { + $checkout = new Checkout_SDK(); + + // Build metadata for Klarna payment + global $wp_version; + $woocommerce = WC(); + + $udf5 = sprintf( + 'Platform Data - WordPress %s / Woocommerce %s, Integration Data - Checkout.com %s, SDK Data - PHP SDK %s, Order ID - %s, Server - %s', + $wp_version, + $woocommerce->version, + WC_CHECKOUTCOM_PLUGIN_VERSION, + CheckoutUtils::PROJECT_VERSION, + $order->get_order_number(), + get_site_url() + ); + + $metadata = [ + 'udf5' => $udf5, + 'order_id' => $order->get_id(), + ]; + + $payment_request_param = $checkout->get_payment_request(); + $payment_request_param->payment_context_id = $payment_context_id; + $payment_request_param->reference = $order->get_order_number(); + $payment_request_param->metadata = $metadata; + + $response = $checkout->get_builder()->getPaymentsClient()->requestPayment( $payment_request_param ); + $response_code = $response['http_metadata']->getStatusCode(); + + if ( ! WC_Checkoutcom_Utility::is_successful( $response ) || 'Declined' === $response['status'] ) { + $order->update_meta_data( '_cko_payment_id', $response['id'] ); + $order->save(); + + $error_message = esc_html__( 'An error has occurred while Klarna payment request. ', 'checkout-com-unified-payments-api' ); + + wp_send_json_error( [ 'messages' => $error_message ] ); + + return [ + 'result' => 'fail', + 'redirect' => '', + ]; + } + + /** + * Full Success = 201 + * Partial Success = 202 + * + * Ref : https://api-reference.checkout.com/#operation/requestAPaymentOrPayout!path=1/payment_context_id&t=request + */ + if ( in_array( $response_code, [ 201, 202 ], true ) ) { + + $order->set_transaction_id( $response['id'] ); + $order->update_meta_data( '_cko_payment_id', $response['id'] ); + + if ( class_exists( 'WC_Subscriptions_Order' ) && isset( $response['source'] ) ) { + // Save source id for subscription. + WC_Checkoutcom_Subscription::save_source_id( $order->get_id(), $order, $response['source']['id'] ); + } + + // Get cko auth status configured in admin. + $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' ); + + $order->update_meta_data( 'cko_payment_authorized', true ); + $order->update_status( $status ); + + // Reduce stock levels. + wc_reduce_stock_levels( $order->get_id() ); + + // Remove cart. + WC()->cart->empty_cart(); + + // Return thank you page. + return [ + 'result' => 'success', + 'redirect' => $this->get_return_url( $order ), + ]; + + } + } catch ( CheckoutApiException $ex ) { + $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes'; + + $error_message = esc_html__( 'An error has occurred while Klarna payment request. ', 'checkout-com-unified-payments-api' ); + + // Check if gateway response is enabled from module settings. + if ( $gateway_debug ) { + $error_message .= $ex->getMessage(); + } + + WC_Checkoutcom_Utility::logger( $error_message, $ex ); + + wp_send_json_error( [ 'messages' => $error_message ] ); + } + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-knet.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-knet.php new file mode 100644 index 00000000..89e0b657 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-knet.php @@ -0,0 +1,99 @@ +id = 'wc_checkout_com_alternative_payments_knet'; + $this->title = __( 'KNET', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + $message = __( 'Pay with Knet. You will be redirected upon place order', 'checkout-com-unified-payments-api' ); + + ?> +
+ + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-multibanco.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-multibanco.php new file mode 100644 index 00000000..94b88754 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-multibanco.php @@ -0,0 +1,88 @@ +id = 'wc_checkout_com_alternative_payments_multibanco'; + $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' ); + $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' ); + $this->title = __( 'Pay by Multibanco with Checkout.com', 'checkout-com-unified-payments-api' ); + $this->supports = [ 'products' ]; + $this->has_fields = true; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment form on checkout page. + */ + public function payment_fields() { + // Get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + + if ( ! in_array( self::PAYMENT_METHOD, $apm_available, true ) ) { + ?> + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-poli.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-poli.php new file mode 100644 index 00000000..0c0a6cdf --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-poli.php @@ -0,0 +1,85 @@ +id = 'wc_checkout_com_alternative_payments_poli'; + $this->title = __( 'Poli', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + $message = __( 'Pay with Poli. You will be redirected upon place order', 'checkout-com-unified-payments-api' ); + + ?> +
+ + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-qpay.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-qpay.php new file mode 100644 index 00000000..ba13986f --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-qpay.php @@ -0,0 +1,99 @@ +id = 'wc_checkout_com_alternative_payments_qpay'; + $this->title = __( 'QPay', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + $message = __( 'Pay with QPay. You will be redirected upon place order', 'checkout-com-unified-payments-api' ); + + ?> +
+ + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-sepa.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-sepa.php new file mode 100644 index 00000000..bc53791c --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-sepa.php @@ -0,0 +1,270 @@ +id = 'wc_checkout_com_alternative_payments_sepa'; + $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' ); + $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' ); + $this->title = __( 'SEPA Direct Debit', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ + 'products', + 'refunds', + 'subscriptions', + 'subscription_cancellation', + 'subscription_suspension', + 'subscription_reactivation', + 'subscription_date_changes', + 'subscription_payment_method_change_admin', + ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + + // Meta field on subscription edit. + add_filter( 'woocommerce_subscription_payment_meta', [ $this, 'add_payment_meta_field' ], 10, 2 ); + } + + /** + * Add subscription order payment meta field. + * + * @param array $payment_meta associative array of meta data required for automatic payments. + * @param WC_Subscription $subscription An instance of a subscription object. + * @return array + */ + public function add_payment_meta_field( $payment_meta, $subscription ) { + $source_id = $subscription->get_meta( '_cko_source_id' ); + + $payment_meta[ $this->id ] = [ + 'post_meta' => [ + '_cko_source_id' => [ + 'value' => $source_id, + 'label' => 'Checkout.com SEPA Direct Debit Source ID', + ], + ], + ]; + + return $payment_meta; + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + + if ( ! in_array( self::PAYMENT_METHOD, $apm_available, true ) ) { + ?> + + + + session->get( 'mandate_reference' ); + $message = ''; + $result = []; + + if ( 0 >= $order->get_total() ) { // 0 cost order. + $message = esc_html__( 'Checkout.com - SEPA payment for free order.', 'checkout-com-unified-payments-api' ); + + // phpcs:ignore WordPress.Security.NonceVerification.Missing + $post_data = sanitize_post( $_POST ); + $method = WC_Checkoutcom_Api_Request::get_apm_method( $post_data, $order, 'sepa' ); + + if ( ! empty( $method->id ) ) { + $status = WC_Admin_Settings::get_option( 'ckocom_order_captured', 'processing' ); + + // save src id for future use. + if ( class_exists( 'WC_Subscriptions_Order' ) ) { + WC_Checkoutcom_Subscription::save_source_id( $order_id, $order, $method->id ); + } + } + + // check if result has error and return error message. + if ( empty( $method->id ) ) { + WC_Checkoutcom_Utility::wc_add_notice_self( esc_html__( 'Please try correct IBAN', 'checkout-com-unified-payments-api' ) ); + + $message .= esc_html__( ' Please try correct IBAN', 'checkout-com-unified-payments-api' ); + + $order->add_order_note( $message ); + + // Prevent from going into action loops. + remove_action( 'woocommerce_order_status_failed', 'WC_Subscriptions_Manager::failed_subscription_sign_ups_for_order' ); + remove_action( 'woocommerce_order_status_changed', 'WC_Subscriptions_Order::maybe_record_subscription_payment', 9, 3 ); + + $subscriptions = function_exists( 'wcs_get_subscriptions_for_order' ) ? wcs_get_subscriptions_for_order( $order ) : null; + if ( ! empty( $subscriptions ) ) { + $order->update_status( 'failed' ); + WC_Subscriptions_Manager::failed_subscription_sign_ups_for_order( $order ); + } else { + $order->update_status( 'failed' ); + } + + add_action( 'woocommerce_order_status_failed', 'WC_Subscriptions_Manager::failed_subscription_sign_ups_for_order' ); + add_action( 'woocommerce_order_status_changed', 'WC_Subscriptions_Order::maybe_record_subscription_payment', 9, 3 ); + // Prevent from going into action loops - END. + + return [ + 'result' => 'fail', + 'redirect' => '', + ]; + } + } else { + // create alternative payment. + $result = (array) WC_Checkoutcom_Api_Request::create_apm_payment( $order, self::PAYMENT_METHOD ); + + if ( ! empty( $mandate ) && ! empty( $result['source'] ) && self::PAYMENT_METHOD === $result['source']['type'] ) { + + $order->update_meta_data( 'cko_sepa_mandate_reference', $mandate ); + $order->update_meta_data( 'cko_payment_authorized', true ); + + WC()->session->__unset( 'mandate_reference' ); + } + + if ( ! empty( $result['source'] ) && self::PAYMENT_METHOD === $result['source']['type'] ) { + + $message = sprintf( + /* translators: 1: Result ID, 2: Mandate reference. */ + esc_html__( 'Checkout.com - Sepa payment Action ID : %1$s - Sepa mandate reference : %2$s', 'checkout-com-unified-payments-api' ), + $result['id'], + $mandate + ); + } + + // check if result has error and return error message. + if ( isset( $result['error'] ) && ! empty( $result['error'] ) ) { + WC_Checkoutcom_Utility::wc_add_notice_self( $result['error'] ); + + $order->add_order_note( $result['error'] ); + + // Prevent from going into action loops. + remove_action( 'woocommerce_order_status_failed', 'WC_Subscriptions_Manager::failed_subscription_sign_ups_for_order' ); + remove_action( 'woocommerce_order_status_changed', 'WC_Subscriptions_Order::maybe_record_subscription_payment', 9, 3 ); + + $subscriptions = function_exists( 'wcs_get_subscriptions_for_order' ) ? wcs_get_subscriptions_for_order( $order ) : null; + if ( ! empty( $subscriptions ) ) { + $order->update_status( 'failed' ); + WC_Subscriptions_Manager::failed_subscription_sign_ups_for_order( $order ); + } else { + $order->update_status( 'failed' ); + } + + add_action( 'woocommerce_order_status_failed', 'WC_Subscriptions_Manager::failed_subscription_sign_ups_for_order' ); + add_action( 'woocommerce_order_status_changed', 'WC_Subscriptions_Order::maybe_record_subscription_payment', 9, 3 ); + // Prevent from going into action loops - END. + + return [ + 'result' => 'fail', + 'redirect' => '', + ]; + } + } + + // save source id for subscription. + if ( class_exists( 'WC_Subscriptions_Order' ) ) { + + if ( ! empty( $result['source'] ) ) { + WC_Checkoutcom_Subscription::save_source_id( $order_id, $order, $result['source']['id'] ); + } + + $mandate_cancel = WC()->session->get( 'mandate_cancel' ); + if ( ! empty( $mandate_cancel ) ) { + WC_Checkoutcom_Subscription::save_mandate_cancel( $order_id, $order, $mandate_cancel ); + WC()->session->__unset( 'mandate_cancel' ); + } + } + + $order->set_transaction_id( $result['id'] ); + $order->update_meta_data( '_cko_payment_id', $result['id'] ); + + // add notes for the order and update status. + $order->add_order_note( $message ); + $order->update_status( $status ); + + // Reduce stock levels. + wc_reduce_stock_levels( $order_id ); + + // Remove cart. + WC()->cart->empty_cart(); + + // Return thank you page. + return [ + 'result' => 'success', + 'redirect' => $this->get_return_url( $order ), + ]; + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-sofort.php b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-sofort.php new file mode 100644 index 00000000..bffb98a8 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/apms/class-wc-gateway-checkout-com-alternative-payments-sofort.php @@ -0,0 +1,99 @@ +id = 'wc_checkout_com_alternative_payments_sofort'; + $this->title = __( 'Sofort', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Payment fields to be displayed. + */ + public function payment_fields() { + // get available apms depending on currency. + $apm_available = WC_Checkoutcom_Utility::get_alternative_payment_methods(); + $message = __( 'Pay with Sofort. You will be redirected upon place order', 'checkout-com-unified-payments-api' ); + + ?> +
+ + + 'success', + 'redirect' => $result['apm_redirection'], + ]; + } + } + + /** + * Process refund for the order. + * + * @param int $order_id Order ID. + * @param int $amount Amount to refund. + * @param string $reason Refund reason. + * + * @return bool + */ + public function process_refund( $order_id, $amount = null, $reason = '' ) { + + return parent::process_refund( $order_id, $amount, $reason ); + } +} diff --git a/checkout-com-unified-payments-api/includes/blocks/class-wc-checkoutcom-blocks-admin-notice.php b/checkout-com-unified-payments-api/includes/blocks/class-wc-checkoutcom-blocks-admin-notice.php new file mode 100644 index 00000000..7406af57 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/blocks/class-wc-checkoutcom-blocks-admin-notice.php @@ -0,0 +1,111 @@ + + + + + id || + 'woocommerce_page_wc-orders' === $screen->id || + 'woocommerce_page_wc-reports' === $screen->id + ); + } +} + +// Initialize the admin notice +WC_Checkoutcom_Blocks_Admin_Notice::init(); diff --git a/checkout-com-unified-payments-api/includes/blocks/class-wc-checkoutcom-blocks-integration.php b/checkout-com-unified-payments-api/includes/blocks/class-wc-checkoutcom-blocks-integration.php new file mode 100644 index 00000000..b66e412f --- /dev/null +++ b/checkout-com-unified-payments-api/includes/blocks/class-wc-checkoutcom-blocks-integration.php @@ -0,0 +1,111 @@ +register( + new WC_Checkoutcom_Cards_Blocks_Integration() + ); + } + + // Register Checkout.com PayPal + if ( class_exists( 'WC_Checkoutcom_PayPal_Blocks_Integration' ) ) { + $payment_method_registry->register( + new WC_Checkoutcom_PayPal_Blocks_Integration() + ); + } + + // Register Checkout.com Google Pay + if ( class_exists( 'WC_Checkoutcom_GooglePay_Blocks_Integration' ) ) { + $payment_method_registry->register( + new WC_Checkoutcom_GooglePay_Blocks_Integration() + ); + } + + // Register Checkout.com Apple Pay + if ( class_exists( 'WC_Checkoutcom_ApplePay_Blocks_Integration' ) ) { + $payment_method_registry->register( + new WC_Checkoutcom_ApplePay_Blocks_Integration() + ); + } + + // Register Checkout.com Flow (if enabled) + if ( class_exists( 'WC_Gateway_Checkout_Com_Flow' ) && class_exists( 'WC_Checkoutcom_Flow_Blocks_Integration' ) ) { + $payment_method_registry->register( + new WC_Checkoutcom_Flow_Blocks_Integration() + ); + } + } catch ( Exception $e ) { + // Log error but don't break the site + error_log( 'Checkout.com Blocks Integration Error: ' . $e->getMessage() ); + } + } +} + +// Initialize the integration only if WooCommerce is active +if ( class_exists( 'WooCommerce' ) ) { + WC_Checkoutcom_Blocks_Integration::init(); +} diff --git a/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-applepay-blocks.php b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-applepay-blocks.php new file mode 100644 index 00000000..5e2da7ba --- /dev/null +++ b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-applepay-blocks.php @@ -0,0 +1,98 @@ +settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', [] ); + } + + /** + * Returns if this payment method should be active. + * + * @return boolean + */ + public function is_active() { + return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled']; + } + + /** + * Returns an array of scripts/handles to be registered for this payment method. + * + * @return array + */ + public function get_payment_method_script_handles() { + $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/applepay-blocks.asset.php'; + $version = WC_CHECKOUTCOM_PLUGIN_VERSION; + $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ]; + + if ( file_exists( $asset_path ) ) { + $asset = require $asset_path; + $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version; + $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies; + } + + wp_register_script( + 'wc-checkoutcom-applepay-blocks', + WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/applepay-blocks.js', + $dependencies, + $version, + true + ); + + return [ 'wc-checkoutcom-applepay-blocks' ]; + } + + /** + * Returns an array of key=>value pairs of data made available to the payment methods script. + * + * @return array + */ + public function get_payment_method_data() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] ); + $environment = 'sandbox' === ( $core_settings['ckocom_environment'] ?? 'sandbox' ); + + return [ + 'title' => $this->get_setting( 'title' ), + 'description' => $this->get_setting( 'description' ), + 'supports' => $this->get_supported_features(), + 'environment' => $environment ? 'TEST' : 'PRODUCTION', + 'public_key' => $core_settings['ckocom_pk'] ?? '', + 'merchant_id' => $this->get_setting( 'ckocom_apple_merchant_id' ), + 'currency' => get_woocommerce_currency(), + ]; + } + + /** + * Returns an array of supported features. + * + * @return string[] + */ + public function get_supported_features() { + return apply_filters( 'wc_checkoutcom_applepay_supported_features', [ + 'products', + 'refunds', + ] ); + } +} diff --git a/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-cards-blocks.php b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-cards-blocks.php new file mode 100644 index 00000000..edfc231b --- /dev/null +++ b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-cards-blocks.php @@ -0,0 +1,113 @@ +settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] ); + } + + /** + * Returns if this payment method should be active. + * + * @return boolean + */ + public function is_active() { + return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled']; + } + + /** + * Returns an array of scripts/handles to be registered for this payment method. + * + * @return array + */ + public function get_payment_method_script_handles() { + $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/index.asset.php'; + $version = WC_CHECKOUTCOM_PLUGIN_VERSION; + $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ]; + + if ( file_exists( $asset_path ) ) { + $asset = require $asset_path; + $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version; + $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies; + } + + wp_register_script( + 'wc-checkoutcom-cards-blocks', + WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/cards-blocks.js', + $dependencies, + $version, + true + ); + + return [ 'wc-checkoutcom-cards-blocks' ]; + } + + /** + * Returns an array of key=>value pairs of data made available to the payment methods script. + * + * @return array + */ + public function get_payment_method_data() { + return [ + 'title' => $this->get_setting( 'title' ), + 'description' => $this->get_setting( 'description' ), + 'supports' => $this->get_supported_features(), + 'environment' => $this->get_setting( 'ckocom_environment' ), + 'public_key' => $this->get_setting( 'ckocom_pk' ), + 'checkout_mode' => $this->get_setting( 'ckocom_checkout_mode' ), + ]; + } + + /** + * Returns an array of supported features. + * + * @return string[] + */ + public function get_supported_features() { + return apply_filters( 'wc_checkoutcom_cards_supported_features', [ + 'products', + 'refunds', + ] ); + } +} diff --git a/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-flow-blocks.php b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-flow-blocks.php new file mode 100644 index 00000000..665a52c9 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-flow-blocks.php @@ -0,0 +1,99 @@ +settings = get_option( 'woocommerce_wc_checkout_com_flow_settings', [] ); + } + + /** + * Returns if this payment method should be active. + * + * @return boolean + */ + public function is_active() { + return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled']; + } + + /** + * Returns an array of scripts/handles to be registered for this payment method. + * + * @return array + */ + public function get_payment_method_script_handles() { + $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/flow-blocks.asset.php'; + $version = WC_CHECKOUTCOM_PLUGIN_VERSION; + $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ]; + + if ( file_exists( $asset_path ) ) { + $asset = require $asset_path; + $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version; + $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies; + } + + wp_register_script( + 'wc-checkoutcom-flow-blocks', + WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/flow-blocks.js', + $dependencies, + $version, + true + ); + + return [ 'wc-checkoutcom-flow-blocks' ]; + } + + /** + * Returns an array of key=>value pairs of data made available to the payment methods script. + * + * @return array + */ + public function get_payment_method_data() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] ); + $environment = 'sandbox' === ( $core_settings['ckocom_environment'] ?? 'sandbox' ); + + return [ + 'title' => $this->get_setting( 'title' ), + 'description' => $this->get_setting( 'description' ), + 'supports' => $this->get_supported_features(), + 'environment' => $environment ? 'TEST' : 'PRODUCTION', + 'public_key' => $core_settings['ckocom_pk'] ?? '', + 'currency' => get_woocommerce_currency(), + 'enabled_payment_methods' => $this->get_setting( 'flow_enabled_payment_methods', [] ), + 'saved_payment_display_order' => $this->get_setting( 'saved_payment_display_order', 'saved_cards_first' ), + ]; + } + + /** + * Returns an array of supported features. + * + * @return string[] + */ + public function get_supported_features() { + return apply_filters( 'wc_checkoutcom_flow_supported_features', [ + 'products', + 'refunds', + ] ); + } +} diff --git a/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-googlepay-blocks.php b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-googlepay-blocks.php new file mode 100644 index 00000000..cfe5486b --- /dev/null +++ b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-googlepay-blocks.php @@ -0,0 +1,99 @@ +settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', [] ); + } + + /** + * Returns if this payment method should be active. + * + * @return boolean + */ + public function is_active() { + return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled']; + } + + /** + * Returns an array of scripts/handles to be registered for this payment method. + * + * @return array + */ + public function get_payment_method_script_handles() { + $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/googlepay-blocks.asset.php'; + $version = WC_CHECKOUTCOM_PLUGIN_VERSION; + $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ]; + + if ( file_exists( $asset_path ) ) { + $asset = require $asset_path; + $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version; + $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies; + } + + wp_register_script( + 'wc-checkoutcom-googlepay-blocks', + WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/googlepay-blocks.js', + $dependencies, + $version, + true + ); + + return [ 'wc-checkoutcom-googlepay-blocks' ]; + } + + /** + * Returns an array of key=>value pairs of data made available to the payment methods script. + * + * @return array + */ + public function get_payment_method_data() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] ); + $environment = 'sandbox' === ( $core_settings['ckocom_environment'] ?? 'sandbox' ); + + return [ + 'title' => $this->get_setting( 'title' ), + 'description' => $this->get_setting( 'description' ), + 'supports' => $this->get_supported_features(), + 'environment' => $environment ? 'TEST' : 'PRODUCTION', + 'public_key' => $core_settings['ckocom_pk'] ?? '', + 'merchant_id' => $this->get_setting( 'ckocom_google_merchant_id' ), + 'currency' => get_woocommerce_currency(), + 'button_type' => $this->get_setting( 'ckocom_google_style', 'google-pay-black' ), + ]; + } + + /** + * Returns an array of supported features. + * + * @return string[] + */ + public function get_supported_features() { + return apply_filters( 'wc_checkoutcom_googlepay_supported_features', [ + 'products', + 'refunds', + ] ); + } +} diff --git a/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-paypal-blocks.php b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-paypal-blocks.php new file mode 100644 index 00000000..36bfddbb --- /dev/null +++ b/checkout-com-unified-payments-api/includes/blocks/payment-methods/class-wc-checkoutcom-paypal-blocks.php @@ -0,0 +1,99 @@ +settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', [] ); + } + + /** + * Returns if this payment method should be active. + * + * @return boolean + */ + public function is_active() { + return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled']; + } + + /** + * Returns an array of scripts/handles to be registered for this payment method. + * + * @return array + */ + public function get_payment_method_script_handles() { + $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/paypal-blocks.asset.php'; + $version = WC_CHECKOUTCOM_PLUGIN_VERSION; + $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ]; + + if ( file_exists( $asset_path ) ) { + $asset = require $asset_path; + $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version; + $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies; + } + + wp_register_script( + 'wc-checkoutcom-paypal-blocks', + WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/paypal-blocks.js', + $dependencies, + $version, + true + ); + + return [ 'wc-checkoutcom-paypal-blocks' ]; + } + + /** + * Returns an array of key=>value pairs of data made available to the payment methods script. + * + * @return array + */ + public function get_payment_method_data() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] ); + $environment = 'sandbox' === ( $core_settings['ckocom_environment'] ?? 'sandbox' ); + + return [ + 'title' => $this->get_setting( 'title' ), + 'description' => $this->get_setting( 'description' ), + 'supports' => $this->get_supported_features(), + 'environment' => $environment ? 'TEST' : 'PRODUCTION', + 'public_key' => $core_settings['ckocom_pk'] ?? '', + 'merchant_id' => $this->get_setting( 'ckocom_paypal_merchant_id' ), + 'currency' => get_woocommerce_currency(), + 'express_enabled' => $this->get_setting( 'paypal_express' ) === 'yes', + ]; + } + + /** + * Returns an array of supported features. + * + * @return string[] + */ + public function get_supported_features() { + return apply_filters( 'wc_checkoutcom_paypal_supported_features', [ + 'products', + 'refunds', + ] ); + } +} diff --git a/checkout-com-unified-payments-api/includes/class-wc-checkout-com-webhook-queue.php b/checkout-com-unified-payments-api/includes/class-wc-checkout-com-webhook-queue.php new file mode 100644 index 00000000..378835df --- /dev/null +++ b/checkout-com-unified-payments-api/includes/class-wc-checkout-com-webhook-queue.php @@ -0,0 +1,498 @@ +prefix . 'cko_pending_webhooks'; + } + + /** + * Create the pending webhooks table. + * + * @return void + */ + public static function create_table() { + global $wpdb; + $table_name = self::get_table_name(); + $charset_collate = $wpdb->get_charset_collate(); + + $sql = "CREATE TABLE IF NOT EXISTS {$table_name} ( + id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY, + payment_id VARCHAR(255) NOT NULL, + order_id VARCHAR(50) NULL, + payment_session_id VARCHAR(255) NULL, + webhook_type VARCHAR(50) NOT NULL, + webhook_data LONGTEXT NOT NULL, + created_at DATETIME NOT NULL, + processed_at DATETIME NULL, + INDEX idx_payment_id (payment_id), + INDEX idx_order_id (order_id), + INDEX idx_payment_session_id (payment_session_id), + INDEX idx_processed (processed_at), + INDEX idx_created (created_at) + ) {$charset_collate};"; + + require_once ABSPATH . 'wp-admin/includes/upgrade.php'; + dbDelta( $sql ); + } + + /** + * Check if webhook debug logging is enabled. + * + * @return bool + */ + private static function is_webhook_debug_enabled() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' ); + return ( isset( $core_settings['cko_gateway_responses'] ) && $core_settings['cko_gateway_responses'] === 'yes' ); + } + + /** + * Save a pending webhook to the queue. + * + * @param string $payment_id Payment ID from Checkout.com. + * @param string|null $order_id Order ID (may be null for Flow payments). + * @param string|null $payment_session_id Payment session ID (may be null). + * @param string $webhook_type Webhook type ('payment_approved' or 'payment_captured'). + * @param object $webhook_data Full webhook payload. + * @return bool True if saved successfully, false otherwise. + */ + public static function save_pending_webhook( $payment_id, $order_id, $payment_session_id, $webhook_type, $webhook_data ) { + global $wpdb; + $table_name = self::get_table_name(); + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Attempting to queue webhook - Type: ' . $webhook_type . ', Payment ID: ' . $payment_id . ', Order ID: ' . ( $order_id ?? 'NULL' ) . ', Session ID: ' . ( $payment_session_id ?? 'NULL' ) ); + } + + // Validate webhook type (only auth and capture) + if ( ! in_array( $webhook_type, array( 'payment_approved', 'payment_captured' ), true ) ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Invalid webhook type for queuing: ' . $webhook_type ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (FAILED - Invalid Type) ===' ); + } + return false; + } + + // Validate payment_id (required) + if ( empty( $payment_id ) ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Cannot queue webhook - payment_id is required' ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (FAILED - Missing Payment ID) ===' ); + } + return false; + } + + // Encode webhook data as JSON + $webhook_data_json = wp_json_encode( $webhook_data ); + if ( false === $webhook_data_json ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Failed to encode webhook data as JSON' ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (FAILED - JSON Encode Error) ===' ); + } + return false; + } + + // Sanitize inputs + $payment_id = sanitize_text_field( $payment_id ); + $order_id = ! empty( $order_id ) ? sanitize_text_field( $order_id ) : null; + $payment_session_id = ! empty( $payment_session_id ) ? sanitize_text_field( $payment_session_id ) : null; + $webhook_type = sanitize_text_field( $webhook_type ); + + // CRITICAL: Check for duplicate webhook before queuing (prevent duplicate queue entries) + // Check if same payment_id + webhook_type combination already exists and is unprocessed + $existing_query = $wpdb->prepare( + "SELECT id FROM {$table_name} + WHERE payment_id = %s + AND webhook_type = %s + AND processed_at IS NULL + LIMIT 1", + $payment_id, + $webhook_type + ); + $existing_webhook = $wpdb->get_var( $existing_query ); + + if ( $existing_webhook ) { + // Duplicate webhook already in queue - skip queuing + WC_Checkoutcom_Utility::logger( + 'WEBHOOK PROCESS: WEBHOOK QUEUE: ✅ Duplicate webhook already queued - Skipping - ' . + 'Type: ' . $webhook_type . ', ' . + 'Payment ID: ' . $payment_id . ', ' . + 'Order ID: ' . ( $order_id ?? 'NULL' ) . ', ' . + 'Existing Queue ID: ' . $existing_webhook + ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (SKIPPED - Duplicate) ===' ); + } + return true; // Return true to indicate "handled" (even though skipped) + } + + $result = $wpdb->insert( + $table_name, + array( + 'payment_id' => $payment_id, + 'order_id' => $order_id, + 'payment_session_id' => $payment_session_id, + 'webhook_type' => $webhook_type, + 'webhook_data' => $webhook_data_json, + 'created_at' => current_time( 'mysql' ), + 'processed_at' => null, + ), + array( + '%s', // payment_id + '%s', // order_id + '%s', // payment_session_id + '%s', // webhook_type + '%s', // webhook_data + '%s', // created_at + null, // processed_at + ) + ); + + if ( false === $result ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Failed to save webhook to queue - ' . $wpdb->last_error ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (FAILED - Database Error) ===' ); + } + return false; + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Successfully queued webhook - Queue ID: ' . $wpdb->insert_id . ', Type: ' . $webhook_type . ', Payment ID: ' . $payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (SUCCESS) ===' ); + } else { + // Always log successful queue operations (even if debug disabled) + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Webhook queued successfully - Type: ' . $webhook_type . ', Payment ID: ' . $payment_id . ', Order ID: ' . ( $order_id ?? 'NULL' ) ); + } + + return true; + } + + /** + * Get pending webhooks for an order. + * + * @param WC_Order $order WooCommerce order object. + * @return array Array of pending webhook objects. + */ + public static function get_pending_webhooks_for_order( $order ) { + global $wpdb; + $table_name = self::get_table_name(); + + $payment_id = $order->get_meta( '_cko_payment_id' ); + $payment_session_id = $order->get_meta( '_cko_payment_session_id' ); + $order_id = $order->get_id(); + + // Build WHERE clause with priority: payment_id > payment_session_id > order_id + $where_conditions = array(); + $where_values = array(); + + if ( ! empty( $payment_id ) ) { + $where_conditions[] = 'payment_id = %s'; + $where_values[] = $payment_id; + } + + if ( ! empty( $payment_session_id ) ) { + $where_conditions[] = 'payment_session_id = %s'; + $where_values[] = $payment_session_id; + } + + if ( ! empty( $order_id ) ) { + $where_conditions[] = 'order_id = %s'; + $where_values[] = (string) $order_id; + } + + // If no identifiers available, return empty array + if ( empty( $where_conditions ) ) { + return array(); + } + + $where_clause = '(' . implode( ' OR ', $where_conditions ) . ') AND processed_at IS NULL'; + + $query = "SELECT * FROM {$table_name} + WHERE {$where_clause} + ORDER BY + CASE webhook_type + WHEN 'payment_approved' THEN 1 + WHEN 'payment_captured' THEN 2 + ELSE 3 + END, + created_at ASC"; + + if ( ! empty( $where_values ) ) { + $query = $wpdb->prepare( $query, $where_values ); + } + + $results = $wpdb->get_results( $query ); + + return $results ? $results : array(); + } + + /** + * Process pending webhooks for an order. + * + * @param WC_Order $order WooCommerce order object. + * @return int Number of webhooks processed. + */ + public static function process_pending_webhooks_for_order( $order ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + $pending_webhooks = self::get_pending_webhooks_for_order( $order ); + + if ( empty( $pending_webhooks ) ) { + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: No pending webhooks found for Order ID: ' . $order->get_id() ); + } + return 0; + } + + $order_id = $order->get_id(); + $processed_count = 0; + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: process_pending_webhooks_for_order START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Found ' . count( $pending_webhooks ) . ' pending webhook(s) for Order ID: ' . $order_id ); + } else { + // Always log when processing queued webhooks (even if debug disabled) + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Processing ' . count( $pending_webhooks ) . ' pending webhook(s) for Order ID: ' . $order_id ); + } + + foreach ( $pending_webhooks as $queued_webhook ) { + // Decode webhook data + $webhook_data = json_decode( $queued_webhook->webhook_data ); + + if ( ! $webhook_data ) { + WC_Checkoutcom_Utility::logger( + 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Failed to decode webhook data for queued webhook ID: ' . $queued_webhook->id + ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Skipping webhook ID: ' . $queued_webhook->id . ' due to decode error' ); + } + continue; + } + + // CRITICAL: Reload order to get latest state (including processed webhooks) + $order = wc_get_order( $order_id ); + if ( ! $order ) { + WC_Checkoutcom_Utility::logger( + 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Order not found - Order ID: ' . $order_id . ', Queue ID: ' . $queued_webhook->id + ); + continue; + } + + // CRITICAL: Check if this webhook already processed (duplicate prevention) + $processed_webhooks = $order->get_meta( '_cko_processed_webhook_ids' ); + if ( ! is_array( $processed_webhooks ) ) { + $processed_webhooks = array(); + } + + // Create unique webhook identifier (payment_id + event_type) + // Use webhook_type from queue (payment_approved/payment_captured) to match event type + $event_type = 'payment_approved' === $queued_webhook->webhook_type ? 'payment_approved' : 'payment_captured'; + $webhook_id = $queued_webhook->payment_id . '_' . $event_type; + + if ( in_array( $webhook_id, $processed_webhooks, true ) ) { + // Webhook already processed - skip to prevent duplicate order updates + WC_Checkoutcom_Utility::logger( + 'WEBHOOK PROCESS: WEBHOOK QUEUE: ✅ Already processed - Skipping duplicate queued webhook - ' . + 'Queue ID: ' . $queued_webhook->id . ', ' . + 'Payment ID: ' . $queued_webhook->payment_id . ', ' . + 'Type: ' . $queued_webhook->webhook_type . ', ' . + 'Order ID: ' . $order_id + ); + + // Mark as processed in queue table (even though already processed) + global $wpdb; + $table_name = self::get_table_name(); + $wpdb->update( + $table_name, + array( 'processed_at' => current_time( 'mysql' ) ), + array( 'id' => $queued_webhook->id ), + array( '%s' ), + array( '%d' ) + ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Marked duplicate webhook as processed in queue table' ); + } + continue; + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Processing queued webhook - Queue ID: ' . $queued_webhook->id . ', Type: ' . $queued_webhook->webhook_type . ', Payment ID: ' . $queued_webhook->payment_id ); + } + + // Ensure order_id is set in metadata for processing functions + if ( ! isset( $webhook_data->data->metadata ) ) { + $webhook_data->data->metadata = new stdClass(); + } + $webhook_data->data->metadata->order_id = $order_id; + + // Ensure event type is set for webhook processing + if ( ! isset( $webhook_data->type ) ) { + $webhook_data->type = $event_type; + } + + // Process webhook based on type + $success = false; + if ( 'payment_approved' === $queued_webhook->webhook_type ) { + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Calling authorize_payment() for queued webhook' ); + } + $success = WC_Checkout_Com_Webhook::authorize_payment( $webhook_data ); + } elseif ( 'payment_captured' === $queued_webhook->webhook_type ) { + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Calling capture_payment() for queued webhook' ); + } + $success = WC_Checkout_Com_Webhook::capture_payment( $webhook_data ); + } + + if ( $success ) { + // CRITICAL: Mark webhook as processed in order meta (same as direct webhook processing) + // Reload order to get latest state after processing + $order = wc_get_order( $order_id ); + if ( $order ) { + $processed_webhooks = $order->get_meta( '_cko_processed_webhook_ids' ); + if ( ! is_array( $processed_webhooks ) ) { + $processed_webhooks = array(); + } + + // Add to processed list if not already there + if ( ! in_array( $webhook_id, $processed_webhooks, true ) ) { + $processed_webhooks[] = $webhook_id; + $order->update_meta_data( '_cko_processed_webhook_ids', array_unique( $processed_webhooks ) ); + $order->save(); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Marked webhook as processed in order meta - Webhook ID: ' . $webhook_id ); + } + } + } + + // Mark as processed in queue table + global $wpdb; + $table_name = self::get_table_name(); + $wpdb->update( + $table_name, + array( 'processed_at' => current_time( 'mysql' ) ), + array( 'id' => $queued_webhook->id ), + array( '%s' ), + array( '%d' ) + ); + + $processed_count++; + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( + 'WEBHOOK PROCESS: WEBHOOK QUEUE: Successfully processed queued webhook - ' . + 'Queue ID: ' . $queued_webhook->id . ', ' . + 'Order ID: ' . $order_id . ', ' . + 'Type: ' . $queued_webhook->webhook_type . ', ' . + 'Payment ID: ' . $queued_webhook->payment_id + ); + } else { + // Always log successful processing (even if debug disabled) + WC_Checkoutcom_Utility::logger( + 'WEBHOOK PROCESS: WEBHOOK QUEUE: Successfully processed queued webhook - ' . + 'Order ID: ' . $order_id . ', ' . + 'Type: ' . $queued_webhook->webhook_type . ', ' . + 'Payment ID: ' . $queued_webhook->payment_id + ); + } + } else { + WC_Checkoutcom_Utility::logger( + 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Failed to process queued webhook - ' . + 'Queue ID: ' . $queued_webhook->id . ', ' . + 'Order ID: ' . $order_id . ', ' . + 'Type: ' . $queued_webhook->webhook_type . ', ' . + 'Payment ID: ' . $queued_webhook->payment_id . ' - ' . + 'Will remain in queue for retry' + ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Webhook processing returned false - check webhook handler logs for details' ); + } + } + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Processed ' . $processed_count . ' of ' . count( $pending_webhooks ) . ' queued webhook(s) for Order ID: ' . $order_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: process_pending_webhooks_for_order END ===' ); + } else { + // Always log summary (even if debug disabled) + if ( $processed_count > 0 ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Completed processing - ' . $processed_count . ' webhook(s) processed successfully for Order ID: ' . $order_id ); + } + } + + return $processed_count; + } + + /** + * Cleanup old processed webhooks. + * + * @param int $days Number of days to keep processed webhooks (default 7). + * @return int Number of webhooks deleted. + */ + public static function cleanup_old_webhooks( $days = 7 ) { + global $wpdb; + $table_name = self::get_table_name(); + + $cutoff_date = date( 'Y-m-d H:i:s', strtotime( "-{$days} days" ) ); + + $deleted = $wpdb->query( + $wpdb->prepare( + "DELETE FROM {$table_name} WHERE processed_at IS NOT NULL AND processed_at < %s", + $cutoff_date + ) + ); + + if ( false !== $deleted ) { + WC_Checkoutcom_Utility::logger( "WEBHOOK QUEUE: Cleaned up {$deleted} old processed webhook(s) older than {$days} days" ); + } + + return $deleted ? $deleted : 0; + } + + /** + * Cleanup old unprocessed webhooks (orphaned webhooks). + * + * @param int $days Number of days to keep unprocessed webhooks (default 7). + * @return int Number of webhooks deleted. + */ + public static function cleanup_old_unprocessed_webhooks( $days = 7 ) { + global $wpdb; + $table_name = self::get_table_name(); + + $cutoff_date = date( 'Y-m-d H:i:s', strtotime( "-{$days} days" ) ); + + $deleted = $wpdb->query( + $wpdb->prepare( + "DELETE FROM {$table_name} WHERE processed_at IS NULL AND created_at < %s", + $cutoff_date + ) + ); + + if ( false !== $deleted ) { + WC_Checkoutcom_Utility::logger( "WEBHOOK QUEUE: Cleaned up {$deleted} old unprocessed webhook(s) older than {$days} days" ); + } + + return $deleted ? $deleted : 0; + } +} + + + + diff --git a/checkout-com-unified-payments-api/includes/class-wc-checkout-com-webhook.php b/checkout-com-unified-payments-api/includes/class-wc-checkout-com-webhook.php new file mode 100644 index 00000000..dadf40d7 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/class-wc-checkout-com-webhook.php @@ -0,0 +1,1033 @@ +data; + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Webhook data extracted: ' . print_r($webhook_data, true) ); + } + + $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null; + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Reference: ' . ($webhook_data->reference ?? 'NULL') ); + + // Log all available metadata + if (isset($webhook_data->metadata)) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: All metadata: ' . print_r($webhook_data->metadata, true) ); + } + } + + // Return false if no order id. + if ( empty( $order_id ) || ! is_numeric( $order_id ) ) { + // Always log errors, even if debug is disabled + WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: Order ID type: " . gettype($order_id) ); + WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: Order ID is_numeric: " . (is_numeric($order_id) ? 'YES' : 'NO') ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: authorize_payment END (FAILED - Invalid Order ID) ===' ); + } + return false; + } + + // Load order form order id. + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id ); + } + $order = self::get_wc_order( $order_id ); + + if ( ! $order ) { + // Always log errors, even if debug is disabled + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: authorize_payment END (FAILED - Order Not Found) ===' ); + } + return false; + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() ); + } + + $already_captured = $order->get_meta( 'cko_payment_captured' ); + $current_status = $order->get_status(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Current order status: ' . $current_status ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Already captured: ' . ( $already_captured ? 'YES' : 'NO' ) ); + } + + $payment_id = $webhook_data->id; + $action_id = $webhook_data->action_id; + $amount = isset( $webhook_data->amount ) ? $webhook_data->amount : 0; + $formatted_amount = $amount > 0 ? wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ) : ''; + $message = sprintf( 'Webhook received from checkout.com. Payment Authorized - Payment ID: %s, Action ID: %s%s', $payment_id, $action_id, $formatted_amount ? ', Amount: ' . $formatted_amount : '' ); + + // CRITICAL: Check if already captured FIRST (most important check) + // Don't update status if already captured (even if not authorized yet) + // This prevents downgrading from processing back to on-hold + if ( $already_captured ) { + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Payment already captured, skipping status update to prevent downgrade' ); + } + // Payment already captured - just add note and update meta, don't change status + $order->set_transaction_id( $action_id ); + $order->update_meta_data( '_cko_payment_id', $payment_id ); + $order->update_meta_data( 'cko_payment_authorized', true ); + $order->add_order_note( $message ); + return true; + } + + $already_authorized = $order->get_meta( 'cko_payment_authorized' ); + $auth_status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' ); + + // Don't update status if already authorized AND status matches + if ( $already_authorized && $order->get_status() === $auth_status ) { + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Already authorized with matching status, adding note only' ); + } + $order->add_order_note( $message ); + return true; + } + + // Don't update status if order is already in a more advanced state (processing, completed) + // This prevents race conditions where capture webhook updated status but meta not saved yet + if ( in_array( $current_status, array( 'processing', 'completed' ), true ) ) { + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Order already in advanced state (' . $current_status . '), skipping status update to prevent downgrade' ); + } + // Order is already processing/completed - don't downgrade to on-hold + // Just add note and update meta, but don't change status + $order->set_transaction_id( $action_id ); + $order->update_meta_data( '_cko_payment_id', $payment_id ); + $order->update_meta_data( 'cko_payment_authorized', true ); + $order->add_order_note( $message ); + return true; + } + + // Set action id as woo transaction id. + $order->set_transaction_id( $action_id ); + $order->update_meta_data( '_cko_payment_id', $payment_id ); + $order->update_meta_data( 'cko_payment_authorized', true ); + + $order->add_order_note( $message ); + $order->update_status( $auth_status ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $auth_status ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: authorize_payment END (SUCCESS) ===' ); + } + return true; + } + + /** + * Process webhook for card verification. + * + * @param array $data Webhook data. + * + * @return bool + */ + public static function card_verified( $data ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: card_verified START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: card_verified' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) ); + } + + $webhook_data = $data->data; + $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null; + $action_id = isset($webhook_data->action_id) ? $webhook_data->action_id : null; + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Action ID: ' . ($action_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') ); + } + + // Return false if no order id. + if ( empty( $order_id ) || ! is_numeric( $order_id ) ) { + // Always log errors + WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: card_verified END (FAILED - Invalid Order ID) ===' ); + } + return false; + } + + // Load order form order id. + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id ); + } + $order = self::get_wc_order( $order_id ); + + if ( ! $order ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: card_verified END (FAILED - Order Not Found) ===' ); + } + return false; + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() ); + } + + $payment_id = $webhook_data->id; + $order->add_order_note( sprintf( __( 'Checkout.com Card verified webhook received - Payment ID: %s, Action ID: %s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id ) ); + // Set action id as woo transaction id. + $order->set_transaction_id( $action_id ); + + // Get cko capture status configured in admin. + $status = WC_Admin_Settings::get_option( 'ckocom_order_captured', 'processing' ); + + // update status of the order. + $order->update_status( $status ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: card_verified END (SUCCESS) ===' ); + } + return true; + } + + /** + * Process webhook for captured payment. + * + * @param array $data Webhook data. + * + * @return bool + */ + public static function capture_payment( $data ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_payment START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_captured' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) ); + } + + $webhook_data = $data->data; + $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null; + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Amount: ' . (isset($webhook_data->amount) ? $webhook_data->amount : 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Action ID: ' . (isset($webhook_data->action_id) ? $webhook_data->action_id : 'NULL') ); + } + + // Return false if no order id. + if ( empty( $order_id ) || ! is_numeric( $order_id ) ) { + // Always log errors + WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_payment END (FAILED - Invalid Order ID) ===' ); + } + return false; + } + + // Load order form order id. + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id ); + } + $order = self::get_wc_order( $order_id ); + + if ( ! $order ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_payment END (FAILED - Order Not Found) ===' ); + } + return false; + } + + $order_id = $order->get_id(); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order_id . ', Status: ' . $order->get_status() ); + } + + // Check if payment is already captured. + $already_captured = $order->get_meta( 'cko_payment_captured' ); + $payment_id = $webhook_data->id; + + // Get action id from webhook data. + $action_id = $webhook_data->action_id; + $amount = $webhook_data->amount; + $order_amount = $order->get_total(); + $order_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $order_amount, $order->get_currency() ); + $formatted_amount_for_message = wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ); + + $message = sprintf( 'Webhook received from checkout.com Payment captured - Payment ID: %s, Action ID: %s, Amount: %s', $payment_id, $action_id, $formatted_amount_for_message ); + + $already_authorized = $order->get_meta( 'cko_payment_authorized' ); + + // If not already authorized, set it now (capture implies authorization) + // This handles cases where capture webhook arrives before auth webhook + if ( ! $already_authorized ) { + $order->update_meta_data( 'cko_payment_authorized', true ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Capture webhook arrived before auth - setting authorization status automatically for order: ' . $order_id ); + } + } + + // Add note to order if captured already. + if ( $already_captured ) { + $order->add_order_note( $message ); + return true; + } + + $formatted_amount = wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ); + $order->add_order_note( sprintf( __( 'Checkout.com Payment Capture webhook received - Payment ID: %s, Amount: %s', 'checkout-com-unified-payments-api' ), $payment_id, $formatted_amount ) ); + + // Set action id as woo transaction id. + $order->set_transaction_id( $action_id ); + $order->update_meta_data( 'cko_payment_captured', true ); + + // Get cko capture status configured in admin. + $status = WC_Admin_Settings::get_option( 'ckocom_order_captured', 'processing' ); + + $formatted_amount = wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ); + /* translators: %1$s: Payment ID, %2$s: Action ID, %3$s: Amount. */ + $order_message = sprintf( esc_html__( 'Checkout.com Payment Captured - Payment ID: %1$s, Action ID: %2$s, Amount: %3$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id, $formatted_amount ); + + // Check if webhook amount is less than order amount. + if ( $amount < $order_amount_cents ) { + /* translators: %1$s: Payment ID, %2$s: Action ID, %3$s: Amount. */ + $order_message = sprintf( esc_html__( 'Checkout.com Payment partially captured - Payment ID: %1$s, Action ID: %2$s, Amount: %3$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id, $formatted_amount ); + } + + // add notes for the order and update status. + $order->add_order_note( $order_message ); + $order->update_status( $status ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_payment END (SUCCESS) ===' ); + } + return true; + } + + /** + * Process webhook for capture declined payment. + * + * @param array $data Webhook data. + * + * @return bool + */ + public static function capture_declined( $data ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_declined START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_capture_declined' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) ); + } + + $webhook_data = $data->data; + $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null; + $payment_id = isset($webhook_data->id) ? $webhook_data->id : null; + $action_id = isset($webhook_data->action_id) ? $webhook_data->action_id : null; + $response_summary = isset($webhook_data->response_summary) ? $webhook_data->response_summary : 'N/A'; + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($payment_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Action ID: ' . ($action_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Response summary: ' . $response_summary ); + } + + // Return false if no order id. + if ( empty( $order_id ) || ! is_numeric( $order_id ) ) { + // Always log errors + WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_declined END (FAILED - Invalid Order ID) ===' ); + } + return false; + } + + // Load order form order id. + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id ); + } + $order = self::get_wc_order( $order_id ); + + if ( ! $order ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_declined END (FAILED - Order Not Found) ===' ); + } + return false; + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() ); + } + + // Get amount from webhook or use order amount as fallback + $amount = isset( $webhook_data->amount ) ? $webhook_data->amount : 0; + $formatted_amount = ''; + if ( $amount > 0 ) { + $formatted_amount = wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ); + } else { + // Fallback to order amount if webhook doesn't have amount + $formatted_amount = wc_price( $order->get_total(), array( 'currency' => $order->get_currency() ) ); + } + + // Include Payment ID and Action ID (if available) in the order note for consistency with other webhook handlers + if ( ! empty( $action_id ) ) { + $message = sprintf( 'Webhook received from checkout.com. Payment capture declined - Payment ID: %s, Action ID: %s, Reason: %s, Amount: %s', $payment_id, $action_id, $response_summary, $formatted_amount ); + } else { + $message = sprintf( 'Webhook received from checkout.com. Payment capture declined - Payment ID: %s, Reason: %s, Amount: %s', $payment_id, $response_summary, $formatted_amount ); + } + + // Add note to order if capture declined. + $order->add_order_note( $message ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Capture declined note added to order' ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_declined END (SUCCESS) ===' ); + } + return true; + } + + /** + * Process webhook for void payment. + * + * @param array $data Webhook data. + * + * @return bool + */ + public static function void_payment( $data ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_voided' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) ); + } + + $webhook_data = $data->data; + $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null; + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') ); + } + + // Return false if no order id. + if ( empty( $order_id ) || ! is_numeric( $order_id ) ) { + // Always log errors + WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment END (FAILED - Invalid Order ID) ===' ); + } + return false; + } + + // Load order form order id. + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id ); + } + $order = self::get_wc_order( $order_id ); + + if ( ! $order ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment END (FAILED - Order Not Found) ===' ); + } + return false; + } + + $order_id = $order->get_id(); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order_id . ', Status: ' . $order->get_status() ); + } + + // CRITICAL: Validate payment ID matches order (prevent wrong webhooks from matching orders) + $payment_id = $webhook_data->id; + $order_payment_id = $order->get_meta( '_cko_flow_payment_id' ); + $order_payment_id_alt = $order->get_meta( '_cko_payment_id' ); + + // Use Flow payment ID if available, otherwise fall back to regular payment ID + $expected_payment_id = ! empty( $order_payment_id ) ? $order_payment_id : $order_payment_id_alt; + + if ( ! empty( $expected_payment_id ) && $expected_payment_id !== $payment_id ) { + // Payment ID mismatch - reject webhook + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ❌ CRITICAL ERROR - Void webhook payment ID mismatch!' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID: ' . $order_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order _cko_flow_payment_id: ' . ( $order_payment_id ?: 'NOT SET' ) ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order _cko_payment_id: ' . ( $order_payment_id_alt ?: 'NOT SET' ) ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Expected payment ID: ' . $expected_payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Webhook payment ID: ' . $payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ❌ REJECTING VOID WEBHOOK - Payment ID does not match order!' ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment END (FAILED - Payment ID Mismatch) ===' ); + } + return false; // Reject webhook - wrong payment + } + + if ( $webhook_debug_enabled && ! empty( $expected_payment_id ) ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ✅ Payment ID validation passed - Order payment ID: ' . $expected_payment_id . ', Webhook payment ID: ' . $payment_id ); + } + + // check if payment is already captured. + $already_voided = $order->get_meta( 'cko_payment_voided' ); + + // Get action id from webhook data. + $action_id = $webhook_data->action_id; + $amount = isset( $webhook_data->amount ) ? $webhook_data->amount : 0; + $formatted_amount = ''; + if ( $amount > 0 ) { + $formatted_amount = wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ); + } else { + // Fallback to order amount if webhook doesn't have amount + $formatted_amount = wc_price( $order->get_total(), array( 'currency' => $order->get_currency() ) ); + } + + $message = sprintf( 'Webhook received from checkout.com. Payment voided - Payment ID: %s, Action ID: %s%s', $payment_id, $action_id, $formatted_amount ? ', Amount: ' . $formatted_amount : '' ); + + // Add note to order if captured already. + if ( $already_voided ) { + $order->add_order_note( $message ); + return true; + } + + $order->add_order_note( sprintf( esc_html__( 'Checkout.com Payment Void webhook received - Payment ID: %s%s', 'checkout-com-unified-payments-api' ), $payment_id, $formatted_amount ? ', Amount: ' . $formatted_amount : '' ) ); + + // Set action id as woo transaction id. + $order->set_transaction_id( $action_id ); + $order->update_meta_data( 'cko_payment_voided', true ); + + // Get cko capture status configured in admin. + $status = WC_Admin_Settings::get_option( 'ckocom_order_void', 'cancelled' ); + + /* translators: %1$s: Payment ID, %2$s: Action ID, %3$s: Amount. */ + $order_message = sprintf( esc_html__( 'Checkout.com Payment Voided - Payment ID: %1$s, Action ID: %2$s, Amount: %3$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id, $formatted_amount ); + + // add notes for the order and update status. + $order->add_order_note( $order_message ); + $order->update_status( $status ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment END (SUCCESS) ===' ); + } + return true; + } + + /** + * Process webhook for refund payment. + * Order status will not be changed if it's not fully refunded, + * if it's fully refunded, order status will be changed to refunded + * status by WC. + * + * @param array $data Webhook data. + * + * @return bool + */ + public static function refund_payment( $data ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_refunded' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) ); + } + + $webhook_data = $data->data; + $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null; + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Refund amount: ' . (isset($webhook_data->amount) ? $webhook_data->amount : 'NULL') ); + } + + // Return false if no order id. + if ( empty( $order_id ) || ! is_numeric( $order_id ) ) { + // Always log errors + WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment END (FAILED - Invalid Order ID) ===' ); + } + return false; + } + + // Load order form order id. + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id ); + } + $order = self::get_wc_order( $order_id ); + + if ( ! $order ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment END (FAILED - Order Not Found) ===' ); + } + return false; + } + + $order_id = $order->get_id(); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order_id . ', Status: ' . $order->get_status() ); + } + + // CRITICAL: Validate payment ID matches order (prevent wrong webhooks from matching orders) + $payment_id = $webhook_data->id; + $order_payment_id = $order->get_meta( '_cko_flow_payment_id' ); + $order_payment_id_alt = $order->get_meta( '_cko_payment_id' ); + + // Use Flow payment ID if available, otherwise fall back to regular payment ID + $expected_payment_id = ! empty( $order_payment_id ) ? $order_payment_id : $order_payment_id_alt; + + if ( ! empty( $expected_payment_id ) && $expected_payment_id !== $payment_id ) { + // Payment ID mismatch - reject webhook + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ❌ CRITICAL ERROR - Refund webhook payment ID mismatch!' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID: ' . $order_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order _cko_flow_payment_id: ' . ( $order_payment_id ?: 'NOT SET' ) ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order _cko_payment_id: ' . ( $order_payment_id_alt ?: 'NOT SET' ) ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Expected payment ID: ' . $expected_payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Webhook payment ID: ' . $payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ❌ REJECTING REFUND WEBHOOK - Payment ID does not match order!' ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment END (FAILED - Payment ID Mismatch) ===' ); + } + return false; // Reject webhook - wrong payment + } + + if ( $webhook_debug_enabled && ! empty( $expected_payment_id ) ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ✅ Payment ID validation passed - Order payment ID: ' . $expected_payment_id . ', Webhook payment ID: ' . $payment_id ); + } + + // check if payment is already refunded. + $already_refunded = $order->get_meta( 'cko_payment_refunded' ); + + // Get action id from webhook data. + $action_id = $webhook_data->action_id; + $amount = $webhook_data->amount; + $order_amount = $order->get_total(); + $order_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $order_amount, $order->get_currency() ); + $get_transaction_id = $order->get_transaction_id(); + + $refund_amount_formatted = wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ); + $message = sprintf( 'Webhook received from checkout.com. Payment refunded - Payment ID: %s, Action ID: %s, Amount: %s', $payment_id, $action_id, $refund_amount_formatted ); + + if ( $get_transaction_id === $action_id ) { + return true; + } + + // Add note to order if refunded already. + if ( $order->get_total_refunded() == $order_amount ) { // PHPCS:ignore WordPress.PHP.StrictComparisons.LooseComparison + $order->add_order_note( $message ); + return true; + } + + // Set action id as woo transaction id. + $order->set_transaction_id( $action_id ); + $order->update_meta_data( 'cko_payment_refunded', true ); + + $refund_amount = WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ); + + /* translators: %1$s: Payment ID, %2$s: Action ID, %3$s: Amount. */ + $order_message = sprintf( esc_html__( 'Checkout.com Payment Refunded - Payment ID: %1$s, Action ID: %2$s, Amount: %3$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id, $refund_amount_formatted ); + + // Check if webhook amount is less than order amount - partial refund. + if ( $amount < $order_amount_cents ) { + /* translators: %1$s: Payment ID, %2$s: Action ID, %3$s: Amount. */ + $order_message = sprintf( esc_html__( 'Checkout.com Payment partially refunded - Payment ID: %1$s, Action ID: %2$s, Amount: %3$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id, $refund_amount_formatted ); + + $refund = wc_create_refund( + [ + 'amount' => $refund_amount, + 'reason' => '', + 'order_id' => $order_id, + 'line_items' => [], + ] + ); + + } elseif ( $amount == $order_amount_cents ) { // PHPCS:ignore WordPress.PHP.StrictComparisons.LooseComparison + // Full refund. + /* translators: %1$s: Payment ID, %2$s: Action ID, %3$s: Amount. */ + $order_message = sprintf( esc_html__( 'Checkout.com Payment fully refunded - Payment ID: %1$s, Action ID: %2$s, Amount: %3$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id, $refund_amount_formatted ); + + $refund = wc_create_refund( + [ + 'amount' => $refund_amount, + 'reason' => '', + 'order_id' => $order_id, + 'line_items' => [], + ] + ); + } + + // add notes for the order and update status. + $order->add_order_note( $order_message ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Refund processed successfully' ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment END (SUCCESS) ===' ); + } + return true; + } + + /** + * Process webhook for cancelled payment. + * + * @param array $data Webhook data. + * + * @return bool + */ + public static function cancel_payment( $data ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_canceled' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) ); + } + + $webhook_data = $data->data; + $payment_id = isset($webhook_data->id) ? $webhook_data->id : null; + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($payment_id ?? 'NULL') ); + } + + // Initialize the Checkout Api. + $checkout = new Checkout_SDK(); + + try { + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Fetching payment details from Checkout.com for payment ID: ' . $payment_id ); + } + // Check if payment is already voided or captured on checkout.com hub. + $details = $checkout->get_builder()->getPaymentsClient()->getPaymentDetails( $payment_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment details retrieved: ' . print_r($details, true) ); + } + + $order_id = ! empty( $details['metadata']['order_id'] ) ? $details['metadata']['order_id'] : null; + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from payment details metadata: ' . ($order_id ?? 'NULL') ); + } + + // Return false if no order id. + if ( empty( $order_id ) || ! is_numeric( $order_id ) ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - No valid order_id found in payment details' ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment details metadata: ' . print_r(isset($details['metadata']) ? $details['metadata'] : 'N/A', true) ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (FAILED - Invalid Order ID) ===' ); + } + return false; + } + + // Load order form order id. + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id ); + } + $order = self::get_wc_order( $order_id ); + + if ( ! $order ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (FAILED - Order Not Found) ===' ); + } + return false; + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() ); + } + + // CRITICAL: Validate payment ID matches order (prevent wrong webhooks from matching orders) + $order_payment_id = $order->get_meta( '_cko_flow_payment_id' ); + $order_payment_id_alt = $order->get_meta( '_cko_payment_id' ); + + // Use Flow payment ID if available, otherwise fall back to regular payment ID + $expected_payment_id = ! empty( $order_payment_id ) ? $order_payment_id : $order_payment_id_alt; + + if ( ! empty( $expected_payment_id ) && $expected_payment_id !== $payment_id ) { + // Payment ID mismatch - reject webhook + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ❌ CRITICAL ERROR - Cancel webhook payment ID mismatch!' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID: ' . $order->get_id() ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order _cko_flow_payment_id: ' . ( $order_payment_id ?: 'NOT SET' ) ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order _cko_payment_id: ' . ( $order_payment_id_alt ?: 'NOT SET' ) ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Expected payment ID: ' . $expected_payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Webhook payment ID: ' . $payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ❌ REJECTING CANCEL WEBHOOK - Payment ID does not match order!' ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (FAILED - Payment ID Mismatch) ===' ); + } + return false; // Reject webhook - wrong payment + } + + if ( $webhook_debug_enabled && ! empty( $expected_payment_id ) ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ✅ Payment ID validation passed - Order payment ID: ' . $expected_payment_id . ', Webhook payment ID: ' . $payment_id ); + } + + $status = 'wc-cancelled'; + $amount = isset( $webhook_data->amount ) ? $webhook_data->amount : 0; + $formatted_amount = ''; + if ( $amount > 0 ) { + $formatted_amount = wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ); + } else { + // Fallback to order amount if webhook doesn't have amount + $formatted_amount = wc_price( $order->get_total(), array( 'currency' => $order->get_currency() ) ); + } + $message = sprintf( 'Webhook received from checkout.com. Payment cancelled%s', $formatted_amount ? ' - Amount: ' . $formatted_amount : '' ); + + // Add notes for the order and update status. + $order->add_order_note( $message ); + $order->update_status( $status ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (SUCCESS) ===' ); + } + return true; + + } catch ( CheckoutApiException $ex ) { + // Always log errors + $error_message = 'WEBHOOK PROCESS: ERROR - An error has occurred while processing cancel request.'; + WC_Checkoutcom_Utility::logger( $error_message ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Exception message: ' . $ex->getMessage() ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Exception code: ' . $ex->getCode() ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Exception trace: ' . $ex->getTraceAsString() ); + } + + // Check if gateway response is enabled from module settings. + if ( $webhook_debug_enabled ) { + $error_message .= $ex->getMessage(); + } + + WC_Checkoutcom_Utility::logger( $error_message, $ex ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (FAILED - Exception) ===' ); + } + return false; + } + } + + /** + * Desc : This function is used to change the status of an order which are created following + * Status changed from "pending payment to Failed". + * + * @param array $data Webhook data. + * + * @return bool + */ + public static function decline_payment( $data ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment START ===' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_declined/payment_authentication_failed' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) ); + } + + $webhook_data = $data->data; + $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null; + $payment_id = isset($webhook_data->id) ? $webhook_data->id : null; + $action_id = isset($webhook_data->action_id) ? $webhook_data->action_id : null; + $response_summary = isset($webhook_data->response_summary) ? $webhook_data->response_summary : null; + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($payment_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Action ID: ' . ($action_id ?? 'NULL') ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Response summary: ' . ($response_summary ?? 'NULL') ); + } + + if ( empty( $order_id ) || ! is_numeric( $order_id ) ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - No valid order_id for payment: ' . ($payment_id ?? 'NULL') ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment END (FAILED - Invalid Order ID) ===' ); + } + return false; + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id ); + } + $order = self::get_wc_order( $order_id ); + + if ( ! $order ) { + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id ); + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment END (FAILED - Order Not Found) ===' ); + } + return false; + } + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() ); + } + + // CRITICAL: Validate payment ID matches order (prevent wrong webhooks from matching orders) + $order_payment_id = $order->get_meta( '_cko_flow_payment_id' ); + $order_payment_id_alt = $order->get_meta( '_cko_payment_id' ); + + // Use Flow payment ID if available, otherwise fall back to regular payment ID + $expected_payment_id = ! empty( $order_payment_id ) ? $order_payment_id : $order_payment_id_alt; + + // CRITICAL: If order has a payment ID, it MUST match the webhook payment ID + // If order doesn't have payment ID yet, this webhook might be for a different payment attempt + // For decline webhooks, we should be more strict - only process if payment IDs match OR order has no payment ID set + if ( ! empty( $expected_payment_id ) && $expected_payment_id !== $payment_id ) { + // Payment ID mismatch - reject webhook + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ❌ CRITICAL ERROR - Decline webhook payment ID mismatch!' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID: ' . $order->get_id() ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order _cko_flow_payment_id: ' . ( $order_payment_id ?: 'NOT SET' ) ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order _cko_payment_id: ' . ( $order_payment_id_alt ?: 'NOT SET' ) ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Expected payment ID: ' . $expected_payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Webhook payment ID: ' . $payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ❌ REJECTING DECLINE WEBHOOK - Payment ID does not match order!' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: This webhook is for a different payment attempt - ignoring to prevent incorrect order updates' ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment END (FAILED - Payment ID Mismatch) ===' ); + } + return false; // Reject webhook - wrong payment + } + + // If order doesn't have payment ID yet, this might be the first payment attempt for this order + // But we should still validate - if order_id in metadata matches, it's likely correct + // However, if multiple payments have same order_id, we can't distinguish them + // For now, we'll allow it but log a warning + if ( empty( $expected_payment_id ) ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ⚠️ Order has no payment ID set yet - Processing decline webhook' ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ⚠️ Order ID: ' . $order->get_id() . ', Webhook Payment ID: ' . $payment_id ); + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ⚠️ This could be a different payment attempt - verify order_id in metadata is correct' ); + } + + if ( $webhook_debug_enabled && ! empty( $expected_payment_id ) ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ✅ Payment ID validation passed - Order payment ID: ' . $expected_payment_id . ', Webhook payment ID: ' . $payment_id ); + } + + $status = 'wc-failed'; + // Get amount from webhook or use order amount as fallback + $amount = isset( $webhook_data->amount ) ? $webhook_data->amount : 0; + $formatted_amount = ''; + if ( $amount > 0 ) { + $formatted_amount = wc_price( WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() ), array( 'currency' => $order->get_currency() ) ); + } else { + // Fallback to order amount if webhook doesn't have amount + $formatted_amount = wc_price( $order->get_total(), array( 'currency' => $order->get_currency() ) ); + } + + // Include Payment ID and Action ID (if available) in the order note for consistency with other webhook handlers + if ( ! empty( $action_id ) ) { + $message = sprintf( 'Webhook received from checkout.com. Payment declined - Payment ID: %s, Action ID: %s, Reason: %s, Amount: %s', $payment_id, $action_id, $response_summary, $formatted_amount ); + } else { + $message = sprintf( 'Webhook received from checkout.com. Payment declined - Payment ID: %s, Reason: %s, Amount: %s', $payment_id, $response_summary, $formatted_amount ); + } + + // Add notes for the order and update status. + $order->add_order_note( $message ); + $order->update_status( $status ); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status ); + WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment END (SUCCESS) ===' ); + } + return true; + } + + /** + * Load order from order id or Query order by order number. + * + * @param int $order_id Order id. + * + * @return bool|mixed|WC_Order|WC_Order_Refund + */ + private static function get_wc_order( $order_id ) { + $webhook_debug_enabled = self::is_webhook_debug_enabled(); + + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - Looking up order ID: ' . $order_id ); + } + + $order = wc_get_order( $order_id ); + + if ( $order ) { + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - Order found via wc_get_order - ID: ' . $order->get_id() . ', Status: ' . $order->get_status() ); + } + return $order; + } + + // Query order by order number to check if order exist. + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - Order not found via wc_get_order, trying order_number lookup' ); + } + $orders = wc_get_orders( + [ + 'order_number' => $order_id, + ] + ); + + if ( ! empty( $orders ) && isset( $orders[0] ) ) { + $order = $orders[0]; + if ( $webhook_debug_enabled ) { + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - Order found via order_number lookup - ID: ' . $order->get_id() . ', Status: ' . $order->get_status() ); + } + return $order; + } + + // Always log errors + WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - ERROR - Order not found by ID or order_number: ' . $order_id ); + return false; + } +} diff --git a/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-alternative-payments.php b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-alternative-payments.php new file mode 100644 index 00000000..bb3c9448 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-alternative-payments.php @@ -0,0 +1,137 @@ +id = 'wc_checkout_com_alternative_payments'; + $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' ); + $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' ); + $this->title = __( 'Alternative Payment', 'checkout-com-unified-payments-api' ); + + $this->has_fields = true; + $this->supports = [ 'products', 'refunds' ]; + + $this->init_form_fields(); + $this->init_settings(); + + // Turn these settings into variables we can use. + foreach ( $this->settings as $setting_key => $value ) { + $this->$setting_key = $value; + } + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + } + + /** + * Show module configuration in backend. + * + * @return string|void + */ + public function init_form_fields() { + $this->form_fields = WC_Checkoutcom_Cards_Settings::apm_settings(); + $this->form_fields = array_merge( + $this->form_fields, + [ + 'screen_button' => [ + 'id' => 'screen_button', + 'type' => 'screen_button', + 'title' => __( 'Other Settings', 'checkout-com-unified-payments-api' ), + ], + ] + ); + } + + /** + * Generate links for the admin page. + * + * @param string $key The key. + * @param array $value The value. + */ + public function generate_screen_button_html( $key, $value ) { + WC_Checkoutcom_Admin::generate_links( $key, $value ); + } + + /** + * Show frames js on checkout page. + */ + public function payment_fields() { + ?> + + set_transaction_id( $result['action_id'] ); + $order->update_meta_data( 'cko_payment_refunded', true ); + $order->save(); + + if ( isset( $_SESSION['cko-refund-is-less'] ) ) { + if ( $_SESSION['cko-refund-is-less'] ) { + /* translators: %s: Action ID. */ + $order->add_order_note( sprintf( esc_html__( 'Checkout.com Payment Partially refunded from Admin - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] ) ); + + unset( $_SESSION['cko-refund-is-less'] ); + + return true; + } + } + + /* translators: %s: Action ID. */ + $order->add_order_note( sprintf( esc_html__( 'Checkout.com Payment refunded from Admin - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] ) ); + + // when true is returned, status is changed to refunded automatically. + return true; + } +} diff --git a/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-apple-pay.php b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-apple-pay.php new file mode 100644 index 00000000..ef1c3a73 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/class-wc-gateway-checkout-com-apple-pay.php @@ -0,0 +1,3294 @@ +id = 'wc_checkout_com_apple_pay'; + $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' ); + $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' ); + $this->title = __( 'Apple Pay', 'checkout-com-unified-payments-api' ); + $this->has_fields = true; + $this->supports = [ + 'products', + 'refunds', + 'subscriptions', + 'subscription_cancellation', + 'subscription_suspension', + 'subscription_reactivation', + 'subscription_date_changes', + ]; + + $this->init_form_fields(); + $this->init_settings(); + + // Turn these settings into variables we can use. + foreach ( $this->settings as $setting_key => $value ) { + $this->$setting_key = $value; + } + + add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, [ $this, 'process_admin_options' ] ); + + // Redirection hook. + add_action( 'woocommerce_api_wc_checkoutcom_session', [ $this, 'applepay_sesion' ] ); + + add_action( 'woocommerce_api_wc_checkoutcom_generate_token', [ $this, 'applepay_token' ] ); + + add_action( 'woocommerce_api_' . strtolower( 'CKO_Apple_Pay_Woocommerce' ), [ $this, 'handle_wc_api' ] ); + + // CSR generation scripts (AJAX handler is registered in main plugin file) + add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_csr_scripts' ] ); + } + + /** + * Check if existing Apple Pay configuration is detected. + * + * @return array Array with 'detected' (boolean) and 'details' (array of detected fields). + */ + private function detect_existing_configuration() { + $detected_fields = []; + + // Check for migrated configuration fields + $merchant_id = $this->get_option( 'ckocom_apple_mercahnt_id' ); + $certificate_path = $this->get_option( 'ckocom_apple_certificate' ); + $key_path = $this->get_option( 'ckocom_apple_key' ); + $domain_name = $this->get_option( 'apple_pay_domain_name' ); + $display_name = $this->get_option( 'apple_pay_display_name' ); + + if ( ! empty( $merchant_id ) ) { + $detected_fields['merchant_id'] = true; + } + if ( ! empty( $certificate_path ) && file_exists( $certificate_path ) ) { + $detected_fields['certificate'] = true; + } + if ( ! empty( $key_path ) && file_exists( $key_path ) ) { + $detected_fields['key'] = true; + } + if ( ! empty( $domain_name ) ) { + $detected_fields['domain'] = true; + } + if ( ! empty( $display_name ) ) { + $detected_fields['display_name'] = true; + } + + // Configuration is detected if we have merchant ID, certificate, and key + $is_detected = ! empty( $merchant_id ) && + ! empty( $certificate_path ) && + ! empty( $key_path ); + + return [ + 'detected' => $is_detected, + 'details' => $detected_fields, + ]; + } + + /** + * Show module configuration in backend. + * + * @return string|void + */ + public function init_form_fields() { + $settings = WC_Checkoutcom_Cards_Settings::apple_settings(); + // Add navigation links at the beginning, right after the first title section + $this->form_fields = array_merge( + [ + 'screen_button' => [ + 'id' => 'screen_button', + 'type' => 'screen_button', + 'title' => __( 'Other Settings', 'checkout-com-unified-payments-api' ), + ], + 'existing_config_banner' => [ + 'id' => 'existing_config_banner', + 'type' => 'existing_config_banner', + 'title' => '', + ], + 'two_system_notice' => [ + 'id' => 'two_system_notice', + 'type' => 'two_system_notice', + 'title' => '', + ], + ], + $settings + ); + } + + /** + * Generate links for the admin page. + * + * @param string $key The key. + * @param array $value The value. + */ + public function generate_screen_button_html( $key, $value ) { + WC_Checkoutcom_Admin::generate_links( $key, $value ); + } + + /** + * Generate existing configuration banner HTML. + * + * @param string $key The key. + * @param array $value The value. + */ + public function generate_existing_config_banner_html( $key, $value ) { + $config_status = $this->detect_existing_configuration(); + + if ( ! $config_status['detected'] ) { + return; // Don't show banner if no existing config detected + } + ?> +
+
+ + ℹ️ +
++ +
+>
+
+
+
+
+
+ + + +
+ Required + + ✓ Configuration detected, click to renew + + +
+
+
+
+
+
+
+
+ >
+
+
+
+
+
+ + + +
+ Required + + ✓ Configuration detected, click to renew + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ [Your Server Path]/.well-known/apple-developer-merchantid-domain-association.txt
+
+
+ https://[YOUR-DOMAIN.COM]/.well-known/apple-developer-merchantid-domain-association.txt
+
+ + +
+ +
+
+
+
+
+
+
+ sudo cp /path/to/apple-developer-merchantid-domain-association.txt
+ sudo chmod 644
+
>
+
+
+
+
+
+ + + +
+ Required + + ✓ Configuration detected, click to renew + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + + + + - YOUR NEXT STEP + +
+ Required +
+
+
+
+
+
+
+
+
+
+ +
+
+
+
+
+
+
+ + +
+-
+
+
+
+
+
+
- ';
+ $error_message .= '
- ' . __( 'Your certificate paths are correct', 'checkout-com-unified-payments-api' ) . ' '; + $error_message .= '
- ' . __( 'Your certificate has not expired', 'checkout-com-unified-payments-api' ) . ' '; + $error_message .= '
- ' . __( 'You clicked "Verify" in your Apple Developer account for your domain', 'checkout-com-unified-payments-api' ) . ' '; + $error_message .= '
' . $this->method_title . '
'; + echo '' . $this->method_description . '
'; + $this->generate_screen_button_html( 'screen_button', $test ); + + if ( 'orders_settings' === $screen ) { + echo '' . esc_html__( 'Webhook Queue Admin class not found.', 'checkout-com-unified-payments-api' ) . '
; ?>){kind=icon}
+ ; ?>){kind=icon}
+ ; ?>){kind=icon}
+ ; ?>){kind=icon}
+
+
+
+
+
+
+
+
+
+ $methods['wc_checkout_com_apple_pay'] ];
+ }
+
+ return $methods;
+ }
+
+ public function cancel_apple_pay_session_markup() {
+ $cko_apple_pay_order_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_apple_pay_order_id' );
+ $cko_ap_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_ap_id' );
+
+ // Check if Apple Pay session variable exist for current customer.
+ $apple_pay_session_exist = ! empty( $cko_ap_id ) && ! empty( $cko_apple_pay_order_id );
+
+ $cancel_url = add_query_arg(
+ [
+ 'cko-apple-pay-session-cancel' => '1',
+ 'cko-apple-pay-session-cancel-nonce' => wp_create_nonce( 'checkoutcom_apple_pay_cancel' ),
+ ],
+ wc_get_checkout_url()
+ );
+
+ if ( ! $apple_pay_session_exist ) {
+ return;
+ }
+
+ ob_start();
+ ?>
+ + ', + '', + '', + ); + + ?> +
+ user_email ) { + return $current_user->user_email; + } + } + // For guest users, get email from Apple Pay data if available + if ( isset( $cko_ap_details['email'] ) ) { + return $cko_ap_details['email']; + } + return $value; + } + } + + return $value; + } +} + +CKO_Apple_Pay_Express::get_instance(); + diff --git a/checkout-com-unified-payments-api/includes/express/class-wc-checkoutcom-express-checkout-element.php b/checkout-com-unified-payments-api/includes/express/class-wc-checkoutcom-express-checkout-element.php new file mode 100644 index 00000000..23ed7d17 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/express/class-wc-checkoutcom-express-checkout-element.php @@ -0,0 +1,449 @@ +is_express_checkout_enabled() ) { + return; + } + + // Add hooks for button display + add_action( 'woocommerce_after_add_to_cart_form', [ $this, 'display_express_checkout_button_html' ], 1 ); + add_action( 'woocommerce_after_shop_loop_item', [ $this, 'display_shop_express_checkout_button_html' ], 15 ); + add_action( 'woocommerce_proceed_to_checkout', [ $this, 'display_cart_express_checkout_button_html' ], 5 ); + add_action( 'woocommerce_blocks_cart_block_render', [ $this, 'display_cart_express_checkout_button_html' ], 10 ); + add_action( 'woocommerce_checkout_before_customer_details', [ $this, 'display_checkout_express_checkout_button_html' ], 1 ); + + // Enqueue scripts + add_action( 'wp_enqueue_scripts', [ $this, 'scripts' ] ); + } + + /** + * Check if express checkout is enabled. + * + * @return bool + */ + private function is_express_checkout_enabled() { + $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', array() ); + $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() ); + $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', array() ); + + // Check if at least one express checkout method is enabled + $apple_pay_enabled = isset( $apple_pay_settings['apple_pay_express'] ) + && 'yes' === $apple_pay_settings['apple_pay_express'] + && ! empty( $apple_pay_settings['apple_pay_express'] ); + + $google_pay_enabled = isset( $google_pay_settings['google_pay_express'] ) + && 'yes' === $google_pay_settings['google_pay_express'] + && ! empty( $google_pay_settings['google_pay_express'] ); + + $paypal_enabled = isset( $paypal_settings['paypal_express'] ) + && 'yes' === $paypal_settings['paypal_express'] + && ! empty( $paypal_settings['paypal_express'] ); + + return $apple_pay_enabled || $google_pay_enabled || $paypal_enabled; + } + + /** + * Check if we should show express checkout buttons on current page. + * + * @param string $page_type Page type: 'product', 'shop', 'cart', 'checkout' + * @return bool + */ + private function should_show_express_checkout_button( $page_type = 'product' ) { + $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', array() ); + $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() ); + $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', array() ); + + // Check if at least one express method is enabled for this page type + switch ( $page_type ) { + case 'product': + $apple_show = ! isset( $apple_pay_settings['apple_pay_express_product_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_product_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_product_page'] + && ! empty( $apple_pay_settings['apple_pay_express_product_page'] ) ); + $google_show = ! isset( $google_pay_settings['google_pay_express_product_page'] ) + || ( isset( $google_pay_settings['google_pay_express_product_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_product_page'] + && ! empty( $google_pay_settings['google_pay_express_product_page'] ) ); + $paypal_show = ! isset( $paypal_settings['paypal_express_product_page'] ) + || ( isset( $paypal_settings['paypal_express_product_page'] ) + && 'yes' === $paypal_settings['paypal_express_product_page'] + && ! empty( $paypal_settings['paypal_express_product_page'] ) ); + return $apple_show || $google_show || $paypal_show; + + case 'shop': + $apple_show = ! isset( $apple_pay_settings['apple_pay_express_shop_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_shop_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_shop_page'] + && ! empty( $apple_pay_settings['apple_pay_express_shop_page'] ) ); + $google_show = ! isset( $google_pay_settings['google_pay_express_shop_page'] ) + || ( isset( $google_pay_settings['google_pay_express_shop_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_shop_page'] + && ! empty( $google_pay_settings['google_pay_express_shop_page'] ) ); + $paypal_show = ! isset( $paypal_settings['paypal_express_shop_page'] ) + || ( isset( $paypal_settings['paypal_express_shop_page'] ) + && 'yes' === $paypal_settings['paypal_express_shop_page'] + && ! empty( $paypal_settings['paypal_express_shop_page'] ) ); + return $apple_show || $google_show || $paypal_show; + + case 'cart': + $apple_show = ! isset( $apple_pay_settings['apple_pay_express_cart_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_cart_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_cart_page'] + && ! empty( $apple_pay_settings['apple_pay_express_cart_page'] ) ); + $google_show = ! isset( $google_pay_settings['google_pay_express_cart_page'] ) + || ( isset( $google_pay_settings['google_pay_express_cart_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_cart_page'] + && ! empty( $google_pay_settings['google_pay_express_cart_page'] ) ); + $paypal_show = ! isset( $paypal_settings['paypal_express_cart_page'] ) + || ( isset( $paypal_settings['paypal_express_cart_page'] ) + && 'yes' === $paypal_settings['paypal_express_cart_page'] + && ! empty( $paypal_settings['paypal_express_cart_page'] ) ); + return $apple_show || $google_show || $paypal_show; + + case 'checkout': + $apple_show = ! isset( $apple_pay_settings['apple_pay_express_checkout_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_checkout_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_checkout_page'] + && ! empty( $apple_pay_settings['apple_pay_express_checkout_page'] ) ); + $google_show = ! isset( $google_pay_settings['google_pay_express_checkout_page'] ) + || ( isset( $google_pay_settings['google_pay_express_checkout_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_checkout_page'] + && ! empty( $google_pay_settings['google_pay_express_checkout_page'] ) ); + $paypal_show = ! isset( $paypal_settings['paypal_express_checkout_page'] ) + || ( isset( $paypal_settings['paypal_express_checkout_page'] ) + && 'yes' === $paypal_settings['paypal_express_checkout_page'] + && ! empty( $paypal_settings['paypal_express_checkout_page'] ) ); + return $apple_show || $google_show || $paypal_show; + + default: + return false; + } + } + + /** + * Get available express checkout methods. + * + * @param string $page_type Page type: 'product', 'shop', 'cart', 'checkout' + * @return array Array of available express checkout methods + */ + private function get_available_express_methods( $page_type = 'product' ) { + $methods = array(); + + $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', array() ); + $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() ); + $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', array() ); + + // Check Apple Pay + $apple_pay_enabled = isset( $apple_pay_settings['apple_pay_express'] ) + && 'yes' === $apple_pay_settings['apple_pay_express'] + && ! empty( $apple_pay_settings['apple_pay_express'] ); + + if ( $apple_pay_enabled && WC_Checkoutcom_Utility::is_apple_pay_express_available() ) { + // Check page-specific setting + $show_on_page = true; + if ( 'shop' === $page_type ) { + $show_on_page = ! isset( $apple_pay_settings['apple_pay_express_shop_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_shop_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_shop_page'] + && ! empty( $apple_pay_settings['apple_pay_express_shop_page'] ) ); + } elseif ( 'product' === $page_type ) { + $show_on_page = ! isset( $apple_pay_settings['apple_pay_express_product_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_product_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_product_page'] + && ! empty( $apple_pay_settings['apple_pay_express_product_page'] ) ); + } elseif ( 'cart' === $page_type ) { + $show_on_page = ! isset( $apple_pay_settings['apple_pay_express_cart_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_cart_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_cart_page'] + && ! empty( $apple_pay_settings['apple_pay_express_cart_page'] ) ); + } elseif ( 'checkout' === $page_type ) { + $show_on_page = ! isset( $apple_pay_settings['apple_pay_express_checkout_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_checkout_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_checkout_page'] + && ! empty( $apple_pay_settings['apple_pay_express_checkout_page'] ) ); + } + + if ( $show_on_page ) { + $methods['apple_pay'] = true; + } + } + + // Check Google Pay + $google_pay_enabled = isset( $google_pay_settings['google_pay_express'] ) + && 'yes' === $google_pay_settings['google_pay_express'] + && ! empty( $google_pay_settings['google_pay_express'] ); + + if ( $google_pay_enabled && WC_Checkoutcom_Utility::is_google_pay_express_available() ) { + // Check page-specific setting + $show_on_page = true; + if ( 'shop' === $page_type ) { + $show_on_page = ! isset( $google_pay_settings['google_pay_express_shop_page'] ) + || ( isset( $google_pay_settings['google_pay_express_shop_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_shop_page'] + && ! empty( $google_pay_settings['google_pay_express_shop_page'] ) ); + } elseif ( 'product' === $page_type ) { + $show_on_page = ! isset( $google_pay_settings['google_pay_express_product_page'] ) + || ( isset( $google_pay_settings['google_pay_express_product_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_product_page'] + && ! empty( $google_pay_settings['google_pay_express_product_page'] ) ); + } elseif ( 'cart' === $page_type ) { + $show_on_page = ! isset( $google_pay_settings['google_pay_express_cart_page'] ) + || ( isset( $google_pay_settings['google_pay_express_cart_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_cart_page'] + && ! empty( $google_pay_settings['google_pay_express_cart_page'] ) ); + } elseif ( 'checkout' === $page_type ) { + $show_on_page = ! isset( $google_pay_settings['google_pay_express_checkout_page'] ) + || ( isset( $google_pay_settings['google_pay_express_checkout_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_checkout_page'] + && ! empty( $google_pay_settings['google_pay_express_checkout_page'] ) ); + } + + if ( $show_on_page ) { + $methods['google_pay'] = true; + } + } + + // Check PayPal + $paypal_enabled = isset( $paypal_settings['paypal_express'] ) + && 'yes' === $paypal_settings['paypal_express'] + && ! empty( $paypal_settings['paypal_express'] ); + + if ( $paypal_enabled && WC_Checkoutcom_Utility::is_paypal_express_available() ) { + // Check page-specific setting + $show_on_page = true; + if ( 'shop' === $page_type ) { + $show_on_page = ! isset( $paypal_settings['paypal_express_shop_page'] ) + || ( isset( $paypal_settings['paypal_express_shop_page'] ) + && 'yes' === $paypal_settings['paypal_express_shop_page'] + && ! empty( $paypal_settings['paypal_express_shop_page'] ) ); + } elseif ( 'product' === $page_type ) { + $show_on_page = ! isset( $paypal_settings['paypal_express_product_page'] ) + || ( isset( $paypal_settings['paypal_express_product_page'] ) + && 'yes' === $paypal_settings['paypal_express_product_page'] + && ! empty( $paypal_settings['paypal_express_product_page'] ) ); + } elseif ( 'cart' === $page_type ) { + $show_on_page = ! isset( $paypal_settings['paypal_express_cart_page'] ) + || ( isset( $paypal_settings['paypal_express_cart_page'] ) + && 'yes' === $paypal_settings['paypal_express_cart_page'] + && ! empty( $paypal_settings['paypal_express_cart_page'] ) ); + } elseif ( 'checkout' === $page_type ) { + $show_on_page = ! isset( $paypal_settings['paypal_express_checkout_page'] ) + || ( isset( $paypal_settings['paypal_express_checkout_page'] ) + && 'yes' === $paypal_settings['paypal_express_checkout_page'] + && ! empty( $paypal_settings['paypal_express_checkout_page'] ) ); + } + + if ( $show_on_page ) { + $methods['paypal'] = true; + } + } + + return $methods; + } + + /** + * Display express checkout button HTML on product page. + */ + public function display_express_checkout_button_html() { + if ( ! is_product() || ! $this->should_show_express_checkout_button( 'product' ) ) { + return; + } + + $methods = $this->get_available_express_methods( 'product' ); + if ( empty( $methods ) ) { + return; + } + + // Use existing unified container from individual classes (they handle product page) + // This method is kept for compatibility but won't render to avoid duplicates + return; + } + + /** + * Display express checkout button HTML on shop/listing pages. + * Compact horizontal layout for space efficiency. + */ + public function display_shop_express_checkout_button_html() { + global $product; + + // Don't show for variable products on shop pages (too complex) + if ( $product && $product->is_type( 'variable' ) ) { + return; + } + + if ( ! ( is_shop() || is_product_category() || is_product_tag() || is_product_taxonomy() ) ) { + return; + } + + if ( ! $this->should_show_express_checkout_button( 'shop' ) ) { + return; + } + + $methods = $this->get_available_express_methods( 'shop' ); + if ( empty( $methods ) ) { + return; + } + + $product_id = $product ? $product->get_id() : 0; + if ( ! $product_id ) { + return; + } + + // Use product-specific container key to prevent duplicates + static $rendered_products = array(); + $container_key = 'shop_' . $product_id; + + if ( isset( $rendered_products[ $container_key ] ) ) { + return; // Already rendered for this product + } + + $rendered_products[ $container_key ] = true; + + ?> +
+
+
+
+
+
+
+
+
+
+
+ should_show_express_checkout_button( 'cart' ) ) {
+ return;
+ }
+
+ // Don't show if cart is empty
+ if ( WC()->cart->is_empty() ) {
+ return;
+ }
+
+ // Use existing unified container from individual classes (they handle cart page)
+ // This method is kept for compatibility but won't render to avoid duplicates
+ return;
+ }
+
+ /**
+ * Display express checkout button HTML on checkout page.
+ */
+ public function display_checkout_express_checkout_button_html() {
+ if ( ! is_checkout() || ! $this->should_show_express_checkout_button( 'checkout' ) ) {
+ return;
+ }
+
+ $methods = $this->get_available_express_methods( 'checkout' );
+ if ( empty( $methods ) ) {
+ return;
+ }
+
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+ div {
+ flex: 1 1 auto;
+ min-width: 0;
+ display: block;
+ }
+ .cko-disabled {
+ cursor: not-allowed;
+ opacity: 0.5;
+ }
+ ' );
+ }
+}
+
diff --git a/checkout-com-unified-payments-api/includes/express/google-pay/class-google-pay-express.php b/checkout-com-unified-payments-api/includes/express/google-pay/class-google-pay-express.php
new file mode 100644
index 00000000..b96cd83c
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/express/google-pay/class-google-pay-express.php
@@ -0,0 +1,862 @@
+maybe_enable_google_pay_in_flow_mode();
+ }
+
+ /**
+ * Check if Express Checkout session exists.
+ *
+ * @return bool
+ */
+ private function has_express_checkout_session(): bool {
+ $cko_google_pay_order_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_google_pay_order_id' );
+ $cko_gc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_gc_id' );
+
+ return ( ! empty( $cko_gc_id ) && ! empty( $cko_google_pay_order_id ) );
+ }
+
+ /**
+ * Dynamically enable Google Pay in FLOW mode if session exists.
+ */
+ private function maybe_enable_google_pay_in_flow_mode() {
+
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : '';
+
+ // Run only for FLOW mode.
+ if ( 'flow' !== $checkout_mode ) {
+ return;
+ }
+
+ // Add hooks for FLOW Google Pay enablement.
+ add_filter( 'woocommerce_payment_gateways', [ $this, 'add_google_pay_gateway' ] );
+ add_filter( 'option_woocommerce_wc_checkout_com_google_pay_settings', [ $this, 'force_enable_google_pay_settings' ] );
+ add_filter( 'woocommerce_available_payment_gateways', [ $this, 'restrict_gateways_to_google_pay' ] );
+ }
+
+ /**
+ * Step 1: Add Google Pay gateway dynamically.
+ *
+ * @param array $gateways
+ * @return array
+ */
+ public function add_google_pay_gateway( $gateways ) {
+ if ( $this->has_express_checkout_session() ) {
+ if ( ! in_array( 'WC_Gateway_Checkout_Com_Google_Pay', $gateways, true ) ) {
+ $gateways[] = 'WC_Gateway_Checkout_Com_Google_Pay';
+ }
+ }
+ return $gateways;
+ }
+
+ /**
+ * Step 2: Force-enable Google Pay settings.
+ *
+ * @param array $settings
+ * @return array
+ */
+ public function force_enable_google_pay_settings( $settings ) {
+ if ( $this->has_express_checkout_session() ) {
+ $settings['enabled'] = 'yes';
+ }
+ return $settings;
+ }
+
+ /**
+ * Step 3: Restrict available payment gateways to Google Pay only.
+ *
+ * @param array $methods
+ * @return array
+ */
+ public function restrict_gateways_to_google_pay( $methods ) {
+ if ( $this->has_express_checkout_session() && isset( $methods['wc_checkout_com_google_pay'] ) ) {
+ return [ 'wc_checkout_com_google_pay' => $methods['wc_checkout_com_google_pay'] ];
+ }
+ return $methods;
+ }
+
+ public function payment_scripts() {
+ $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() );
+
+ // First check if master toggle is enabled - must be explicitly 'yes'
+ // Handle cases: not set, empty string, false, 'no', or anything else = disabled
+ $is_express_enabled = isset( $google_pay_settings['google_pay_express'] )
+ && 'yes' === $google_pay_settings['google_pay_express']
+ && ! empty( $google_pay_settings['google_pay_express'] );
+ if ( ! $is_express_enabled ) {
+ return;
+ }
+
+ // Check which pages should load scripts - must be explicitly 'yes'
+ // Handle cases: not set (default enabled), empty string, false, 'no' = disabled
+ $show_on_product = false;
+ if ( ! isset( $google_pay_settings['google_pay_express_product_page'] ) ) {
+ $show_on_product = true; // Default to yes if setting doesn't exist (backward compatibility)
+ } elseif ( isset( $google_pay_settings['google_pay_express_product_page'] )
+ && 'yes' === $google_pay_settings['google_pay_express_product_page']
+ && ! empty( $google_pay_settings['google_pay_express_product_page'] ) ) {
+ $show_on_product = true;
+ }
+
+ $show_on_shop = false;
+ if ( ! isset( $google_pay_settings['google_pay_express_shop_page'] ) ) {
+ $show_on_shop = true; // Default to yes if setting doesn't exist (backward compatibility)
+ } elseif ( isset( $google_pay_settings['google_pay_express_shop_page'] )
+ && 'yes' === $google_pay_settings['google_pay_express_shop_page']
+ && ! empty( $google_pay_settings['google_pay_express_shop_page'] ) ) {
+ $show_on_shop = true;
+ }
+
+ $show_on_cart = false;
+ if ( ! isset( $google_pay_settings['google_pay_express_cart_page'] ) ) {
+ $show_on_cart = true; // Default to yes if setting doesn't exist (backward compatibility)
+ } elseif ( isset( $google_pay_settings['google_pay_express_cart_page'] )
+ && 'yes' === $google_pay_settings['google_pay_express_cart_page']
+ && ! empty( $google_pay_settings['google_pay_express_cart_page'] ) ) {
+ $show_on_cart = true;
+ }
+
+ // Only load on relevant pages where Express is enabled
+ $should_load = false;
+
+ if ( ( is_product() && $show_on_product ) ||
+ ( is_cart() && $show_on_cart ) ||
+ ( ( is_shop() || is_product_category() || is_product_tag() || is_product_taxonomy() ) && $show_on_shop ) ) {
+ $should_load = true;
+ }
+
+ if ( ! $should_load ) {
+ return;
+ }
+
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+ $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() );
+ $environment = isset( $core_settings['ckocom_environment'] ) && 'sandbox' === $core_settings['ckocom_environment'];
+
+ // Load Google Pay API script
+ wp_enqueue_script(
+ 'google-pay-api',
+ 'https://pay.google.com/gp/p/js/pay.js',
+ array(),
+ null,
+ true
+ );
+
+ $vars = [
+ 'add_to_cart_url' => add_query_arg( [ 'cko_google_pay_action' => 'express_add_to_cart' ], WC()->api_request_url( 'CKO_Google_Pay_Woocommerce' ) ),
+ 'create_payment_context_url' => add_query_arg( [ 'cko_google_pay_action' => 'express_create_payment_context' ], WC()->api_request_url( 'CKO_Google_Pay_Woocommerce' ) ),
+ 'get_cart_total_url' => add_query_arg( [ 'cko_google_pay_action' => 'express_get_cart_total' ], WC()->api_request_url( 'CKO_Google_Pay_Woocommerce' ) ),
+ 'google_pay_order_session_url' => add_query_arg( [ 'cko_google_pay_action' => 'express_google_pay_order_session' ], WC()->api_request_url( 'CKO_Google_Pay_Woocommerce' ) ),
+ 'woocommerce_process_checkout' => wp_create_nonce( 'woocommerce-process_checkout' ),
+ 'is_cart_contains_subscription' => WC_Checkoutcom_Utility::is_cart_contains_subscription(),
+ 'google_pay_button_selector' => '#cko-google-pay-button-wrapper',
+ 'redirect' => wc_get_checkout_url(),
+ 'google_pay_express_add_to_cart_nonce' => wp_create_nonce( 'checkoutcom_google_pay_express_add_to_cart' ),
+ 'debug' => 'yes' === WC_Admin_Settings::get_option( 'cko_console_logging', 'no' ),
+ 'environment' => $environment ? 'TEST' : 'PRODUCTION',
+ 'public_key' => $core_settings['ckocom_pk'] ?? '',
+ 'merchant_id' => $google_pay_settings['ckocom_google_merchant_id'] ?? '',
+ 'currency_code' => get_woocommerce_currency(),
+ 'button_style' => $google_pay_settings['ckocom_google_style'] ?? 'google-pay-black',
+ ];
+
+ wp_localize_script( 'google-pay-api', 'cko_google_pay_vars', $vars );
+
+ wp_register_script(
+ 'cko-google-pay-express-integration-script',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/cko-google-pay-express-integration.js',
+ array( 'jquery', 'google-pay-api' ),
+ WC_CHECKOUTCOM_PLUGIN_VERSION
+ );
+
+ wp_enqueue_script( 'cko-google-pay-express-integration-script' );
+ }
+
+ public function display_payment_request_button_html() {
+ static $container_rendered = false;
+
+ $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() );
+
+ // First check if master toggle is enabled - must be explicitly 'yes'
+ // Handle cases: not set, empty string, false, 'no', or anything else = disabled
+ $is_express_enabled = isset( $google_pay_settings['google_pay_express'] )
+ && 'yes' === $google_pay_settings['google_pay_express']
+ && ! empty( $google_pay_settings['google_pay_express'] );
+ if ( ! $is_express_enabled ) {
+ return;
+ }
+
+ // Check if Google Pay Express is enabled for product pages - must be explicitly 'yes'
+ // Handle cases: not set (default enabled), empty string, false, 'no' = disabled
+ $show_on_product = false;
+ if ( ! isset( $google_pay_settings['google_pay_express_product_page'] ) ) {
+ // Default to yes if setting doesn't exist (backward compatibility)
+ $show_on_product = true;
+ } elseif ( isset( $google_pay_settings['google_pay_express_product_page'] )
+ && 'yes' === $google_pay_settings['google_pay_express_product_page']
+ && ! empty( $google_pay_settings['google_pay_express_product_page'] ) ) {
+ $show_on_product = true;
+ }
+
+ if ( ! is_product() || ! $show_on_product ) {
+ return;
+ }
+
+ // Check if unified express checkout container should be rendered
+ $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', array() );
+ $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', array() );
+
+ $paypal_express_enabled = isset( $paypal_settings['paypal_express'] )
+ && 'yes' === $paypal_settings['paypal_express']
+ && ! empty( $paypal_settings['paypal_express'] );
+ $paypal_available = WC_Checkoutcom_Utility::is_paypal_express_available();
+ $paypal_show_on_product = ! isset( $paypal_settings['paypal_express_product_page'] )
+ || ( isset( $paypal_settings['paypal_express_product_page'] )
+ && 'yes' === $paypal_settings['paypal_express_product_page']
+ && ! empty( $paypal_settings['paypal_express_product_page'] ) );
+
+ $apple_pay_express_enabled = isset( $apple_pay_settings['apple_pay_express'] )
+ && 'yes' === $apple_pay_settings['apple_pay_express']
+ && ! empty( $apple_pay_settings['apple_pay_express'] );
+ $apple_pay_available = WC_Checkoutcom_Utility::is_apple_pay_express_available();
+ $apple_pay_show_on_product = ! isset( $apple_pay_settings['apple_pay_express_product_page'] )
+ || ( isset( $apple_pay_settings['apple_pay_express_product_page'] )
+ && 'yes' === $apple_pay_settings['apple_pay_express_product_page']
+ && ! empty( $apple_pay_settings['apple_pay_express_product_page'] ) );
+
+ // Check if unified container has been rendered
+ $unified_container_rendered = WC_Checkoutcom_Utility::express_checkout_container_rendered();
+
+ // Determine if we should render unified container
+ $should_render_container = ! $unified_container_rendered && (
+ ( $paypal_express_enabled && $paypal_available && $paypal_show_on_product ) ||
+ ( $apple_pay_express_enabled && $apple_pay_available && $apple_pay_show_on_product )
+ );
+
+ // Render unified container only once if both are enabled, or Google Pay's own container
+ if ( $should_render_container ) {
+ WC_Checkoutcom_Utility::express_checkout_container_rendered( true );
+ $container_rendered = true;
+ ?>
+
+
+
+
+
+
+
+
+
+
+ is_type( 'variable' ) ) {
+ return;
+ }
+
+ $product_id = $product ? $product->get_id() : 0;
+ ?>
+
+
+ cart->is_empty() ) {
+ return;
+ }
+
+ // Check if unified express checkout container should be rendered
+ $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', array() );
+ $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', array() );
+
+ $paypal_express_enabled = isset( $paypal_settings['paypal_express'] )
+ && 'yes' === $paypal_settings['paypal_express']
+ && ! empty( $paypal_settings['paypal_express'] );
+ $paypal_available = WC_Checkoutcom_Utility::is_paypal_express_available();
+ $paypal_show_on_cart = ! isset( $paypal_settings['paypal_express_cart_page'] )
+ || ( isset( $paypal_settings['paypal_express_cart_page'] )
+ && 'yes' === $paypal_settings['paypal_express_cart_page']
+ && ! empty( $paypal_settings['paypal_express_cart_page'] ) );
+
+ $apple_pay_express_enabled = isset( $apple_pay_settings['apple_pay_express'] )
+ && 'yes' === $apple_pay_settings['apple_pay_express']
+ && ! empty( $apple_pay_settings['apple_pay_express'] );
+ $apple_pay_available = WC_Checkoutcom_Utility::is_apple_pay_express_available();
+ $apple_pay_show_on_cart = ! isset( $apple_pay_settings['apple_pay_express_cart_page'] )
+ || ( isset( $apple_pay_settings['apple_pay_express_cart_page'] )
+ && 'yes' === $apple_pay_settings['apple_pay_express_cart_page']
+ && ! empty( $apple_pay_settings['apple_pay_express_cart_page'] ) );
+
+ // Check if unified container has been rendered
+ $unified_container_rendered = WC_Checkoutcom_Utility::express_checkout_container_rendered();
+
+ // Determine if we should render unified container
+ $should_render_container = ! $unified_container_rendered && (
+ ( $paypal_express_enabled && $paypal_available && $paypal_show_on_cart ) ||
+ ( $apple_pay_express_enabled && $apple_pay_available && $apple_pay_show_on_cart )
+ );
+
+ // Render unified container only once if both are enabled, or Google Pay's own container
+ if ( $should_render_container ) {
+ WC_Checkoutcom_Utility::express_checkout_container_rendered( true );
+ $container_rendered = true;
+ ?>
+
+
+
+
+
+
+
+
+
+
+ $methods['wc_checkout_com_google_pay'] ];
+ }
+
+ return $methods;
+ }
+
+ public function cancel_google_pay_session_markup() {
+ $cko_google_pay_order_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_google_pay_order_id' );
+ $cko_gc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_gc_id' );
+
+ // Check if Google Pay session variable exist for current customer.
+ $google_pay_session_exist = ! empty( $cko_gc_id ) && ! empty( $cko_google_pay_order_id );
+
+ $cancel_url = add_query_arg(
+ [
+ 'cko-google-pay-session-cancel' => '1',
+ 'cko-google-pay-session-cancel-nonce' => wp_create_nonce( 'checkoutcom_google_pay_cancel' ),
+ ],
+ wc_get_checkout_url()
+ );
+
+ if ( ! $google_pay_session_exist ) {
+ return;
+ }
+
+ ob_start();
+ ?>
+ + ', + '', + '', + ); + + ?> +
+ get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_gc_id ); + $cko_gc_details = $response; + + WC_Checkoutcom_Utility::cko_set_session( 'cko_gc_details', $response ); + + } catch ( CheckoutApiException $ex ) { + } + } + + if ( isset( $cko_gc_details['payment_request']['shipping']['address'] ) ) { + $google_pay_shipping_address = $cko_gc_details['payment_request']['shipping']['address']; + $shipping_name = $cko_gc_details['payment_request']['shipping']['first_name'] ? explode( ' ', $cko_gc_details['payment_request']['shipping']['first_name'] ) : []; + $google_pay_shipping_first_name = $shipping_name[0] ?? ''; + $google_pay_shipping_last_name = $shipping_name[1] ?? ''; + + switch ( $key ) { + case 'billing_first_name': + case 'shipping_first_name': + return $google_pay_shipping_first_name; + + case 'billing_last_name': + case 'shipping_last_name': + return $google_pay_shipping_last_name; + + case 'billing_address_1': + case 'shipping_address_1': + return $google_pay_shipping_address['address_line1']; + + case 'billing_address_2': + case 'shipping_address_2': + return $google_pay_shipping_address['address_line2'] ?? ''; + + case 'billing_city': + case 'shipping_city': + return $google_pay_shipping_address['city']; + + case 'billing_postcode': + case 'shipping_postcode': + return $google_pay_shipping_address['zip']; + + case 'billing_country': + case 'shipping_country': + return $google_pay_shipping_address['country']; + + case 'billing_email': + // For logged-in users, use their account email + if ( is_user_logged_in() ) { + $current_user = wp_get_current_user(); + if ( $current_user && $current_user->user_email ) { + return $current_user->user_email; + } + } + // For guest users, get email from Google Pay data + // Check multiple possible locations + if ( isset( $cko_gc_details['payment_request']['source']['account_holder']['email'] ) ) { + return $cko_gc_details['payment_request']['source']['account_holder']['email']; + } + if ( isset( $cko_gc_details['payment_request']['shipping']['email'] ) ) { + return $cko_gc_details['payment_request']['shipping']['email']; + } + if ( isset( $cko_gc_details['payment_request']['billing']['email'] ) ) { + return $cko_gc_details['payment_request']['billing']['email']; + } + if ( isset( $cko_gc_details['payment_request']['payer']['email'] ) ) { + return $cko_gc_details['payment_request']['payer']['email']; + } + if ( isset( $cko_gc_details['payment_request']['customer']['email'] ) ) { + return $cko_gc_details['payment_request']['customer']['email']; + } + // Return original value if not found + return $value; + } + } + + return $value; + } +} + +CKO_Google_Pay_Express::get_instance(); + diff --git a/checkout-com-unified-payments-api/includes/express/paypal/class-paypal-express.php b/checkout-com-unified-payments-api/includes/express/paypal/class-paypal-express.php new file mode 100644 index 00000000..9bde0314 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/express/paypal/class-paypal-express.php @@ -0,0 +1,897 @@ +maybe_enable_paypal_in_flow_mode(); + } + + /** + * Check if Express Checkout session exists. + * + * @return bool + */ + private function has_express_checkout_session(): bool { + $cko_paypal_order_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_paypal_order_id' ); + $cko_pc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_id' ); + + return ( ! empty( $cko_pc_id ) && ! empty( $cko_paypal_order_id ) ); + } + + /** + * Dynamically enable PayPal in FLOW mode if session exists. + */ + private function maybe_enable_paypal_in_flow_mode() { + + $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings' ); + $checkout_mode = $checkout_setting['ckocom_checkout_mode'] ?? ''; + + // Run only for FLOW mode. + if ( 'flow' !== $checkout_mode ) { + return; + } + + // Add hooks for FLOW PayPal enablement. + add_filter( 'woocommerce_payment_gateways', [ $this, 'add_paypal_gateway' ] ); + add_filter( 'option_woocommerce_wc_checkout_com_paypal_settings', [ $this, 'force_enable_paypal_settings' ] ); + add_filter( 'woocommerce_available_payment_gateways', [ $this, 'restrict_gateways_to_paypal' ] ); + } + + /** + * Step 1: Add PayPal gateway dynamically. + * + * @param array $gateways + * @return array + */ + public function add_paypal_gateway( $gateways ) { + if ( $this->has_express_checkout_session() ) { + if ( ! in_array( 'WC_Gateway_Checkout_Com_PayPal', $gateways, true ) ) { + $gateways[] = 'WC_Gateway_Checkout_Com_PayPal'; + } + } + return $gateways; + } + + /** + * Step 2: Force-enable PayPal settings. + * + * @param array $settings + * @return array + */ + public function force_enable_paypal_settings( $settings ) { + if ( $this->has_express_checkout_session() ) { + $settings['enabled'] = 'yes'; + } + return $settings; + } + + /** + * Step 3: Restrict available payment gateways to PayPal only. + * + * @param array $methods + * @return array + */ + public function restrict_gateways_to_paypal( $methods ) { + if ( $this->has_express_checkout_session() && isset( $methods['wc_checkout_com_paypal'] ) ) { + return [ 'wc_checkout_com_paypal' => $methods['wc_checkout_com_paypal'] ]; + } + return $methods; + } + + public function payment_scripts() { + $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', array() ); + + // First check if master toggle is enabled - must be explicitly 'yes' + // Handle cases: not set, empty string, false, 'no', or anything else = disabled + $is_express_enabled = isset( $paypal_settings['paypal_express'] ) + && 'yes' === $paypal_settings['paypal_express'] + && ! empty( $paypal_settings['paypal_express'] ); + if ( ! $is_express_enabled ) { + return; + } + + // Load on Product, Cart, Shop, or Checkout pages if PayPal Express is available. + if ( ! WC_Checkoutcom_Utility::is_paypal_express_available() ) { + return; + } + + // Check which pages should load scripts - must be explicitly 'yes' + // Handle cases: not set (default enabled), empty string, false, 'no' = disabled + $show_on_product = false; + if ( ! isset( $paypal_settings['paypal_express_product_page'] ) ) { + $show_on_product = true; // Default to yes if setting doesn't exist (backward compatibility) + } elseif ( isset( $paypal_settings['paypal_express_product_page'] ) + && 'yes' === $paypal_settings['paypal_express_product_page'] + && ! empty( $paypal_settings['paypal_express_product_page'] ) ) { + $show_on_product = true; + } + + $show_on_shop = false; + if ( ! isset( $paypal_settings['paypal_express_shop_page'] ) ) { + $show_on_shop = true; // Default to yes if setting doesn't exist (backward compatibility) + } elseif ( isset( $paypal_settings['paypal_express_shop_page'] ) + && 'yes' === $paypal_settings['paypal_express_shop_page'] + && ! empty( $paypal_settings['paypal_express_shop_page'] ) ) { + $show_on_shop = true; + } + + $show_on_cart = false; + if ( ! isset( $paypal_settings['paypal_express_cart_page'] ) ) { + $show_on_cart = true; // Default to yes if setting doesn't exist (backward compatibility) + } elseif ( isset( $paypal_settings['paypal_express_cart_page'] ) + && 'yes' === $paypal_settings['paypal_express_cart_page'] + && ! empty( $paypal_settings['paypal_express_cart_page'] ) ) { + $show_on_cart = true; + } + + // Only load on relevant pages where Express is enabled + $should_load = false; + + if ( ( is_product() && $show_on_product ) || + ( is_cart() && $show_on_cart ) || + ( ( is_shop() || is_product_category() || is_product_tag() || is_product_taxonomy() ) && $show_on_shop ) ) { + $should_load = true; + } + + if ( ! $should_load ) { + return; + } + + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' ); + $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings' ); + $environment = 'sandbox' === $core_settings['ckocom_environment']; + + if ( $environment ) { + // sandbox. + $paypal_js_arg['client-id'] = 'ASLqLf4pnWuBshW8Qh8z_DRUbIv2Cgs3Ft8aauLm9Z-MO9FZx1INSo38nW109o_Xvu88P3tly88XbJMR'; + } else { + // live. + $paypal_js_arg['client-id'] = 'ATbi1ysGm-jp4RmmAFz1EWH4dFpPd-VdXIWWzR4QZK5LAvDu_5atDY9dsUEJcLS5mTpR8Wb1l_m6Ameq'; + } + + // Always add merchant-id if available (PayPal requires it to match payee in transaction) + // PayPal SDK validation error indicates payee mismatch when merchant-id is missing + $merchant_id = $paypal_settings['ckocom_paypal_merchant_id'] ?? ''; + if ( ! empty( $merchant_id ) ) { + $paypal_js_arg['merchant-id'] = $merchant_id; + } + + $paypal_js_arg['disable-funding'] = 'credit,card,sepa'; + $paypal_js_arg['commit'] = 'false'; + $paypal_js_arg['currency'] = get_woocommerce_currency(); + $paypal_js_arg['intent'] = 'capture'; // 'authorize' // ??? + + if ( WC_Checkoutcom_Utility::is_cart_contains_subscription() ) { + $paypal_js_arg['intent'] = 'tokenize'; + $paypal_js_arg['vault'] = 'true'; + } + + $paypal_js_url = add_query_arg( $paypal_js_arg, 'https://www.paypal.com/sdk/js' ); + + wp_register_script( 'cko-paypal-script', $paypal_js_url, [ 'jquery' ], null ); + + // Get base API URL and validate it + $base_api_url = WC()->api_request_url( 'CKO_Paypal_Woocommerce' ); + + // Ensure base API URL is valid + if ( empty( $base_api_url ) || ! filter_var( $base_api_url, FILTER_VALIDATE_URL ) ) { + WC_Checkoutcom_Utility::logger( 'PayPal Express: Warning - API request URL is empty or invalid. Check if CKO_Paypal_Woocommerce API route is registered.' ); + $base_api_url = home_url( '/wc-api/CKO_Paypal_Woocommerce/' ); + } + + // Ensure base URL ends with a trailing slash for proper query string handling + $base_api_url = trailingslashit( $base_api_url ); + + $vars = [ + 'add_to_cart_url' => add_query_arg( [ 'cko_paypal_action' => 'express_add_to_cart' ], $base_api_url ), + 'create_order_url' => add_query_arg( [ 'cko_paypal_action' => 'express_create_order' ], $base_api_url ), + 'paypal_order_session_url' => add_query_arg( [ 'cko_paypal_action' => 'express_paypal_order_session' ], $base_api_url ), + 'cc_capture' => add_query_arg( [ 'cko_paypal_action' => 'cc_capture' ], $base_api_url ), + 'woocommerce_process_checkout' => wp_create_nonce( 'woocommerce-process_checkout' ), + 'is_cart_contains_subscription' => WC_Checkoutcom_Utility::is_cart_contains_subscription(), + 'paypal_button_selector' => '#cko-paypal-button-wrapper', + 'redirect' => wc_get_checkout_url(), + 'paypal_express_add_to_cart_nonce' => wp_create_nonce( 'checkoutcom_paypal_express_add_to_cart' ), + 'debug' => 'yes' === WC_Admin_Settings::get_option( 'cko_console_logging', 'no' ), + ]; + + wp_localize_script( 'cko-paypal-script', 'cko_paypal_vars', $vars ); + + wp_enqueue_script( 'cko-paypal-script' ); + + wp_register_script( + 'cko-paypal-express-integration-script', + WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/cko-paypal-express-integration.js', + [ 'jquery', 'cko-paypal-script' ], + WC_CHECKOUTCOM_PLUGIN_VERSION + ); + + // Also localize on express integration script to ensure variables are available + wp_localize_script( 'cko-paypal-express-integration-script', 'cko_paypal_vars', $vars ); + + wp_enqueue_script( 'cko-paypal-express-integration-script' ); + } + + public function display_payment_request_button_html() { + static $container_rendered = false; + + $paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', array() ); + + // First check if master toggle is enabled - must be explicitly 'yes' + // Handle cases: not set, empty string, false, 'no', or anything else = disabled + $is_express_enabled = isset( $paypal_settings['paypal_express'] ) + && 'yes' === $paypal_settings['paypal_express'] + && ! empty( $paypal_settings['paypal_express'] ); + if ( ! $is_express_enabled ) { + return; + } + + // Check if PayPal Express is available (gateway check) + if ( ! WC_Checkoutcom_Utility::is_paypal_express_available() ) { + return; + } + + // Check if PayPal Express is enabled for product pages - must be explicitly 'yes' + // Handle cases: not set (default enabled), empty string, false, 'no' = disabled + $show_on_product = false; + if ( ! isset( $paypal_settings['paypal_express_product_page'] ) ) { + // Default to yes if setting doesn't exist (backward compatibility) + $show_on_product = true; + } elseif ( isset( $paypal_settings['paypal_express_product_page'] ) + && 'yes' === $paypal_settings['paypal_express_product_page'] + && ! empty( $paypal_settings['paypal_express_product_page'] ) ) { + $show_on_product = true; + } + + if ( ! is_product() || ! $show_on_product ) { + return; + } + + // Check if unified express checkout container should be rendered + $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() ); + $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', array() ); + + $google_express_enabled = isset( $google_pay_settings['google_pay_express'] ) + && 'yes' === $google_pay_settings['google_pay_express'] + && ! empty( $google_pay_settings['google_pay_express'] ); + $google_available = WC_Checkoutcom_Utility::is_google_pay_express_available(); + $google_show_on_product = ! isset( $google_pay_settings['google_pay_express_product_page'] ) + || ( isset( $google_pay_settings['google_pay_express_product_page'] ) + && 'yes' === $google_pay_settings['google_pay_express_product_page'] + && ! empty( $google_pay_settings['google_pay_express_product_page'] ) ); + + $apple_pay_express_enabled = isset( $apple_pay_settings['apple_pay_express'] ) + && 'yes' === $apple_pay_settings['apple_pay_express'] + && ! empty( $apple_pay_settings['apple_pay_express'] ); + $apple_pay_available = WC_Checkoutcom_Utility::is_apple_pay_express_available(); + $apple_pay_show_on_product = ! isset( $apple_pay_settings['apple_pay_express_product_page'] ) + || ( isset( $apple_pay_settings['apple_pay_express_product_page'] ) + && 'yes' === $apple_pay_settings['apple_pay_express_product_page'] + && ! empty( $apple_pay_settings['apple_pay_express_product_page'] ) ); + + // Check if unified container has been rendered + $unified_container_rendered = WC_Checkoutcom_Utility::express_checkout_container_rendered(); + + // Determine if we should render unified container + $should_render_container = ! $unified_container_rendered && ( + ( $google_express_enabled && $google_available && $google_show_on_product ) || + ( $apple_pay_express_enabled && $apple_pay_available && $apple_pay_show_on_product ) + ); + + // Render unified container only once if both are enabled, or PayPal's own container + if ( $should_render_container ) { + WC_Checkoutcom_Utility::express_checkout_container_rendered( true ); + $container_rendered = true; + ?> + +
+
+
+
+
+
+
+
+
+ is_type( 'variable' ) ) {
+ return;
+ }
+
+ $product_id = $product ? $product->get_id() : 0;
+ ?>
+
+
+ cart->is_empty() ) {
+ return;
+ }
+
+ // Check if unified express checkout container should be rendered
+ $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', array() );
+ $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', array() );
+
+ $google_express_enabled = isset( $google_pay_settings['google_pay_express'] )
+ && 'yes' === $google_pay_settings['google_pay_express']
+ && ! empty( $google_pay_settings['google_pay_express'] );
+ $google_available = WC_Checkoutcom_Utility::is_google_pay_express_available();
+ $google_show_on_cart = ! isset( $google_pay_settings['google_pay_express_cart_page'] )
+ || ( isset( $google_pay_settings['google_pay_express_cart_page'] )
+ && 'yes' === $google_pay_settings['google_pay_express_cart_page']
+ && ! empty( $google_pay_settings['google_pay_express_cart_page'] ) );
+
+ $apple_pay_express_enabled = isset( $apple_pay_settings['apple_pay_express'] )
+ && 'yes' === $apple_pay_settings['apple_pay_express']
+ && ! empty( $apple_pay_settings['apple_pay_express'] );
+ $apple_pay_available = WC_Checkoutcom_Utility::is_apple_pay_express_available();
+ $apple_pay_show_on_cart = ! isset( $apple_pay_settings['apple_pay_express_cart_page'] )
+ || ( isset( $apple_pay_settings['apple_pay_express_cart_page'] )
+ && 'yes' === $apple_pay_settings['apple_pay_express_cart_page']
+ && ! empty( $apple_pay_settings['apple_pay_express_cart_page'] ) );
+
+ // Check if unified container has been rendered
+ $unified_container_rendered = WC_Checkoutcom_Utility::express_checkout_container_rendered();
+
+ // Determine if we should render unified container
+ $should_render_container = ! $unified_container_rendered && (
+ ( $google_express_enabled && $google_available && $google_show_on_cart ) ||
+ ( $apple_pay_express_enabled && $apple_pay_available && $apple_pay_show_on_cart )
+ );
+
+ // Render unified container only once if both are enabled, or PayPal's own container
+ if ( $should_render_container ) {
+ WC_Checkoutcom_Utility::express_checkout_container_rendered( true );
+ $container_rendered = true;
+ ?>
+
+
+
+
+
+
+
+
+
+
+ $methods['wc_checkout_com_paypal'] ];
+ }
+
+ return $methods;
+ }
+
+ public function cancel_paypal_session_markup() {
+ $cko_paypal_order_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_paypal_order_id' );
+ $cko_pc_id = WC_Checkoutcom_Utility::cko_get_session( 'cko_pc_id' );
+
+ // Check if PayPal session variable exist for current customer.
+ $paypal_session_exist = ! empty( $cko_pc_id ) && ! empty( $cko_paypal_order_id );
+
+ $cancel_url = add_query_arg(
+ [
+ 'cko-paypal-session-cancel' => '1',
+ 'cko-paypal-session-cancel-nonce' => wp_create_nonce( 'checkoutcom_paypal_cancel' ),
+ ],
+ wc_get_checkout_url()
+ );
+
+ if ( ! $paypal_session_exist ) {
+ return;
+ }
+
+ ob_start();
+ ?>
+ + ', + '', + '', + ); + + ?> +
+ get_builder()->getPaymentContextsClient()->getPaymentContextDetails( $cko_pc_id ); + $cko_pc_details = $response; + + WC_Checkoutcom_Utility::cko_set_session( 'cko_pc_details', $response ); + + } catch ( CheckoutApiException $ex ) { + } + } + + if ( isset( $cko_pc_details['payment_request']['shipping']['address'] ) ) { + $paypal_shipping_address = $cko_pc_details['payment_request']['shipping']['address']; + $shipping_name = $cko_pc_details['payment_request']['shipping']['first_name'] ? explode( ' ', $cko_pc_details['payment_request']['shipping']['first_name'] ) : []; + $paypal_shipping_first_name = $shipping_name[0] ?? ''; + $paypal_shipping_last_name = $shipping_name[1] ?? ''; + + switch ( $key ) { + case 'billing_first_name': + case 'shipping_first_name': + return $paypal_shipping_first_name; + + case 'billing_last_name': + case 'shipping_last_name': + return $paypal_shipping_last_name; + + case 'billing_address_1': + case 'shipping_address_1': + return $paypal_shipping_address['address_line1']; + + case 'billing_address_2': + case 'shipping_address_2': + return $paypal_shipping_address['address_line2'] ?? ''; + + case 'billing_city': + case 'shipping_city': + return $paypal_shipping_address['city']; + + case 'billing_postcode': + case 'shipping_postcode': + return $paypal_shipping_address['zip']; + + case 'billing_country': + case 'shipping_country': + return $paypal_shipping_address['country']; + + case 'billing_email': + // For logged-in users, use their account email + if ( is_user_logged_in() ) { + $current_user = wp_get_current_user(); + if ( $current_user && $current_user->user_email ) { + return $current_user->user_email; + } + } + // For guest users, get email from PayPal data + // Check multiple possible locations + if ( isset( $cko_pc_details['payment_request']['source']['account_holder']['email'] ) ) { + return $cko_pc_details['payment_request']['source']['account_holder']['email']; + } + if ( isset( $cko_pc_details['payment_request']['shipping']['email'] ) ) { + return $cko_pc_details['payment_request']['shipping']['email']; + } + if ( isset( $cko_pc_details['payment_request']['billing']['email'] ) ) { + return $cko_pc_details['payment_request']['billing']['email']; + } + if ( isset( $cko_pc_details['payment_request']['payer']['email'] ) ) { + return $cko_pc_details['payment_request']['payer']['email']; + } + if ( isset( $cko_pc_details['payment_request']['customer']['email'] ) ) { + return $cko_pc_details['payment_request']['customer']['email']; + } + // Return original value if not found + return $value; + } + } + + return $value; + } +} + +CKO_Paypal_Express::get_instance(); \ No newline at end of file diff --git a/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-enhanced-logger.php b/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-enhanced-logger.php new file mode 100644 index 00000000..1f68e087 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-enhanced-logger.php @@ -0,0 +1,551 @@ + 0, + LogLevel::ALERT => 1, + LogLevel::CRITICAL => 2, + LogLevel::ERROR => 3, + LogLevel::WARNING => 4, + LogLevel::NOTICE => 5, + LogLevel::INFO => 6, + LogLevel::DEBUG => 7, + ]; + + /** + * Logger instance. + * + * @var WC_Checkoutcom_Enhanced_Logger + */ + private static $instance = null; + + /** + * WooCommerce logger instance. + * + * @var WC_Logger + */ + private $wc_logger; + + /** + * Log buffer for batch processing. + * + * @var array + */ + private $log_buffer = []; + + /** + * Buffer size limit. + * + * @var int + */ + private $buffer_size = 100; + + /** + * Current log level threshold. + * + * @var int + */ + private $log_level_threshold; + + /** + * Context data for all logs. + * + * @var array + */ + private $global_context = []; + + /** + * Correlation ID for request tracking. + * + * @var string + */ + private $correlation_id; + + /** + * Performance metrics. + * + * @var array + */ + private $metrics = [ + 'logs_written' => 0, + 'logs_buffered' => 0, + 'buffer_flushes' => 0, + 'start_time' => null, + ]; + + /** + * Get singleton instance. + * + * @return WC_Checkoutcom_Enhanced_Logger + */ + public static function get_instance() { + if (null === self::$instance) { + self::$instance = new self(); + } + return self::$instance; + } + + /** + * Constructor. + */ + private function __construct() { + $this->wc_logger = wc_get_logger(); + $this->log_level_threshold = $this->get_log_level_threshold(); + $this->correlation_id = $this->generate_correlation_id(); + $this->metrics['start_time'] = microtime(true); + + // Set global context + $this->global_context = [ + 'plugin_version' => WC_CHECKOUTCOM_PLUGIN_VERSION ?? 'unknown', + 'wp_version' => get_bloginfo('version'), + 'wc_version' => WC()->version ?? 'unknown', + 'correlation_id' => $this->correlation_id, + 'request_id' => uniqid('req_', true), + ]; + + // Register shutdown hook for buffer flush + register_shutdown_function([$this, 'flush_buffer']); + + // Register buffer flush on WordPress actions + add_action('wp_footer', [$this, 'flush_buffer']); + add_action('admin_footer', [$this, 'flush_buffer']); + } + + /** + * Get log level threshold from settings. + * + * @return int + */ + private function get_log_level_threshold() { + $log_level = WC_Admin_Settings::get_option('cko_log_level', 'error'); + + switch (strtolower($log_level)) { + case 'debug': + return self::LOG_LEVELS[LogLevel::DEBUG]; + case 'info': + return self::LOG_LEVELS[LogLevel::INFO]; + case 'warning': + case 'warn': + return self::LOG_LEVELS[LogLevel::WARNING]; + case 'error': + return self::LOG_LEVELS[LogLevel::ERROR]; + case 'critical': + return self::LOG_LEVELS[LogLevel::CRITICAL]; + default: + return self::LOG_LEVELS[LogLevel::ERROR]; + } + } + + /** + * Generate correlation ID for request tracking. + * + * @return string + */ + private function generate_correlation_id() { + return 'cko_' . uniqid() . '_' . substr(md5(microtime()), 0, 8); + } + + /** + * Log with an arbitrary level. + * + * @param mixed $level Log level. + * @param string $message Log message. + * @param array $context Log context. + */ + public function log($level, $message, array $context = []) { + $numeric_level = self::LOG_LEVELS[$level] ?? self::LOG_LEVELS[LogLevel::ERROR]; + + // Skip if below threshold + if ($numeric_level > $this->log_level_threshold) { + return; + } + + $this->write_log($level, $message, $context); + } + + /** + * System is unusable. + * + * @param string $message Log message. + * @param array $context Log context. + */ + public function emergency($message, array $context = []) { + $this->log(LogLevel::EMERGENCY, $message, $context); + } + + /** + * Action must be taken immediately. + * + * @param string $message Log message. + * @param array $context Log context. + */ + public function alert($message, array $context = []) { + $this->log(LogLevel::ALERT, $message, $context); + } + + /** + * Critical conditions. + * + * @param string $message Log message. + * @param array $context Log context. + */ + public function critical($message, array $context = []) { + $this->log(LogLevel::CRITICAL, $message, $context); + } + + /** + * Runtime errors that do not require immediate action. + * + * @param string $message Log message. + * @param array $context Log context. + */ + public function error($message, array $context = []) { + $this->log(LogLevel::ERROR, $message, $context); + } + + /** + * Exceptional occurrences that are not errors. + * + * @param string $message Log message. + * @param array $context Log context. + */ + public function warning($message, array $context = []) { + $this->log(LogLevel::WARNING, $message, $context); + } + + /** + * Normal but significant condition. + * + * @param string $message Log message. + * @param array $context Log context. + */ + public function notice($message, array $context = []) { + $this->log(LogLevel::NOTICE, $message, $context); + } + + /** + * Interesting events. + * + * @param string $message Log message. + * @param array $context Log context. + */ + public function info($message, array $context = []) { + $this->log(LogLevel::INFO, $message, $context); + } + + /** + * Detailed debug information. + * + * @param string $message Log message. + * @param array $context Log context. + */ + public function debug($message, array $context = []) { + $this->log(LogLevel::DEBUG, $message, $context); + } + + /** + * Write log entry. + * + * @param string $level Log level. + * @param string $message Log message. + * @param array $context Log context. + */ + private function write_log($level, $message, array $context = []) { + $log_entry = $this->format_log_entry($level, $message, $context); + + // Check if we should use async logging + if ($this->should_use_async_logging($level)) { + $this->buffer_log($log_entry); + } else { + $this->write_immediately($log_entry); + } + } + + /** + * Format log entry with structured data. + * + * @param string $level Log level. + * @param string $message Log message. + * @param array $context Log context. + * @return array + */ + private function format_log_entry($level, $message, array $context = []) { + $timestamp = gmdate('Y-m-d H:i:s'); + $memory_usage = memory_get_usage(true); + $memory_peak = memory_get_peak_usage(true); + + // Merge global context with local context + $merged_context = array_merge($this->global_context, $context); + + // Add performance data + $merged_context['memory_usage'] = $this->format_bytes($memory_usage); + $merged_context['memory_peak'] = $this->format_bytes($memory_peak); + $merged_context['execution_time'] = microtime(true) - $this->metrics['start_time']; + + // Add order context if available + if (isset($context['order_id'])) { + $merged_context['order_id'] = $context['order_id']; + } + + // Add payment context if available + if (isset($context['payment_id'])) { + $merged_context['payment_id'] = $context['payment_id']; + } + + return [ + 'timestamp' => $timestamp, + 'level' => strtoupper($level), + 'message' => $message, + 'context' => $merged_context, + 'formatted_message' => $this->interpolate_message($message, $merged_context), + ]; + } + + /** + * Interpolate message with context variables. + * + * @param string $message Log message. + * @param array $context Log context. + * @return string + */ + private function interpolate_message($message, array $context = []) { + $replace = []; + foreach ($context as $key => $val) { + if (!is_array($val) && (!is_object($val) || method_exists($val, '__toString'))) { + $replace['{' . $key . '}'] = $val; + } + } + return strtr($message, $replace); + } + + /** + * Determine if async logging should be used. + * + * @param string $level Log level. + * @return bool + */ + private function should_use_async_logging($level) { + // Use immediate logging for critical errors + $immediate_levels = [LogLevel::EMERGENCY, LogLevel::ALERT, LogLevel::CRITICAL]; + return !in_array($level, $immediate_levels); + } + + /** + * Buffer log entry for batch processing. + * + * @param array $log_entry Log entry. + */ + private function buffer_log($log_entry) { + $this->log_buffer[] = $log_entry; + $this->metrics['logs_buffered']++; + + // Flush buffer if it reaches the limit + if (count($this->log_buffer) >= $this->buffer_size) { + $this->flush_buffer(); + } + } + + /** + * Write log entry immediately. + * + * @param array $log_entry Log entry. + */ + private function write_immediately($log_entry) { + $this->write_to_wc_logger($log_entry); + $this->metrics['logs_written']++; + } + + /** + * Flush log buffer. + */ + public function flush_buffer() { + if (empty($this->log_buffer)) { + return; + } + + foreach ($this->log_buffer as $log_entry) { + $this->write_to_wc_logger($log_entry); + } + + $this->metrics['logs_written'] += count($this->log_buffer); + $this->metrics['buffer_flushes']++; + $this->log_buffer = []; + } + + /** + * Write to WooCommerce logger. + * + * @param array $log_entry Log entry. + */ + private function write_to_wc_logger($log_entry) { + $context = ['source' => 'wc_checkoutcom_enhanced_log']; + + // Add structured data as JSON + $context['structured_data'] = json_encode($log_entry['context']); + + // Write to WC logger + $this->wc_logger->log( + $this->map_to_wc_level($log_entry['level']), + $log_entry['formatted_message'], + $context + ); + } + + /** + * Map log level to WooCommerce log level. + * + * @param string $level Log level. + * @return string + */ + private function map_to_wc_level($level) { + $mapping = [ + 'EMERGENCY' => 'emergency', + 'ALERT' => 'alert', + 'CRITICAL' => 'critical', + 'ERROR' => 'error', + 'WARNING' => 'warning', + 'NOTICE' => 'notice', + 'INFO' => 'info', + 'DEBUG' => 'debug', + ]; + + return $mapping[$level] ?? 'error'; + } + + /** + * Format bytes to human readable format. + * + * @param int $bytes Number of bytes. + * @return string + */ + private function format_bytes($bytes) { + $units = ['B', 'KB', 'MB', 'GB']; + $bytes = max($bytes, 0); + $pow = floor(($bytes ? log($bytes) : 0) / log(1024)); + $pow = min($pow, count($units) - 1); + $bytes /= pow(1024, $pow); + return round($bytes, 2) . ' ' . $units[$pow]; + } + + /** + * Add context to all subsequent logs. + * + * @param array $context Additional context. + */ + public function add_context(array $context) { + $this->global_context = array_merge($this->global_context, $context); + } + + /** + * Get correlation ID. + * + * @return string + */ + public function get_correlation_id() { + return $this->correlation_id; + } + + /** + * Get performance metrics. + * + * @return array + */ + public function get_metrics() { + return array_merge($this->metrics, [ + 'buffer_size' => count($this->log_buffer), + 'uptime' => microtime(true) - $this->metrics['start_time'], + ]); + } + + /** + * Log performance metrics. + */ + public function log_metrics() { + $metrics = $this->get_metrics(); + $this->info('Logger performance metrics', ['metrics' => $metrics]); + } + + /** + * Create a child logger with additional context. + * + * @param array $context Additional context. + * @return WC_Checkoutcom_Enhanced_Logger + */ + public function with_context(array $context) { + $child = clone $this; + $child->add_context($context); + return $child; + } + + /** + * Log API request/response for debugging. + * + * @param string $method HTTP method. + * @param string $url Request URL. + * @param array $data Request/response data. + * @param string $type Request or response. + */ + public function log_api_call($method, $url, $data, $type = 'request') { + $context = [ + 'api_call' => true, + 'method' => $method, + 'url' => $url, + 'type' => $type, + 'data_size' => strlen(json_encode($data)), + ]; + + $message = sprintf('API %s: %s %s', strtoupper($type), $method, $url); + $this->debug($message, $context); + } + + /** + * Log payment flow events. + * + * @param string $event Event name. + * @param array $context Event context. + */ + public function log_payment_event($event, array $context = []) { + $context['payment_event'] = true; + $context['event_name'] = $event; + + $this->info("Payment event: {$event}", $context); + } + + /** + * Log webhook events. + * + * @param string $event Webhook event type. + * @param array $data Webhook data. + * @param string $status Processing status. + */ + public function log_webhook_event($event, $data, $status = 'received') { + $context = [ + 'webhook_event' => true, + 'event_type' => $event, + 'status' => $status, + 'data_size' => strlen(json_encode($data)), + ]; + + if (isset($data['metadata']['order_id'])) { + $context['order_id'] = $data['metadata']['order_id']; + } + + $message = sprintf('Webhook %s: %s', $status, $event); + $this->info($message, $context); + } +} diff --git a/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-log-manager.php b/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-log-manager.php new file mode 100644 index 00000000..c81e7ec9 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-log-manager.php @@ -0,0 +1,437 @@ +log_directory = WC_LOG_DIR . 'checkout-com/'; + $this->max_file_size = $this->get_max_file_size(); + $this->max_files = $this->get_max_files(); + $this->retention_days = $this->get_retention_days(); + + // Ensure log directory exists + $this->ensure_log_directory(); + + // Schedule cleanup if not already scheduled + if (!wp_next_scheduled('cko_log_cleanup')) { + wp_schedule_event(time(), 'daily', 'cko_log_cleanup'); + } + + // Hook into cleanup action + add_action('cko_log_cleanup', [$this, 'cleanup_old_logs']); + + // Hook into WordPress shutdown for immediate cleanup if needed + add_action('shutdown', [$this, 'maybe_cleanup_logs']); + } + + /** + * Get maximum log file size from settings. + * + * @return int + */ + private function get_max_file_size() { + $size_mb = WC_Admin_Settings::get_option('cko_log_max_size_mb', 10); + return $size_mb * 1024 * 1024; // Convert MB to bytes + } + + /** + * Get maximum number of log files from settings. + * + * @return int + */ + private function get_max_files() { + return WC_Admin_Settings::get_option('cko_log_max_files', 5); + } + + /** + * Get log retention period from settings. + * + * @return int + */ + private function get_retention_days() { + return WC_Admin_Settings::get_option('cko_log_retention_days', 30); + } + + /** + * Ensure log directory exists and is writable. + */ + private function ensure_log_directory() { + if (!file_exists($this->log_directory)) { + wp_mkdir_p($this->log_directory); + } + + // Create .htaccess to prevent direct access + $htaccess_file = $this->log_directory . '.htaccess'; + if (!file_exists($htaccess_file)) { + file_put_contents($htaccess_file, "Order deny,allow\nDeny from all\n"); + } + + // Create index.php to prevent directory listing + $index_file = $this->log_directory . 'index.php'; + if (!file_exists($index_file)) { + file_put_contents($index_file, "log_directory . $filename; + } + + /** + * Check if log file needs rotation. + * + * @param string $log_file_path Log file path. + * @return bool + */ + public function should_rotate_log($log_file_path) { + if (!file_exists($log_file_path)) { + return false; + } + + return filesize($log_file_path) >= $this->max_file_size; + } + + /** + * Rotate log file. + * + * @param string $log_file_path Log file path. + * @return bool + */ + public function rotate_log($log_file_path) { + if (!$this->should_rotate_log($log_file_path)) { + return false; + } + + $timestamp = date('Y-m-d-H-i-s'); + $rotated_file = str_replace('.log', "-{$timestamp}.log", $log_file_path); + + // Move current log to rotated file + if (rename($log_file_path, $rotated_file)) { + // Compress the rotated file + $this->compress_log_file($rotated_file); + + // Clean up old rotated files + $this->cleanup_rotated_files(dirname($log_file_path)); + + return true; + } + + return false; + } + + /** + * Compress log file using gzip. + * + * @param string $file_path File path to compress. + * @return bool + */ + private function compress_log_file($file_path) { + if (!function_exists('gzopen')) { + return false; + } + + $gz_file = $file_path . '.gz'; + + $fp_in = fopen($file_path, 'rb'); + $fp_out = gzopen($gz_file, 'wb9'); + + if (!$fp_in || !$fp_out) { + return false; + } + + while (!feof($fp_in)) { + gzwrite($fp_out, fread($fp_in, 1024 * 512)); + } + + fclose($fp_in); + gzclose($fp_out); + + // Remove original file after successful compression + unlink($file_path); + + return true; + } + + /** + * Clean up old rotated log files. + * + * @param string $directory Directory to clean. + */ + private function cleanup_rotated_files($directory) { + $files = glob($directory . '/checkout-com-*.log*'); + + if (empty($files)) { + return; + } + + // Sort files by modification time (newest first) + usort($files, function($a, $b) { + return filemtime($b) - filemtime($a); + }); + + // Remove files beyond the limit + if (count($files) > $this->max_files) { + $files_to_remove = array_slice($files, $this->max_files); + foreach ($files_to_remove as $file) { + unlink($file); + } + } + } + + /** + * Clean up old log files based on retention policy. + */ + public function cleanup_old_logs() { + $cutoff_time = time() - ($this->retention_days * 24 * 60 * 60); + $files = glob($this->log_directory . 'checkout-com-*.log*'); + + $deleted_count = 0; + $deleted_size = 0; + + foreach ($files as $file) { + if (filemtime($file) < $cutoff_time) { + $file_size = filesize($file); + if (unlink($file)) { + $deleted_count++; + $deleted_size += $file_size; + } + } + } + + // Log cleanup results + if ($deleted_count > 0) { + $logger = WC_Checkoutcom_Enhanced_Logger::get_instance(); + $logger->info('Log cleanup completed', [ + 'deleted_files' => $deleted_count, + 'deleted_size_mb' => round($deleted_size / 1024 / 1024, 2), + 'retention_days' => $this->retention_days, + ]); + } + + return [ + 'deleted_files' => $deleted_count, + 'deleted_size' => $deleted_size, + ]; + } + + /** + * Maybe cleanup logs on shutdown if needed. + */ + public function maybe_cleanup_logs() { + // Only run cleanup occasionally to avoid performance impact + $last_cleanup = get_transient('cko_last_log_cleanup'); + if (!$last_cleanup || (time() - $last_cleanup) > 3600) { // 1 hour + $this->cleanup_old_logs(); + set_transient('cko_last_log_cleanup', time(), 3600); + } + } + + /** + * Get log file statistics. + * + * @return array + */ + public function get_log_statistics() { + $files = glob($this->log_directory . 'checkout-com-*.log*'); + $total_size = 0; + $file_count = 0; + $oldest_file = null; + $newest_file = null; + + foreach ($files as $file) { + $file_size = filesize($file); + $file_time = filemtime($file); + + $total_size += $file_size; + $file_count++; + + if (!$oldest_file || $file_time < $oldest_file['time']) { + $oldest_file = [ + 'name' => basename($file), + 'time' => $file_time, + 'size' => $file_size, + ]; + } + + if (!$newest_file || $file_time > $newest_file['time']) { + $newest_file = [ + 'name' => basename($file), + 'time' => $file_time, + 'size' => $file_size, + ]; + } + } + + return [ + 'total_files' => $file_count, + 'total_size_mb' => round($total_size / 1024 / 1024, 2), + 'oldest_file' => $oldest_file, + 'newest_file' => $newest_file, + 'retention_days' => $this->retention_days, + 'max_files' => $this->max_files, + 'max_size_mb' => round($this->max_file_size / 1024 / 1024, 2), + ]; + } + + /** + * Export logs for debugging. + * + * @param int $days Number of days to export. + * @return string + */ + public function export_logs($days = 7) { + $cutoff_time = time() - ($days * 24 * 60 * 60); + $files = glob($this->log_directory . 'checkout-com-*.log*'); + + $export_data = [ + 'export_timestamp' => date('Y-m-d H:i:s'), + 'export_period_days' => $days, + 'files' => [], + ]; + + foreach ($files as $file) { + if (filemtime($file) >= $cutoff_time) { + $content = file_get_contents($file); + + // Decompress if it's a gzipped file + if (substr($file, -3) === '.gz') { + $content = gzdecode($content); + } + + $export_data['files'][] = [ + 'filename' => basename($file), + 'size' => filesize($file), + 'modified' => date('Y-m-d H:i:s', filemtime($file)), + 'content' => $content, + ]; + } + } + + return json_encode($export_data, JSON_PRETTY_PRINT); + } + + /** + * Clear all log files. + * + * @return bool + */ + public function clear_all_logs() { + $files = glob($this->log_directory . 'checkout-com-*.log*'); + $deleted_count = 0; + + foreach ($files as $file) { + if (unlink($file)) { + $deleted_count++; + } + } + + $logger = WC_Checkoutcom_Enhanced_Logger::get_instance(); + $logger->info('All log files cleared', ['deleted_files' => $deleted_count]); + + return $deleted_count > 0; + } + + /** + * Get log file content for display. + * + * @param string $filename Log filename. + * @param int $lines Number of lines to return. + * @return string + */ + public function get_log_content($filename, $lines = 100) { + $file_path = $this->log_directory . $filename; + + if (!file_exists($file_path)) { + return ''; + } + + $content = file_get_contents($file_path); + + // Decompress if it's a gzipped file + if (substr($file_path, -3) === '.gz') { + $content = gzdecode($content); + } + + // Return last N lines + $content_lines = explode("\n", $content); + return implode("\n", array_slice($content_lines, -$lines)); + } + + /** + * Schedule immediate log cleanup. + */ + public function schedule_cleanup() { + wp_schedule_single_event(time(), 'cko_log_cleanup'); + } + + /** + * Unschedule log cleanup. + */ + public function unschedule_cleanup() { + wp_clear_scheduled_hook('cko_log_cleanup'); + } +} diff --git a/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-performance-monitor.php b/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-performance-monitor.php new file mode 100644 index 00000000..bcebb9b3 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/logging/class-wc-checkoutcom-performance-monitor.php @@ -0,0 +1,465 @@ +initialize_tracking(); + } + + /** + * Initialize performance tracking. + */ + private function initialize_tracking() { + // Track initial memory usage + $this->memory_usage['start'] = memory_get_usage(true); + $this->memory_usage['peak_start'] = memory_get_peak_usage(true); + + // Track initial time + $this->start_times['request'] = microtime(true); + + // Hook into WordPress actions for tracking + add_action('init', [$this, 'track_wp_init']); + add_action('wp_loaded', [$this, 'track_wp_loaded']); + add_action('shutdown', [$this, 'track_shutdown']); + + // Track database queries if WP_DEBUG is enabled + if (defined('WP_DEBUG') && WP_DEBUG) { + add_filter('log_query_custom_data', [$this, 'track_db_query'], 10, 5); + } + } + + /** + * Start timing an operation. + * + * @param string $operation Operation name. + * @return void + */ + public function start_timer($operation) { + $this->start_times[$operation] = microtime(true); + } + + /** + * End timing an operation and record the duration. + * + * @param string $operation Operation name. + * @param array $context Additional context. + * @return float Duration in seconds. + */ + public function end_timer($operation, $context = []) { + if (!isset($this->start_times[$operation])) { + return 0; + } + + $duration = microtime(true) - $this->start_times[$operation]; + + $this->metrics['operations'][$operation] = [ + 'duration' => $duration, + 'context' => $context, + 'timestamp' => time(), + ]; + + unset($this->start_times[$operation]); + + return $duration; + } + + /** + * Track memory usage. + * + * @param string $label Memory usage label. + * @return void + */ + public function track_memory($label) { + $this->memory_usage[$label] = [ + 'current' => memory_get_usage(true), + 'peak' => memory_get_peak_usage(true), + 'timestamp' => microtime(true), + ]; + } + + /** + * Track API call performance. + * + * @param string $method HTTP method. + * @param string $url API URL. + * @param float $duration Request duration. + * @param int $status HTTP status code. + * @param array $context Additional context. + * @return void + */ + public function track_api_call($method, $url, $duration, $status, $context = []) { + $this->api_calls[] = [ + 'method' => $method, + 'url' => $url, + 'duration' => $duration, + 'status' => $status, + 'context' => $context, + 'timestamp' => microtime(true), + ]; + + // Keep only last 100 API calls + if (count($this->api_calls) > 100) { + $this->api_calls = array_slice($this->api_calls, -100); + } + } + + /** + * Track database query. + * + * @param array $query_data Query data. + * @param string $query SQL query. + * @param float $query_time Query execution time. + * @param string $query_callstack Query callstack. + * @param string $query_start Query start time. + * @return array + */ + public function track_db_query($query_data, $query, $query_time, $query_callstack, $query_start) { + $this->db_queries[] = [ + 'query' => $query, + 'duration' => $query_time, + 'callstack' => $query_callstack, + 'timestamp' => $query_start, + ]; + + // Keep only last 50 queries + if (count($this->db_queries) > 50) { + $this->db_queries = array_slice($this->db_queries, -50); + } + + return $query_data; + } + + /** + * Track WordPress initialization. + */ + public function track_wp_init() { + $this->end_timer('wp_init'); + $this->track_memory('wp_init'); + } + + /** + * Track WordPress loaded. + */ + public function track_wp_loaded() { + $this->end_timer('wp_loaded'); + $this->track_memory('wp_loaded'); + } + + /** + * Track shutdown performance. + */ + public function track_shutdown() { + $this->end_timer('request'); + $this->track_memory('shutdown'); + + // Log performance summary if enabled + if ($this->should_log_performance()) { + $this->log_performance_summary(); + } + } + + /** + * Check if performance logging should be enabled. + * + * @return bool + */ + private function should_log_performance() { + return 'yes' === WC_Admin_Settings::get_option('cko_performance_logging', 'no'); + } + + /** + * Log performance summary. + */ + private function log_performance_summary() { + $summary = $this->get_performance_summary(); + + if (class_exists('WC_Checkoutcom_Enhanced_Logger')) { + $logger = WC_Checkoutcom_Enhanced_Logger::get_instance(); + $logger->info('Performance summary', [ + 'performance_summary' => true, + 'summary' => $summary, + ]); + } + } + + /** + * Get performance summary. + * + * @return array + */ + public function get_performance_summary() { + $total_time = microtime(true) - $this->start_times['request']; + $memory_peak = memory_get_peak_usage(true); + $memory_current = memory_get_usage(true); + + // Calculate operation statistics + $operation_stats = []; + if (isset($this->metrics['operations'])) { + foreach ($this->metrics['operations'] as $operation => $data) { + $operation_stats[$operation] = [ + 'duration' => round($data['duration'] * 1000, 2), // Convert to milliseconds + 'context' => $data['context'], + ]; + } + } + + // Calculate API call statistics + $api_stats = [ + 'total_calls' => count($this->api_calls), + 'total_duration' => 0, + 'average_duration' => 0, + 'slowest_call' => null, + 'status_codes' => [], + ]; + + if (!empty($this->api_calls)) { + $total_duration = 0; + $slowest_duration = 0; + + foreach ($this->api_calls as $call) { + $total_duration += $call['duration']; + + if ($call['duration'] > $slowest_duration) { + $slowest_duration = $call['duration']; + $api_stats['slowest_call'] = [ + 'url' => $call['url'], + 'method' => $call['method'], + 'duration' => round($call['duration'] * 1000, 2), + ]; + } + + $status = $call['status']; + $api_stats['status_codes'][$status] = ($api_stats['status_codes'][$status] ?? 0) + 1; + } + + $api_stats['total_duration'] = round($total_duration * 1000, 2); + $api_stats['average_duration'] = round(($total_duration / count($this->api_calls)) * 1000, 2); + } + + // Calculate database query statistics + $db_stats = [ + 'total_queries' => count($this->db_queries), + 'total_duration' => 0, + 'average_duration' => 0, + 'slowest_query' => null, + ]; + + if (!empty($this->db_queries)) { + $total_duration = 0; + $slowest_duration = 0; + + foreach ($this->db_queries as $query) { + $total_duration += $query['duration']; + + if ($query['duration'] > $slowest_duration) { + $slowest_duration = $query['duration']; + $db_stats['slowest_query'] = [ + 'query' => substr($query['query'], 0, 100) . '...', + 'duration' => round($query['duration'] * 1000, 2), + ]; + } + } + + $db_stats['total_duration'] = round($total_duration * 1000, 2); + $db_stats['average_duration'] = round(($total_duration / count($this->db_queries)) * 1000, 2); + } + + return [ + 'request_duration_ms' => round($total_time * 1000, 2), + 'memory_usage' => [ + 'peak_mb' => round($memory_peak / 1024 / 1024, 2), + 'current_mb' => round($memory_current / 1024 / 1024, 2), + 'peak_usage' => $this->format_bytes($memory_peak), + 'current_usage' => $this->format_bytes($memory_current), + ], + 'operations' => $operation_stats, + 'api_calls' => $api_stats, + 'database_queries' => $db_stats, + 'timestamp' => date('Y-m-d H:i:s'), + ]; + } + + /** + * Format bytes to human readable format. + * + * @param int $bytes Number of bytes. + * @return string + */ + private function format_bytes($bytes) { + $units = ['B', 'KB', 'MB', 'GB']; + $bytes = max($bytes, 0); + $pow = floor(($bytes ? log($bytes) : 0) / log(1024)); + $pow = min($pow, count($units) - 1); + $bytes /= pow(1024, $pow); + return round($bytes, 2) . ' ' . $units[$pow]; + } + + /** + * Get slow operations (above threshold). + * + * @param float $threshold_ms Threshold in milliseconds. + * @return array + */ + public function get_slow_operations($threshold_ms = 100) { + $slow_operations = []; + + if (isset($this->metrics['operations'])) { + foreach ($this->metrics['operations'] as $operation => $data) { + $duration_ms = $data['duration'] * 1000; + if ($duration_ms > $threshold_ms) { + $slow_operations[$operation] = [ + 'duration_ms' => round($duration_ms, 2), + 'context' => $data['context'], + ]; + } + } + } + + return $slow_operations; + } + + /** + * Get memory usage statistics. + * + * @return array + */ + public function get_memory_statistics() { + return [ + 'current' => $this->format_bytes(memory_get_usage(true)), + 'peak' => $this->format_bytes(memory_get_peak_usage(true)), + 'tracked_points' => $this->memory_usage, + ]; + } + + /** + * Reset all metrics. + */ + public function reset_metrics() { + $this->metrics = []; + $this->start_times = []; + $this->memory_usage = []; + $this->db_queries = []; + $this->api_calls = []; + + // Reinitialize tracking + $this->initialize_tracking(); + } + + /** + * Export performance data. + * + * @return array + */ + public function export_performance_data() { + return [ + 'summary' => $this->get_performance_summary(), + 'slow_operations' => $this->get_slow_operations(), + 'memory_statistics' => $this->get_memory_statistics(), + 'api_calls' => $this->api_calls, + 'db_queries' => $this->db_queries, + 'export_timestamp' => date('Y-m-d H:i:s'), + ]; + } + + /** + * Check if performance is within acceptable limits. + * + * @return array + */ + public function check_performance_limits() { + $summary = $this->get_performance_summary(); + $warnings = []; + + // Check request duration + if ($summary['request_duration_ms'] > 5000) { // 5 seconds + $warnings[] = 'Request duration exceeds 5 seconds'; + } + + // Check memory usage + if ($summary['memory_usage']['peak_mb'] > 128) { // 128 MB + $warnings[] = 'Peak memory usage exceeds 128 MB'; + } + + // Check for slow operations + $slow_ops = $this->get_slow_operations(1000); // 1 second + if (!empty($slow_ops)) { + $warnings[] = 'Slow operations detected: ' . implode(', ', array_keys($slow_ops)); + } + + // Check API call performance + if ($summary['api_calls']['average_duration'] > 2000) { // 2 seconds + $warnings[] = 'Average API call duration exceeds 2 seconds'; + } + + return [ + 'within_limits' => empty($warnings), + 'warnings' => $warnings, + 'summary' => $summary, + ]; + } +} diff --git a/checkout-com-unified-payments-api/includes/settings/admin/class-wc-checkoutcom-admin.php b/checkout-com-unified-payments-api/includes/settings/admin/class-wc-checkoutcom-admin.php new file mode 100644 index 00000000..19db98a6 --- /dev/null +++ b/checkout-com-unified-payments-api/includes/settings/admin/class-wc-checkoutcom-admin.php @@ -0,0 +1,96 @@ + + + + ++ + + +
+ + ++ + + +
+ %s%s',
+ esc_html__( 'Click above button to register webhook URL', 'checkout-com-unified-payments-api' ),
+ esc_url( WC_Checkoutcom_Webhook::get_instance()->generate_current_webhook_url() )
+ );
+ ?>
+ ' . __( 'For testing use the following value: 01234567890123456789', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => '01234567890123456789', + ], + 'ckocom_google_threed' => [ + 'id' => 'ckocom_google_threed', + 'title' => __( 'Use 3D Secure', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'desc_tip' => true, + 'options' => [ + 0 => __( 'No', 'checkout-com-unified-payments-api' ), + 1 => __( 'Yes', 'checkout-com-unified-payments-api' ), + ], + 'default' => 0, + 'description' => '3D secure payment', + ], + 'ckocom_google_style' => [ + 'title' => __( 'Button Style', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'class' => 'wc-enhanced-select', + 'description' => __( 'Select button color.', 'checkout-com-unified-payments-api' ), + 'default' => 'google-pay-black', + 'desc_tip' => true, + 'options' => [ + 'google-pay-black' => __( 'Black', 'checkout-com-unified-payments-api' ), + 'google-pay-white' => __( 'White', 'checkout-com-unified-payments-api' ), + ], + ], + 'google_pay_express' => [ + 'title' => __( 'Google Pay Express', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Enable Google Pay Express', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Master toggle to activate Google Pay Express checkout. When enabled, use the options below to control where buttons appear.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'no', + ], + 'google_pay_express_location' => [ + 'title' => __( 'Button Locations', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => __( 'Control where Google Pay Express buttons appear on your store.', 'checkout-com-unified-payments-api' ), + ], + 'google_pay_express_product_page' => [ + 'title' => __( 'Show on Product Page', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display Google Pay Express button on product detail pages', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show Google Pay Express button on individual product pages.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + 'google_pay_express_shop_page' => [ + 'title' => __( 'Show on Shop/Category Pages', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display Google Pay Express button on shop and category listing pages', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show Google Pay Express button on shop, category, tag, and archive pages.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + 'google_pay_express_cart_page' => [ + 'title' => __( 'Show on Cart Page', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display Google Pay Express button on cart page', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show Google Pay Express button on the cart page.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + // Size settings temporarily disabled - buttons use native SDK sizes + /* + 'google_pay_express_button_size' => [ + 'title' => __( 'Button Size Customization', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => __( 'Customize the size of Google Pay Express buttons. By default, buttons use their native styles for optimal appearance. You can choose to set a consistent size across all express buttons if needed.', 'checkout-com-unified-payments-api' ), + ], + 'google_pay_express_button_size_preset' => [ + 'title' => __( 'Button Size', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'description' => __( 'Choose the button size preset. "Native" uses the default Google Pay button styling (recommended). Other options set a consistent height across all express buttons.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => 'native', + 'options' => [ + 'native' => __( 'Native (Recommended)', 'checkout-com-unified-payments-api' ), + 'small' => __( 'Small (36px)', 'checkout-com-unified-payments-api' ), + 'medium' => __( 'Medium (40px)', 'checkout-com-unified-payments-api' ), + 'large' => __( 'Large (48px)', 'checkout-com-unified-payments-api' ), + 'custom' => __( 'Custom Height', 'checkout-com-unified-payments-api' ), + ], + ], + 'google_pay_express_button_custom_height' => [ + 'title' => __( 'Custom Button Height', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Enter a custom height in pixels (minimum 36px, maximum 60px). This setting only applies when "Custom Height" is selected above.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => '40', + 'custom_attributes' => [ + 'min' => '36', + 'max' => '60', + 'step' => '1', + ], + ], + */ + ]; + + return apply_filters( 'wc_checkout_com_google_pay', $settings ); + } + + /** + * CKO admin paypal setting fields + * + * @return mixed|void + */ + public static function paypal_settings() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' ); + + $checkout_mode = $core_settings['ckocom_checkout_mode']; + $should_disable_checkbox = false; + + if ( 'flow' === $checkout_mode ) { + $should_disable_checkbox = true; + } + + $settings = [ + 'google_setting' => [ + 'title' => __( 'PayPal Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ], + 'enabled' => [ + 'id' => 'enable', + 'title' => __( 'Enable/Disable', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'label' => __( 'Enable Checkout.com', 'checkout-com-unified-payments-api' ), + 'description' => __( 'This enables PayPal as a payment method', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'no', + 'custom_attributes' => $should_disable_checkbox ? [ 'disabled' => 'disabled' ] : [], + ], + 'title' => [ + 'title' => __( 'Title', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'label' => __( 'PayPal', 'checkout-com-unified-payments-api' ), + 'description' => __( 'Title that will be displayed on the checkout page', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'PayPal', + ], + 'description' => [ + 'title' => __( 'Description', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'This controls the description which the user sees during checkout.', 'checkout-com-unified-payments-api' ), + 'default' => 'Pay with PayPal.', + 'desc_tip' => true, + ], + 'ckocom_paypal_merchant_id' => [ + 'title' => __( 'Merchant ID', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Your Paypal merchant ID.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => '', + 'placeholder' => 'ABCD1EFGH2I3K', + ], + 'paypal_express' => [ + 'title' => __( 'PayPal Express', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Enable PayPal Express', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Master toggle to activate PayPal Express checkout. When enabled, use the options below to control where buttons appear.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'no', + ], + 'paypal_express_location' => [ + 'title' => __( 'Button Locations', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => __( 'Control where PayPal Express buttons appear on your store.', 'checkout-com-unified-payments-api' ), + ], + 'paypal_express_product_page' => [ + 'title' => __( 'Show on Product Page', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display PayPal Express button on product detail pages', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show PayPal Express button on individual product pages.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + 'paypal_express_shop_page' => [ + 'title' => __( 'Show on Shop/Category Pages', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display PayPal Express button on shop and category listing pages', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show PayPal Express button on shop, category, tag, and archive pages.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + 'paypal_express_cart_page' => [ + 'title' => __( 'Show on Cart Page', 'checkout-com-unified-payments-api' ), + 'label' => __( 'Display PayPal Express button on cart page', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'description' => __( 'Show PayPal Express button on the cart page.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ], + // Size settings temporarily disabled - buttons use native SDK sizes + /* + 'paypal_express_button_size' => [ + 'title' => __( 'Button Size Customization', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => __( 'Customize the size of PayPal Express buttons. By default, buttons use their native styles for optimal appearance. You can choose to set a consistent size across all express buttons if needed.', 'checkout-com-unified-payments-api' ), + ], + 'paypal_express_button_size_preset' => [ + 'title' => __( 'Button Size', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'description' => __( 'Choose the button size preset. "Native" uses the default PayPal button styling (recommended). Other options set a consistent height across all express buttons.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => 'native', + 'options' => [ + 'native' => __( 'Native (Recommended)', 'checkout-com-unified-payments-api' ), + 'small' => __( 'Small (36px)', 'checkout-com-unified-payments-api' ), + 'medium' => __( 'Medium (40px)', 'checkout-com-unified-payments-api' ), + 'large' => __( 'Large (48px)', 'checkout-com-unified-payments-api' ), + 'custom' => __( 'Custom Height', 'checkout-com-unified-payments-api' ), + ], + ], + 'paypal_express_button_custom_height' => [ + 'title' => __( 'Custom Button Height', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Enter a custom height in pixels (minimum 36px, maximum 60px). This setting only applies when "Custom Height" is selected above.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => false, + 'default' => '40', + 'custom_attributes' => [ + 'min' => '36', + 'max' => '60', + 'step' => '1', + ], + ], + */ + ]; + + return apply_filters( 'wc_checkout_com_paypal', $settings ); + } + + /** + * Alternative payment methods settings fields. + * + * @return mixed + */ + public static function apm_settings() { + $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' ); + + $checkout_mode = $core_settings['ckocom_checkout_mode']; + $should_disable_checkbox = false; + + if ( 'flow' === $checkout_mode ) { + $should_disable_checkbox = true; + } + + $settings = [ + 'apm_setting' => [ + 'title' => __( 'Alternative Payment Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ], + 'enabled' => [ + 'id' => 'enable', + 'title' => __( 'Enable/Disable', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'label' => __( 'Enable Checkout.com', 'checkout-com-unified-payments-api' ), + 'description' => __( 'This enables alternative payment methods', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'no', + 'custom_attributes' => $should_disable_checkbox ? [ 'disabled' => 'disabled' ] : [], + ], + 'title' => [ + 'title' => __( 'Title', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'label' => __( 'Alternative Payments', 'checkout-com-unified-payments-api' ), + 'description' => __( 'Title that will be displayed on the checkout page', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'Alternative Payment Methods', + ], + 'ckocom_apms_selector' => [ + 'title' => __( 'Alternative Payment Methods', 'checkout-com-unified-payments-api' ), + 'type' => 'multiselect', + 'options' => [ + 'alipay' => __( 'Alipay', 'checkout-com-unified-payments-api' ), + 'boleto' => __( 'Boleto', 'checkout-com-unified-payments-api' ), + 'ideal' => __( 'iDEAL', 'checkout-com-unified-payments-api' ), + 'klarna' => __( 'Klarna', 'checkout-com-unified-payments-api' ), + 'poli' => __( 'Poli', 'checkout-com-unified-payments-api' ), + 'sepa' => __( 'Sepa Direct Debit', 'checkout-com-unified-payments-api' ), + 'sofort' => __( 'Sofort', 'checkout-com-unified-payments-api' ), + 'eps' => __( 'EPS', 'checkout-com-unified-payments-api' ), + 'bancontact' => __( 'Bancontact', 'checkout-com-unified-payments-api' ), + 'knet' => __( 'KNET', 'checkout-com-unified-payments-api' ), + 'fawry' => __( 'Fawry', 'checkout-com-unified-payments-api' ), + 'qpay' => __( 'QPay', 'checkout-com-unified-payments-api' ), + 'multibanco' => __( 'Multibanco', 'checkout-com-unified-payments-api' ), + ], + 'class' => 'wc-enhanced-select', + 'css' => 'width: 400px;', + ], + + ]; + + return apply_filters( 'wc_checkout_com_alternative_payments', $settings ); + } + + /** + * Debugging settings. + * + * @return mixed + */ + public static function debug_settings() { + $settings = [ + 'debug_settings' => [ + 'title' => __( 'Debug Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ], + 'cko_file_logging' => [ + 'id' => 'cko_file_logging', + 'title' => __( 'File Logging', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'desc_tip' => true, + 'default' => 'no', + 'desc' => __( 'Check to enable file logging', 'checkout-com-unified-payments-api' ), + ], + 'cko_console_logging' => [ + 'id' => 'cko_console_logging', + 'title' => __( 'Console Logging', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'desc_tip' => true, + 'default' => 'no', + 'desc' => __( 'Check to enable console logging', 'checkout-com-unified-payments-api' ), + ], + 'cko_gateway_responses' => [ + 'id' => 'cko_gateway_responses', + 'title' => __( 'Gateway Responses', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'desc_tip' => true, + 'default' => 'no', + 'desc' => __( 'Check to show gateway response.', 'checkout-com-unified-payments-api' ), + ], + ]; + + return apply_filters( 'wc_checkout_com_cards', $settings ); + } + + /** + * CKO webhook settings fields. + * + * @return mixed + */ + public static function webhook_settings() { + + $settings = [ + 'webhook_settings' => [ + 'title' => __( 'Webhook Details', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ], + 'cko_webhook_set' => [ + 'id' => 'cko_webhook_set', + 'type' => 'checkoutcom_webhook_settings', + ], + ]; + + return apply_filters( 'wc_checkout_com_cards', $settings ); + } + + /** + * CKO FLOW settings fields. + * + * @return array + */ + public static function flow_settings() { + + $locale_link = 'https://www.checkout.com/docs/payments/accept-payments/accept-a-payment-on-your-website/add-localization-to-your-flow-integration#Supported_languages'; + $translation_link = 'https://www.checkout.com/docs/payments/accept-payments/accept-a-payment-on-your-website/add-localization-to-your-flow-integration#Add_custom_translations'; + $flow_com_link = 'https://www.checkout.com/docs/payments/accept-payments/accept-a-payment-on-your-website/flow-library-reference/checkoutwebcomponents#Methods'; + + // Flow Appearance settings. + $settings = array( + 'flow_appearance_settings' => array( + 'title' => __( 'Appearance', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_appearance_color_action' => array( + 'id' => 'flow_appearance_color_action', + 'title' => __( 'Color Action', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Pay Button', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#186AFF', + ), + 'flow_appearance_color_background' => array( + 'id' => 'flow_appearance_color_background', + 'title' => __( 'Color Background', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Background', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#f8f9fa', + ), + 'flow_appearance_color_border' => array( + 'id' => 'flow_appearance_color_border', + 'title' => __( 'Color Border', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Border', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#68686C', + ), + 'flow_appearance_color_disabled' => array( + 'id' => 'flow_appearance_color_disabled', + 'title' => __( 'Color Disabled', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Disabled button', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#64646E', + ), + 'flow_appearance_color_error' => array( + 'id' => 'flow_appearance_color_error', + 'title' => __( 'Color Error', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the Error Notification', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#FF3300', + ), + 'flow_appearance_color_form_background' => array( + 'id' => 'flow_appearance_color_form_background', + 'title' => __( 'Color Form Background', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( "Choose a color for the Form's Background", 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#e9ebeb', + ), + 'flow_appearance_color_form_border' => array( + 'id' => 'flow_appearance_color_form_border', + 'title' => __( 'Color Form Border', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( "Choose a color for the Form's Border", 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#1F1F1F', + ), + 'flow_appearance_color_inverse' => array( + 'id' => 'flow_appearance_color_inverse', + 'title' => __( 'Color Inverse', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the text on Pay Button', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#F9F9FB', + ), + 'flow_appearance_color_outline' => array( + 'id' => 'flow_appearance_color_outline', + 'title' => __( 'Color Outline', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for the outline', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#ADA4EC', + ), + 'flow_appearance_color_primary' => array( + 'id' => 'flow_appearance_color_primary', + 'title' => __( 'Color Primary', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a primary color for the flow container', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#454553', + ), + 'flow_appearance_color_secondary' => array( + 'id' => 'flow_appearance_color_secondary', + 'title' => __( 'Color Secondary', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a secondary color for the flow container', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#828388', + ), + 'flow_appearance_color_success' => array( + 'id' => 'flow_appearance_color_success', + 'title' => __( 'Color Success', 'checkout-com-unified-payments-api' ), + 'type' => 'color', + 'description' => __( 'Choose a color for success notifications', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '#2ECC71', + ), + ); + + // Flow Button settings. + $settings = array_merge( + $settings, + array( + 'flow_button_settings' => array( + 'title' => __( 'Button Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_button_font_family' => array( + 'id' => 'flow_button_font_family', + 'title' => __( 'Font Family', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font family', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '"Roboto Mono", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif', + ), + 'flow_button_font_size' => array( + 'id' => 'flow_button_font_size', + 'title' => __( 'Font Size', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font size', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '16px', + ), + 'flow_button_font_weight' => array( + 'id' => 'flow_button_font_weight', + 'title' => __( 'Font Weight', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set the font weight (e.g., 400, 700)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '700', + ), + 'flow_button_letter_spacing' => array( + 'id' => 'flow_button_letter_spacing', + 'title' => __( 'Letter Spacing', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set letter spacing (px)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '0', + ), + 'flow_button_line_height' => array( + 'id' => 'flow_button_line_height', + 'title' => __( 'Line Height', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set line height', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '24px', + ), + ) + ); + + // Flow Footnote settings. + $settings = array_merge( + $settings, + array( + 'flow_footnote_settings' => array( + 'title' => __( 'Footnote Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_footnote_font_family' => array( + 'id' => 'flow_footnote_font_family', + 'title' => __( 'Font Family', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font family', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '"PT Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif', + ), + 'flow_footnote_font_size' => array( + 'id' => 'flow_footnote_font_size', + 'title' => __( 'Font Size', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font size', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '14px', + ), + 'flow_footnote_font_weight' => array( + 'id' => 'flow_footnote_font_weight', + 'title' => __( 'Font Weight', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set the font weight (e.g., 400, 700)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '400', + ), + 'flow_footnote_letter_spacing' => array( + 'id' => 'flow_footnote_letter_spacing', + 'title' => __( 'Letter Spacing', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set letter spacing (px)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '0', + ), + 'flow_footnote_line_height' => array( + 'id' => 'flow_footnote_line_height', + 'title' => __( 'Line Height', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set line height', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '20px', + ), + ) + ); + + // Flow Label settings. + $settings = array_merge( + $settings, + array( + 'flow_label_settings' => array( + 'title' => __( 'Label Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_label_font_family' => array( + 'id' => 'flow_label_font_family', + 'title' => __( 'Font Family', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font family', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '"Roboto Mono", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif', + ), + 'flow_label_font_size' => array( + 'id' => 'flow_label_font_size', + 'title' => __( 'Font Size', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font size', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '14px', + ), + 'flow_label_font_weight' => array( + 'id' => 'flow_label_font_weight', + 'title' => __( 'Font Weight', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set the font weight (e.g., 400, 700)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '400', + ), + 'flow_label_letter_spacing' => array( + 'id' => 'flow_label_letter_spacing', + 'title' => __( 'Letter Spacing', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set letter spacing (px)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '0', + ), + 'flow_label_line_height' => array( + 'id' => 'flow_label_line_height', + 'title' => __( 'Line Height', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set line height', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '20px', + ), + ) + ); + + // Flow Subheading settings. + $settings = array_merge( + $settings, + array( + 'flow_subheading_settings' => array( + 'title' => __( 'Subheading Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_subheading_font_family' => array( + 'id' => 'flow_subheading_font_family', + 'title' => __( 'Font Family', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font family', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '"Roboto Mono", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif', + ), + 'flow_subheading_font_size' => array( + 'id' => 'flow_subheading_font_size', + 'title' => __( 'Font Size', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set the font size', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '16px', + ), + 'flow_subheading_font_weight' => array( + 'id' => 'flow_subheading_font_weight', + 'title' => __( 'Font Weight', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set the font weight (e.g., 400, 700)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '700', + ), + 'flow_subheading_letter_spacing' => array( + 'id' => 'flow_subheading_letter_spacing', + 'title' => __( 'Letter Spacing', 'checkout-com-unified-payments-api' ), + 'type' => 'number', + 'description' => __( 'Set letter spacing (px)', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '0', + ), + 'flow_subheading_line_height' => array( + 'id' => 'flow_subheading_line_height', + 'title' => __( 'Line Height', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Set line height', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '24px', + ), + ) + ); + + // Flow Border settings. + $settings = array_merge( + $settings, + array( + 'flow_border_settings' => array( + 'title' => __( 'Border Settings', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_form_border_radius' => array( + 'id' => 'flow_form_border_radius', + 'title' => __( 'Form Border Radius', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Enter Form border-radius value', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '8px', + ), + 'flow_button_border_radius' => array( + 'id' => 'flow_button_border_radius', + 'title' => __( 'Button Border Radius', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + 'description' => __( 'Enter Button border-radius value', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => '8px', + ), + ) + ); + + // Flow Component options. + $settings = array_merge( + $settings, + array( + 'flow_component_options' => array( + 'title' => __( 'Component Options', 'checkout-com-unified-payments-api' ), + 'type' => 'title', + 'description' => '', + ), + 'flow_component_expand_first_payment_method' => array( + 'id' => 'flow_component_expand_first_payment_method', + 'title' => __( 'Auto Expand', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'label' => __( 'Expand/Collapse First Payment Method', 'checkout-com-unified-payments-api' ), + 'description' => __( 'Automatically expand the first available payment method if multiple methods exist.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ), + 'flow_show_card_holder_name' => array( + 'id' => 'flow_show_card_holder_name', + 'title' => __( 'Card Holder Name', 'checkout-com-unified-payments-api' ), + 'type' => 'checkbox', + 'label' => __( 'Show/Hide Card Holder Name', 'checkout-com-unified-payments-api' ), + 'description' => __( 'Show Card holder name from their account', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'yes', + ), + 'flow_saved_payment' => array( + 'id' => 'flow_saved_payment', + 'title' => __( 'Saved Payment Display Order', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'description' => __( "Choose how to display payment options at checkout: + - **Saved Cards First**: Show saved payment methods first and expand them by default when available. + - **New Payment Methods First**: Show new payment options first and expand them by default.", 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'saved_cards_first', + 'options' => array( + 'saved_cards_first' => __( 'Saved Cards First (default expanded)', 'checkout-com-unified-payments-api' ), + 'new_payment_first' => __( 'New Payment Methods First (default expanded)', 'checkout-com-unified-payments-api' ), + ), + ), + 'flow_component_cardholder_name_position' => array( + 'id' => 'flow_component_cardholder_name_position', + 'title' => __( 'Cardholder Name Position', 'checkout-com-unified-payments-api' ), + 'type' => 'select', + 'options' => array( + 'top' => __( 'Top', 'checkout-com-unified-payments-api' ), + 'bottom' => __( 'Bottom', 'checkout-com-unified-payments-api' ), + 'hidden' => __( 'Hidden', 'checkout-com-unified-payments-api' ), + ), + 'description' => __( 'Choose the position of the cardholder name field.', 'checkout-com-unified-payments-api' ), + 'desc_tip' => true, + 'default' => 'top', + ), + 'flow_component_locale' => array( + 'id' => 'flow_component_locale', + 'title' => __( 'Locale', 'checkout-com-unified-payments-api' ), + 'type' => 'text', + /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */ + 'description' => sprintf( __( 'You can %1$s check out locales here %2$s in the Checkout.com Hub', 'checkout-com-unified-payments-api' ), '', '' ), + 'default' => 'en', + ), + 'flow_component_translation' => array( + 'id' => 'flow_component_translation', + 'title' => __( 'Custom Translation', 'checkout-com-unified-payments-api' ), + 'type' => 'textarea', + /* translators: 1: HTML anchor opening tag, 2: HTML anchor closing tag. */ + 'description' => sprintf( __( 'Add data in JSON format. You can %1$s check out about translations here %2$s in the Checkout.com Hub', 'checkout-com-unified-payments-api' ), '', '' ), + 'placeholder' => <<
+
+
+
+
+
+
+
+ sanitize_text_field($_POST['cko_log_level']),
+ 'cko_log_max_size_mb' => intval($_POST['cko_log_max_size_mb']),
+ 'cko_log_max_files' => intval($_POST['cko_log_max_files']),
+ 'cko_log_retention_days' => intval($_POST['cko_log_retention_days']),
+ 'cko_async_logging' => isset($_POST['cko_async_logging']) ? 'yes' : 'no',
+ 'cko_log_buffer_size' => intval($_POST['cko_log_buffer_size']),
+ 'cko_performance_logging' => isset($_POST['cko_performance_logging']) ? 'yes' : 'no',
+ ];
+
+ foreach ($settings as $key => $value) {
+ update_option($key, $value);
+ }
+
+ echo '
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ | + | + |
| + | MB | +
| + | + |
| + | + |
+ + + +
+
+
+
+
+
+
+
+
+
+ + + +
+' . __('Settings saved successfully.', 'checkout-com-unified-payments-api') . '
%s', $message, $webhook_is_ready );
+ } else {
+
+ $message = esc_html__( 'Webhook is not configured with the current site or there is some issue with connection, Please check logs or try again.', 'checkout-com-unified-payments-api' );
+ }
+
+ wp_send_json_success( [ 'message' => $message ] );
+ }
+
+ /**
+ * Check if webhook is registered.
+ *
+ * @param string $url Webhook URL.
+ *
+ * @return string|null
+ */
+ public function is_registered( $url = '' ): string {
+ $webhooks = $this->get_list();
+
+ if ( empty( $url ) ) {
+ $url = home_url( '/' );
+ }
+
+ foreach ( $webhooks as $item ) {
+ if ( false !== strpos( $item['url'], $url ) ) {
+ $this->url_is_registered = $item['url'];
+
+ return $this->url_is_registered;
+ }
+ }
+
+ return $this->url_is_registered;
+ }
+
+ /**
+ * Get list of all webhooks.
+ *
+ * @return array|mixed
+ */
+ public function get_list(): array {
+
+ if ( $this->list ) {
+ return $this->list;
+ }
+
+ try {
+ $builder = $this->checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot retrieve webhooks' );
+ return array();
+ }
+ $webhooks = $builder->getWebhooksClient()->retrieveWebhooks();
+
+ if ( isset( $webhooks ) && ! empty( $webhooks['items'] ) ) {
+ $this->list = $webhooks['items'];
+
+ return $this->list;
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = esc_html__( 'An error has occurred while processing webhook request.', 'checkout-com-unified-payments-api' );
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ }
+
+ return $this->list;
+ }
+}
+
+WC_Checkoutcom_Webhook::get_instance();
diff --git a/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-workflows.php b/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-workflows.php
new file mode 100644
index 00000000..bfaced3f
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/settings/class-wc-checkoutcom-workflows.php
@@ -0,0 +1,304 @@
+secret_key = $core_settings['ckocom_sk'];
+
+ if ( $subdomain_check ) {
+ $this->url = $environment ? 'https://' . $core_settings['ckocom_region'] . '.api.sandbox.checkout.com/workflows' : 'https://' . $core_settings['ckocom_region'] . '.api.checkout.com/workflows';
+ } else {
+ $this->url = $environment ? 'https://api.sandbox.checkout.com/workflows' : 'https://api.checkout.com/workflows';
+ }
+
+ $this->checkout = new Checkout_SDK();
+ }
+
+ /**
+ * Get singleton instance of class
+ *
+ * @return WC_Checkoutcom_Workflows
+ */
+ public static function get_instance(): WC_Checkoutcom_Workflows {
+ if ( null === self::$instance ) {
+ self::$instance = new WC_Checkoutcom_Workflows();
+ }
+
+ return self::$instance;
+ }
+
+ /**
+ * Check if webhook is registered.
+ *
+ * @param string $url Workflow URL.
+ *
+ * @return string|null
+ */
+ public function is_registered( $url = '' ): string {
+ $webhooks = $this->get_list();
+
+ if ( empty( $url ) ) {
+ $url = home_url( '/' );
+ }
+
+ foreach ( $webhooks as $item ) {
+
+ if ( false !== strpos( $item['name'], $url ) ) {
+ $this->url_is_registered = $item['name'];
+
+ return $this->url_is_registered;
+ }
+ }
+
+ return $this->url_is_registered;
+ }
+
+ /**
+ * Get list of all workflow.
+ *
+ * @return array|mixed
+ */
+ public function get_list() {
+
+ if ( $this->list ) {
+ return $this->list;
+ }
+
+ try {
+ $builder = $this->checkout->get_builder();
+
+ // Check if SDK was properly initialized
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot fetch workflows' );
+ return array();
+ }
+
+ $workflows = $builder->getWorkflowsClient()->getWorkflows();
+
+ if ( ! is_wp_error( $workflows ) && ! empty( $workflows ) ) {
+
+ if ( isset( $workflows['data'] ) && ! empty( $workflows['data'] ) ) {
+ $this->list = $workflows['data'];
+
+ return $this->list;
+ }
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = 'An error has occurred while processing workflow request. ';
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ }
+
+ return $this->list;
+ }
+
+ /**
+ * Get request args.
+ *
+ * @param array $args Request Arguments.
+ *
+ * @return array|object
+ */
+ private function get_request_args( $args = [] ) {
+
+ $defaults = [
+ 'headers' => [
+ 'Authorization' => $this->secret_key,
+ 'Content-Type' => 'application/json;charset=utf-8',
+ ],
+ 'timeout' => 30,
+ ];
+
+ return wp_parse_args( $args, $defaults );
+ }
+
+ /**
+ * Register new workflow.
+ *
+ * @param string $url Webhook URL.
+ *
+ * @return array|WP_Error
+ */
+ public function create( $url ) {
+
+ if ( empty( $url ) ) {
+ $url = WC_Checkoutcom_Webhook::get_instance()->generate_current_webhook_url();
+ }
+
+ // Check if SDK classes are available
+ if ( ! class_exists( 'Checkout\Workflows\Actions\WebhookSignature' ) ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK Workflow classes not found - cannot create webhook workflow' );
+ return array();
+ }
+
+ $signature = new WebhookSignature();
+ $signature->key = $this->secret_key;
+ $signature->method = 'HMACSHA256';
+
+ $action_request = new WebhookWorkflowActionRequest();
+ $action_request->url = $url;
+ $action_request->signature = $signature;
+
+ $event_workflow_condition_request = new EventWorkflowConditionRequest();
+ $event_workflow_condition_request->events = [
+ 'gateway' => [
+ 'card_verification_declined',
+ 'card_verified',
+ 'payment_approved',
+ 'payment_canceled',
+ 'payment_capture_declined',
+ 'payment_capture_pending',
+ 'payment_captured',
+ 'payment_declined',
+ 'payment_expired',
+ 'payment_paid',
+ 'payment_pending',
+ 'payment_refund_declined',
+ 'payment_refund_pending',
+ 'payment_refunded',
+ 'payment_void_declined',
+ 'payment_voided',
+ 'payment_authentication_failed',
+ // 'payment_authorized',
+ // 'payment_retry_scheduled',
+ // 'payment_returned',
+ ],
+ 'dispute' => [
+ 'dispute_canceled',
+ 'dispute_evidence_required',
+ 'dispute_expired',
+ 'dispute_lost',
+ 'dispute_resolved',
+ 'dispute_won',
+ ],
+ 'mbccards' => [
+ 'card_verification_declined',
+ 'card_verified',
+ 'payment_approved',
+ 'payment_capture_declined',
+ 'payment_captured',
+ 'payment_declined',
+ 'payment_refund_declined',
+ 'payment_refunded',
+ 'payment_void_declined',
+ 'payment_voided',
+ ],
+ 'card_payout' => [
+ 'payment_approved',
+ 'payment_declined',
+ ],
+ ];
+
+ $workflow_request = new CreateWorkflowRequest();
+ $workflow_request->actions = [ $action_request ];
+ $workflow_request->conditions = [ $event_workflow_condition_request ];
+ $workflow_request->name = $url;
+ $workflow_request->active = true;
+
+ $workflows = [];
+ try {
+ $builder = $this->checkout->get_builder();
+
+ // Check if SDK was properly initialized
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot create workflow' );
+ return array();
+ }
+
+ $workflows = $builder->getWorkflowsClient()->createWorkflow( $workflow_request );
+
+ if ( ! is_wp_error( $workflows ) && ! empty( $workflows ) ) {
+
+ if ( isset( $workflows['id'] ) ) {
+ return $workflows;
+ }
+ }
+ } catch ( CheckoutApiException $ex ) {
+ $gateway_debug = WC_Admin_Settings::get_option( 'cko_gateway_responses' ) === 'yes';
+
+ $error_message = esc_html__( 'An error has occurred while processing webhook request.', 'checkout-com-unified-payments-api' );
+
+ if ( $gateway_debug ) {
+ $error_message .= $ex->getMessage();
+ }
+
+ WC_Checkoutcom_Utility::logger( $error_message, $ex );
+ }
+
+ return $workflows;
+ }
+}
diff --git a/checkout-com-unified-payments-api/includes/subscription/class-wc-checkoutcom-subscription.php b/checkout-com-unified-payments-api/includes/subscription/class-wc-checkoutcom-subscription.php
new file mode 100644
index 00000000..3f1f2bb6
--- /dev/null
+++ b/checkout-com-unified-payments-api/includes/subscription/class-wc-checkoutcom-subscription.php
@@ -0,0 +1,186 @@
+ 'renewal' ] );
+ }
+
+ foreach ( $subscriptions_arr as $subscriptions_obj ) {
+ $args['source_id'] = $subscriptions_obj->get_meta( '_cko_source_id' );
+ $args['parent_order_id'] = $subscriptions_obj->get_parent_id();
+ $args['preferred_scheme'] = $subscriptions_obj->get_meta( '_cko_preferred_scheme' );
+ }
+
+ $payment_result = (array) WC_Checkoutcom_Api_Request::create_payment( $renewal_order, $args, 'renewal' );
+
+ // Update renewal order status based on payment result.
+ if ( ! isset( $payment_result['error'] ) ) {
+ self::update_order_status( $payment_result, $renewal_order );
+ }
+ }
+
+ /**
+ * Update status of renewal order and add notes
+ *
+ * @param array $payment_result Payment result.
+ * @param WC_Order $renewal_order Renewal order object.
+ */
+ public static function update_order_status( $payment_result, $renewal_order ) {
+ // Get renewal order ID.
+ $order_id = $renewal_order->get_id();
+
+ // Set action id as woo transaction id.
+ $renewal_order->set_transaction_id( $payment_result['action_id'] );
+ $renewal_order->update_meta_data( '_cko_payment_id', $payment_result['id'] );
+
+ // Set Authorize meta key to true if renewal order.
+ if ( in_array(
+ $renewal_order->get_meta( '_payment_method' ),
+ [
+ 'wc_checkout_com_google_pay',
+ 'wc_checkout_com_apple_pay',
+ 'wc_checkout_com_alternative_payments_sepa',
+ ],
+ true
+ ) ) {
+ $renewal_order->update_meta_data( 'cko_payment_authorized', true );
+ }
+
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
+ $message = sprintf(
+ /* translators: %s: Payment result ID. */
+ __( 'Checkout.com Payment Authorised - Action ID : %s ', 'checkout-com-unified-payments-api' ),
+ $payment_result['action_id']
+ );
+
+ // check if payment was flagged.
+ if ( $payment_result['risk']['flagged'] ) {
+ // Get cko auth status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_flagged', 'flagged' );
+ $message = sprintf(
+ /* translators: %s: Payment result ID. */
+ __( 'Checkout.com Payment Flagged - Action ID : %s ', 'checkout-com-unified-payments-api' ),
+ $payment_result['action_id']
+ );
+ }
+
+ // add notes for the order.
+ $renewal_order->add_order_note( $message );
+
+ $order_status = $renewal_order->get_status();
+
+ if ( 'pending' === $order_status ) {
+ $renewal_order->update_meta_data( 'cko_payment_authorized', true );
+ $renewal_order->update_status( $status );
+ }
+
+ // Reduce stock levels.
+ wc_reduce_stock_levels( $order_id );
+ }
+
+ /**
+ * Save source id for each order containing subscription
+ *
+ * @param int $order_id Order ID.
+ * @param object $order Order object.
+ * @param string $source_id Payment source ID.
+ */
+ public static function save_source_id( $order_id, $order, $source_id ) {
+ // update source id for subscription payment method change.
+ if ( $order instanceof WC_Subscription ) {
+ $order->update_meta_data( '_cko_source_id', $source_id );
+ $order->save();
+ }
+
+ // Check for subscription and save source id.
+ if ( function_exists( 'wcs_order_contains_subscription' ) ) {
+ if ( wcs_order_contains_subscription( $order_id ) ) {
+ $subscriptions = wcs_get_subscriptions_for_order( $order );
+
+ foreach ( $subscriptions as $subscription_obj ) {
+ $subscription_obj->update_meta_data( '_cko_source_id', $source_id );
+ $subscription_obj->save();
+ }
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Save source id for each order containing subscription
+ *
+ * @param WC_Subscription|WC_Order $subscription WC_Subscription.
+ *
+ * @return void
+ */
+ public static function subscription_cancelled( $subscription ) {
+
+ if ( 'wc_checkout_com_alternative_payments_sepa' === $subscription->get_payment_method() ) {
+
+ $mandate_cancel = $subscription->get_meta( '_cko_mandate_cancel' );
+
+ if ( $mandate_cancel ) {
+ $is_mandate_cancel = WC_Checkoutcom_Api_Request::mandate_cancel_request( $mandate_cancel, $subscription->get_id() );
+
+ if ( $is_mandate_cancel ) {
+ $subscription->add_order_note( 'Checkout.com mandate cancelled.', false );
+ } else {
+ $subscription->add_order_note( 'Checkout.com mandate already cancel or failed.', false );
+ }
+ }
+ }
+ }
+
+ /**
+ * Save mandate cancel URL to order meta.
+ *
+ * @param int $order_id Order ID.
+ * @param WC_Subscription $order Order object.
+ * @param string $url Mandate cancel URL.
+ *
+ * @return void
+ */
+ public static function save_mandate_cancel( $order_id, $order, $url ) {
+
+ if ( $order instanceof WC_Subscription ) {
+ $order->update_meta_data( '_cko_mandate_cancel', $url );
+ }
+
+ // check for subscription and save source id.
+ if ( function_exists( 'wcs_order_contains_subscription' ) ) {
+ if ( wcs_order_contains_subscription( $order_id ) ) {
+ $subscriptions = wcs_get_subscriptions_for_order( $order );
+
+ foreach ( $subscriptions as $subscription_obj ) {
+ $subscription_obj->update_meta_data( '_cko_mandate_cancel', $url );
+ }
+ }
+ }
+ }
+}
diff --git a/languages/README.md b/checkout-com-unified-payments-api/languages/README.md
similarity index 100%
rename from languages/README.md
rename to checkout-com-unified-payments-api/languages/README.md
diff --git a/languages/checkout-com-unified-payments-api.pot b/checkout-com-unified-payments-api/languages/checkout-com-unified-payments-api.pot
similarity index 100%
rename from languages/checkout-com-unified-payments-api.pot
rename to checkout-com-unified-payments-api/languages/checkout-com-unified-payments-api.pot
diff --git a/lib/class-checkout-sdk.php b/checkout-com-unified-payments-api/lib/class-checkout-sdk.php
similarity index 86%
rename from lib/class-checkout-sdk.php
rename to checkout-com-unified-payments-api/lib/class-checkout-sdk.php
index bca7ab26..b2d36157 100644
--- a/lib/class-checkout-sdk.php
+++ b/checkout-com-unified-payments-api/lib/class-checkout-sdk.php
@@ -38,6 +38,12 @@ class Checkout_SDK {
* @param bool $use_fallback Use Fallback account flag.
*/
public function __construct( $use_fallback = false ) {
+ // Check if SDK classes are available
+ if ( ! class_exists( 'Checkout\CheckoutSdk' ) ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK classes not found. Please ensure vendor/autoload.php is loaded.' );
+ return;
+ }
+
$core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
$environment = 'sandbox' === $core_settings['ckocom_environment'] ? Environment::sandbox() : Environment::production();
$subdomain = ! isset( $core_settings['ckocom_region'] ) ? '--' : $core_settings['ckocom_region'];
@@ -87,6 +93,10 @@ public function get_builder() {
* @return object
*/
public function get_payment_request() {
+ if ( ! class_exists( 'Checkout\CheckoutSdk' ) ) {
+ return null;
+ }
+
if ( $this->nas_account_type ) {
return new Checkout\Payments\Request\PaymentRequest();
} else {
@@ -100,6 +110,10 @@ public function get_payment_request() {
* @return object
*/
public function get_capture_request() {
+ if ( ! class_exists( 'Checkout\CheckoutSdk' ) ) {
+ return null;
+ }
+
if ( $this->nas_account_type ) {
return new Checkout\Payments\CaptureRequest();
} else {
diff --git a/readme.txt b/checkout-com-unified-payments-api/readme.txt
similarity index 93%
rename from readme.txt
rename to checkout-com-unified-payments-api/readme.txt
index 90304758..5a892f50 100644
--- a/readme.txt
+++ b/checkout-com-unified-payments-api/readme.txt
@@ -2,7 +2,7 @@
Contributors: checkoutintegration
Tags: checkout, payments, credit card, payment gateway, apple pay, google pay, payment request
Requires at least: 5.0
-Stable tag: trunk
+Stable tag: 5.0.0
Requires PHP: 7.3
Tested up to: 6.7.0
License: GPLv2 or later
@@ -35,6 +35,12 @@ Users can place orders with an Apple Pay wallet.
= PayPal Payments =
Users can place orders with an PayPal wallet.
+= PayPal Express Checkout =
+Users can place orders with PayPal Express checkout on product pages, shop pages, and cart pages without going through the full checkout process.
+
+= Google Pay Express Checkout =
+Users can place orders with Google Pay Express checkout on product pages, shop pages, and cart pages without going through the full checkout process. Express checkout options appear in a unified container on the cart page when both PayPal and Google Pay Express are enabled.
+
= Saved Cards Payments =
Users can place orders with a payment card saved in their account.
@@ -188,6 +194,15 @@ v4.8.0 30th October 2024
v4.7.0 12th July 2024
- **[tweak]** Upgrade Klarna integration
+v5.0.0_beta 4th November 2024
+- **[feat]** Add Google Pay Express Checkout (product, shop, cart pages)
+- **[feat]** Unified Express Checkout container for PayPal and Google Pay
+- **[feat]** Blocks cart support for Express Checkout
+- **[feat]** Classic cart support for Express Checkout
+- **[fix]** Fix duplicate Express Checkout containers on cart page
+- **[fix]** Fix inconsistent button sizes in unified container
+- **[fix]** Fix PHP syntax error in class-wc-checkoutcom-cards-blocks.php
+
v4.6.0 27th June 2024
- **[feat]** Upgrade PayPal with Express Checkout
- **[feat]** Update iDEAL APM with latest standard
diff --git a/templates/class-wc-checkoutcom-apm-templates.php b/checkout-com-unified-payments-api/templates/class-wc-checkoutcom-apm-templates.php
similarity index 100%
rename from templates/class-wc-checkoutcom-apm-templates.php
rename to checkout-com-unified-payments-api/templates/class-wc-checkoutcom-apm-templates.php
diff --git a/checkout-com-unified-payments-api/view-webhook-queue.php b/checkout-com-unified-payments-api/view-webhook-queue.php
new file mode 100644
index 00000000..3c66b9c2
--- /dev/null
+++ b/checkout-com-unified-payments-api/view-webhook-queue.php
@@ -0,0 +1,225 @@
+prefix . 'cko_pending_webhooks';
+
+// Check if running from command line
+$is_cli = php_sapi_name() === 'cli';
+
+if ($is_cli) {
+ // Command line output
+ echo "========================================\n";
+ echo "Webhook Queue Table Viewer\n";
+ echo "========================================\n\n";
+
+ // Check if table exists
+ $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'");
+
+ if (!$table_exists) {
+ echo "❌ Table '$table_name' does not exist.\n";
+ exit(1);
+ }
+
+ // Get statistics
+ $total = $wpdb->get_var("SELECT COUNT(*) FROM $table_name");
+ $pending = $wpdb->get_var("SELECT COUNT(*) FROM $table_name WHERE processed_at IS NULL");
+ $processed = $wpdb->get_var("SELECT COUNT(*) FROM $table_name WHERE processed_at IS NOT NULL");
+
+ echo "Statistics:\n";
+ echo " Total: $total\n";
+ echo " Pending: $pending\n";
+ echo " Processed: $processed\n\n";
+
+ // Get records
+ $records = $wpdb->get_results("SELECT * FROM $table_name ORDER BY created_at DESC LIMIT 20");
+
+ if (empty($records)) {
+ echo "No webhooks found.\n";
+ exit(0);
+ }
+
+ echo "Recent Webhooks (showing latest 20):\n";
+ echo str_repeat("=", 120) . "\n";
+
+ foreach ($records as $record) {
+ echo "ID: {$record->id}\n";
+ echo " Payment ID: {$record->payment_id}\n";
+ echo " Order ID: " . ($record->order_id ?: 'N/A') . "\n";
+ echo " Payment Session ID: " . ($record->payment_session_id ?: 'N/A') . "\n";
+ echo " Type: {$record->webhook_type}\n";
+ echo " Status: " . ($record->processed_at ? 'Processed' : 'Pending') . "\n";
+ echo " Created: {$record->created_at}\n";
+ if ($record->processed_at) {
+ echo " Processed: {$record->processed_at}\n";
+ }
+
+ // Show webhook data preview
+ $data = json_decode($record->webhook_data);
+ echo " Webhook Data: " . substr(json_encode($data, JSON_PRETTY_PRINT), 0, 200) . "...\n";
+ echo str_repeat("-", 120) . "\n";
+ }
+
+ echo "\nTo view full webhook data, use SQL query:\n";
+ echo "SELECT webhook_data FROM $table_name WHERE id = [ID];\n";
+
+} else {
+ // Browser output
+ ?>
+
+
+
+
+
+
+
+
+ get_row($wpdb->prepare("SELECT * FROM $table_name WHERE id = %d", $view_id));
+ if ($webhook):
+ ?>
+
+
+
+
+ version : 'UNKNOWN' ) ) );
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] PHP Version: ' . PHP_VERSION );
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] ========================================' );
+ $version_logged = true;
+ }
+
+ // Log during checkout processing
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_flow' === $_POST['payment_method'] ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] ========== CHECKOUT PROCESSING ==========' );
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] Payment method in POST: ' . sanitize_text_field( $_POST['payment_method'] ) );
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] Available payment gateways count: ' . count( $available_gateways ) );
+ }
+
+ // Always ensure Flow gateway is in the list if checkout mode is 'flow' and gateway is enabled
+ // This bypasses ALL other checks (country, currency, etc.) to ensure Flow is always available
+ $all_gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $all_gateways['wc_checkout_com_flow'] ) ) {
+ $flow_gateway = $all_gateways['wc_checkout_com_flow'];
+
+ // Check if gateway is enabled (basic check)
+ $is_enabled = isset( $flow_gateway->enabled ) && 'yes' === $flow_gateway->enabled;
+
+ if ( $is_enabled ) {
+ // Force add Flow gateway to available list REGARDLESS of other checks
+ // This ensures Flow is always available when enabled and checkout mode is 'flow'
+ $available_gateways['wc_checkout_com_flow'] = $flow_gateway;
+
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_flow' === $_POST['payment_method'] ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] FORCING Flow gateway into available gateways list!' );
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] Flow gateway enabled: ' . ( $is_enabled ? 'YES' : 'NO' ) );
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] Flow gateway is_available() result: ' . ( method_exists( $flow_gateway, 'is_available' ) ? ( $flow_gateway->is_available() ? 'TRUE' : 'FALSE' ) : 'METHOD NOT FOUND' ) );
+ if ( method_exists( $flow_gateway, 'valid_for_use' ) ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] Flow gateway valid_for_use() result: ' . ( $flow_gateway->valid_for_use() ? 'TRUE' : 'FALSE' ) );
+ }
+ }
+ } else {
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_flow' === $_POST['payment_method'] ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] Flow gateway is NOT enabled - not adding to available list' );
+ }
+ }
+ } else {
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_flow' === $_POST['payment_method'] ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] ERROR: Flow gateway does NOT exist in all gateways!' );
+ }
+ }
+
+ // Log final state
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_flow' === $_POST['payment_method'] ) {
+ if ( isset( $available_gateways['wc_checkout_com_flow'] ) ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] SUCCESS: Flow gateway IS in available gateways list!' );
+ } else {
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] CRITICAL: Flow gateway NOT in available gateways list after filter!' );
+ }
+ }
+ }
+ }
+ return $available_gateways;
+}, 1 );
+
+// Backup filter at priority 999 to ensure gateway is added AFTER WooCommerce's internal filtering
+// This catches cases where WooCommerce removes it between priority 1 and checkout processing
+add_filter( 'woocommerce_available_payment_gateways', function( $available_gateways ) {
+ // Only process if checkout mode is 'flow' and gateway is not already in list
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ if ( 'flow' === $checkout_mode && ! isset( $available_gateways['wc_checkout_com_flow'] ) ) {
+ $all_gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $all_gateways['wc_checkout_com_flow'] ) ) {
+ $flow_gateway = $all_gateways['wc_checkout_com_flow'];
+ if ( isset( $flow_gateway->enabled ) && 'yes' === $flow_gateway->enabled ) {
+ // Force add Flow gateway - this is a backup in case it was removed by WooCommerce or other plugins
+ $available_gateways['wc_checkout_com_flow'] = $flow_gateway;
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_flow' === $_POST['payment_method'] ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW DEBUG] BACKUP FILTER: Re-adding Flow gateway at priority 999' );
+ }
+ }
+ }
+ }
+
+ return $available_gateways;
+}, 999 );
+
+// Add hook to log before checkout process starts
+add_action( 'woocommerce_before_checkout_process', function() {
+ try {
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_flow' === $_POST['payment_method'] ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] ========== BEFORE CHECKOUT PROCESS ==========' );
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] Payment method in POST: ' . sanitize_text_field( $_POST['payment_method'] ) );
+
+ // Check available gateways at this point to see if our filter is working
+ if ( function_exists( 'WC' ) && WC() && method_exists( WC(), 'payment_gateways' ) ) {
+ $available_gateways = WC()->payment_gateways()->get_available_payment_gateways();
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] Available gateways before validation: ' . count( $available_gateways ) );
+ if ( isset( $available_gateways['wc_checkout_com_flow'] ) ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] SUCCESS: Flow gateway IS available before validation' );
+ } else {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] WARNING: Flow gateway NOT available before validation' );
+ }
+ }
+ }
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] ERROR in before_checkout_process hook: ' . $e->getMessage() );
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] ERROR stack trace: ' . $e->getTraceAsString() );
+ }
+}, 1 );
+
+// Add hook to log when WooCommerce validates payment method during checkout processing
+// Use try-catch to prevent fatal errors from breaking checkout
+add_action( 'woocommerce_checkout_process', function() {
+ try {
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_flow' === $_POST['payment_method'] ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] ========== WOOCOMMERCE CHECKOUT PROCESS ==========' );
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] Payment method in POST: ' . sanitize_text_field( $_POST['payment_method'] ) );
+
+ // Check if WooCommerce is available
+ if ( ! function_exists( 'WC' ) || ! WC() ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] WARNING: WooCommerce not available in checkout_process hook' );
+ return;
+ }
+
+ // Check if payment gateways is available
+ if ( ! method_exists( WC(), 'payment_gateways' ) ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] WARNING: payment_gateways() method not available' );
+ return;
+ }
+
+ // Check available gateways at this point
+ $available_gateways = WC()->payment_gateways()->get_available_payment_gateways();
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] Available payment gateways count: ' . count( $available_gateways ) );
+
+ if ( isset( $available_gateways['wc_checkout_com_flow'] ) ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] SUCCESS: Flow gateway IS available during checkout process' );
+ } else {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] ERROR: Flow gateway is NOT available during checkout process!' );
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] This is a SERVER-SIDE (PHP) validation error' );
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] Available gateways: ' . implode( ', ', array_keys( $available_gateways ) ) );
+ }
+ }
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] ERROR in checkout_process hook: ' . $e->getMessage() );
+ WC_Checkoutcom_Utility::logger( '[FLOW SERVER] ERROR stack trace: ' . $e->getTraceAsString() );
+ // Don't throw - just log the error to prevent breaking checkout
+ }
+}, 5 );
+
+// Additional hook to ensure order ID is updated in session after order creation
+// This handles cases where the order was replaced with an existing one
+add_action( 'woocommerce_new_order', function( $order_id ) {
+ // Only apply to Classic Cards payment method
+ if ( ! isset( $_POST['payment_method'] ) || 'wc_checkout_com_cards' !== $_POST['payment_method'] ) {
+ return;
+ }
+
+ // Check if there's a different order ID in session (meaning order was replaced)
+ if ( WC()->session ) {
+ $session_order_id = WC()->session->get( 'order_awaiting_payment' );
+ if ( ! empty( $session_order_id ) && $session_order_id != $order_id ) {
+ WC_Checkoutcom_Utility::logger( '[CLASSIC CARDS] Order ID mismatch detected - Session: ' . $session_order_id . ', New Order: ' . $order_id . ' - Order was likely replaced with existing one' );
+ }
+ }
+}, 5 );
+
+/**
+ * Constants.
+ */
+define( 'WC_CHECKOUTCOM_PLUGIN_VERSION', '5.0.0' );
+define( 'WC_CHECKOUTCOM_PLUGIN_URL', untrailingslashit( plugins_url( basename( plugin_dir_path( __FILE__ ) ), basename( __FILE__ ) ) ) );
+define( 'WC_CHECKOUTCOM_PLUGIN_PATH', untrailingslashit( plugin_dir_path( __FILE__ ) ) );
+
+/**
+ * This function registers our PHP class as a WooCommerce payment gateway.
+ */
+if ( ! function_exists( 'init_checkout_com_gateway_class' ) ) {
+add_action( 'plugins_loaded', 'init_checkout_com_gateway_class', 0 );
+ function init_checkout_com_gateway_class() {
+ if ( ! class_exists( 'WC_Payment_Gateway' ) ) {
+ return;
+ }
+
+ load_plugin_textdomain( 'checkout-com-unified-payments-api', false, plugin_basename( __DIR__ ) . '/languages' );
+
+ // Core payment gateway classes
+ include_once 'includes/class-wc-checkout-com-webhook.php';
+ include_once 'includes/class-wc-checkout-com-webhook-queue.php';
+
+ // Admin pages
+ if ( is_admin() ) {
+ include_once 'includes/admin/class-wc-checkoutcom-webhook-queue-admin.php';
+ }
+
+ // Note: You can also access the webhook queue table directly using:
+ // - view-webhook-queue.php script (command line or browser)
+ // - WordPress Admin: WooCommerce > Webhook Queue
+ // - Direct SQL queries to wp_cko_pending_webhooks table
+
+ // Create webhook queue table if it doesn't exist
+ if ( class_exists( 'WC_Checkout_Com_Webhook_Queue' ) ) {
+ WC_Checkout_Com_Webhook_Queue::create_table();
+
+ // Schedule cleanup of old webhooks (daily)
+ if ( ! wp_next_scheduled( 'cko_cleanup_old_webhooks' ) ) {
+ wp_schedule_event( time(), 'daily', 'cko_cleanup_old_webhooks' );
+ }
+ }
+
+ // Hook for cleanup of old webhooks
+ add_action( 'cko_cleanup_old_webhooks', function() {
+ if ( class_exists( 'WC_Checkout_Com_Webhook_Queue' ) ) {
+ // Cleanup processed webhooks older than 7 days
+ WC_Checkout_Com_Webhook_Queue::cleanup_old_webhooks( 7 );
+ // Cleanup unprocessed webhooks older than 7 days (orphaned)
+ WC_Checkout_Com_Webhook_Queue::cleanup_old_unprocessed_webhooks( 7 );
+ }
+ } );
+
+ include_once 'includes/class-wc-gateway-checkout-com-cards.php';
+ include_once 'includes/class-wc-gateway-checkout-com-apple-pay.php';
+
+ // Register Apple Pay CSR generation AJAX handler early
+ // Use a wrapper function to ensure it's always available
+ if ( class_exists( 'WC_Gateway_Checkout_Com_Apple_Pay' ) ) {
+ add_action( 'wp_ajax_cko_generate_apple_pay_csr', 'cko_ajax_generate_apple_pay_csr' );
+ add_action( 'wp_ajax_cko_upload_apple_pay_certificate', 'cko_ajax_upload_apple_pay_certificate' );
+ add_action( 'wp_ajax_cko_generate_apple_pay_merchant_certificate', 'cko_ajax_generate_apple_pay_merchant_certificate' );
+ add_action( 'wp_ajax_cko_upload_apple_pay_domain_association', 'cko_ajax_upload_apple_pay_domain_association' );
+ add_action( 'wp_ajax_cko_generate_apple_pay_merchant_identity_csr', 'cko_ajax_generate_apple_pay_merchant_identity_csr' );
+ add_action( 'wp_ajax_cko_upload_apple_pay_merchant_identity_certificate', 'cko_ajax_upload_apple_pay_merchant_identity_certificate' );
+ add_action( 'wp_ajax_cko_test_apple_pay_certificate', 'cko_ajax_test_apple_pay_certificate' );
+ }
+
+ include_once 'includes/class-wc-gateway-checkout-com-google-pay.php';
+ include_once 'includes/class-wc-gateway-checkout-com-paypal.php';
+ include_once 'includes/class-wc-gateway-checkout-com-alternative-payments.php';
+
+ // Flow integration
+ include_once 'flow-integration/class-wc-gateway-checkout-com-flow.php';
+
+ // Unified Express Checkout Element Handler
+ include_once 'includes/express/class-wc-checkoutcom-express-checkout-element.php';
+
+ // Initialize unified express checkout element
+ if ( class_exists( 'WC_Checkoutcom_Express_Checkout_Element' ) ) {
+ $express_checkout_element = new WC_Checkoutcom_Express_Checkout_Element();
+ $express_checkout_element->init();
+ }
+
+ // Enhanced logging classes (commented out temporarily)
+ // include_once 'includes/logging/class-wc-checkoutcom-enhanced-logger.php';
+ // include_once 'includes/logging/class-wc-checkoutcom-log-manager.php';
+ // include_once 'includes/logging/class-wc-checkoutcom-performance-monitor.php';
+ // include_once 'includes/settings/class-wc-checkoutcom-logging-settings.php';
+
+ // Initialize enhanced logging (commented out temporarily)
+ // WC_Checkoutcom_Logging_Settings::init();
+
+ // WooCommerce Blocks integration (safe/conditional)
+ // Check for safe version first, fallback to regular version
+ $blocks_safe_file = __DIR__ . '/includes/blocks/class-wc-checkoutcom-blocks-integration-safe.php';
+ $blocks_file = __DIR__ . '/includes/blocks/class-wc-checkoutcom-blocks-integration.php';
+
+ if ( file_exists( $blocks_safe_file ) ) {
+ include_once $blocks_safe_file;
+ } elseif ( file_exists( $blocks_file ) ) {
+ include_once $blocks_file;
+ } else {
+ // Log error but don't break the site - Blocks integration is optional
+ error_log( 'Checkout.com Blocks integration file not found. Expected: ' . $blocks_file );
+ }
+
+ // Load payment gateway class.
+ add_filter( 'woocommerce_payment_gateways', 'checkout_com_add_gateway' );
+ }
+}
+
+/**
+ * Make billing details read-only on order-pay page
+ * This ensures customers can't modify billing information that was set when the order was created
+ */
+if ( ! function_exists( 'cko_make_order_pay_billing_readonly' ) ) {
+add_action( 'wp_enqueue_scripts', 'cko_make_order_pay_billing_readonly' );
+function cko_make_order_pay_billing_readonly() {
+ // Only on order-pay page
+ if ( ! is_wc_endpoint_url( 'order-pay' ) ) {
+ return;
+ }
+
+ // Add CSS to make billing details read-only
+ wp_add_inline_style( 'woocommerce-general', '
+ .woocommerce-order-pay #billing_first_name,
+ .woocommerce-order-pay #billing_last_name,
+ .woocommerce-order-pay #billing_company,
+ .woocommerce-order-pay #billing_address_1,
+ .woocommerce-order-pay #billing_address_2,
+ .woocommerce-order-pay #billing_city,
+ .woocommerce-order-pay #billing_state,
+ .woocommerce-order-pay #billing_postcode,
+ .woocommerce-order-pay #billing_country,
+ .woocommerce-order-pay #billing_phone,
+ .woocommerce-order-pay #billing_email,
+ .woocommerce-order-pay .woocommerce-billing-fields input,
+ .woocommerce-order-pay .woocommerce-billing-fields select,
+ .woocommerce-order-pay .woocommerce-billing-fields textarea {
+ background-color: #f9f9f9 !important;
+ border: 1px solid #ddd !important;
+ color: #666 !important;
+ cursor: not-allowed !important;
+ pointer-events: none !important;
+ opacity: 0.7 !important;
+ }
+ .woocommerce-order-pay .woocommerce-billing-fields label {
+ color: #666 !important;
+ font-weight: normal !important;
+ }
+ .woocommerce-order-pay .woocommerce-billing-fields h3::after {
+ content: " (from your order - read only)";
+ font-size: 12px;
+ font-weight: normal;
+ color: #999;
+ }
+ ' );
+
+ // Add JavaScript to disable billing fields
+ wp_add_inline_script( 'wc-checkout', '
+ jQuery(document).ready(function($) {
+ console.log("🔥🔥🔥 [CKO DEBUG] Order-pay page detected - making billing fields read-only 🔥🔥🔥");
+
+ // Disable all billing fields
+ var billingFields = $("#billing_first_name, #billing_last_name, #billing_company, #billing_address_1, #billing_address_2, #billing_city, #billing_state, #billing_postcode, #billing_country, #billing_phone, #billing_email");
+ console.log("[CKO DEBUG] Found billing fields:", billingFields.length);
+ billingFields.prop("disabled", true);
+
+ // Also disable any selects in billing fields
+ var billingSelects = $(".woocommerce-billing-fields select");
+ console.log("[CKO DEBUG] Found billing selects:", billingSelects.length);
+ billingSelects.prop("disabled", true);
+
+ console.log("[CKO DEBUG] Billing fields disabled successfully on order-pay page");
+ });
+ ' );
+ }
+}
+
+
+
+/**
+ * Declare compatibility with HPOS.
+ * https://github.com/woocommerce/woocommerce/wiki/High-Performance-Order-Storage-Upgrade-Recipe-Book#declaring-extension-incompatibility
+ */
+add_action(
+ 'before_woocommerce_init',
+ function () {
+ if ( class_exists( '\Automattic\WooCommerce\Utilities\FeaturesUtil' ) ) {
+ \Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility( 'custom_order_tables', __FILE__, true );
+ }
+ }
+);
+
+
+/**
+ * AJAX handler wrapper for Apple Pay CSR generation.
+ * This ensures the handler is always available, even if the gateway class isn't fully instantiated.
+ */
+if ( ! function_exists( 'cko_ajax_generate_apple_pay_csr' ) ) {
+ function cko_ajax_generate_apple_pay_csr() {
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Apple_Pay' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Apple Pay gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get the gateway instance
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_apple_pay'] ) ) {
+ $gateways['wc_checkout_com_apple_pay']->ajax_generate_csr();
+ } else {
+ // Fallback: create a temporary instance
+ $gateway = new WC_Gateway_Checkout_Com_Apple_Pay();
+ $gateway->ajax_generate_csr();
+ }
+ }
+}
+
+/**
+ * AJAX handler wrapper for Apple Pay certificate upload.
+ * This ensures the handler is always available, even if the gateway class isn't fully instantiated.
+ */
+if ( ! function_exists( 'cko_ajax_upload_apple_pay_certificate' ) ) {
+ function cko_ajax_upload_apple_pay_certificate() {
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Apple_Pay' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Apple Pay gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get the gateway instance
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_apple_pay'] ) ) {
+ $gateways['wc_checkout_com_apple_pay']->ajax_upload_certificate();
+ } else {
+ // Fallback: create a temporary instance
+ $gateway = new WC_Gateway_Checkout_Com_Apple_Pay();
+ $gateway->ajax_upload_certificate();
+ }
+ }
+}
+
+/**
+ * AJAX handler wrapper for Apple Pay merchant certificate generation.
+ * This ensures the handler is always available, even if the gateway class isn't fully instantiated.
+ */
+if ( ! function_exists( 'cko_ajax_generate_apple_pay_merchant_certificate' ) ) {
+ function cko_ajax_generate_apple_pay_merchant_certificate() {
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Apple_Pay' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Apple Pay gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get the gateway instance
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_apple_pay'] ) ) {
+ $gateways['wc_checkout_com_apple_pay']->ajax_generate_merchant_certificate();
+ } else {
+ // Fallback: create a temporary instance
+ $gateway = new WC_Gateway_Checkout_Com_Apple_Pay();
+ $gateway->ajax_generate_merchant_certificate();
+ }
+ }
+}
+
+/**
+ * AJAX handler wrapper for Apple Pay domain association upload.
+ */
+if ( ! function_exists( 'cko_ajax_upload_apple_pay_domain_association' ) ) {
+ function cko_ajax_upload_apple_pay_domain_association() {
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Apple_Pay' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Apple Pay gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_apple_pay'] ) ) {
+ $gateways['wc_checkout_com_apple_pay']->ajax_upload_domain_association();
+ } else {
+ $gateway = new WC_Gateway_Checkout_Com_Apple_Pay();
+ $gateway->ajax_upload_domain_association();
+ }
+ }
+}
+
+/**
+ * AJAX handler wrapper for Apple Pay merchant identity CSR generation.
+ */
+if ( ! function_exists( 'cko_ajax_generate_apple_pay_merchant_identity_csr' ) ) {
+ function cko_ajax_generate_apple_pay_merchant_identity_csr() {
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Apple_Pay' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Apple Pay gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_apple_pay'] ) ) {
+ $gateways['wc_checkout_com_apple_pay']->ajax_generate_merchant_identity_csr();
+ } else {
+ $gateway = new WC_Gateway_Checkout_Com_Apple_Pay();
+ $gateway->ajax_generate_merchant_identity_csr();
+ }
+ }
+}
+
+/**
+ * AJAX handler wrapper for Apple Pay merchant identity certificate upload.
+ */
+if ( ! function_exists( 'cko_ajax_upload_apple_pay_merchant_identity_certificate' ) ) {
+ function cko_ajax_upload_apple_pay_merchant_identity_certificate() {
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Apple_Pay' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Apple Pay gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_apple_pay'] ) ) {
+ $gateways['wc_checkout_com_apple_pay']->ajax_upload_merchant_identity_certificate();
+ } else {
+ $gateway = new WC_Gateway_Checkout_Com_Apple_Pay();
+ $gateway->ajax_upload_merchant_identity_certificate();
+ }
+ }
+}
+
+/**
+ * AJAX handler wrapper for Apple Pay certificate testing.
+ */
+if ( ! function_exists( 'cko_ajax_test_apple_pay_certificate' ) ) {
+ function cko_ajax_test_apple_pay_certificate() {
+ if ( ! class_exists( 'WC_Gateway_Checkout_Com_Apple_Pay' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Apple Pay gateway class not found.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $gateways = WC()->payment_gateways()->payment_gateways();
+ if ( isset( $gateways['wc_checkout_com_apple_pay'] ) ) {
+ $gateways['wc_checkout_com_apple_pay']->ajax_test_certificate();
+ } else {
+ $gateway = new WC_Gateway_Checkout_Com_Apple_Pay();
+ $gateway->ajax_test_certificate();
+ }
+ }
+}
+
+/**
+ * Add payment method class to WooCommerce.
+ *
+ * @param array $methods Array of payment methods.
+ *
+ * @return array
+ */
+function checkout_com_add_gateway( $methods ) {
+
+ $array = get_selected_apms_class();
+
+ $methods[] = 'WC_Gateway_Checkout_Com_Cards';
+ $methods[] = 'WC_Gateway_Checkout_Com_Apple_Pay';
+ $methods[] = 'WC_Gateway_Checkout_Com_Google_Pay';
+ $methods[] = 'WC_Gateway_Checkout_Com_PayPal';
+ $methods[] = 'WC_Gateway_Checkout_Com_Alternative_Payments';
+ $methods[] = 'WC_Gateway_Checkout_Com_Flow';
+
+ $methods = sizeof( $array ) > 0 ? array_merge( $methods, $array ) : $methods;
+
+ return $methods;
+}
+
+/**
+ * Filter payment gateways in admin settings to show only one "Checkout.com" entry
+ * based on checkout mode (Flow or Classic).
+ *
+ * This filter only affects the display in WooCommerce > Settings > Payments.
+ * All gateways remain registered in the system for functionality.
+ *
+ * For existing environments: This will hide duplicate entries in the settings page
+ * while preserving all gateway registrations in the database.
+ */
+add_filter( 'woocommerce_payment_gateways', 'checkout_com_filter_admin_gateways', 20 );
+function checkout_com_filter_admin_gateways( $gateways ) {
+ // Only filter in admin settings page (WooCommerce > Settings > Payments)
+ if ( ! is_admin() || ! isset( $_GET['page'] ) || 'wc-settings' !== $_GET['page'] || ! isset( $_GET['tab'] ) || 'checkout' !== $_GET['tab'] ) {
+ return $gateways;
+ }
+
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ // Get all Checkout.com gateway IDs
+ $cko_gateway_ids = array(
+ 'wc_checkout_com_cards',
+ 'wc_checkout_com_apple_pay',
+ 'wc_checkout_com_google_pay',
+ 'wc_checkout_com_paypal',
+ 'wc_checkout_com_flow',
+ );
+
+ // Add alternative payments gateways (if any are enabled)
+ $apms_settings = get_option( 'woocommerce_wc_checkout_com_alternative_payments_settings', array() );
+ if ( ! empty( $apms_settings['enabled'] ) && 'yes' === $apms_settings['enabled'] ) {
+ $apm_selected = ! empty( $apms_settings['ckocom_apms_selector'] ) ? $apms_settings['ckocom_apms_selector'] : array();
+ foreach ( $apm_selected as $value ) {
+ $cko_gateway_ids[] = 'wc_checkout_com_alternative_payments_' . $value;
+ }
+ }
+
+ // Filter based on checkout mode
+ if ( 'flow' === $checkout_mode ) {
+ // In Flow mode: Only show Flow gateway in settings
+ foreach ( $cko_gateway_ids as $gateway_id ) {
+ if ( 'wc_checkout_com_flow' !== $gateway_id && isset( $gateways[ $gateway_id ] ) ) {
+ unset( $gateways[ $gateway_id ] );
+ }
+ }
+ } else {
+ // In Classic mode: Only show Cards gateway in settings, hide others
+ foreach ( $cko_gateway_ids as $gateway_id ) {
+ if ( 'wc_checkout_com_cards' !== $gateway_id && isset( $gateways[ $gateway_id ] ) ) {
+ unset( $gateways[ $gateway_id ] );
+ }
+ }
+ }
+
+ return $gateways;
+}
+
+/**
+ * Return the class name of the apm selected.
+ *
+ * @return array
+ */
+function get_selected_apms_class() {
+
+ $apms_settings = get_option( 'woocommerce_wc_checkout_com_alternative_payments_settings' );
+ $selected_apms_class = [];
+
+ // Check if alternative payment method is enabled.
+ if ( ! empty( $apms_settings['enabled'] ) && 'yes' === $apms_settings['enabled'] ) {
+ $apm_selected = ! empty( $apms_settings['ckocom_apms_selector'] ) ? $apms_settings['ckocom_apms_selector'] : [];
+
+ // Get apm selected and add the class name in array.
+ foreach ( $apm_selected as $value ) {
+ $selected_apms_class[] = 'WC_Gateway_Checkout_Com_Alternative_Payments' . '_' . $value;
+ }
+ }
+
+ return $selected_apms_class;
+}
+
+add_filter( 'plugin_action_links_' . plugin_basename( __FILE__ ), 'checkout_com_action_links' );
+
+/**
+ * Add settings link.
+ *
+ * @param mixed $links Plugin Action links.
+ *
+ * @return array
+ */
+function checkout_com_action_links( $links ) {
+ $plugin_links = [
+ '' . __( 'Settings', 'checkout-com-unified-payments-api' ) . '',
+ ];
+
+ return array_merge( $plugin_links, $links );
+}
+
+// This action will register flagged order status in woocommerce.
+add_action( 'init', 'register_cko_new_order_statuses' );
+
+/**
+ * Register flagged order status.
+ */
+function register_cko_new_order_statuses() {
+ register_post_status(
+ 'wc-flagged',
+ [
+ 'label' => _x( 'Suspected Fraud', 'Order status', 'checkout-com-unified-payments-api' ),
+ 'public' => true,
+ 'exclude_from_search' => false,
+ 'show_in_admin_all_list' => true,
+ 'show_in_admin_status_list' => true,
+ /* translators: %s: number of orders */
+ 'label_count' => _n_noop( 'Suspected Fraud (%s)', 'Suspected Frauds (%s)', 'checkout-com-unified-payments-api' ),
+ ]
+ );
+}
+
+
+add_filter( 'wc_order_statuses', 'my_new_wc_order_statuses' );
+
+/**
+ * Register flagged status in wc_order_statuses.
+ *
+ * @param array $order_statuses Array of order statuses.
+ *
+ * @return array
+ */
+function my_new_wc_order_statuses( $order_statuses ) {
+ $order_statuses['wc-flagged'] = _x( 'Suspected Fraud', 'Order status', 'checkout-com-unified-payments-api' );
+
+ return $order_statuses;
+}
+
+add_action( 'woocommerce_checkout_process', 'cko_check_if_empty' );
+
+/**
+ * Validate cvv on checkout page.
+ */
+function cko_check_if_empty() {
+ // phpcs:disable WordPress.Security.NonceVerification.Missing
+ if ( isset( $_POST['payment_method'] ) && 'wc_checkout_com_cards' === $_POST['payment_method'] ) {
+
+ // Check if require cvv is enabled in module setting.
+ if (
+ WC_Admin_Settings::get_option( 'ckocom_card_saved' )
+ && WC_Admin_Settings::get_option( 'ckocom_card_require_cvv' )
+ && isset( $_POST['wc-wc_checkout_com_cards-payment-token'] )
+ && 'new' !== $_POST['wc-wc_checkout_com_cards-payment-token']
+ ) {
+ // check if cvv is empty on checkout page.
+ if ( empty( $_POST['wc_checkout_com_cards-card-cvv'] ) ) {
+ // phpcs:enable
+ wc_add_notice( esc_html__( 'Please enter a valid cvv.', 'checkout-com-unified-payments-api' ), 'error' );
+ }
+ }
+ }
+}
+
+// Hook into order creation and updates
+add_action( 'woocommerce_new_order', 'cko_validate_manual_order_creation' );
+add_action( 'woocommerce_update_order', 'cko_validate_manual_order_creation' );
+add_action( 'save_post', 'cko_validate_manual_order_on_save' );
+add_action( 'admin_init', 'cko_check_incomplete_orders' );
+
+/**
+ * Validate manual order creation to ensure billing address and email are set.
+ * This prevents issues when using Flow payment on order-pay page.
+ *
+ * @param int $order_id Order ID.
+ */
+function cko_validate_manual_order_creation( $order_id ) {
+ $order = wc_get_order( $order_id );
+
+ // Only validate admin-created orders (manual orders)
+ if ( ! $order || ! $order->is_created_via( 'admin' ) ) {
+ return;
+ }
+
+ // Log for debugging
+ WC_Checkoutcom_Utility::logger( 'Validating manual order creation. Order ID: ' . $order_id );
+
+ // Check if billing email is missing or invalid
+ $billing_email = $order->get_billing_email();
+ if ( empty( $billing_email ) || ! is_email( $billing_email ) ) {
+ // Log the issue
+ WC_Checkoutcom_Utility::logger( 'Manual order created without valid billing email. Order ID: ' . $order_id );
+
+ // Set a transient to show notice on next admin page load
+ set_transient( 'cko_validation_email_' . $order_id, true, 60 );
+ }
+
+ // Check if billing address is missing
+ $billing_address_1 = $order->get_billing_address_1();
+ $billing_city = $order->get_billing_city();
+ $billing_country = $order->get_billing_country();
+
+ if ( empty( $billing_address_1 ) || empty( $billing_city ) || empty( $billing_country ) ) {
+ // Log the issue
+ WC_Checkoutcom_Utility::logger( 'Manual order created without complete billing address. Order ID: ' . $order_id );
+
+ // Set a transient to show notice on next admin page load
+ set_transient( 'cko_validation_address_' . $order_id, true, 60 );
+ }
+}
+
+/**
+ * Validate order when saved via admin (different hook)
+ *
+ * @param int $post_id Post ID.
+ */
+function cko_validate_manual_order_on_save( $post_id ) {
+ // Only process shop_order posts
+ if ( get_post_type( $post_id ) !== 'shop_order' ) {
+ return;
+ }
+
+ $order = wc_get_order( $post_id );
+
+ // Only validate admin-created orders (manual orders)
+ if ( ! $order || ! $order->is_created_via( 'admin' ) ) {
+ return;
+ }
+
+ // Log for debugging
+ WC_Checkoutcom_Utility::logger( 'Validating manual order on save. Order ID: ' . $post_id );
+
+ $validation_errors = array();
+
+ // Check if billing email is missing or invalid
+ $billing_email = $order->get_billing_email();
+ if ( empty( $billing_email ) || ! is_email( $billing_email ) ) {
+ $validation_errors[] = __( 'Billing email is required for Flow payments to work properly.', 'checkout-com-unified-payments-api' );
+ WC_Checkoutcom_Utility::logger( 'Manual order saved without valid billing email. Order ID: ' . $post_id );
+ }
+
+ // Check if billing address is missing
+ $billing_address_1 = $order->get_billing_address_1();
+ $billing_city = $order->get_billing_city();
+ $billing_country = $order->get_billing_country();
+
+ if ( empty( $billing_address_1 ) || empty( $billing_city ) || empty( $billing_country ) ) {
+ $validation_errors[] = __( 'Complete billing address is required for Flow payments to work properly.', 'checkout-com-unified-payments-api' );
+ WC_Checkoutcom_Utility::logger( 'Manual order saved without complete billing address. Order ID: ' . $post_id );
+ }
+
+ // If there are validation errors, prevent saving and show error
+ if ( ! empty( $validation_errors ) ) {
+ // Log the blocking
+ WC_Checkoutcom_Utility::logger( 'BLOCKING order creation due to validation errors: ' . implode( ', ', $validation_errors ) );
+
+ // Show error message and stop execution
+ $error_message = 'Webhook Queue Table - Direct Access
+ + get_var("SHOW TABLES LIKE '$table_name'"); + + if (!$table_exists) { + echo "❌ Table '$table_name' does not exist.
"; + exit; + } + + // Get statistics + $total = $wpdb->get_var("SELECT COUNT(*) FROM $table_name"); + $pending = $wpdb->get_var("SELECT COUNT(*) FROM $table_name WHERE processed_at IS NULL"); + $processed = $wpdb->get_var("SELECT COUNT(*) FROM $table_name WHERE processed_at IS NOT NULL"); + ?> + +
+
+
+
+ Total:
+
+
+ Pending:
+
+
+ Processed:
+
+ Recent Webhooks
+ + get_results($wpdb->prepare( + "SELECT * FROM $table_name ORDER BY created_at DESC LIMIT %d", + $limit + )); + + if (empty($records)) { + echo "No webhooks found.
"; + } else { + ?> +| ID | +Payment ID | +Order ID | +Session ID | +Type | +Status | +Created | +Processed | +Actions | +
|---|---|---|---|---|---|---|---|---|
| id); ?> | +payment_id); ?> |
+ order_id ?: '—'); ?> | +payment_session_id ?: '—'); ?> |
+ webhook_type); ?> | ++ processed_at): ?> + Processed + + Pending + + | +created_at); ?> | +processed_at ?: '—'); ?> | ++ View JSON + | +
Full Webhook Data (ID: )
+webhook_data), JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES)); ?>+ + + +
+ Show 100 | + Show 200 | + Show 500 +
+ + ++
SQL Queries
+You can also run these SQL queries directly:
++-- View all pending webhooks +SELECT * FROM WHERE processed_at IS NULL ORDER BY created_at DESC; + +-- View all processed webhooks +SELECT * FROM WHERE processed_at IS NOT NULL ORDER BY processed_at DESC; + +-- View webhook by payment ID +SELECT * FROM WHERE payment_id = 'pay_xxx'; + +-- View webhook by order ID +SELECT * FROM WHERE order_id = '12345'; + +-- Count by type +SELECT webhook_type, COUNT(*) as count FROM GROUP BY webhook_type; ++
❌ Order Creation Blocked
'; + $error_message .= 'Checkout.com Flow: Cannot create order with missing required information.
'; + $error_message .= '- ';
+ foreach ( $validation_errors as $error ) {
+ $error_message .= '
- ' . esc_html( $error ) . ' '; + } + $error_message .= '
Please:
'; + $error_message .= '- ';
+ $error_message .= '
- Go back to the order form '; + $error_message .= '
- Add the missing billing email and address '; + $error_message .= '
- Try creating the order again '; + $error_message .= '
';
+ echo '
';
+ });
+ }
+}
+
+// Show admin notices based on transients
+add_action( 'admin_notices', 'cko_show_validation_notices' );
+
+/**
+ * Show validation notices in admin
+ */
+function cko_show_validation_notices() {
+ // Get current order ID if we're on an order edit page
+ global $post;
+ $order_id = 0;
+
+ if ( isset( $_GET['post'] ) && get_post_type( $_GET['post'] ) === 'shop_order' ) {
+ $order_id = intval( $_GET['post'] );
+ } elseif ( $post && $post->post_type === 'shop_order' ) {
+ $order_id = $post->ID;
+ }
+
+ if ( ! $order_id ) {
+ return;
+ }
+
+ // Check for email validation notice
+ if ( get_transient( 'cko_validation_email_' . $order_id ) ) {
+ delete_transient( 'cko_validation_email_' . $order_id );
+ echo '⚠️ Checkout.com Flow Warning: '; + echo 'This manual order is missing: ' . implode( ', ', $missing_fields ) . '. '; + echo 'Flow payments will fail without this information. '; + echo 'Please complete the order details before proceeding with payment.'; + echo '
';
+ echo '
';
+ }
+
+ // Check for address validation notice
+ if ( get_transient( 'cko_validation_address_' . $order_id ) ) {
+ delete_transient( 'cko_validation_address_' . $order_id );
+ echo 'Checkout.com Flow: '; + echo esc_html__( 'Manual orders require a valid billing email address for Flow payments to work properly. Please add a billing email to this order.', 'checkout-com-unified-payments-api' ); + echo ' ' . esc_html__( 'Edit Order', 'checkout-com-unified-payments-api' ) . ''; + echo '
';
+ echo '
';
+ }
+}
+
+add_action( 'admin_enqueue_scripts', 'cko_admin_enqueue_scripts' );
+
+/**
+ * Load admin scripts.
+ *
+ * @return void
+ */
+function cko_admin_enqueue_scripts() {
+
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = $core_settings['ckocom_checkout_mode'];
+ $flow_enabled = false;
+
+ if( $checkout_mode === 'flow' ) {
+ $flow_enabled = true;
+ }
+
+ // Load admin scripts.
+ wp_enqueue_script( 'cko-admin-script', WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin.js', [ 'jquery' ], WC_CHECKOUTCOM_PLUGIN_VERSION );
+
+ $vars = [
+ 'nas_docs' => 'https://www.checkout.com/docs/four/resources/api-authentication/api-keys',
+ 'abc_docs' => 'https://www.checkout.com/docs/the-hub/update-your-hub-settings#Manage_the_API_keys',
+
+ 'webhook_check_error' => esc_html__( 'An error occurred while fetching the webhooks. Please try again.', 'checkout-com-unified-payments-api' ),
+ 'webhook_register_error' => esc_html__( 'An error occurred while registering the webhook. Please try again.', 'checkout-com-unified-payments-api' ),
+
+ 'checkoutcom_check_webhook_nonce' => wp_create_nonce( 'checkoutcom_check_webhook' ),
+ 'checkoutcom_register_webhook_nonce' => wp_create_nonce( 'checkoutcom_register_webhook' ),
+
+ 'flow_enabled' => $flow_enabled,
+ ];
+
+ wp_localize_script( 'cko-admin-script', 'cko_admin_vars', $vars );
+}
+
+add_action( 'wp_enqueue_scripts', 'callback_for_setting_up_scripts' );
+
+/**
+ * Load checkout.com style sheet.
+ * Load Google Pay js.
+ *
+ * Only on Checkout related pages.
+ */
+function callback_for_setting_up_scripts() {
+
+ // Load on Cart, Checkout, pay for order or add payment method pages.
+ if ( ! is_cart() && ! is_checkout() && ! isset( $_GET['pay_for_order'] ) && ! is_add_payment_method_page() ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
+ return;
+ }
+
+ // Register adn enqueue checkout css.
+ wp_register_style( 'checkoutcom-style', WC_CHECKOUTCOM_PLUGIN_URL . '/assets/css/checkoutcom-styles.css', [], WC_CHECKOUTCOM_PLUGIN_VERSION );
+ wp_register_style( 'normalize', WC_CHECKOUTCOM_PLUGIN_URL . '/assets/css/normalize.css', [], WC_CHECKOUTCOM_PLUGIN_VERSION );
+ wp_enqueue_style( 'checkoutcom-style' );
+ wp_enqueue_style( 'normalize' );
+
+ // load cko apm settings.
+ $apm_settings = get_option( 'woocommerce_wc_checkout_com_alternative_payments_settings' );
+ $apm_enable = ! empty( $apm_settings['enabled'] ) && 'yes' === $apm_settings['enabled'];
+
+ if ( $apm_enable && ! empty( $apm_settings['ckocom_apms_selector'] ) ) {
+ foreach ( $apm_settings['ckocom_apms_selector'] as $value ) {
+ if ( 'klarna' === $value ) {
+ wp_enqueue_script( 'cko-klarna-script', 'https://x.klarnacdn.net/kp/lib/v1/api.js', [ 'jquery' ] );
+ }
+ }
+ }
+
+ // Enqueue FLOW scripts.
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = $core_settings['ckocom_checkout_mode'];
+ $flow_customization = get_option( 'woocommerce_wc_checkout_com_flow_settings', array() );
+
+ // Ensure flow_component_name is always set with a default value
+ if ( empty( $flow_customization['flow_component_name'] ) ) {
+ $flow_customization['flow_component_name'] = 'flow';
+ }
+
+ if ( 'flow' === $checkout_mode ) {
+ // Add resource hints for faster DNS resolution and connection to Checkout.com
+ add_action( 'wp_head', function() use ( $core_settings ) {
+ $environment = $core_settings['ckocom_environment'] ?? 'sandbox';
+ $api_domain = 'sandbox' === $environment ? 'api.sandbox.checkout.com' : 'api.checkout.com';
+ ?>
+
+
+
+
+
+
+
+
+ version : null;
+ } else {
+ $woo_version = null;
+ }
+
+ $udf5 = sprintf(
+ 'Platform Data - WordPress %s / Woocommerce %s, Integration Data - Checkout.com %s, SDK Data - PHP SDK %s, Server - %s',
+ $wp_version,
+ $woo_version,
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ ( class_exists('Checkout\\CheckoutUtils') && defined('Checkout\\CheckoutUtils::PROJECT_VERSION') ) ? \Checkout\CheckoutUtils::PROJECT_VERSION : 'unknown',
+ get_site_url()
+ );
+
+ $regular_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$regular : 'Regular';
+ $recurring_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$recurring : 'Recurring';
+
+ $ref_session = is_array( WC()->session->get_session_cookie() ) ? substr( WC()->session->get_session_cookie()[3], 0, 25 ) : '';
+ $ref_session = preg_match( '/^[a-zA-Z0-9]{25}$/', $ref_session ) ? $ref_session : substr( bin2hex( random_bytes(13) ), 0, 25 );
+
+
+ // Get 3DS settings
+ $three_d_enabled = '1' === WC_Admin_Settings::get_option( 'ckocom_card_threed', '0' );
+ $attempt_no_three_d = '1' === WC_Admin_Settings::get_option( 'ckocom_card_notheed', '0' );
+ $save_card = WC_Admin_Settings::get_option( 'ckocom_card_saved' );
+
+ // Get capture settings
+ $auto_capture = '1' === WC_Admin_Settings::get_option( 'ckocom_card_autocap', '1' );
+ $capture_delay_hours = WC_Admin_Settings::get_option( 'ckocom_card_cap_delay', '0' );
+
+ // Get Flow-specific settings
+ $flow_settings = get_option( 'woocommerce_wc_checkout_com_flow_settings' );
+ $debug_logging = isset( $flow_settings['flow_debug_logging'] ) && 'yes' === $flow_settings['flow_debug_logging'];
+
+ // Get enabled payment methods from Flow settings
+ $enabled_payment_methods = isset( $flow_settings['flow_enabled_payment_methods'] ) ? $flow_settings['flow_enabled_payment_methods'] : array();
+ // Ensure it's an array
+ if ( ! is_array( $enabled_payment_methods ) ) {
+ $enabled_payment_methods = array();
+ }
+
+ // Note: Cards are always available in Flow and are automatically included
+ // The enabled_payment_methods setting only controls APMs (Alternative Payment Methods)
+ // If empty, all available methods will be shown
+
+ // Get additional 3DS configuration from card settings
+ $challenge_indicator = WC_Admin_Settings::get_option( 'ckocom_card_3ds_challenge_indicator', 'no_preference' );
+ $exemption = WC_Admin_Settings::get_option( 'ckocom_card_3ds_exemption', '' );
+ $allow_upgrade = 'yes' === WC_Admin_Settings::get_option( 'ckocom_card_3ds_allow_upgrade', 'yes' );
+
+ // Debug: Log 3DS settings for troubleshooting
+ $allow_upgrade_raw = WC_Admin_Settings::get_option( 'ckocom_card_3ds_allow_upgrade', 'yes' );
+ error_log('[FLOW] 3DS Settings Debug: ' . print_r([
+ 'three_d_enabled_raw' => WC_Admin_Settings::get_option( 'ckocom_card_threed', '0' ),
+ 'three_d_enabled' => $three_d_enabled,
+ 'attempt_no_three_d_raw' => WC_Admin_Settings::get_option( 'ckocom_card_notheed', '0' ),
+ 'attempt_no_three_d' => $attempt_no_three_d,
+ 'challenge_indicator' => $challenge_indicator,
+ 'exemption' => $exemption,
+ 'allow_upgrade_raw' => $allow_upgrade_raw,
+ 'allow_upgrade_raw_type' => gettype($allow_upgrade_raw),
+ 'allow_upgrade_comparison' => ($allow_upgrade_raw === 'yes'),
+ 'allow_upgrade' => $allow_upgrade,
+ 'settings_source' => 'card_settings'
+ ], true));
+
+ // Validate 3DS values according to Checkout.com API requirements
+ $valid_challenge_indicators = ['no_preference', 'no_challenge_requested', 'challenge_requested', 'challenge_requested_mandate'];
+ $valid_exemptions = [
+ 'low_value', 'trusted_listing', 'trusted_listing_prompt',
+ 'transaction_risk_assessment', '3ds_outage', 'sca_delegation',
+ 'out_of_sca_scope', 'low_risk_program', 'recurring_operation',
+ 'data_share', 'other'
+ ];
+
+ // Ensure challenge indicator is valid
+ if (!in_array($challenge_indicator, $valid_challenge_indicators)) {
+ error_log('[FLOW] Invalid challenge_indicator: ' . $challenge_indicator . ', using default: no_preference');
+ $challenge_indicator = 'no_preference';
+ }
+
+ // Ensure exemption is valid - use empty string if not valid (no exemption)
+ if (empty($exemption) || !in_array($exemption, $valid_exemptions)) {
+ error_log('[FLOW] Invalid or empty exemption: ' . $exemption . ', using empty string (no exemption)');
+ $exemption = '';
+ }
+
+ // Ensure boolean values are properly formatted for JavaScript
+ $three_d_enabled = $three_d_enabled ? true : false;
+ $attempt_no_three_d = $attempt_no_three_d ? true : false;
+ $allow_upgrade = $allow_upgrade ? true : false;
+
+ // Map 'live' to 'production' for SDK compatibility
+ // SDK might expect 'production' instead of 'live' to properly construct URLs
+ $sdk_env = $core_settings['ckocom_environment'];
+ if ( 'live' === $sdk_env ) {
+ $sdk_env = 'production'; // SDK might need 'production' to construct URLs correctly
+ }
+
+ $flow_vars = array(
+ 'checkoutSlug' => get_post_field( 'post_name', get_option( 'woocommerce_checkout_page_id' ) ),
+ 'orderPaySlug' => WC()->query->query_vars['order-pay'],
+ // Removed apiURL and SKey - payment session creation now handled securely via AJAX backend
+ 'PKey' => $core_settings['ckocom_pk'],
+ 'env' => $sdk_env, // Use mapped environment value
+ 'ajax_url' => admin_url( 'admin-ajax.php' ),
+ // Security nonce for payment session creation
+ 'payment_session_nonce' => wp_create_nonce( 'cko_flow_payment_session' ),
+ 'woo_version' => $woo_version,
+ 'ref_session' => $ref_session,
+ 'site_url' => get_home_url(),
+ 'async_url' => '/wp-json/ckoplugin/v1/payment-status',
+ 'udf5' => $udf5,
+ 'regular_payment_type' => $regular_payment_type,
+ 'recurring_payment_type' => $recurring_payment_type,
+ 'three_d_enabled' => $three_d_enabled,
+ 'attempt_no_three_d' => $attempt_no_three_d,
+ 'save_card' => $save_card,
+ 'challenge_indicator' => $challenge_indicator,
+ 'exemption' => $exemption,
+ 'allow_upgrade' => $allow_upgrade,
+ // Capture settings
+ 'auto_capture' => $auto_capture ? true : false,
+ 'capture_delay_hours' => $capture_delay_hours,
+ // Debug logging (enables detailed console logs)
+ 'debug_logging' => $debug_logging ? true : false,
+ // Enabled payment methods
+ 'enabled_payment_methods' => $enabled_payment_methods,
+ );
+
+ wp_set_script_translations( 'checkout-com-flow-payment-session-script', 'checkout-com-unified-payments-api' );
+
+ wp_localize_script( 'checkout-com-flow-payment-session-script', 'cko_flow_vars', $flow_vars );
+ }
+}
+
+add_action( 'woocommerce_order_item_add_action_buttons', 'action_woocommerce_order_item_add_action_buttons', 10, 1 );
+
+/**
+ * Add custom button to admin order.
+ * Button capture and button void.
+ *
+ * @param WC_Order $order The order being edited.
+ */
+function action_woocommerce_order_item_add_action_buttons( $order ) {
+
+ // Check order payment method is checkout.
+ if ( false === strpos( $order->get_payment_method(), 'wc_checkout_com_' ) ) {
+ return;
+ }
+
+ $order_status = $order->get_status();
+ $auth_status = str_replace( 'wc-', '', WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' ) );
+ $capture_status = str_replace( 'wc-', '', WC_Admin_Settings::get_option( 'ckocom_order_captured', 'processing' ) );
+
+ if ( $order->get_payment_method() === 'wc_checkout_com_cards' || $order->get_payment_method() === 'wc_checkout_com_google_pay' ) {
+ ?>
+
+
+
+
+
+ set_transaction_id( $result['action_id'] );
+ $order->update_meta_data( 'cko_payment_captured', true );
+
+ // Get cko capture status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_captured', 'processing' );
+
+ /* translators: %s: Action id. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Captured from Admin - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+
+ // add notes for the order and update status.
+ $order->add_order_note( $message );
+ $order->update_status( $status );
+
+ return true;
+
+ } elseif ( 'cko-void' === sanitize_text_field( $_POST['cko_payment_action'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
+ // check if post is void.
+ // send void request to cko.
+ $result = (array) WC_Checkoutcom_Api_Request::void_payment( $order_id );
+
+ if ( ! empty( $result['error'] ) ) {
+ WC_Admin_Notices::add_custom_notice( 'wc_checkout_com_cards', $result['error'] );
+
+ return false;
+ }
+
+ // Set action id as woo transaction id.
+ $order->set_transaction_id( $result['action_id'] );
+ $order->update_meta_data( 'cko_payment_voided', true );
+
+ // Get cko capture status configured in admin.
+ $status = WC_Admin_Settings::get_option( 'ckocom_order_void', 'cancelled' );
+
+ /* translators: %s: Action id. */
+ $message = sprintf( esc_html__( 'Checkout.com Payment Voided from Admin - Action ID : %s', 'checkout-com-unified-payments-api' ), $result['action_id'] );
+
+ // add notes for the order and update status.
+ $order->add_order_note( $message );
+ $order->update_status( $status );
+
+ // increase stock level.
+ wc_increase_stock_levels( $order );
+
+ return true;
+
+ } else {
+ WC_Admin_Notices::add_custom_notice( 'wc_checkout_com_cards', esc_html__( 'An error has occurred.', 'checkout-com-unified-payments-api' ) );
+
+ return false;
+ }
+}
+
+add_action( 'woocommerce_thankyou', 'add_fawry_number' );
+
+/**
+ * Add the fawry reference number in the "thank you" page.
+ *
+ * @param mixed $order_id Order ID.
+ *
+ * @return void
+ */
+function add_fawry_number( $order_id ) {
+
+ $order = wc_get_order( $order_id );
+
+ $fawry_number = $order->get_meta( 'cko_fawry_reference_number' );
+ $fawry = __( 'Fawry reference number: ', 'checkout-com-unified-payments-api' );
+ if ( $fawry_number ) {
+ wc_enqueue_js(
+ "
+ jQuery( function(){
+ jQuery('.woocommerce-thankyou-order-details.order_details').append('Checkout.com Flow: '; + echo esc_html__( 'Manual orders require a complete billing address for Flow payments to work properly. Please add billing address details to this order.', 'checkout-com-unified-payments-api' ); + echo ' ' . esc_html__( 'Edit Order', 'checkout-com-unified-payments-api' ) . ''; + echo '
element that contains the actual checkbox + const saveNewElement = saveCardCheckbox.find('.woocommerce-SavedPaymentMethods-saveNew'); + if ( saveNewElement.length > 0 ) { + saveNewElement.css('display', 'block'); + saveNewElement.show(); + } +======= +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + ckoLogger.debug('onChange - Showing Save to Account checkbox for CARD'); + } else { + saveCardCheckbox.removeClass('wc-cko-flow-card-on'); + saveCardCheckbox.css('display', 'none'); // Use .css() to set inline style + saveCardCheckbox.hide(); + ckoLogger.debug('onChange - Hiding Save to Account checkbox for', component.selectedType); + } + } else { + ckoLogger.debug('onChange - Save card checkbox not available (feature disabled)'); + } + + console.log( + `[FLOW] onChange() -> isValid: "${component.isValid()}" for "${ + component.type + }"` + ); + + // Additional debugging for Flow component validation issues + if (component.type === 'flow' && !component.isValid()) { +<<<<<<< HEAD + ckoLogger.debug('Flow component validation failed - checking component state:', { + componentType: component.type, + isValid: component.isValid(), + componentState: component.state || 'no state available', + componentErrors: component.errors || 'no errors available' + }); +======= + console.log('[FLOW DEBUG] Flow component validation failed - checking component state:', { + componentType: component.type, + isValid: component.isValid(), + componentState: component.state || 'no state available', + componentErrors: component.errors || 'no errors available', + componentValue: component.value || 'no value available', + componentData: component.data || 'no data available', + componentMethods: Object.getOwnPropertyNames(component), + componentPrototype: Object.getOwnPropertyNames(Object.getPrototypeOf(component)), + componentMounted: component.mount ? 'mount method exists' : 'no mount method', + componentAvailable: component.isAvailable ? 'isAvailable method exists' : 'no isAvailable method' + }); + + // Check if component is properly mounted + if (component.mount) { + console.log('[FLOW DEBUG] Component mount method exists, checking if mounted...'); + + // Check if component is mounted to DOM + const flowContainer = document.getElementById('flow-container'); + if (flowContainer) { + console.log('[FLOW DEBUG] Flow container found:', { + containerExists: true, + containerChildren: flowContainer.children.length, + containerInnerHTML: flowContainer.innerHTML.length > 0 ? 'has content' : 'empty', + containerVisible: flowContainer.offsetWidth > 0 && flowContainer.offsetHeight > 0 + }); + } else { + console.log('[FLOW DEBUG] Flow container NOT found - this is the problem!'); + } + } +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + } + }; + + /* + * Triggered on component click. + */ + const handleClick = (component) => { + + if(component.type==="applepay") { + return {continue: true}; + } + + if ( orderId ) { + return {continue: true}; + } + + return new Promise((resolve) => { + const form = jQuery("form.checkout"); + + validateCheckout(form, function (response) { + resolve({ continue: true }); + }); + }); + }; + + /* + * Triggered on any error in the component. + */ + const onError = (component, error) => { + ckoLogger.error("onError", error, "Component", component.type); + + // Hide loading overlay and skeleton. + hideLoadingOverlay(); + hideLoadingOverlay(2); + + const skeleton = document.getElementById("flow-skeleton"); + const placeOrderBtn = document.getElementById("place_order"); + + if (skeleton) { + skeleton.classList.remove("show"); + } + if (placeOrderBtn) { + placeOrderBtn.classList.remove("flow-loading"); + } + +<<<<<<< HEAD + // Extract error message from various error object formats + // CheckoutError objects might have message in different places + let errorMessage = ''; + if (error.message) { + errorMessage = error.message; + } else if (error.toString && typeof error.toString === 'function') { + errorMessage = error.toString(); + } else if (typeof error === 'string') { + errorMessage = error; + } else { + errorMessage = JSON.stringify(error); + } + + // Handle specific error types with user-friendly messages + let userFriendlyMessage = null; + let isPaymentDeclined = false; + + if (errorMessage.includes("[Request]: Network request failed [payment_request_failed]")) { + ckoLogger.error("Payment request failed - checking configuration:"); + ckoLogger.error("Public Key:", cko_flow_vars.PKey ? 'SET' : 'NOT SET'); + ckoLogger.error("Environment:", cko_flow_vars.env); + ckoLogger.error("Payment Session ID:", paymentSession ? paymentSession.id : 'N/A'); + userFriendlyMessage = "Payment request failed. Please check your payment gateway configuration or try again."; + } else if (errorMessage.includes("[Request]: Payment request declined [payment_request_declined]") || + errorMessage.includes("payment_request_declined")) { + ckoLogger.error("Payment request declined by Checkout.com"); + ckoLogger.error("Error details:", error); + // User-friendly message for payment decline + userFriendlyMessage = "Your payment was declined. Please check your card details and try again, or use a different payment method."; + isPaymentDeclined = true; + } else if (errorMessage === "[Submit]: Component is invalid [component_invalid]") { + userFriendlyMessage = "Please complete your payment before placing the order."; + } else if (errorMessage.includes("declined")) { + // Catch any other decline-related errors + ckoLogger.error("Payment declined (generic decline error)"); + ckoLogger.error("Error details:", error); + userFriendlyMessage = "Your payment was declined. Please check your card details and try again, or use a different payment method."; + isPaymentDeclined = true; + } + + // Use user-friendly message if available, otherwise use original or fallback + const finalErrorMessage = userFriendlyMessage || errorMessage || wp.i18n.__( + "Something went wrong. Please try again.", + "checkout-com-unified-payments-api" + ); + + // Always show error message to user + ckoLogger.error("Displaying error to user:", finalErrorMessage); + showError(finalErrorMessage); + + // CRITICAL: Create order for declined payments if Place Order was clicked + // This ensures failed payment attempts are tracked even when payment fails before form submission + ckoLogger.error("[ORDER CREATION DEBUG] Checking conditions:"); + ckoLogger.error("[ORDER CREATION DEBUG] isPaymentDeclined:", isPaymentDeclined); + ckoLogger.error("[ORDER CREATION DEBUG] window.ckoPlaceOrderClicked:", window.ckoPlaceOrderClicked); + ckoLogger.error("[ORDER CREATION DEBUG] cko_flow_vars:", typeof cko_flow_vars !== 'undefined' ? 'defined' : 'undefined'); + ckoLogger.error("[ORDER CREATION DEBUG] ajax_url:", typeof cko_flow_vars !== 'undefined' ? cko_flow_vars.ajax_url : 'N/A'); + + if (isPaymentDeclined && window.ckoPlaceOrderClicked) { + ckoLogger.error("[ORDER CREATION] Payment declined AFTER Place Order clicked - creating failed order for tracking"); + + const form = jQuery("form.checkout"); + ckoLogger.error("[ORDER CREATION DEBUG] Form found:", form.length > 0); + + if (form.length > 0) { + const formData = form.serialize(); + ckoLogger.error("[ORDER CREATION DEBUG] Form data serialized, length:", formData.length); + + // Check if nonce exists in form + const nonceField = jQuery('input[name="woocommerce-process-checkout-nonce"]'); + const nonceValue = nonceField.length > 0 ? nonceField.val() : ''; + ckoLogger.error("[ORDER CREATION DEBUG] Nonce field found:", nonceField.length > 0); + ckoLogger.error("[ORDER CREATION DEBUG] Nonce value:", nonceValue ? nonceValue.substring(0, 10) + '...' : 'EMPTY'); + + // Parse form data into object + const formDataObj = Object.fromEntries(new URLSearchParams(formData)); + + // Ensure nonce is explicitly included + if (!formDataObj['woocommerce-process-checkout-nonce'] && nonceValue) { + formDataObj['woocommerce-process-checkout-nonce'] = nonceValue; + ckoLogger.error("[ORDER CREATION DEBUG] Added nonce explicitly to data"); + } + + // Create order via AJAX to track failed payment attempt + jQuery.ajax({ + url: cko_flow_vars.ajax_url, + type: "POST", + data: { + action: "cko_flow_create_failed_order", + error_reason: "payment_request_declined", + error_message: finalErrorMessage, + ...formDataObj + }, + success: function(response) { + ckoLogger.error("[ORDER CREATION] AJAX Success Response:", response); + if (response.success && response.data && response.data.order_id) { + ckoLogger.error("[ORDER CREATION] ✅ Failed order created successfully - Order ID: " + response.data.order_id); + } else { + ckoLogger.error("[ORDER CREATION] ❌ Failed to create order for declined payment:", response); + } + }, + error: function(xhr, status, error) { + ckoLogger.error("[ORDER CREATION] ❌ AJAX Error:", error); + ckoLogger.error("[ORDER CREATION] ❌ Status:", status); + ckoLogger.error("[ORDER CREATION] ❌ XHR Response:", xhr.responseText); + ckoLogger.error("[ORDER CREATION] ❌ XHR Status Code:", xhr.status); + ckoLogger.error("[ORDER CREATION] ❌ XHR Response Headers:", xhr.getAllResponseHeaders()); + + // Try to parse response if available + if (xhr.responseText) { + try { + const responseData = JSON.parse(xhr.responseText); + ckoLogger.error("[ORDER CREATION] ❌ Parsed Response:", responseData); + } catch (e) { + ckoLogger.error("[ORDER CREATION] ❌ Response is not JSON:", xhr.responseText.substring(0, 500)); + } + } + } + }); + } else { + ckoLogger.error("[ORDER CREATION] ❌ Form not found - cannot create order"); + } + + // Clear the flag + window.ckoPlaceOrderClicked = false; + } else { + ckoLogger.error("[ORDER CREATION] ⚠️ Conditions not met - order NOT created"); + if (!isPaymentDeclined) { + ckoLogger.error("[ORDER CREATION] ⚠️ Reason: Payment not declined"); + } + if (!window.ckoPlaceOrderClicked) { + ckoLogger.error("[ORDER CREATION] ⚠️ Reason: Place Order not clicked"); + } + } + + // Log the error for debugging + ckoLogger.error("Flow component error:", { + component: component.type, + originalMessage: errorMessage, + userFriendlyMessage: userFriendlyMessage, + finalErrorMessage: finalErrorMessage, + isPaymentDeclined: isPaymentDeclined, + placeOrderClicked: window.ckoPlaceOrderClicked || false, + fullError: error + }); +======= + // Handle specific error types + if (error.message && error.message.includes("[Request]: Network request failed [payment_request_failed]")) { + ckoLogger.error("Payment request failed - checking configuration:"); + ckoLogger.error("Public Key:", cko_flow_vars.PKey ? 'SET' : 'NOT SET'); + ckoLogger.error("Environment:", cko_flow_vars.env); + ckoLogger.error("Payment Session ID:", paymentSession.id); + error.message = "Payment request failed. Please check your payment gateway configuration or try again."; + } else if (error.message === "[Submit]: Component is invalid [component_invalid]") { + error.message = "Please complete your payment before placing the order."; + } + + showError( + error.message || + wp.i18n.__( + "Something went wrong. Please try again.", + "checkout-com-unified-payments-api" + ) + ); +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + }; + + // Debug: Log callback functions + ckoLogger.debug('Callback Functions:', { + onReady: typeof onReady, + onPaymentCompleted: typeof onPaymentCompleted, + onSubmit: typeof onSubmit, + onChange: typeof onChange, + handleClick: typeof handleClick, + onError: typeof onError + }); + +<<<<<<< HEAD + // Note: onPaymentCompleted is internal - not exposed globally for security +======= + // Debug: Make onPaymentCompleted globally accessible for testing + window.testOnPaymentCompleted = onPaymentCompleted; + ckoLogger.debug('onPaymentCompleted callback is now globally accessible as window.testOnPaymentCompleted'); +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + + // WORKAROUND: Add URL fields to paymentSession object based on environment + // This helps SDK construct correct URLs even if token is missing URL fields + // SDK might check these fields before/after decoding the token + const baseUrl = cko_flow_vars.env === 'sandbox' + ? 'https://api.sandbox.checkout.com' + : 'https://api.checkout.com'; + const cdnUrl = cko_flow_vars.env === 'sandbox' + ? 'https://cdn.sandbox.checkout.com' + : 'https://cdn.checkout.com'; + const devicesUrl = cko_flow_vars.env === 'sandbox' + ? 'https://devices.api.sandbox.checkout.com' + : 'https://devices.api.checkout.com'; + + // Add URL fields to paymentSession object (SDK might use these) + // Note: SDK decodes token internally, but might fall back to these if token URLs are missing + if (!paymentSession._urls) { + paymentSession._urls = { + api_url: baseUrl, + cdn_url: cdnUrl, + devices_url: devicesUrl, + base_url: baseUrl + }; + ckoLogger.debug('Added URL fields to paymentSession:', paymentSession._urls); + } + + // NOTE: We cannot pre-load risk.js manually because: + // 1. The SDK constructs the risk.js URL internally from the payment session token + // 2. The SDK decodes the token and extracts URLs (cdn_url, etc.) + // 3. If token is missing URL fields, SDK constructs incorrect URLs + // 4. We cannot modify the token without decoding it (which we're avoiding) + // 5. The SDK must load risk.js itself - we can't intercept or pre-load it + // + // SOLUTION: The payment session token MUST include URL fields (cdn_url, api_url, etc.) + // This is an API issue that needs to be fixed by Checkout.com + // + // We've added URL fields to paymentSession._urls as a fallback, but the SDK + // primarily uses URLs from the decoded token, so this may not help. + + const checkout = await CheckoutWebComponents({ + publicKey: cko_flow_vars.PKey, + environment: cko_flow_vars.env, + locale: window.locale, + paymentSession, + appearance: window.appearance, + componentOptions: window.componentOptions, + translations: window.translations, + onReady, + onPaymentCompleted, + onSubmit, + onChange, + handleClick, + onError + }); + + // Log SDK initialization (debug mode only) + ckoLogger.debug('SDK initialized:', { + hasCreate: typeof checkout.create === 'function', + paymentSessionId: paymentSession.id, + environment: cko_flow_vars.env + }); + + + // Ensure component name is defined + const componentName = window.componentName || 'flow'; + ckoLogger.debug('Creating Flow component with name:', componentName); + + let flowComponent; + try { +<<<<<<< HEAD +======= + console.log('[FLOW DEBUG] About to create Flow component with:', { + componentName: componentName, + checkoutObject: typeof checkout, + checkoutCreate: typeof checkout.create, + componentOptions: { showPayButton: false } + }); + + ckoLogger.debug('About to create Flow component with:', { + componentName: componentName, + checkoutObject: typeof checkout, + checkoutCreate: typeof checkout.create, + componentOptions: { showPayButton: false } + }); + +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + flowComponent = checkout.create(componentName, { + showPayButton: false, + }); + +<<<<<<< HEAD + ckoLogger.debug('Flow component created successfully:', { + componentName: componentName, + componentType: flowComponent.type + }); + } catch (error) { +======= + console.log('[FLOW DEBUG] Flow component created successfully:', { + componentName: componentName, + componentType: flowComponent.type, + componentAvailable: flowComponent.isAvailable ? 'method exists' : 'method missing', + componentMethods: Object.getOwnPropertyNames(flowComponent), + componentPrototype: Object.getOwnPropertyNames(Object.getPrototypeOf(flowComponent)) + }); + + ckoLogger.debug('Flow component created successfully:', { + componentName: componentName, + componentType: flowComponent.type, + componentAvailable: flowComponent.isAvailable ? 'method exists' : 'method missing', + componentMethods: Object.getOwnPropertyNames(flowComponent), + componentPrototype: Object.getOwnPropertyNames(Object.getPrototypeOf(flowComponent)) + }); + } catch (error) { + console.log('[FLOW ERROR] Error creating Flow component:', error); +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + ckoLogger.error('Error creating Flow component:', error); + showError('Failed to initialize payment component. Please try again.'); + return; + } + + // Performance: Track component creation + const componentInitEnd = performance.now(); + const componentInitDuration = componentInitEnd - componentInitStart; + if (ckoFlow.performanceMetrics.enableLogging) { + ckoLogger.performance(`Component initialized in ${componentInitDuration.toFixed(2)}ms (${(componentInitDuration / 1000).toFixed(2)}s)`); + } + + ckoFlow.flowComponent = flowComponent; + + /* + * Check if the component is available. Mount component only if available. + */ + flowComponent.isAvailable().then((available) => { + // Log component availability (debug mode only) + ckoLogger.debug('Component availability:', { + available: available, + componentType: flowComponent.type, + environment: cko_flow_vars.env + }); + + if (available) { + // Performance: Track component mount + const mountStart = performance.now(); + if (ckoFlow.performanceMetrics.enableLogging) { + ckoLogger.performance('Mounting component to DOM...'); + } + flowComponent.mount(document.getElementById("flow-container")); + const mountEnd = performance.now(); + if (ckoFlow.performanceMetrics.enableLogging) { + ckoLogger.performance(`Component mounted in ${(mountEnd - mountStart).toFixed(2)}ms`); + } + +<<<<<<< HEAD + // Mark Flow as initialized and clear guard flag now that component is mounted + ckoFlowInitialized = true; + ckoFlowInitializing = false; + +======= +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + // ============================================================ + // SMOOTH CHECKOUT EXPERIENCE - Enable UI after mount + // ============================================================ + ckoLogger.debug('Component mounted - enabling UI! 🔥🔥🔥'); + + const skeleton = document.getElementById("flow-skeleton"); + const placeOrderBtn = document.getElementById("place_order"); + const saveCardCheckbox = document.querySelector('.cko-save-card-checkbox'); + + // Step 1: Hide skeleton loader + if (skeleton) { + skeleton.classList.remove("show"); + ckoLogger.debug('✓ Skeleton loader hidden'); + } + + // Step 2: Enable Place Order button + if (placeOrderBtn) { + placeOrderBtn.classList.remove("flow-loading"); + placeOrderBtn.style.removeProperty('opacity'); + placeOrderBtn.style.removeProperty('visibility'); + console.log('[FLOW] ✓ Place Order button enabled'); + } + + // Step 3: Hide save card checkbox initially + if (saveCardCheckbox) { + saveCardCheckbox.style.display = 'none'; + } else { + console.log('[FLOW] Mount - Save card checkbox not available (feature disabled)'); + } + + // Step 4: Mark Flow as ready + document.body.classList.add("flow-ready"); + console.log('[FLOW] ✓ Checkout is now fully interactive'); + + // CRITICAL: Listen for user interaction with Flow fields (click, focus, input) + // This detects when user actually starts using Flow (not just onChange firing on load) + setTimeout(() => { + const flowContainer = document.getElementById("flow-container"); + if (flowContainer) { + // Listen for any interaction with Flow component + flowContainer.addEventListener('click', function() { + if (!window.flowUserInteracted) { + console.log('[FLOW] User clicked on Flow component - marking as interacted'); + window.flowUserInteracted = true; + window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow + } + }, { once: false }); + + flowContainer.addEventListener('focus', function(e) { + if (!window.flowUserInteracted) { + console.log('[FLOW] User focused on Flow field - marking as interacted'); + window.flowUserInteracted = true; + window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow + } + }, { capture: true }); + + flowContainer.addEventListener('input', function(e) { + if (!window.flowUserInteracted) { + console.log('[FLOW] User typing in Flow field - marking as interacted'); + window.flowUserInteracted = true; + window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow + } + }, { capture: true }); + + console.log('[FLOW] Flow interaction listeners attached'); + } + }, 500); + + } else { + // Hide loading overlay. + hideLoadingOverlay(); + ckoLogger.error("Component is not available."); + console.error('[FLOW UI ERROR] Component is not available - showing error message'); + console.error('[FLOW UI ERROR] This is a CLIENT-SIDE (JavaScript) error'); + + showError( + wp.i18n.__( + "The selected payment method is not available at this time.", + "checkout-com-unified-payments-api" + ) + ); + } + }); + } + } catch (error) { +<<<<<<< HEAD + // Clear initialization guard flag on error + ckoFlowInitializing = false; + ckoFlowInitialized = false; + +======= +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + // Hide loading overlay and skeleton. + hideLoadingOverlay(); + + const skeleton = document.getElementById("flow-skeleton"); + const placeOrderBtn = document.getElementById("place_order"); + + if (skeleton) { + skeleton.classList.remove("show"); + } + if (placeOrderBtn) { + placeOrderBtn.classList.remove("flow-loading"); + } + + ckoLogger.error("Error creating payment session:", error); + + showError( + error.message || + wp.i18n.__( + "Error creating payment session.", + "checkout-com-unified-payments-api" + ) + ); + } + }, +}; + +/* + * Displays error messages at the top of the WooCommerce form. + */ +let showError = function (error_message) { +<<<<<<< HEAD + ckoLogger.error("showError() called with message:", error_message); + + if (!error_message) { + ckoLogger.error("showError() called with empty/null message"); + return; + } + +======= +>>>>>>> upstream/feature/flow-integration-v5.0.0-beta + if ("string" === typeof error_message) { + error_message = [error_message]; + } + + let ulWrapper = jQuery("
")
+ .addClass("woocommerce-NoticeGroup woocommerce-NoticeGroup-checkout")
+ .append(ulWrapper);
+
+ let scrollTarget;
+<<<<<<< HEAD
+ let errorDisplayed = false;
+
+ // Try form.checkout first
+ if (jQuery("form.checkout").length) {
+ ckoLogger.error("showError() - Found form.checkout, displaying error");
+=======
+
+ if (jQuery("form.checkout").length) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ jQuery("form.checkout .woocommerce-NoticeGroup").remove();
+ jQuery("form.checkout").prepend(wcNoticeDiv);
+ jQuery(".woocommerce, .form.checkout").removeClass("processing").unblock();
+ scrollTarget = jQuery("form.checkout");
+<<<<<<< HEAD
+ errorDisplayed = true;
+ }
+ // Try .woocommerce-order-pay
+ else if (jQuery(".woocommerce-order-pay").length) {
+ ckoLogger.error("showError() - Found .woocommerce-order-pay, displaying error");
+=======
+ } else if (jQuery(".woocommerce-order-pay").length) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ jQuery(".woocommerce-order-pay .woocommerce-NoticeGroup").remove();
+ jQuery(".woocommerce-order-pay").prepend(wcNoticeDiv);
+ jQuery(".woocommerce, .woocommerce-order-pay")
+ .removeClass("processing")
+ .unblock();
+ scrollTarget = jQuery(".woocommerce-order-pay");
+<<<<<<< HEAD
+ errorDisplayed = true;
+ }
+ // Try .woocommerce-checkout (block theme)
+ else if (jQuery(".woocommerce-checkout").length) {
+ ckoLogger.error("showError() - Found .woocommerce-checkout, displaying error");
+ jQuery(".woocommerce-checkout .woocommerce-NoticeGroup").remove();
+ jQuery(".woocommerce-checkout").prepend(wcNoticeDiv);
+ jQuery(".woocommerce-checkout").removeClass("processing").unblock();
+ scrollTarget = jQuery(".woocommerce-checkout");
+ errorDisplayed = true;
+ }
+ // Fallback: Try to use WooCommerce's notice system
+ else if (typeof wc_add_to_notices === 'function') {
+ ckoLogger.error("showError() - Using WooCommerce notice system");
+ wc_add_to_notices(error_message, 'error');
+ errorDisplayed = true;
+ }
+ // Last resort: Display at top of body
+ else {
+ ckoLogger.error("showError() - No form found, displaying error at top of body");
+ jQuery("body").prepend(wcNoticeDiv);
+ errorDisplayed = true;
+ }
+
+ if (errorDisplayed) {
+ ckoLogger.error("showError() - Error displayed successfully");
+
+ // Store error message to persist through updated_checkout events
+ // WooCommerce's updated_checkout event replaces the form HTML, clearing our error
+ if (error_message && error_message.length > 0) {
+ window.ckoLastError = Array.isArray(error_message) ? error_message[0] : error_message;
+ ckoLogger.error("showError() - Stored error message for persistence:", window.ckoLastError);
+ }
+ } else {
+ ckoLogger.error("showError() - ERROR: Failed to display error message!");
+ }
+
+ // Scroll to top of checkout form or error message
+ if (scrollTarget && scrollTarget.length) {
+=======
+ }
+
+ // Scroll to top of checkout form.
+ if (scrollTarget) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ jQuery("html, body").animate(
+ {
+ scrollTop: scrollTarget.offset().top - 100,
+ },
+ 1000
+ );
+<<<<<<< HEAD
+ } else if (wcNoticeDiv.length) {
+ // Scroll to the error message itself
+ jQuery("html, body").animate(
+ {
+ scrollTop: wcNoticeDiv.offset().top - 100,
+ },
+ 1000
+ );
+ }
+};
+
+// Re-display error messages after WooCommerce's updated_checkout event
+// This ensures payment decline errors persist even when WooCommerce refreshes the checkout form
+jQuery(document.body).on('updated_checkout', function() {
+ if (window.ckoLastError) {
+ ckoLogger.error("updated_checkout fired - Re-displaying stored error:", window.ckoLastError);
+ // Use a small delay to ensure form is fully updated
+ setTimeout(function() {
+ showError(window.ckoLastError);
+ // Verify error is visible in DOM
+ setTimeout(function() {
+ const errorElement = jQuery("form.checkout .woocommerce-NoticeGroup, .woocommerce-order-pay .woocommerce-NoticeGroup, .woocommerce-checkout .woocommerce-NoticeGroup");
+ if (errorElement.length > 0) {
+ ckoLogger.error("Error element found in DOM:", errorElement.length, "elements");
+ // Make sure it's visible
+ errorElement.css('display', 'block').css('visibility', 'visible');
+ // Scroll to it
+ jQuery("html, body").animate({
+ scrollTop: errorElement.offset().top - 100
+ }, 500);
+ } else {
+ ckoLogger.error("ERROR: Error element NOT found in DOM after re-display!");
+ }
+ }, 200);
+ // Clear the stored error after displaying (user can dismiss it manually)
+ // Don't clear immediately - let it persist for a few seconds
+ setTimeout(function() {
+ window.ckoLastError = null;
+ ckoLogger.error("Cleared stored error message");
+ }, 5000);
+ }, 100);
+ }
+});
+
+=======
+ }
+};
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+/**
+ * Initialize Flow interaction tracking flag
+ * This flag tracks whether the user has actively interacted with the Flow component
+ * to differentiate between saved card payments and new Flow payments
+ */
+window.flowUserInteracted = false;
+
+/**
+ * Initializes the observer to monitor the presence of the Flow checkout component in the DOM.
+ *
+ * - Sets the `ckoFlowInitialized` flag to `false` on page load.
+ * - Observes the DOM for any changes using `MutationObserver`.
+ * - If the Flow checkout component (identified by `data-testid="checkout-web-component-root"`)
+ * is removed from the DOM, the flag `ckoFlowInitialized` is reset to `false`.
+ *
+ * This helps ensure that the Flow component can be re-initialized when needed.
+ */
+
+let ckoFlowInitialized = false;
+<<<<<<< HEAD
+let ckoFlowInitializing = false; // Guard flag to prevent multiple simultaneous initializations
+let ckoOrderCreationInProgress = false; // Guard flag to prevent multiple simultaneous order creation calls
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+
+// Note: Early 3DS detection is now at the top of the file (right after ckoLogger definition)
+// This ensures it runs before any other code that might initialize Flow
+
+document.addEventListener("DOMContentLoaded", function () {
+ // CRITICAL: Check for 3DS return FIRST - before any other checks
+ // Check flag first (set by early detection)
+ if (window.ckoFlow3DSReturn) {
+ console.log('[FLOW 3DS] ⚠️ DOMContentLoaded: Blocked by 3DS return flag');
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.threeDS('DOMContentLoaded: 3DS return in progress, skipping all Flow initialization');
+ }
+ return;
+ }
+
+ // Also check URL parameters directly as fallback (in case early detection didn't run)
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ console.log('[FLOW 3DS] ⚠️ DOMContentLoaded: Blocked by 3DS return URL parameters', {
+ paymentId: paymentId,
+ sessionId: sessionId,
+ paymentSessionId: paymentSessionId
+ });
+ window.ckoFlow3DSReturn = true;
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.threeDS('DOMContentLoaded: 3DS return detected in URL, skipping all Flow initialization');
+ }
+ return;
+ }
+
+ // Track page load time for performance metrics
+ ckoFlow.performanceMetrics.pageLoadTime = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ ckoLogger.performance('Page DOMContentLoaded at:', ckoFlow.performanceMetrics.pageLoadTime.toFixed(2) + 'ms');
+ }
+
+ const element = document.querySelector(
+ '[data-testid="checkout-web-component-root"]'
+ );
+ ckoFlowInitialized = false;
+
+ const observer = new MutationObserver(() => {
+ const element = document.querySelector(
+ '[data-testid="checkout-web-component-root"]'
+ );
+
+ // If the element is not present, update ckoFlowInitialized.
+ if (!element) {
+ ckoFlowInitialized = false;
+ }
+ });
+
+ // Observe the entire document for any changes in the DOM.
+ observer.observe(document.body, {
+ childList: true,
+ subtree: true,
+ });
+});
+
+/*
+ * Listens to changes in the payment method radio buttons
+ * and initializes the Flow payment method if selected.
+ *
+ * This function handles the logic for showing or hiding the Flow payment container
+ * and initializing the Flow checkout component when the Flow payment method is selected.
+ * It also manages the visibility of saved payment methods and ensures the Flow component is
+ * initialized when needed.
+ */
+/**
+<<<<<<< HEAD
+ * Validation Helper Functions
+ * These functions check if Flow can be initialized based on required fields
+ */
+
+/**
+ * Check if user is logged in
+ * @returns {boolean}
+ */
+function isUserLoggedIn() {
+ return cko_flow_vars.is_user_logged_in === true ||
+ cko_flow_vars.is_user_logged_in === "1" ||
+ cko_flow_vars.is_user_logged_in === 1 ||
+ document.querySelector('.woocommerce-form-login') === null;
+}
+
+/**
+ * Get checkout field value by ID
+ * @param {string} fieldId - Field ID
+ * @returns {string|null}
+ */
+function getCheckoutFieldValue(fieldId) {
+ const el = document.getElementById(fieldId);
+ return el && el.value ? el.value.trim() : null;
+}
+
+/**
+ * Validate email format
+ * @param {string} email - Email address
+ * @returns {boolean}
+ */
+function isValidEmail(email) {
+ if (!email) return false;
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ return emailRegex.test(email);
+}
+
+/**
+ * Check if postcode is required for a country
+ * @param {string} country - Country code
+ * @returns {boolean}
+ */
+function isPostcodeRequiredForCountry(country) {
+ if (!country) return true; // Default to required if unknown
+ // Countries that don't require postcode
+ const noPostcodeCountries = ['AE', 'AO', 'AG', 'AW', 'BS', 'BZ', 'BJ', 'BW', 'BF', 'BI', 'CM', 'CF', 'KM', 'CG', 'CD', 'CK', 'CI', 'DJ', 'DM', 'GQ', 'ER', 'FJ', 'TF', 'GM', 'GH', 'GD', 'GN', 'GY', 'HK', 'IE', 'JM', 'KE', 'KI', 'LS', 'LR', 'MW', 'ML', 'MR', 'MU', 'MS', 'NR', 'NU', 'KP', 'PA', 'QA', 'RW', 'KN', 'LC', 'ST', 'SC', 'SL', 'SB', 'SO', 'SR', 'SZ', 'TJ', 'TZ', 'TL', 'TG', 'TO', 'TT', 'TV', 'UG', 'VU', 'YE', 'ZW'];
+ return !noPostcodeCountries.includes(country.toUpperCase());
+}
+
+/**
+ * Check if billing address is present
+ * For order-pay pages, checks order data first (cartInfo), then falls back to form fields
+ * @returns {boolean}
+ */
+function hasBillingAddress() {
+ // Check if we're on order-pay page and have order data
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ let orderPayInfo = null;
+ if (isOrderPayPage) {
+ orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ }
+
+ // If order-pay page and order data exists, use it for validation
+ if (isOrderPayPage && orderPayInfo && orderPayInfo.billing_address) {
+ const billing = orderPayInfo.billing_address;
+ const email = billing.email || billing.Email || '';
+ const address1 = billing.street_address || billing.address_line1 || '';
+ const city = billing.city || '';
+ const country = billing.country || '';
+
+ if (email && address1 && city && country) {
+ ckoLogger.debug('hasBillingAddress: Using order data (order-pay page)', {
+ email: email ? 'SET' : 'EMPTY',
+ address1: address1 ? 'SET' : 'EMPTY',
+ city: city ? 'SET' : 'EMPTY',
+ country: country ? 'SET' : 'EMPTY'
+ });
+ return true;
+ }
+ }
+
+ // Fallback to form fields (regular checkout or if order data not available)
+ const email = getCheckoutFieldValue("billing_email");
+ const address1 = getCheckoutFieldValue("billing_address_1");
+ const city = getCheckoutFieldValue("billing_city");
+ const country = getCheckoutFieldValue("billing_country");
+
+ return !!(email && address1 && city && country);
+}
+
+/**
+ * Check if billing address is complete
+ * For order-pay pages, checks order data first (cartInfo), then falls back to form fields
+ * @returns {boolean}
+ */
+function hasCompleteBillingAddress() {
+ // Check if we're on order-pay page and have order data
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ let orderPayInfo = null;
+ if (isOrderPayPage) {
+ orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ }
+
+ // If order-pay page and order data exists, use it for validation
+ if (isOrderPayPage && orderPayInfo && orderPayInfo.billing_address) {
+ const billing = orderPayInfo.billing_address;
+ const address1 = billing.street_address || billing.address_line1 || '';
+ const city = billing.city || '';
+ const country = billing.country || '';
+ const postcode = billing.postal_code || billing.postcode || '';
+
+ if (!address1 || !city || !country) {
+ return false;
+ }
+
+ // Check if postcode is required for country
+ const postcodeRequired = isPostcodeRequiredForCountry(country);
+ if (postcodeRequired && !postcode) {
+ return false;
+ }
+
+ return true;
+ }
+
+ // Fallback to form fields (regular checkout or if order data not available)
+ const address1 = getCheckoutFieldValue("billing_address_1");
+ const city = getCheckoutFieldValue("billing_city");
+ const country = getCheckoutFieldValue("billing_country");
+ const postcode = getCheckoutFieldValue("billing_postcode");
+
+ if (!address1 || !city || !country) {
+ return false;
+ }
+
+ // Check if postcode is required for country
+ const postcodeRequired = isPostcodeRequiredForCountry(country);
+ if (postcodeRequired && !postcode) {
+ return false;
+ }
+
+ return true;
+}
+
+/**
+ * Enhanced required fields check with email validation
+ * For order-pay pages, checks order data first (cartInfo), then falls back to form fields
+ * @returns {boolean}
+ */
+function requiredFieldsFilledAndValid() {
+ // Check if we're on order-pay page and have order data
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ let orderPayInfo = null;
+ if (isOrderPayPage) {
+ orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ }
+
+ // If order-pay page and order data exists, use it for validation
+ if (isOrderPayPage && orderPayInfo && orderPayInfo.billing_address) {
+ const billing = orderPayInfo.billing_address;
+ const email = billing.email || billing.Email || '';
+ const address1 = billing.street_address || billing.address_line1 || '';
+ const city = billing.city || '';
+ const country = billing.country || '';
+ const postcode = billing.postal_code || billing.postcode || '';
+
+ // Check if all required fields are filled
+ if (!email || !address1 || !city || !country) {
+ ckoLogger.debug('requiredFieldsFilledAndValid: Order data missing required fields', {
+ email: email ? 'SET' : 'EMPTY',
+ address1: address1 ? 'SET' : 'EMPTY',
+ city: city ? 'SET' : 'EMPTY',
+ country: country ? 'SET' : 'EMPTY'
+ });
+ return false;
+ }
+
+ // Validate email format
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+ if (!emailRegex.test(email.trim())) {
+ ckoLogger.debug('requiredFieldsFilledAndValid: Order data email invalid', { email: email });
+ return false;
+ }
+
+ // Check postcode if required for country
+ const postcodeRequired = isPostcodeRequiredForCountry(country);
+ if (postcodeRequired && !postcode) {
+ ckoLogger.debug('requiredFieldsFilledAndValid: Order data missing postcode for country', { country: country });
+ return false;
+ }
+
+ ckoLogger.debug('requiredFieldsFilledAndValid: Order data validation passed (order-pay page)', {
+ email: email ? 'SET' : 'EMPTY',
+ address1: address1 ? 'SET' : 'EMPTY',
+ city: city ? 'SET' : 'EMPTY',
+ country: country ? 'SET' : 'EMPTY',
+ postcode: postcode ? 'SET' : 'EMPTY'
+ });
+ return true;
+ }
+
+ // Fallback to form fields (regular checkout or if order data not available)
+ // First check if all required fields are filled
+ ckoLogger.debug('requiredFieldsFilledAndValid: Calling requiredFieldsFilled()...');
+ const fieldsFilled = requiredFieldsFilled();
+ ckoLogger.debug('requiredFieldsFilledAndValid: requiredFieldsFilled() returned:', fieldsFilled);
+ if (!fieldsFilled) {
+ ckoLogger.debug('requiredFieldsFilledAndValid: requiredFieldsFilled() returned false - fields not filled');
+ return false;
+ }
+
+ // Validate email format
+ const email = getCheckoutFieldValue("billing_email");
+ if (!email || !isValidEmail(email)) {
+ return false;
+ }
+
+ // Check billing address is complete
+ if (!hasCompleteBillingAddress()) {
+ return false;
+ }
+
+ return true;
+}
+
+/**
+ * Check if Flow can be initialized
+ * Validates all requirements before allowing Flow initialization
+ * @returns {boolean}
+ */
+function canInitializeFlow() {
+ // Check if Flow payment method is selected
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (!flowPayment || !flowPayment.checked) {
+ ckoLogger.debug('canInitializeFlow: Flow payment method not selected');
+ return false;
+ }
+
+ // Check if container exists
+ const flowContainer = document.getElementById("flow-container");
+ if (!flowContainer) {
+ ckoLogger.debug('canInitializeFlow: Flow container not found');
+ return false;
+ }
+
+ // Check if already initialized
+ if (ckoFlowInitialized && ckoFlow.flowComponent) {
+ ckoLogger.debug('canInitializeFlow: Already initialized');
+ return true; // Already initialized
+ }
+
+ // Check cart has items
+ // Note: cart_total might not be available in cko_flow_vars
+ // If we're on checkout page, WooCommerce ensures cart has items (redirects empty carts)
+ // So we can skip strict cart validation and let the API handle it if cart is truly empty
+ const cartTotal = cko_flow_vars?.cart_total ? parseFloat(cko_flow_vars.cart_total) : null;
+ const isOnCheckoutPage = window.location.pathname.includes('/checkout') || window.location.pathname.includes('/order-pay/');
+
+ if (cartTotal !== null && cartTotal <= 0 && !isOnCheckoutPage) {
+ ckoLogger.debug('canInitializeFlow: Cart is empty', {
+ cartTotal: cartTotal,
+ isOnCheckoutPage: isOnCheckoutPage
+ });
+ return false;
+ }
+
+ // If cart_total not available but we're on checkout page, assume cart has items
+ if (cartTotal === null && isOnCheckoutPage) {
+ ckoLogger.debug('canInitializeFlow: cart_total not available, but on checkout page - assuming cart has items');
+ }
+
+ // Check if user is logged in
+ const userLoggedIn = isUserLoggedIn();
+
+ // Check if we're on order-pay page (special handling)
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ let orderPayInfo = null;
+ if (isOrderPayPage) {
+ orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ }
+
+ ckoLogger.debug('canInitializeFlow: User status', {
+ isLoggedIn: userLoggedIn,
+ isOrderPayPage: isOrderPayPage,
+ hasOrderData: !!orderPayInfo,
+ hasBillingAddress: !!(orderPayInfo && orderPayInfo.billing_address)
+ });
+
+ if (userLoggedIn) {
+ // Logged-in users can initialize if billing address exists
+ // But still check if address is filled (user might have cleared it)
+ // On order-pay pages, hasBillingAddress() now checks order data first
+ const hasAddress = hasBillingAddress();
+ ckoLogger.debug('canInitializeFlow: Logged-in user address check', {
+ hasAddress: hasAddress,
+ isOrderPayPage: isOrderPayPage,
+ usingOrderData: !!(isOrderPayPage && orderPayInfo && orderPayInfo.billing_address)
+ });
+ if (hasAddress) {
+ return true;
+ }
+ // Address was cleared - wait for user to fill it
+ ckoLogger.debug('Cannot initialize Flow - logged-in user but billing address not filled');
+ return false;
+ }
+
+ // Guest users: Check ALL required fields are filled and valid
+ // On order-pay pages, requiredFieldsFilledAndValid() now checks order data first
+ const requiredFilled = requiredFieldsFilled();
+ const requiredValid = requiredFieldsFilledAndValid();
+
+ // Get field values for logging (prefer order data on order-pay pages)
+ let email, address1, city, country;
+ if (isOrderPayPage && orderPayInfo && orderPayInfo.billing_address) {
+ const billing = orderPayInfo.billing_address;
+ email = billing.email || billing.Email || '';
+ address1 = billing.street_address || billing.address_line1 || '';
+ city = billing.city || '';
+ country = billing.country || '';
+ } else {
+ email = getCheckoutFieldValue("billing_email");
+ address1 = getCheckoutFieldValue("billing_address_1");
+ city = getCheckoutFieldValue("billing_city");
+ country = getCheckoutFieldValue("billing_country");
+ }
+
+ // DETAILED LOGGING: Log each field individually
+ const emailField = document.getElementById("billing_email");
+ const addressField = document.getElementById("billing_address_1");
+ const cityField = document.getElementById("billing_city");
+ const countryField = document.getElementById("billing_country");
+ const postcodeField = document.getElementById("billing_postcode");
+
+ ckoLogger.debug('===== canInitializeFlow: Guest user validation DETAILED =====');
+ ckoLogger.debug('Field-by-field analysis:', {
+ email: {
+ fieldExists: !!emailField,
+ value: email || 'EMPTY',
+ rawValue: emailField?.value || 'EMPTY',
+ disabled: emailField?.disabled || false,
+ display: emailField?.style.display || 'default',
+ offsetParent: !!emailField?.offsetParent,
+ valid: email && isValidEmail(email)
+ },
+ address1: {
+ fieldExists: !!addressField,
+ value: address1 || 'EMPTY',
+ rawValue: addressField?.value || 'EMPTY',
+ disabled: addressField?.disabled || false,
+ display: addressField?.style.display || 'default',
+ offsetParent: !!addressField?.offsetParent
+ },
+ city: {
+ fieldExists: !!cityField,
+ value: city || 'EMPTY',
+ rawValue: cityField?.value || 'EMPTY',
+ disabled: cityField?.disabled || false,
+ display: cityField?.style.display || 'default',
+ offsetParent: !!cityField?.offsetParent
+ },
+ country: {
+ fieldExists: !!countryField,
+ value: country || 'EMPTY',
+ rawValue: countryField?.value || 'EMPTY',
+ disabled: countryField?.disabled || false,
+ display: countryField?.style.display || 'default',
+ offsetParent: !!countryField?.offsetParent
+ },
+ postcode: {
+ fieldExists: !!postcodeField,
+ value: getCheckoutFieldValue("billing_postcode") || 'EMPTY',
+ rawValue: postcodeField?.value || 'EMPTY',
+ disabled: postcodeField?.disabled || false,
+ display: postcodeField?.style.display || 'default',
+ offsetParent: !!postcodeField?.offsetParent
+ }
+ });
+
+ ckoLogger.debug('Validation results:', {
+ requiredFilled: requiredFilled,
+ requiredValid: requiredValid,
+ isOrderPayPage: isOrderPayPage,
+ usingOrderData: !!(isOrderPayPage && orderPayInfo && orderPayInfo.billing_address),
+ email: email ? 'SET' : 'EMPTY',
+ address1: address1 ? 'SET' : 'EMPTY',
+ city: city ? 'SET' : 'EMPTY',
+ country: country ? 'SET' : 'EMPTY',
+ hasBillingAddress: hasBillingAddress(),
+ hasCompleteBillingAddress: hasCompleteBillingAddress()
+ });
+
+ // Additional validation: Check email format and billing address
+ // This function now checks order data first on order-pay pages
+ if (!requiredFieldsFilledAndValid()) {
+ ckoLogger.debug('Cannot initialize Flow - required fields not filled or invalid');
+ return false;
+ }
+
+ ckoLogger.debug('canInitializeFlow: All checks passed - Flow can initialize');
+ return true;
+}
+
+/**
+ * Show waiting message in Flow container
+ */
+function showFlowWaitingMessage() {
+ const flowContainer = document.getElementById("flow-container");
+ if (!flowContainer) {
+ return;
+ }
+
+ // Show container but with waiting message
+ flowContainer.style.display = "block";
+
+ // Check if waiting message already exists
+ let waitingMessage = flowContainer.querySelector('.flow-waiting-message');
+ if (!waitingMessage) {
+ waitingMessage = document.createElement('div');
+ waitingMessage.className = 'flow-waiting-message';
+ waitingMessage.innerHTML = `
+ } Order ID if successful, null if failed
+ */
+ async function createOrderBeforePayment() {
+ // CRITICAL: Prevent multiple simultaneous order creation calls (race condition protection)
+ if (ckoOrderCreationInProgress) {
+ ckoLogger.warn('[CREATE ORDER] ⚠️ Order creation already in progress - preventing duplicate call');
+ // Wait a bit and check if order was created
+ await new Promise(resolve => setTimeout(resolve, 500));
+ const orderIdField = jQuery('input[name="order_id"]');
+ if (orderIdField.length && orderIdField.val()) {
+ const existingOrderId = orderIdField.val();
+ ckoLogger.debug('[CREATE ORDER] Order was created by previous call - Order ID: ' + existingOrderId);
+ return parseInt(existingOrderId);
+ }
+ // If still in progress after wait, return null to prevent duplicate
+ if (ckoOrderCreationInProgress) {
+ ckoLogger.error('[CREATE ORDER] ❌ Order creation still in progress after wait - aborting duplicate call');
+ return null;
+ }
+ }
+
+ // Set lock flag to prevent multiple simultaneous calls
+ ckoOrderCreationInProgress = true;
+
+ // Disable place order button to prevent multiple clicks
+ const placeOrderButton = jQuery('#place_order');
+ const originalButtonText = placeOrderButton.length ? placeOrderButton.text() : '';
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', true);
+ placeOrderButton.addClass('processing');
+ if (placeOrderButton.text().trim() !== '') {
+ placeOrderButton.data('original-text', placeOrderButton.text());
+ placeOrderButton.text('Processing...');
+ }
+ ckoLogger.debug('[CREATE ORDER] Place Order button disabled to prevent multiple clicks');
+ }
+
+ try {
+ // Check if order already exists (for order-pay page) - check BEFORE form lookup
+ const orderIdField = jQuery('input[name="order_id"]');
+ if (orderIdField.length && orderIdField.val()) {
+ const existingOrderId = orderIdField.val();
+ ckoLogger.debug('[CREATE ORDER] Order already exists (order-pay page) - Order ID: ' + existingOrderId);
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return parseInt(existingOrderId);
+ }
+
+ // Try to find form - checkout form or order-pay form
+ let form = jQuery("form.checkout");
+ if (!form.length) {
+ // Try order-pay form (form#order_review)
+ form = jQuery("form#order_review");
+ if (form.length) {
+ ckoLogger.debug('[CREATE ORDER] Found order-pay form (form#order_review)');
+ }
+ }
+
+ if (!form.length) {
+ ckoLogger.debug('[CREATE ORDER] No checkout form or order-pay form found - skipping order creation');
+ // For order-pay pages, order already exists, so return order ID from URL
+ if (window.location.pathname.includes('/order-pay/')) {
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ if (pathMatch && pathMatch[1]) {
+ const orderId = parseInt(pathMatch[1]);
+ ckoLogger.debug('[CREATE ORDER] Order-pay page detected - using order ID from URL: ' + orderId);
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return orderId;
+ }
+ }
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return null;
+ }
+
+ ckoLogger.debug('[CREATE ORDER] Creating order before payment processing...');
+
+ // Get form data
+ const formData = form.serialize();
+ const formDataObj = Object.fromEntries(new URLSearchParams(formData));
+
+ // Get nonce from form or page
+ let nonceValue = '';
+ const nonceField = jQuery('input[name="woocommerce-process-checkout-nonce"]');
+ if (nonceField.length > 0) {
+ nonceValue = nonceField.val();
+ }
+
+ // Fallback: Try to get nonce from form data
+ if (!nonceValue && formDataObj['woocommerce-process-checkout-nonce']) {
+ nonceValue = formDataObj['woocommerce-process-checkout-nonce'];
+ }
+
+ // Fallback: Try to get from meta tag or other sources
+ if (!nonceValue) {
+ const metaNonce = jQuery('meta[name="woocommerce-process-checkout-nonce"]');
+ if (metaNonce.length > 0) {
+ nonceValue = metaNonce.attr('content');
+ }
+ }
+
+ // For order-pay pages, order already exists, so we don't need to create it
+ // Just return the order ID from URL if nonce is missing
+ if (!nonceValue) {
+ if (window.location.pathname.includes('/order-pay/')) {
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ if (pathMatch && pathMatch[1]) {
+ const orderId = parseInt(pathMatch[1]);
+ ckoLogger.debug('[CREATE ORDER] Order-pay page - nonce missing but order exists, using order ID from URL: ' + orderId);
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return orderId;
+ }
+ }
+ ckoLogger.error('[CREATE ORDER] ERROR: Nonce not found in form or page');
+ ckoLogger.error('[CREATE ORDER] Form data keys:', Object.keys(formDataObj));
+ // Clear lock flag and re-enable button before returning
+ ckoOrderCreationInProgress = false;
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ return null;
+ }
+
+ ckoLogger.debug('[CREATE ORDER] Nonce found:', nonceValue.substring(0, 10) + '...');
+
+ // Ensure nonce is included in form data
+ formDataObj['woocommerce-process-checkout-nonce'] = nonceValue;
+
+ // Get payment session ID if available
+ const paymentSessionIdField = jQuery('input[name="cko-flow-payment-session-id"]');
+ const paymentSessionId = paymentSessionIdField.length > 0 ? paymentSessionIdField.val() : '';
+
+ // Get save card preference
+ const saveCardField = jQuery('input[name="cko-flow-save-card-persist"]');
+ const saveCardValue = saveCardField.length > 0 ? saveCardField.val() : '';
+
+ // Build data object ensuring nonce is included
+ const ajaxData = {
+ action: "cko_flow_create_order",
+ 'cko-flow-payment-session-id': paymentSessionId,
+ 'cko-flow-save-card-persist': saveCardValue
+ };
+
+ // Add all form data (including nonce)
+ Object.assign(ajaxData, formDataObj);
+
+ // Ensure nonce is explicitly included
+ if (nonceValue && !ajaxData['woocommerce-process-checkout-nonce']) {
+ ajaxData['woocommerce-process-checkout-nonce'] = nonceValue;
+ ckoLogger.debug('[CREATE ORDER] Explicitly added nonce to AJAX data');
+ }
+
+ ckoLogger.debug('[CREATE ORDER] AJAX data keys:', Object.keys(ajaxData));
+ ckoLogger.debug('[CREATE ORDER] Nonce in data:', !!ajaxData['woocommerce-process-checkout-nonce']);
+
+ const response = await jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: "POST",
+ data: ajaxData
+ }).fail(function(xhr, status, error) {
+ ckoLogger.error('[CREATE ORDER] ❌ AJAX Request Failed');
+ ckoLogger.error('[CREATE ORDER] Status:', status);
+ ckoLogger.error('[CREATE ORDER] Error:', error);
+ ckoLogger.error('[CREATE ORDER] Response Text:', xhr.responseText);
+ ckoLogger.error('[CREATE ORDER] Status Code:', xhr.status);
+ ckoLogger.error('[CREATE ORDER] Request Data:', ajaxData);
+ });
+
+ ckoLogger.debug('[CREATE ORDER] ========== PROCESSING AJAX RESPONSE ==========');
+ ckoLogger.debug('[CREATE ORDER] Response received:', response);
+ ckoLogger.debug('[CREATE ORDER] Response.success:', response?.success);
+ ckoLogger.debug('[CREATE ORDER] Response.data:', response?.data);
+ ckoLogger.debug('[CREATE ORDER] Response.data.order_id:', response?.data?.order_id);
+
+ if (response && response.success && response.data && response.data.order_id) {
+ const orderId = response.data.order_id;
+ ckoLogger.debug('[CREATE ORDER] ========== ORDER CREATED SUCCESSFULLY ==========');
+ ckoLogger.debug('[CREATE ORDER] ✅✅✅ Order created successfully - Order ID: ' + orderId + ' ✅✅✅');
+ ckoLogger.debug('[CREATE ORDER] Order ID type:', typeof orderId);
+ ckoLogger.debug('[CREATE ORDER] Order ID value:', orderId);
+
+ // Store order ID in form for process_payment()
+ if (!orderIdField.length) {
+ form.append('');
+ } else {
+ orderIdField.val(orderId);
+ }
+
+ // Store in session for fallback
+ sessionStorage.setItem('cko_flow_order_id', orderId);
+
+ // Clear lock flag on success
+ ckoOrderCreationInProgress = false;
+
+ // Re-enable place order button
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+
+ return parseInt(orderId);
+ } else {
+ // Check if this is a validation error
+ ckoLogger.error('[CREATE ORDER] ========== ORDER CREATION FAILED ==========');
+ ckoLogger.error('[CREATE ORDER] Response received:', response);
+ ckoLogger.error('[CREATE ORDER] Response type:', typeof response);
+ ckoLogger.error('[CREATE ORDER] Response.success:', response?.success);
+ ckoLogger.error('[CREATE ORDER] Response.data:', response?.data);
+
+ if (response && response.data && response.data.message) {
+ ckoLogger.error('[CREATE ORDER] ❌❌❌ VALIDATION FAILED - ORDER NOT CREATED ❌❌❌');
+ ckoLogger.error('[CREATE ORDER] Error message:', response.data.message);
+ ckoLogger.error('[CREATE ORDER] This is a validation error - order was NOT created');
+ showError(response.data.message);
+ } else {
+ ckoLogger.error('[CREATE ORDER] ❌❌❌ FAILED TO CREATE ORDER ❌❌❌');
+ ckoLogger.error('[CREATE ORDER] Full response:', JSON.stringify(response, null, 2));
+ ckoLogger.error('[CREATE ORDER] Order creation failed for unknown reason');
+ showError('Failed to create order. Please check your form and try again.');
+ }
+
+ // Clear lock flag on failure
+ ckoOrderCreationInProgress = false;
+
+ // Re-enable place order button on failure
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+
+ return null;
+ }
+ } catch (error) {
+ ckoLogger.error('[CREATE ORDER] ❌ AJAX Error:', error);
+
+ // Clear lock flag on error
+ ckoOrderCreationInProgress = false;
+
+ // Re-enable place order button on error
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+
+ return null;
+ } finally {
+ // Ensure lock flag is cleared even if something unexpected happens
+ // This is a safety net - the flag should already be cleared in success/error handlers
+ if (ckoOrderCreationInProgress) {
+ ckoLogger.warn('[CREATE ORDER] ⚠️ Lock flag still set in finally block - clearing it');
+ ckoOrderCreationInProgress = false;
+
+ // Re-enable button as safety measure
+ if (placeOrderButton.length) {
+ placeOrderButton.prop('disabled', false);
+ placeOrderButton.removeClass('processing');
+ const originalText = placeOrderButton.data('original-text');
+ if (originalText) {
+ placeOrderButton.text(originalText);
+ }
+ }
+ }
+ }
+ }
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ document.addEventListener("click", function (event) {
+ const flowPayment = document.getElementById(
+ "payment_method_wc_checkout_com_flow"
+ );
+
+ // If the Place Order button is clicked, proceed.
+ if (event.target && event.target.id === "place_order") {
+<<<<<<< HEAD
+ // CRITICAL: Prevent multiple clicks if order creation is already in progress
+ if (ckoOrderCreationInProgress) {
+ ckoLogger.warn('[PLACE ORDER] ⚠️ Order creation already in progress - ignoring duplicate click');
+ event.preventDefault();
+ return;
+ }
+
+ // Track that Place Order was clicked (for order creation on payment decline)
+ window.ckoPlaceOrderClicked = true;
+ ckoLogger.debug("Place Order button clicked - tracking for order creation on payment decline");
+
+ // If the Flow payment method is selected, proceed with validation and order placement.
+ if (flowPayment && flowPayment.checked) {
+ event.preventDefault();
+
+ // Check if saved card is selected BEFORE creating order
+ // For saved card payments, WooCommerce will create order on form submission
+ // So we should NOT create order via AJAX to prevent duplicates
+ // Check if saved card is selected (only by property - no defaults anymore)
+ let selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ let savedCardSelected = selectedSavedCard.length > 0;
+ let savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]')?.classList.contains('saved-card-is-enabled') || false;
+
+ if (savedCardSelected || savedCardEnabled) {
+ ckoLogger.debug('[CREATE ORDER] Saved card selected - bypassing Flow component (direct API call via WooCommerce)');
+ // For saved cards, let WooCommerce handle order creation and payment via direct API call
+ // Flow component is NOT used for saved cards - payment is processed server-side via API
+ const form = jQuery("form.checkout");
+
+ // Handle payment for order-pay page.
+ if (form.length === 0) {
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+ const orderPayForm = jQuery('form#order_review');
+
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+ // CRITICAL: Ensure payment session ID is in form before submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+ // Submit directly - no Flow component needed for saved cards
+ ckoLogger.debug('[SAVED CARD] Submitting order-pay form directly (bypassing Flow component)');
+ orderPayForm.submit();
+ }
+ } else {
+ // For saved cards, submit form directly to WooCommerce
+ // WooCommerce will call process_payment() which makes direct API call
+ // No Flow component validation needed
+ ckoLogger.debug('[SAVED CARD] Submitting checkout form directly (bypassing Flow component)');
+
+ // CRITICAL: Ensure payment session ID is in form before submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+ // Submit directly - no validateCheckout needed for saved cards
+ form.submit();
+ }
+ return; // Exit early - don't create order via AJAX, don't use Flow component
+ }
+
+ // CRITICAL: Validate checkout form FIRST before creating order
+ // This ensures orders are only created when form is valid
+ const form = jQuery("form.checkout");
+
+ // Handle payment for order-pay page (order already exists, skip validation)
+=======
+
+ // If the Flow payment method is selected, proceed with validation and order placement.
+ if (flowPayment && flowPayment.checked) {
+ event.preventDefault();
+
+ // Persist save card checkbox before form submission
+ persistSaveCardCheckbox();
+
+ const form = jQuery("form.checkout");
+
+ // Handle payment for order-pay page.
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ if ( form.length === 0 ) {
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+ const orderPayForm = jQuery('form#order_review');
+
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+<<<<<<< HEAD
+ // Order-pay page: Order already exists, proceed with payment processing
+=======
+ // console.log('[CURRENT VERSION] Order-pay page confirmed, showing flow container');
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ document.getElementById("flow-container").style.display = "block";
+
+ // Place order for FLOW.
+ if (ckoFlow.flowComponent) {
+<<<<<<< HEAD
+ // Check if a saved card is actually selected (only by property - no defaults anymore)
+ // Re-check saved card status (may have changed)
+ selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ savedCardSelected = selectedSavedCard.length > 0;
+ savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]')?.classList.contains('saved-card-is-enabled') || false;
+=======
+ // console.log('[CURRENT VERSION] Flow component exists');
+
+ // Check if a saved card is actually selected (not just if saved cards are enabled)
+ const selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ const savedCardSelected = selectedSavedCard.length > 0;
+ const savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]').classList.contains('saved-card-is-enabled');
+
+ // console.log('[CURRENT VERSION] Saved card selected:', savedCardSelected);
+ // console.log('[CURRENT VERSION] Saved card enabled:', savedCardEnabled);
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+
+ // ALWAYS persist save card checkbox on order-pay page (for new card payments)
+ if (!savedCardSelected) {
+ persistSaveCardCheckbox();
+ console.log('[FLOW] Order-pay: Persisted save card checkbox for new card payment');
+ }
+
+ if( savedCardSelected || savedCardEnabled ) {
+<<<<<<< HEAD
+ ckoLogger.debug('[SAVED CARD] Saved card selected - submitting order-pay form directly (bypassing Flow component)');
+ // CRITICAL: Ensure payment session ID is in form before submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+ // Submit directly - Flow component NOT used for saved cards
+ orderPayForm.submit();
+ } else {
+ // CRITICAL: Ensure payment session ID is in form before Flow component submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+
+=======
+ // console.log('[CURRENT VERSION] Saved card selected/enabled - submitting order-pay form directly');
+ orderPayForm.submit();
+ } else {
+ // console.log('[CURRENT VERSION] No saved card - calling flow component submit');
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // Check if component is valid before submitting
+ // Note: isValid() returns a boolean, not a Promise
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.isValid === 'function') {
+ const isValid = ckoFlow.flowComponent.isValid();
+ if (isValid) {
+ ckoLogger.debug('Flow component is valid, submitting...');
+<<<<<<< HEAD
+ try {
+ ckoFlow.flowComponent.submit();
+ } catch (error) {
+ ckoLogger.error('Flow component submit failed:', error);
+ showError('Payment processing failed. Please try again.');
+ }
+=======
+ ckoFlow.flowComponent.submit();
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ } else {
+ ckoLogger.error('Flow component is invalid, cannot submit');
+ showError('Payment form is not valid. Please check your payment details and try again.');
+ }
+ } else {
+ // Fallback: submit without validation check
+ ckoLogger.debug('Flow component validity check not available, submitting directly...');
+<<<<<<< HEAD
+ try {
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.submit === 'function') {
+ ckoFlow.flowComponent.submit();
+ } else {
+ ckoLogger.error('Flow component submit method not available');
+ showError('Payment component not ready. Please refresh the page and try again.');
+ }
+ } catch (error) {
+ ckoLogger.error('Flow component submit failed (fallback):', error);
+ showError('Payment processing failed. Please try again.');
+ }
+ }
+ }
+ } else {
+ // No flow component - submit order-pay form for saved card
+ orderPayForm.submit();
+ }
+ }
+ return; // Exit early for order-pay page
+ }
+
+ // Regular checkout: Check Flow component validity BEFORE creating order
+ // This prevents creating orders when payment form is invalid
+ ckoLogger.debug('[VALIDATION] Checking Flow component validity before order creation...');
+
+ // Check if saved card is selected (saved cards don't need Flow component validation)
+ // Re-check saved card status (may have changed)
+ selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ savedCardSelected = selectedSavedCard.length > 0;
+ savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]')?.classList.contains('saved-card-is-enabled') || false;
+
+ // For new card payments, validate Flow component BEFORE creating order
+ if (!savedCardSelected && !savedCardEnabled && ckoFlow.flowComponent) {
+ if (typeof ckoFlow.flowComponent.isValid === 'function') {
+ const isValid = ckoFlow.flowComponent.isValid();
+ if (!isValid) {
+ ckoLogger.error('[VALIDATION] ❌ Flow component is invalid - blocking order creation');
+ showError('Payment form is not valid. Please check your payment details and try again.');
+ return; // Exit early - don't create order
+ }
+ ckoLogger.debug('[VALIDATION] ✅ Flow component is valid - proceeding with order creation');
+ } else {
+ ckoLogger.warn('[VALIDATION] ⚠️ Flow component isValid() method not available - proceeding with order creation');
+ }
+ }
+
+ // Create order (which includes server-side validation)
+ // OPTIMIZATION: Combined validation + order creation into single AJAX call
+ // This reduces latency by ~100-200ms compared to separate validation call
+ ckoLogger.debug('[CREATE ORDER] Creating order with built-in validation...');
+ (async function() {
+ const orderId = await createOrderBeforePayment();
+ if (!orderId) {
+ // Order creation failed - error already shown by createOrderBeforePayment()
+ // This could be due to validation errors or other issues
+ ckoLogger.error('[CREATE ORDER] Failed to create order - cannot proceed with payment');
+ return;
+ }
+
+ ckoLogger.debug('[CREATE ORDER] ✅ Order created successfully - Order ID: ' + orderId);
+
+ // CRITICAL: Ensure payment session ID is added to form before submission
+ // This is a fallback in case form wasn't available when payment session was created
+ if (window.ckoAddPaymentSessionIdField) {
+ const added = window.ckoAddPaymentSessionIdField();
+ if (added) {
+ ckoLogger.debug('[SAVE PAYMENT SESSION ID] Hidden field added on Place Order click (fallback)');
+ }
+ }
+
+ // Persist save card checkbox before form submission
+ persistSaveCardCheckbox();
+
+ // Show flow container
+ document.getElementById("flow-container").style.display = "block";
+
+ // Place order for FLOW.
+ if (ckoFlow.flowComponent) {
+ if( savedCardSelected || savedCardEnabled ) {
+ ckoLogger.debug('[SAVED CARD] Saved card selected - submitting checkout form directly (bypassing Flow component)');
+ // CRITICAL: Ensure payment session ID is in form before submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+ // Submit directly - Flow component NOT used for saved cards
+ // WooCommerce will call process_payment() which makes direct API call
+ form.submit();
+ } else {
+ // CRITICAL: Ensure payment session ID is in form before Flow component submission
+ if (window.ckoAddPaymentSessionIdField) {
+ window.ckoAddPaymentSessionIdField();
+ }
+
+ // Double-check component validity before submitting (defense-in-depth)
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.isValid === 'function') {
+ const isValid = ckoFlow.flowComponent.isValid();
+ if (isValid) {
+ ckoLogger.debug('Flow component is valid, submitting...');
+ try {
+ ckoFlow.flowComponent.submit();
+ } catch (error) {
+ ckoLogger.error('Flow component submit failed:', error);
+ showError('Payment processing failed. Please try again.');
+ }
+ } else {
+ ckoLogger.error('Flow component became invalid after order creation - cannot submit');
+ showError('Payment form is not valid. Please check your payment details and try again.');
+ // Note: Order was created but payment cannot proceed
+ // The order will remain in "pending" status
+ }
+ } else {
+ // Fallback: submit without validation check
+ ckoLogger.debug('Flow component validity check not available, submitting directly...');
+ try {
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.submit === 'function') {
+ ckoFlow.flowComponent.submit();
+ } else {
+ ckoLogger.error('Flow component submit method not available');
+ showError('Payment component not ready. Please refresh the page and try again.');
+ }
+ } catch (error) {
+ ckoLogger.error('Flow component submit failed (fallback):', error);
+ showError('Payment processing failed. Please try again.');
+ }
+ }
+ }
+ } else {
+ ckoLogger.error('[CREATE ORDER] Flow component not found - cannot process payment');
+ showError('Payment component not loaded. Please refresh the page and try again.');
+ }
+
+ // Place order for saved card.
+ if (!ckoFlow.flowComponent) {
+ form.submit();
+ }
+ })(); // Close async IIFE for order creation
+=======
+ ckoFlow.flowComponent.submit();
+ }
+ }
+ } else {
+ // console.log('[CURRENT VERSION] No flow component found');
+ }
+
+ // Place order for saved card.
+ if (!ckoFlow.flowComponent) {
+ // console.log('[CURRENT VERSION] No flow component - submitting order-pay form for saved card');
+ orderPayForm.submit();
+ }
+
+ } else {
+ // console.log('[CURRENT VERSION] Not an order-pay page, skipping');
+ }
+ } else {
+ // console.log('[CURRENT VERSION] Checkout form found - handling regular checkout');
+
+ // Validate checkout before proceeding.
+ validateCheckout(form, function (response) {
+ // console.log('[CURRENT VERSION] Checkout validation response:', response);
+ document.getElementById("flow-container").style.display = "block";
+
+ // Place order for FLOW.
+ if (ckoFlow.flowComponent) {
+ // console.log('[CURRENT VERSION] Flow component exists for checkout');
+
+ // Check if a saved card is actually selected (not just if saved cards are enabled)
+ const selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ const savedCardSelected = selectedSavedCard.length > 0;
+ const savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]').classList.contains('saved-card-is-enabled');
+
+ // console.log('[CURRENT VERSION] Saved card selected for checkout:', savedCardSelected);
+ // console.log('[CURRENT VERSION] Saved card enabled for checkout:', savedCardEnabled);
+
+ if( savedCardSelected || savedCardEnabled ) {
+ // console.log('[CURRENT VERSION] Saved card selected/enabled - submitting checkout form directly');
+ form.submit();
+ } else {
+ // console.log('[CURRENT VERSION] No saved card - calling flow component submit for checkout');
+ // Check if component is valid before submitting
+ // Note: isValid() returns a boolean, not a Promise
+ if (ckoFlow.flowComponent && typeof ckoFlow.flowComponent.isValid === 'function') {
+ const isValid = ckoFlow.flowComponent.isValid();
+ if (isValid) {
+ ckoLogger.debug('Flow component is valid, submitting...');
+ ckoFlow.flowComponent.submit();
+ } else {
+ ckoLogger.error('Flow component is invalid, cannot submit');
+ showError('Payment form is not valid. Please check your payment details and try again.');
+ }
+ } else {
+ // Fallback: submit without validation check
+ ckoLogger.debug('Flow component validity check not available, submitting directly...');
+ ckoFlow.flowComponent.submit();
+ }
+ }
+ } else {
+ // console.log('[CURRENT VERSION] No flow component found for checkout');
+ }
+
+ // Place order for saved card.
+ if (!ckoFlow.flowComponent) {
+ // console.log('[CURRENT VERSION] No flow component - submitting checkout form for saved card');
+ form.submit();
+ }
+ });
+
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ } else {
+ // console.log('[CURRENT VERSION] Flow payment method not selected or not found');
+ }
+ }
+ });
+});
+
+// Removed complex 3DS redirect handling - keeping it simple like the working version
+
+let virtual = false;
+/**
+ * Handle checkout flow-container rendering on various field changes.
+ * Attaches debounced event listeners to checkout inputs to update flow state and cart info dynamically.
+ */
+jQuery(function ($) {
+
+ /**
+ * Main handler function triggered on input/change events.
+ * It performs field checks and updates the checkout flow and cart info accordingly.
+ *
+ * @param {Event} event - The input or change event.
+ */
+ const handleTyping = (event) => {
+
+ let isShippingField = false;
+
+ // Check if the changed field belongs to shipping info.
+ if (event) {
+ const $target = jQuery(event.target);
+ isShippingField = $target.is('[id^="shipping"]');
+ }
+
+ // If the field is a shipping-related field, trigger WooCommerce checkout update and exit early.
+ if (isShippingField) {
+ console.log("Triggered by a shipping field, skipping...");
+ $("body").trigger("update_checkout");
+ return;
+ }
+
+<<<<<<< HEAD
+ // Check if this is a critical field that requires Flow reload
+ const criticalFields = [
+ 'billing_email',
+ 'billing_country',
+ 'billing_address_1',
+ 'billing_city',
+ 'billing_postcode',
+ 'billing_state'
+ ];
+
+ const fieldName = event.target.name || event.target.id || '';
+ const fieldId = event.target.id || '';
+ const isCriticalField = criticalFields.some(field =>
+ fieldName.includes(field.replace('billing_', '')) ||
+ fieldId.includes(field.replace('billing_', ''))
+ );
+
+ // Store previous values to detect changes
+ if (isCriticalField && ckoFlowInitialized) {
+ const currentValue = event.target.value || '';
+ const fieldKey = fieldId || fieldName;
+ const previousValue = window.ckoFlowFieldValues?.[fieldKey] || '';
+
+ // If value actually changed (not just typing)
+ if (currentValue !== previousValue) {
+ // Update stored value
+ if (!window.ckoFlowFieldValues) {
+ window.ckoFlowFieldValues = {};
+ }
+ window.ckoFlowFieldValues[fieldKey] = currentValue;
+
+ // Debounce the reload check
+ debouncedCheckFlowReload(fieldKey, currentValue);
+ }
+ }
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // Only proceed if all required fields are filled.
+ if (requiredFieldsFilled()) {
+ $("body").trigger("update_checkout");
+
+ // If the event is from checking 'ship to different address' or 'create account', return early.
+ if (
+ jQuery(event.target).is(
+ "#ship-to-different-address-checkbox, #createaccount"
+ ) &&
+ jQuery(event.target).is(":checked")
+ ) {
+ console.log("User just checked the checkbox. Returning early...");
+ return;
+ }
+
+ var targetName = event.target.name || "";
+
+ // If the event is not from billing fields or key checkboxes, exit early.
+ if (
+ !targetName.startsWith("billing") &&
+ !jQuery(event.target).is(
+ "#ship-to-different-address-checkbox, #terms, #createaccount, #coupon_code"
+ )
+ ) {
+ let cartData = $("#cart-info").data("cart");
+ if ( !cartData || !cartData["contains_virtual_product"] ) {
+ console.log(
+ "Neither billing nor the shipping checkbox. Returning early..."
+ );
+ return;
+ }
+ console.log(
+ "Virtual Product found. Triggering FLOW..."
+ );
+ }
+
+<<<<<<< HEAD
+ // Check required fields status (for initialization/reload)
+ checkRequiredFieldsStatus();
+ } else {
+ // Required fields not filled - check status anyway
+ // This ensures Flow initializes when fields become filled
+ checkRequiredFieldsStatus();
+ }
+
+ // Always check field status on any field change (for initialization)
+ // This ensures Flow initializes as soon as all fields are filled
+ if (!ckoFlowInitialized) {
+ checkRequiredFieldsStatus();
+
+ // Also directly check if we can initialize now
+ if (canInitializeFlow()) {
+ ckoLogger.debug('Field change detected - all fields now valid, initializing Flow');
+ initializeFlowIfNeeded();
+ }
+=======
+ // SIMPLIFIED: Don't re-initialize Flow when typing in fields
+ // Flow should only initialize when payment method is selected
+ // This prevents Flow from disappearing/reloading when user types
+ ckoLogger.debug('Field changed - NOT re-initializing Flow (simplified approach)');
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ }
+ };
+
+ // Debounce the handler to limit how often it's triggered during typing.
+ const debouncedTyping = debounce(handleTyping, 2000);
+
+ // Attach debounced handler to key billing fields.
+ $(
+ "#billing_first_name, #billing_last_name, #billing_email, #billing_phone"
+ ).on("input", function (e) {
+ debouncedTyping(e);
+ });
+
+ // Attach to all other inputs/selects, excluding the key billing fields above.
+ $(
+ "input:not(#billing_first_name, #billing_last_name, #billing_email, #billing_phone), select"
+ ).on("input change", function (e) {
+ debouncedTyping(e);
+ });
+
+ // Attach handler to all input/selects, but ignore payment method fields.
+ $(document).on("input change", "input, select", function (e) {
+ if ($(this).closest(".wc_payment_method").length === 0) {
+
+ debouncedTyping(e);
+
+ }
+
+ let cartData = $("#cart-info").data("cart");
+ if ( !virtual && cartData && cartData["contains_virtual_product"] && $('#ship-to-different-address-checkbox').length === 0 ) {
+ debouncedTyping(e);
+ virtual = true;
+ }
+ });
+<<<<<<< HEAD
+
+ // Watch country field specifically for Flow reload
+ jQuery('#billing_country').on('change.flow-reload', function() {
+ ckoLogger.debug('Billing country changed - will reload Flow after checkout update');
+
+ // Wait for WooCommerce to update fields
+ jQuery(document).one('updated_checkout', function() {
+ // Small delay to ensure fields are updated
+ setTimeout(() => {
+ if (ckoFlowInitialized && ckoFlow.flowComponent) {
+ // Store country value
+ const countryValue = jQuery('#billing_country').val();
+ if (!window.ckoFlowFieldValues) {
+ window.ckoFlowFieldValues = {};
+ }
+ window.ckoFlowFieldValues['billing_country'] = countryValue;
+
+ // Reload Flow
+ reloadFlowComponent();
+ } else if (canInitializeFlow()) {
+ initializeFlowIfNeeded();
+ }
+ }, 500);
+ });
+ });
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+});
+
+/**
+ *
+ * Debounce utility function.
+ * Delays the execution of a function until after a specified delay
+ * has passed since the last time it was invoked.
+ *
+ * @param {Function} func - The function to debounce.
+ * @param {number} delay - Delay in milliseconds.
+ *
+ * @returns {Function} - A debounced version of the original function.
+ */
+function debounce(func, delay) {
+ let timer;
+
+ return function (...args) {
+
+ // Clear the existing timer, if any.
+ clearTimeout(timer);
+
+ // Set a new timer to call the function after the delay.
+ timer = setTimeout(() => {
+
+ // Call the original function with the correct context and arguments.
+ func.apply(this, args);
+ }, delay);
+ };
+}
+
+/**
+ * Checks if all non-shipping required fields in the WooCommerce checkout form are filled.
+ *
+ * This function looks for elements marked with a `.required` span inside labels
+ * within the `.woocommerce-checkout` form, extracts the associated input field IDs,
+ * filters out those related to shipping, and then verifies that the corresponding
+ * fields are not empty.
+ *
+ * @returns {boolean} - Returns true if all non-shipping required fields are filled; otherwise, false.
+ */
+function requiredFieldsFilled() {
+<<<<<<< HEAD
+=======
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // Select all required field indicators within WooCommerce checkout labels.
+ const requiredLabels = document.querySelectorAll(
+ ".woocommerce-checkout label .required"
+ );
+
+ const fieldIds = [];
+
+ requiredLabels.forEach((label) => {
+ const fieldId = label.closest("label").getAttribute("for");
+ if (fieldId) {
+ fieldIds.push(fieldId);
+ }
+ });
+
+ // Filter out fieldIds that start with "shipping".
+ let filteredFieldIds = fieldIds.filter((id) => !id.startsWith("shipping"));
+
+<<<<<<< HEAD
+ // CRITICAL: Filter out payment gateway fields from OTHER payment methods
+ // When Checkout.com is selected, PayPal/Stripe fields are still in DOM but empty
+ // We should only check fields relevant to Checkout.com or general checkout fields
+ // Strategy: Check if field is inside another payment gateway's container OR has gateway prefix
+ filteredFieldIds = filteredFieldIds.filter((id) => {
+ const field = document.getElementById(id);
+ if (!field) {
+ return false; // Field doesn't exist
+ }
+
+ // First check: If field ID starts with known payment gateway prefixes, exclude it
+ // This catches fields like ppcp-credit-card-gateway-card-number that might not be in containers
+ const paymentGatewayPrefixes = ['ppcp-', 'stripe-', 'wc-stripe-', 'square-', 'authorize-'];
+ const isOtherGatewayField = paymentGatewayPrefixes.some(prefix => id.startsWith(prefix));
+ if (isOtherGatewayField) {
+ return false;
+ }
+
+ // Second check: Check if field is inside a payment gateway container
+ // WooCommerce payment gateways are wrapped in: .payment_method_{gateway_id}
+ const paymentMethodContainer = field.closest('.payment_method');
+
+ if (paymentMethodContainer) {
+ // Field is inside a payment gateway container
+ const containerClass = paymentMethodContainer.className;
+
+ // Check if it's Checkout.com Flow container
+ if (containerClass.includes('payment_method_wc_checkout_com_flow')) {
+ // This is a Checkout.com field - include it
+ return true;
+ } else {
+ // Field is inside another payment gateway container (PayPal, Stripe, etc.)
+ // Exclude it - we only want Checkout.com fields or general checkout fields
+ return false;
+ }
+ }
+
+ // Field is NOT inside any payment gateway container and doesn't have gateway prefix
+ // This means it's a general checkout field (billing_email, billing_address, etc.)
+ // Include it - these are always relevant
+ return true;
+ });
+
+ // Check if login form is hidden.
+ const loginForm = document.querySelector(".woocommerce-form-login");
+ const loginFormHidden = loginForm && loginForm.style.display === "none";
+
+ if (loginFormHidden) {
+=======
+ // Check if login form is hidden.
+ const loginForm = document.querySelector(".woocommerce-form-login");
+ if (loginForm && loginForm.style.display === "none") {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // Remove username and password fields if form is hidden.
+ filteredFieldIds = filteredFieldIds.filter(
+ (id) => id !== "username" && id !== "password"
+ );
+ }
+
+ // Check that each field is present and not empty.
+ const result = filteredFieldIds.every((id) => {
+ const field = document.getElementById(id);
+<<<<<<< HEAD
+ const fieldExists = !!field;
+ const fieldValue = field?.value || '';
+ const fieldValueTrimmed = fieldValue.trim();
+ const isEmpty = fieldValueTrimmed === "";
+
+ return fieldExists && !isEmpty;
+=======
+ return field && field.value.trim() !== "";
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ });
+
+ return result;
+}
+
+/**
+ * Validates the checkout form by sending serialized form data to the server
+ * using an AJAX POST request. Executes callback functions based on the response.
+ *
+ * @param {jQuery} form - The jQuery-wrapped form element to be validated.
+ * @param {Function} onSuccess - Callback function executed when validation is successful.
+ * @param {Function} onError - Optional callback function executed when validation fails or an error occurs.
+ */
+function validateCheckout(form, onSuccess, onError) {
+
+ const formData = form.serialize(); // Serialize the form.
+
+ // Perform AJAX POST request for server-side validation.
+ jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: "POST",
+ data: {
+ action: "cko_validate_checkout",
+ ...Object.fromEntries(new URLSearchParams(formData)),
+ },
+ success: function (response) {
+
+ // If the response indicates success, trigger the onSuccess callback.
+ if (response.success) {
+ onSuccess(response);
+ } else {
+
+ // Show an error message and trigger the onError callback if provided.
+ showError(response.data.message);
+ if (onError) onError(response);
+ }
+ },
+ error: function () {
+
+ // If the request fails, display the flow container and show a generic error message.
+ document.getElementById("flow-container").style.display = "block";
+ showError(
+ wp.i18n.__(
+ "An error occurred. Please try again.",
+ "checkout-com-unified-payments-api"
+ )
+ );
+
+ // Trigger onError callback if provided.
+ if (onError) onError();
+ },
+ });
+}
+
+/**
+ * Handles radio button selection across multiple saved payment method lists.
+ *
+ * This script ensures that only one radio button across multiple
+ * `.woocommerce-SavedPaymentMethods` lists can be selected at a time.
+ *
+ * Behavior:
+ * - If a radio button inside one list is selected, all radios in the other lists are deselected.
+ * - Supports dynamically added elements by using event delegation on `document`.
+ *
+ * Implementation details:
+ * - Uses jQuery's `on('change')` with delegation to handle dynamically loaded content.
+ * - `currentUl` stores the UL containing the selected radio.
+ * - `otherUls` targets all other ULs to clear their selected radios.
+ *
+ * Example:
+ * If the user selects a radio in the first UL and then selects a radio in the second UL,
+ * the first UL's selected radio is automatically deselected.
+ */
+jQuery(function($) {
+ $(document).on('change', '.woocommerce-SavedPaymentMethods input[type="radio"]', function() {
+ const currentUl = $(this).closest('.woocommerce-SavedPaymentMethods'); // Current UL.
+ const otherUls = $('.woocommerce-SavedPaymentMethods').not(currentUl); // All other ULs.
+
+ // Uncheck all radios in the other ULs.
+ otherUls.find('input[type="radio"]').prop('checked', false);
+ });
+});
+
+/**
+ * Toggles the visibility of the Checkout Payment FLOW label based on the presence
+ * of the 'saved-card-is-enabled' class on the web component root.
+ *
+ * Behavior:
+ * 1. Initially hides the label if the body has class 'flow-method-single' and the
+ * root element exists without 'saved-card-is-enabled'.
+ * 2. Shows the label if 'saved-card-is-enabled' class is present on the root element.
+ * 3. Dynamically observes the root element:
+ * - Detects when the root element appears in the DOM.
+ * - Watches for class changes on the root to toggle the label visibility in real-time.
+ *
+ * Uses MutationObserver to handle dynamically loaded elements and class changes.
+ */
+document.addEventListener('DOMContentLoaded', function () {
+ const labelSelector = 'label[for="payment_method_wc_checkout_com_flow"]';
+ const rootSelector = '[data-testid="checkout-web-component-root"]';
+
+ const checkAndToggle = () => {
+ const label = document.querySelector(labelSelector);
+ const rootElement = document.querySelector(rootSelector);
+
+ // Check if we have saved cards (new behavior)
+ const hasSavedCards = document.querySelector('.saved-cards-accordion-container');
+
+ if (label) {
+ // ALWAYS show the label (either with saved cards or without)
+ label.style.removeProperty('display');
+
+ if (hasSavedCards) {
+ console.log('[FLOW LABEL] Label shown - saved cards present');
+ } else {
+ console.log('[FLOW LABEL] Label shown - no saved cards (default label)');
+ }
+
+ /* DISABLED - Old behavior that was hiding the label
+ // Old behavior: only for flow-method-single (no saved cards)
+ if (document.body.classList.contains('flow-method-single') && rootElement) {
+ if (rootElement.classList.contains('saved-card-is-enabled')) {
+ label.style.removeProperty('display'); // Show again.
+ } else {
+ label.style.setProperty('display', 'none', 'important'); // Hide.
+ }
+ }
+ */
+ }
+ };
+
+ // Watch for root element and its class changes.
+ const observer = new MutationObserver(() => {
+ const rootElement = document.querySelector(rootSelector);
+
+ if (rootElement) {
+ // Run once when root appears.
+ checkAndToggle();
+
+ // Now watch the root for class changes.
+ const classObserver = new MutationObserver(checkAndToggle);
+ classObserver.observe(rootElement, { attributes: true, attributeFilter: ['class'] });
+
+ observer.disconnect(); // Stop watching for root element.
+ }
+ });
+
+ observer.observe(document.body, { childList: true, subtree: true });
+
+ // Also check immediately and after a delay for saved cards
+ checkAndToggle();
+ setTimeout(checkAndToggle, 500);
+ setTimeout(checkAndToggle, 1000);
+});
+
+/**
+ * On DOMContentLoaded, checks if the current order payment type is "MOTO".
+ * If so, it ensures that no saved payment tokens are pre-selected.
+ *
+ * - Looks for the #order-pay-info element and reads its "order-pay" data attribute.
+ * - If payment_type is "MOTO" (Admin order + Order-pay page + Guest customer):
+ * - Finds all saved payment token radio inputs from Checkout.com (Flow & Cards).
+ * - Iterates through them and unchecks each one, forcing the user to actively select a payment method.
+ */
+document.addEventListener('DOMContentLoaded', function () {
+ const orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ if ( orderPayInfo?.payment_type === 'MOTO' ) {
+ console.log('here');
+ const radios = document.querySelectorAll(
+ 'input[name="wc-wc_checkout_com_flow-payment-token"], input[name="wc-wc_checkout_com_cards-payment-token"]'
+ );
+ radios.forEach(radio => {
+ radio.checked = false;
+ });
+ }
+});
+
+/**
+ * REMOVED: JavaScript AJAX handler for 3DS redirects
+ *
+ * The 3DS redirect now goes directly to the PHP endpoint (handle_3ds_return)
+ * which processes the payment and redirects to the success page.
+ * This provides a smoother transition without showing the checkout page.
+ *
+ * The success_url in the payment session request points to:
+ * /wc-api/wc_checkoutcom_flow_process?cko-payment-id=XXX
+ *
+ * This endpoint processes the payment and redirects directly to order-received page.
+ */
diff --git a/flow-integration/assets/js/payment-session.js.backup b/flow-integration/assets/js/payment-session.js.backup
new file mode 100644
index 00000000..53b6fea7
--- /dev/null
+++ b/flow-integration/assets/js/payment-session.js.backup
@@ -0,0 +1,2151 @@
+/*
+ * Centralized logging utility for Checkout.com Flow integration.
+ * Controls what logs appear in production vs debug mode.
+ */
+var ckoLogger = {
+ debugEnabled: (typeof cko_flow_vars !== 'undefined' && cko_flow_vars.debug_logging) || false,
+
+ // ALWAYS VISIBLE (Production + Debug) - Critical for payment troubleshooting
+ error: function(message, data) {
+ console.error('[FLOW ERROR] ' + message, data !== undefined ? data : '');
+ },
+
+ warn: function(message, data) {
+ console.warn('[FLOW WARNING] ' + message, data !== undefined ? data : '');
+ },
+
+ webhook: function(message, data) {
+ console.log('[FLOW WEBHOOK] ' + message, data !== undefined ? data : '');
+ },
+
+ threeDS: function(message, data) {
+ console.log('[FLOW 3DS] ' + message, data !== undefined ? data : '');
+ },
+
+ payment: function(message, data) {
+ console.log('[FLOW PAYMENT] ' + message, data !== undefined ? data : '');
+ },
+
+ version: function(version) {
+ console.log('🚀 Checkout.com Flow v' + version);
+ },
+
+ // DEBUG ONLY (Hidden in Production) - Enable via "Debug Logging" setting
+ debug: function(message, data) {
+ if (this.debugEnabled) {
+ console.log('[FLOW DEBUG] ' + message, data !== undefined ? data : '');
+ }
+ },
+
+ performance: function(message, data) {
+ if (this.debugEnabled) {
+ console.log('[FLOW PERFORMANCE] ' + message, data !== undefined ? data : '');
+ }
+ }
+};
+
+/*
+ * The main object managing the Checkout.com flow payment integration.
+ */
+var ckoFlow = {
+ flowComponent: null, // Holds the reference to the Checkout Web Component.
+ performanceMetrics: {
+ pageLoadTime: null,
+ flowInitStartTime: null,
+ flowReadyTime: null,
+ },
+
+ /*
+ * Initializes the payment flow by loading the component.
+ */
+ init: () => {
+ // Mark when Flow initialization starts
+ ckoFlow.performanceMetrics.flowInitStartTime = performance.now();
+ ckoLogger.performance('Flow initialization started');
+ ckoFlow.loadFlow();
+ },
+
+ /*
+ * Loads the Checkout.com payment flow by collecting cart and user info,
+ * creating a payment session, and mounting the Checkout component.
+ */
+ loadFlow: async () => {
+ // Check if cko_flow_vars is available
+ if (typeof cko_flow_vars === 'undefined') {
+ ckoLogger.error('cko_flow_vars is not defined. Flow cannot be initialized.');
+ return;
+ }
+
+ ckoLogger.version('2025-10-13-FINAL-E2E');
+
+ // Check if we're on a redirect page with payment parameters - if so, don't initialize Flow
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const status = urlParams.get("status");
+
+ if ((paymentId || sessionId) && status === 'succeeded') {
+ ckoLogger.threeDS('3DS redirect completed - Processing payment', {
+ paymentId: paymentId,
+ sessionId: sessionId,
+ status: status
+ });
+
+ // Set the payment ID in the hidden input
+ const paymentIdInput = document.getElementById('cko-flow-payment-id');
+ if (paymentIdInput && paymentId) {
+ paymentIdInput.value = paymentId;
+ ckoLogger.debug('Set payment ID in hidden input:', paymentId);
+ }
+
+ // Set payment type to card (most common)
+ const paymentTypeInput = document.getElementById('cko-flow-payment-type');
+ if (paymentTypeInput) {
+ paymentTypeInput.value = 'card';
+ ckoLogger.debug('Set payment type to: card');
+ }
+
+ // Submit the checkout form to complete the order
+ setTimeout(() => {
+ const checkoutForm = document.querySelector('form.checkout');
+ const orderPayForm = document.querySelector('form#order_review');
+
+ if (checkoutForm) {
+ ckoLogger.threeDS('Submitting checkout form to complete order');
+ jQuery(checkoutForm).submit();
+ } else if (orderPayForm) {
+ ckoLogger.threeDS('Submitting order-pay form to complete order');
+ jQuery(orderPayForm).submit();
+ } else {
+ ckoLogger.error('No checkout or order-pay form found after 3DS redirect');
+ }
+ }, 500); // Small delay to ensure DOM is ready
+
+ return; // Don't initialize Flow component
+ }
+
+ // Show skeleton loader and disable place order button
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+
+ if (skeleton) {
+ skeleton.classList.add("show");
+ }
+ if (placeOrderBtn) {
+ placeOrderBtn.classList.add("flow-loading");
+ }
+
+ let cartInfo = jQuery("#cart-info").data("cart");
+
+ if ( ! cartInfo || jQuery.isEmptyObject( cartInfo ) ) {
+ cartInfo = jQuery("#order-pay-info").data("order-pay");
+ }
+
+ /*
+ * Extract information from cartInfo or fallback to DOM form inputs.
+ */
+ let amount = cartInfo["order_amount"];
+ let currency = cartInfo["purchase_currency"];
+
+ let reference = "WOO" + (cko_flow_vars.ref_session || 'default');
+
+ let email =
+ cartInfo["billing_address"]["email"] ||
+ (document.getElementById("billing_email") ? document.getElementById("billing_email").value : '');
+ let family_name =
+ cartInfo["billing_address"]["family_name"] ||
+ (document.getElementById("billing_last_name") ? document.getElementById("billing_last_name").value : '');
+ let given_name =
+ cartInfo["billing_address"]["given_name"] ||
+ (document.getElementById("billing_first_name") ? document.getElementById("billing_first_name").value : '');
+ let phone =
+ cartInfo["billing_address"]["phone"] ||
+ (document.getElementById("billing_phone") ? document.getElementById("billing_phone").value : '');
+
+ let address1 = shippingAddress1 = cartInfo["billing_address"]["street_address"];
+ let address2 = shippingAddress2 = cartInfo["billing_address"]["street_address2"];
+ let city = shippingCity = cartInfo["billing_address"]["city"];
+ let zip = shippingZip = cartInfo["billing_address"]["postal_code"];
+ let country = shippingCountry = cartInfo["billing_address"]["country"];
+
+
+ let shippingElement = document.getElementById("ship-to-different-address-checkbox");
+ if ( shippingElement?.checked ) {
+ shippingAddress1 = cartInfo["shipping_address"]["street_address"];
+ shippingAddress2 = cartInfo["shipping_address"]["street_address2"];
+ shippingCity = cartInfo["shipping_address"]["city"];
+ shippingZip = cartInfo["shipping_address"]["postal_code"];
+ shippingCountry = cartInfo["shipping_address"]["country"];
+ }
+
+ let orders = cartInfo["order_lines"];
+
+ let products = cartInfo["order_lines"]
+ .map(line => line.name)
+ .join(', ');
+
+ let description = 'Payment from ' + cko_flow_vars.site_url + ' for [ ' + products + ' ]';
+
+ let orderId = cartInfo["order_id"];
+ console.log('[FLOW DEBUG] Initial orderId from cartInfo:', orderId);
+ console.log('[FLOW DEBUG] Current URL pathname:', window.location.pathname);
+ console.log('[FLOW DEBUG] Current URL search:', window.location.search);
+
+ // For MOTO orders (order-pay page), get order ID from URL path if not in cartInfo
+ if ( ! orderId && window.location.pathname.includes('/order-pay/') ) {
+ // Extract order ID from URL path like /order-pay/4127/
+ const pathMatch = window.location.pathname.match(/\/order-pay\/(\d+)\//);
+ orderId = pathMatch ? pathMatch[1] : null;
+ console.log('[FLOW DEBUG] MOTO order detected - Order ID from URL path:', orderId);
+ }
+
+ console.log('[FLOW DEBUG] Final orderId:', orderId);
+
+ let payment_type = cko_flow_vars.regular_payment_type;
+
+ let metadata = {
+ udf5: cko_flow_vars.udf5,
+ }
+
+ if ( orderId ) {
+ metadata = {
+ udf5: cko_flow_vars.udf5,
+ order_id: orderId,
+ }
+
+ payment_type = cartInfo["payment_type"];
+ }
+
+ // Check for subscription product.
+ let containsSubscriptionProduct = cartInfo["contains_subscription_product"];
+
+ if ( containsSubscriptionProduct ) {
+ const isSubscription = orders.some(order => order.is_subscription === true);
+ if ( isSubscription ) {
+ payment_type = cko_flow_vars.recurring_payment_type;
+ }
+ }
+
+ // Remove is_subscription from all orders.
+ orders.forEach(order => {
+ delete order.is_subscription;
+ });
+
+ /*
+ * Helper to get a field value by ID from the DOM.
+ */
+ function getCheckoutField(fieldId) {
+ const el = document.getElementById(fieldId);
+ return el && el.value ? el.value : null;
+ }
+
+ if (!email) {
+ email = getCheckoutField("billing_email");
+ }
+
+ if (!family_name) {
+ family_name = getCheckoutField("billing_first_name");
+ }
+
+ if (!given_name) {
+ given_name = getCheckoutField("billing_last_name");
+ }
+
+ if (!phone) {
+ phone = getCheckoutField("billing_phone");
+ }
+
+ /*
+ * Displays the loading overlay.
+ */
+ function showLoadingOverlay(arg) {
+ let overlay = document.getElementById("loading-overlay");
+ if (arg === 2) {
+ overlay = document.getElementById("loading-overlay2");
+ }
+ if (overlay) {
+ overlay.style.display = "flex";
+ }
+ }
+
+ /*
+ * Hides the loading overlay.
+ */
+ function hideLoadingOverlay(arg) {
+ let overlay = document.getElementById("loading-overlay");
+ if (arg === 2) {
+ overlay = document.getElementById("loading-overlay2");
+ }
+ if (overlay) {
+ overlay.style.display = "none";
+ }
+ }
+
+ try {
+ showLoadingOverlay();
+
+ // Performance: Track API request start
+ const apiRequestStart = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ console.log('[FLOW PERFORMANCE] Starting payment session API request...');
+ }
+
+ /*
+ * Send request to Checkout.com to create a payment session.
+ */
+ // Debug: Log 3DS configuration
+ // Ensure proper boolean values - convert any truthy/falsy values to strict booleans
+ const three_ds_enabled = Boolean(cko_flow_vars.three_d_enabled === true || cko_flow_vars.three_d_enabled === "true" || cko_flow_vars.three_d_enabled === 1 || cko_flow_vars.three_d_enabled === "1");
+ const attempt_n3d = Boolean(cko_flow_vars.attempt_no_three_d === true || cko_flow_vars.attempt_no_three_d === "true" || cko_flow_vars.attempt_no_three_d === 1 || cko_flow_vars.attempt_no_three_d === "1");
+
+ // Valid exemption values according to Checkout.com API
+ const valid_exemptions = [
+ "low_value", "trusted_listing", "trusted_listing_prompt",
+ "transaction_risk_assessment", "3ds_outage", "sca_delegation",
+ "out_of_sca_scope", "low_risk_program", "recurring_operation",
+ "data_share", "other"
+ ];
+
+ // Use valid exemption or default to null (no exemption)
+ const exemption = (cko_flow_vars.exemption && valid_exemptions.includes(cko_flow_vars.exemption)) ? cko_flow_vars.exemption : null;
+
+ console.log('[FLOW] Exemption Processing:', {
+ 'Raw exemption from backend': cko_flow_vars.exemption,
+ 'Type of raw exemption': typeof cko_flow_vars.exemption,
+ 'Is exemption truthy': !!cko_flow_vars.exemption,
+ 'Is exemption valid': cko_flow_vars.exemption && valid_exemptions.includes(cko_flow_vars.exemption),
+ 'Processed exemption': exemption,
+ 'Will exemption be included': !!exemption,
+ 'Valid exemptions list': valid_exemptions
+ });
+
+ console.log('[FLOW] 3DS Configuration (field name: "3ds"):', {
+ 'Raw three_d_enabled': cko_flow_vars.three_d_enabled,
+ 'Type of three_d_enabled': typeof cko_flow_vars.three_d_enabled,
+ 'Processed enabled': three_ds_enabled,
+ 'Type of processed enabled': typeof three_ds_enabled,
+ 'Raw attempt_no_three_d': cko_flow_vars.attempt_no_three_d,
+ 'Type of attempt_no_three_d': typeof cko_flow_vars.attempt_no_three_d,
+ 'Processed attempt_n3d': attempt_n3d,
+ 'Type of processed attempt_n3d': typeof attempt_n3d,
+ challenge_indicator: cko_flow_vars.challenge_indicator || "no_preference",
+ 'Raw exemption': cko_flow_vars.exemption,
+ 'Processed exemption': exemption,
+ 'Raw allow_upgrade': cko_flow_vars.allow_upgrade,
+ 'Type of allow_upgrade': typeof cko_flow_vars.allow_upgrade,
+ allow_upgrade: cko_flow_vars.allow_upgrade === true || cko_flow_vars.allow_upgrade === "true" || cko_flow_vars.allow_upgrade === "yes",
+ });
+
+ // Debug: Log complete payment session request
+ const paymentSessionRequest = {
+ amount: amount,
+ currency: currency,
+ reference: reference,
+ payment_type: payment_type,
+ description: description,
+ customer: {
+ name: `${given_name} ${family_name}`,
+ email: email,
+ },
+ billing: {
+ address: {
+ address_line1: address1,
+ address_line2: address2,
+ city: city,
+ zip: zip,
+ country: country,
+ },
+ },
+ shipping: {
+ address: {
+ address_line1: shippingAddress1,
+ address_line2: shippingAddress2,
+ city: shippingCity,
+ zip: shippingZip,
+ country: shippingCountry,
+ },
+ },
+ // Determine success and failure URLs based on current page
+ success_url: (() => {
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ if (isOrderPayPage) {
+ // For order-pay pages, redirect to order-received page with order key
+ const orderId = window.location.pathname.match(/\/order-pay\/(\d+)\//)?.[1];
+ const orderKey = new URLSearchParams(window.location.search).get('key');
+ if (orderId && orderKey) {
+ return window.location.origin + "/checkout/order-received/" + orderId + "/?key=" + orderKey;
+ } else {
+ // Fallback to checkout page if order details not found
+ return window.location.origin + "/" + cko_flow_vars.checkoutSlug + "/?status=succeeded&from=order-pay";
+ }
+ } else {
+ // For regular checkout pages
+ return window.location.origin + "/" + cko_flow_vars.checkoutSlug + "/?status=succeeded";
+ }
+ })(),
+ failure_url: (() => {
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ if (isOrderPayPage) {
+ // For order-pay pages, redirect to order-received page with order key
+ const orderId = window.location.pathname.match(/\/order-pay\/(\d+)\//)?.[1];
+ const orderKey = new URLSearchParams(window.location.search).get('key');
+ if (orderId && orderKey) {
+ return window.location.origin + "/checkout/order-received/" + orderId + "/?key=" + orderKey;
+ } else {
+ // Fallback to checkout page if order details not found
+ return window.location.origin + "/" + cko_flow_vars.checkoutSlug + "/?status=failed&from=order-pay";
+ }
+ } else {
+ // For regular checkout pages
+ return window.location.origin + "/" + cko_flow_vars.checkoutSlug + "/?status=failed";
+ }
+ })(),
+ metadata: metadata,
+ payment_method_configuration: {
+ card: {
+ store_payment_details: "enabled",
+ },
+ },
+ capture: true,
+ items: orders,
+ integration: {
+ external_platform: {
+ name: "Woocomerce",
+ version: cko_flow_vars.woo_version,
+ },
+ },
+ "3ds": {
+ enabled: three_ds_enabled,
+ attempt_n3d: attempt_n3d,
+ challenge_indicator: cko_flow_vars.challenge_indicator || "no_preference",
+ ...(exemption && { exemption: exemption }),
+ allow_upgrade: cko_flow_vars.allow_upgrade === true || cko_flow_vars.allow_upgrade === "true" || cko_flow_vars.allow_upgrade === "yes",
+ },
+ };
+
+ // Check if this is a MOTO order (admin-created order + order-pay page + guest customer)
+ const orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ const isMotoOrder = orderPayInfo?.payment_type === 'MOTO';
+
+ console.log('[FLOW DEBUG] MOTO Detection - Payment Type:', orderPayInfo?.payment_type, 'Is MOTO:', isMotoOrder);
+
+ // Override payment type for MOTO orders
+ if (isMotoOrder) {
+ payment_type = 'MOTO';
+ console.log('[FLOW] MOTO order detected - setting payment_type to MOTO');
+ console.log('[FLOW] MOTO conditions: Admin order + Order-pay page + Guest customer');
+ } else {
+ console.log('[FLOW] Not a MOTO order - using regular payment type:', payment_type);
+ }
+
+ // Update payment type in the request
+ paymentSessionRequest.payment_type = payment_type;
+
+ // Simple implementation: For order-pay pages, always redirect to order-received page after 3DS
+ const isOrderPayPage = window.location.pathname.includes('/order-pay/');
+ if (isOrderPayPage) {
+ // Extract order ID and key from current order-pay URL
+ const orderId = window.location.pathname.match(/\/order-pay\/(\d+)\//)?.[1];
+ const orderKey = new URLSearchParams(window.location.search).get('key');
+
+ if (orderId && orderKey) {
+ // FIXED: Redirect back to order-pay page after 3DS so form can be submitted to process_payment()
+ // This is critical for card saving to work - the form submission triggers process_payment() where card saving logic lives
+ const orderPayReturnUrl = window.location.origin + "/checkout/order-pay/" + orderId + "/?pay_for_order=true&key=" + orderKey;
+ paymentSessionRequest.success_url = orderPayReturnUrl;
+ paymentSessionRequest.failure_url = orderPayReturnUrl;
+ console.log('[FLOW] 🎯 Order-pay 3DS will redirect BACK to order-pay page for form submission');
+ console.log('[FLOW] Order ID:', orderId);
+ console.log('[FLOW] Order Key:', orderKey);
+ console.log('[FLOW] Success URL:', paymentSessionRequest.success_url);
+ console.log('[FLOW] Failure URL:', paymentSessionRequest.failure_url);
+ } else {
+ console.error('[FLOW] ❌ ERROR: Could not extract order ID or key from order-pay URL');
+ console.error('[FLOW] Current URL:', window.location.href);
+ console.error('[FLOW] Order ID found:', orderId);
+ console.error('[FLOW] Order Key found:', orderKey);
+ // Fallback to checkout page
+ paymentSessionRequest.success_url = window.location.origin + "/" + cko_flow_vars.checkoutSlug + "/?status=succeeded&from=order-pay";
+ paymentSessionRequest.failure_url = window.location.origin + "/" + cko_flow_vars.checkoutSlug + "/?status=failed&from=order-pay";
+ }
+ } else {
+ // For regular checkout, use the standard URLs
+ paymentSessionRequest.success_url = window.location.origin + "/" + cko_flow_vars.checkoutSlug + "/?status=succeeded";
+ paymentSessionRequest.failure_url = window.location.origin + "/" + cko_flow_vars.checkoutSlug + "/?status=failed";
+ console.log('[FLOW] Regular checkout - using standard success/failure URLs');
+ }
+
+ // Add enabled_payment_methods if specified by merchant
+ // Only send if array has items (empty array means show all methods)
+ // For MOTO orders, hardcode to only show card payment method
+ if (isMotoOrder) {
+ console.log('[FLOW] MOTO order detected - hardcoding to show only card payment method');
+ paymentSessionRequest.enabled_payment_methods = ['card'];
+ console.log('[FLOW] MOTO: Set enabled_payment_methods to:', paymentSessionRequest.enabled_payment_methods);
+ } else if (cko_flow_vars.enabled_payment_methods &&
+ Array.isArray(cko_flow_vars.enabled_payment_methods) &&
+ cko_flow_vars.enabled_payment_methods.length > 0) {
+ paymentSessionRequest.enabled_payment_methods = cko_flow_vars.enabled_payment_methods;
+ console.log('[FLOW] Regular: Enabled payment methods (sent to API):', cko_flow_vars.enabled_payment_methods);
+ } else {
+ console.log('[FLOW] No payment methods filter - all available methods will be shown');
+ console.log('[FLOW] cko_flow_vars.enabled_payment_methods:', cko_flow_vars.enabled_payment_methods);
+ }
+
+ console.log('[FLOW] Complete Payment Session Request:', paymentSessionRequest);
+
+ let response = await fetch(cko_flow_vars.apiURL, {
+ method: "POST",
+ headers: {
+ Authorization: `Bearer ${cko_flow_vars.SKey}`,
+ "Content-Type": "application/json",
+ },
+ body: JSON.stringify(paymentSessionRequest),
+ });
+
+ let paymentSession = await response.json();
+
+ // Performance: Track API request completion
+ const apiRequestEnd = performance.now();
+ const apiDuration = apiRequestEnd - apiRequestStart;
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ console.log(`[FLOW PERFORMANCE] Payment session API completed in ${apiDuration.toFixed(2)}ms (${(apiDuration / 1000).toFixed(2)}s)`);
+ }
+
+ // Debug: Log payment session response
+ console.log('[FLOW] Payment Session Response:', paymentSession);
+
+ // Store payment session ID globally for access in callbacks
+ window.currentPaymentSessionId = paymentSession.id;
+
+ /*
+ * Handle API Session errors returned from Checkout.com.
+ */
+ if (paymentSession.error_type) {
+ // Hide loading overlay.
+ hideLoadingOverlay();
+
+ // Check for 3DS specific errors
+ if (paymentSession.error_codes && paymentSession.error_codes.includes('three_ds_invalid')) {
+ console.error('[FLOW] 3DS Configuration Error:', paymentSession);
+ showError('3DS configuration error. Please check your 3DS settings in the admin panel.');
+ return;
+ }
+
+ const readableErrors = {
+ customer_email_invalid: wp.i18n.__(
+ "Please enter the email to proceed.",
+ "checkout-com-unified-payments-api"
+ ),
+ billing_phone_number_invalid: wp.i18n.__(
+ "Please enter the phone number to proceed.",
+ "checkout-com-unified-payments-api"
+ ),
+ };
+
+ let messages = (paymentSession.error_codes || []).map(
+ (code) => readableErrors[code] || code
+ );
+ showError(messages[0]);
+ return;
+ }
+
+ /*
+ * Successfully received a payment session.
+ * Load Checkout.com Web Component.
+ */
+ if (paymentSession.id) {
+ // Performance: Track component initialization start
+ const componentInitStart = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ console.log('[FLOW PERFORMANCE] Initializing Checkout Web Component...');
+ }
+
+ // Debug: Log Flow component configuration
+ console.log('[FLOW] Flow Component Configuration:', {
+ publicKey: cko_flow_vars.PKey ? 'SET' : 'NOT SET',
+ environment: cko_flow_vars.env,
+ locale: window.locale,
+ paymentSessionId: paymentSession.id,
+ paymentSessionSecret: paymentSession.payment_session_secret ? 'SET' : 'NOT SET',
+ appearance: window.appearance ? 'SET' : 'NOT SET',
+ componentOptions: window.componentOptions ? 'SET' : 'NOT SET',
+ translations: window.translations ? 'SET' : 'NOT SET'
+ });
+
+ // Define callback functions BEFORE passing them to CheckoutWebComponents
+ const onReady = () => {
+ try {
+ console.log('🔥🔥🔥 [FLOW] onReady FIRED! 🔥🔥🔥');
+ hideLoadingOverlay();
+
+ // Performance tracking: Mark when Flow is ready
+ ckoFlow.performanceMetrics.flowReadyTime = performance.now();
+
+ const pageLoadToReady = ckoFlow.performanceMetrics.flowReadyTime - ckoFlow.performanceMetrics.pageLoadTime;
+ const initToReady = ckoFlow.performanceMetrics.flowReadyTime - ckoFlow.performanceMetrics.flowInitStartTime;
+
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ console.log('[FLOW PERFORMANCE] ===== Flow Load Complete =====');
+ console.log(`[FLOW PERFORMANCE] Page Load → Flow Ready: ${pageLoadToReady.toFixed(2)}ms (${(pageLoadToReady / 1000).toFixed(2)}s)`);
+ console.log(`[FLOW PERFORMANCE] Flow Init → Flow Ready: ${initToReady.toFixed(2)}ms (${(initToReady / 1000).toFixed(2)}s)`);
+ console.log('[FLOW PERFORMANCE] ================================');
+ }
+
+ // ============================================================
+ // SMOOTH CHECKOUT EXPERIENCE - onReady Handler
+ // ============================================================
+
+ const displayOrder = window.saved_payment || 'new_payment_first';
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+ const saveCardCheckbox = document.querySelector('.cko-save-card-checkbox');
+
+ console.log('[FLOW] onReady - Display order:', displayOrder);
+ console.log('[FLOW] onReady - Flow is fully loaded and ready');
+
+ // Step 1: Hide skeleton loader with smooth transition
+ console.log('[FLOW] onReady - Skeleton element found:', !!skeleton);
+ if (skeleton) {
+ console.log('[FLOW] onReady - Skeleton classes BEFORE:', skeleton.className);
+ skeleton.classList.remove("show");
+ console.log('[FLOW] onReady - Skeleton classes AFTER:', skeleton.className);
+ console.log('[FLOW] onReady - ✓ Skeleton loader hidden');
+ } else {
+ console.log('[FLOW] onReady - ❌ Skeleton element NOT FOUND');
+ }
+
+ // Step 2: Enable Place Order button (remove loading state)
+ console.log('[FLOW] onReady - Place Order button found:', !!placeOrderBtn);
+ if (placeOrderBtn) {
+ console.log('[FLOW] onReady - Button classes BEFORE:', placeOrderBtn.className);
+ placeOrderBtn.classList.remove("flow-loading");
+ console.log('[FLOW] onReady - Button classes AFTER:', placeOrderBtn.className);
+ placeOrderBtn.style.removeProperty('opacity');
+ placeOrderBtn.style.removeProperty('visibility');
+ console.log('[FLOW] onReady - ✓ Place Order button enabled');
+ } else {
+ console.log('[FLOW] onReady - ❌ Place Order button NOT FOUND');
+ }
+
+ // Step 3: Hide save card checkbox initially (onChange will show it for card payment type)
+ if (saveCardCheckbox) {
+ saveCardCheckbox.style.display = 'none';
+ console.log('[FLOW] onReady - ✓ Save card checkbox hidden (will show on card selection)');
+ } else {
+ console.log('[FLOW] onReady - Save card checkbox not available (feature disabled)');
+ }
+
+ // Step 4: Mark Flow as ready - triggers CSS animations and visibility rules
+ document.body.classList.add("flow-ready");
+ console.log('[FLOW] onReady - ✓ Flow marked as ready - Checkout is now fully interactive');
+
+ // Step 5: Restore saved card selection if in saved_cards_first mode
+ if (displayOrder === 'saved_cards_first') {
+ console.log('[FLOW] onReady - saved_cards_first mode: checking for default saved card');
+
+ // Find default card (has checked="checked" attribute or is marked as default)
+ const defaultCardRadio = jQuery('.saved-cards-accordion-panel input[name="wc-wc_checkout_com_flow-payment-token"][checked="checked"]:not(#wc-wc_checkout_com_flow-payment-token-new)').first();
+
+ if (defaultCardRadio.length) {
+ // Re-select the default card (in case Flow init deselected it)
+ defaultCardRadio.prop('checked', true);
+ window.flowSavedCardSelected = true;
+ window.flowUserInteracted = false;
+ console.log('[FLOW] onReady - ✓ Default saved card re-selected after Flow load');
+ console.log('[FLOW] onReady - Selected card ID:', defaultCardRadio.attr('id'));
+ } else {
+ console.log('[FLOW] onReady - No default saved card found');
+ }
+ }
+
+ // Note: Save card checkbox visibility is controlled by the onChange event
+ // It will only show when payment type is "card" and hide for other payment methods
+ } catch (error) {
+ console.error('❌❌❌ [FLOW] onReady ERROR:', error);
+ console.error('Error stack:', error.stack);
+ }
+ };
+
+ /*
+ * Called when the payment is completed successfully.
+ */
+ const onPaymentCompleted = (_component, paymentResponse) => {
+
+ // Check if this is a 3DS authentication response
+ if (paymentResponse.threeDs && paymentResponse.threeDs.challenged) {
+ // 3DS challenge detected - user will be redirected to 3DS page
+ return;
+ }
+
+ if (paymentResponse.id) {
+ hideLoadingOverlay(2);
+
+ // Set the hidden input values.
+ jQuery("#cko-flow-payment-id").val(paymentResponse.id);
+ jQuery("#cko-flow-payment-type").val(paymentResponse?.type || "");
+
+ if ( ! orderId ) {
+ // Trigger WooCommerce order placement on checkout page.
+ jQuery("form.checkout").submit();
+ } else {
+ // For order-pay pages, use native DOM submit to bypass event handlers
+ console.log('[FLOW] Submitting order-pay form using native submit after payment completion');
+ const orderPayForm = document.querySelector('form#order_review');
+ if (orderPayForm) {
+ orderPayForm.submit();
+ } else {
+ console.error('[FLOW] ERROR: form#order_review not found!');
+ }
+ }
+ }
+ };
+
+ /*
+ * Triggered when user submits the payment using Place Order Button of Woocommerce.
+ */
+ const onSubmit = async (component) => {
+ showLoadingOverlay(2);
+ return { continue: true };
+ };
+
+ /*
+ * Triggered on component state change.
+ */
+ const onChange = (component) => {
+ hideLoadingOverlay();
+
+ // Initialize tracking variables if not exists
+ if (!window.onChangeTracking) {
+ window.onChangeTracking = {
+ lastState: {},
+ lastProcessedTime: 0,
+ processingCount: 0
+ };
+ }
+
+ const now = Date.now();
+ const currentState = {
+ selectedType: component.selectedType,
+ componentType: component.type,
+ isValid: component.isValid ? component.isValid() : false
+ };
+
+ // Check if state has actually changed
+ const stateChanged = (
+ window.onChangeTracking.lastState.selectedType !== currentState.selectedType ||
+ window.onChangeTracking.lastState.componentType !== currentState.componentType ||
+ window.onChangeTracking.lastState.isValid !== currentState.isValid
+ );
+
+ // Rate limiting: don't process more than once every 50ms
+ const timeSinceLastProcess = now - window.onChangeTracking.lastProcessedTime;
+ const shouldRateLimit = timeSinceLastProcess < 50;
+
+ // Only process if state actually changed AND enough time has passed
+ if (!stateChanged || shouldRateLimit) {
+ window.onChangeTracking.processingCount++;
+ if (window.onChangeTracking.processingCount % 10 === 0) {
+ console.log(`[FLOW] onChange - Skipped ${window.onChangeTracking.processingCount} duplicate events`);
+ }
+ return;
+ }
+
+ // Update tracking
+ window.onChangeTracking.lastState = { ...currentState };
+ window.onChangeTracking.lastProcessedTime = now;
+ window.onChangeTracking.processingCount = 0;
+
+ console.log('[FLOW] ===== onChange START =====');
+ console.log('[FLOW] onChange - Selected Type:', component.selectedType);
+ console.log('[FLOW] onChange - Component Type:', component.type);
+ console.log('[FLOW] onChange - Component valid:', component.isValid ? component.isValid() : 'unknown');
+ console.log('[FLOW] onChange - User interacted flag:', window.flowUserInteracted);
+ console.log('[FLOW] onChange - Body has flow-ready class:', document.body.classList.contains('flow-ready'));
+
+ // CRITICAL: Auto-deselect saved card when user interacts with Flow
+ // Check if a saved card is currently selected and Flow is de-emphasized
+ const flowContainer = document.getElementById("flow-container");
+ const anySavedCardSelected = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked').filter(function() {
+ return jQuery(this).attr('id') !== 'wc-wc_checkout_com_flow-payment-token-new';
+ }).length > 0;
+
+ if (anySavedCardSelected && flowContainer) {
+ console.log('[FLOW] onChange - User typing in Flow while saved card selected - auto-activating Flow');
+ // Call the activation function
+ if (typeof window.activateFlowPayment === 'function') {
+ window.activateFlowPayment();
+ } else {
+ // Fallback if function not available yet
+ jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked').prop('checked', false);
+ window.flowSavedCardSelected = false;
+ console.log('[FLOW] onChange - Deselected saved card and activated Flow (fallback)');
+ }
+ }
+
+ // Note: We don't set flowUserInteracted here anymore because onChange
+ // fires on initial load. Instead, we use click/focus/input listeners
+ // to detect actual user interaction with Flow fields.
+
+ const hiddenTypes = [
+ "applepay",
+ "googlepay",
+ "octopus",
+ "paypal",
+ "twint",
+ "venmo",
+ "wechatpay"
+ ];
+
+ const placeOrderButton = document.querySelector("#place_order");
+
+ // Hide place order button on digital wallets.
+ if (hiddenTypes.includes(component.selectedType)) {
+ if (placeOrderButton) placeOrderButton.style.display = "none";
+ console.log('[FLOW] onChange - Hiding Place Order button');
+ } else {
+ if (placeOrderButton) placeOrderButton.style.display = "block";
+ console.log('[FLOW] onChange - Showing Place Order button');
+ }
+
+ console.log('[FLOW] ===== onChange END =====');
+
+ // Pre-validate for apple pay.
+ if ( component.selectedType === "applepay" ) {
+ const applePayButton = document.querySelector('button[aria-label="Apple Pay"]');
+ applePayButton.disabled = true;
+
+ const form = jQuery("form.checkout");
+
+ if ( ! orderId ) {
+ validateCheckout(form, function (response) {
+ applePayButton.disabled = false;
+ });
+ }
+ }
+
+ // Control Save to Account checkbox visibility based on payment type
+ const saveCardCheckbox = jQuery('.cko-save-card-checkbox');
+ if ( saveCardCheckbox.length > 0 ) {
+ if ( component.selectedType === "card" ) {
+ saveCardCheckbox.addClass('wc-cko-flow-card-on');
+ saveCardCheckbox.css('display', 'block'); // Use .css() to set inline style
+ saveCardCheckbox.show();
+ console.log('[FLOW] onChange - Showing Save to Account checkbox for CARD');
+ } else {
+ saveCardCheckbox.removeClass('wc-cko-flow-card-on');
+ saveCardCheckbox.css('display', 'none'); // Use .css() to set inline style
+ saveCardCheckbox.hide();
+ console.log('[FLOW] onChange - Hiding Save to Account checkbox for', component.selectedType);
+ }
+ } else {
+ console.log('[FLOW] onChange - Save card checkbox not available (feature disabled)');
+ }
+
+ console.log(
+ `[FLOW] onChange() -> isValid: "${component.isValid()}" for "${
+ component.type
+ }"`
+ );
+ };
+
+ /*
+ * Triggered on component click.
+ */
+ const handleClick = (component) => {
+
+ if(component.type==="applepay") {
+ return {continue: true};
+ }
+
+ if ( orderId ) {
+ return {continue: true};
+ }
+
+ return new Promise((resolve) => {
+ const form = jQuery("form.checkout");
+
+ validateCheckout(form, function (response) {
+ resolve({ continue: true });
+ });
+ });
+ };
+
+ /*
+ * Triggered on any error in the component.
+ */
+ const onError = (component, error) => {
+ console.log("[FLOW] onError", error, "Component", component.type);
+
+ // Hide loading overlay and skeleton.
+ hideLoadingOverlay();
+ hideLoadingOverlay(2);
+
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+
+ if (skeleton) {
+ skeleton.classList.remove("show");
+ }
+ if (placeOrderBtn) {
+ placeOrderBtn.classList.remove("flow-loading");
+ }
+
+ if (
+ error.message ===
+ "[Submit]: Component is invalid [component_invalid]"
+ ) {
+ error.message =
+ "Please complete your payment before placing the order.";
+ }
+
+ showError(
+ error.message ||
+ wp.i18n.__(
+ "Something went wrong. Please try again.",
+ "checkout-com-unified-payments-api"
+ )
+ );
+ };
+
+ // Debug: Log callback functions
+ console.log('[FLOW] Callback Functions:', {
+ onReady: typeof onReady,
+ onPaymentCompleted: typeof onPaymentCompleted,
+ onSubmit: typeof onSubmit,
+ onChange: typeof onChange,
+ handleClick: typeof handleClick,
+ onError: typeof onError
+ });
+
+ // Debug: Make onPaymentCompleted globally accessible for testing
+ window.testOnPaymentCompleted = onPaymentCompleted;
+ console.log('[FLOW] onPaymentCompleted callback is now globally accessible as window.testOnPaymentCompleted');
+
+ const checkout = await CheckoutWebComponents({
+ publicKey: cko_flow_vars.PKey,
+ environment: cko_flow_vars.env,
+ locale: window.locale,
+ paymentSession,
+ appearance: window.appearance,
+ componentOptions: window.componentOptions,
+ translations: window.translations,
+ onReady,
+ onPaymentCompleted,
+ onSubmit,
+ onChange,
+ handleClick,
+ onError
+ });
+
+ const flowComponent = checkout.create(window.componentName, {
+ showPayButton: false,
+ });
+
+ // Performance: Track component creation
+ const componentInitEnd = performance.now();
+ const componentInitDuration = componentInitEnd - componentInitStart;
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ console.log(`[FLOW PERFORMANCE] Component initialized in ${componentInitDuration.toFixed(2)}ms (${(componentInitDuration / 1000).toFixed(2)}s)`);
+ }
+
+ ckoFlow.flowComponent = flowComponent;
+
+ /*
+ * Check if the component is available. Mount component only if available.
+ */
+ flowComponent.isAvailable().then((available) => {
+ if (available) {
+ // Performance: Track component mount
+ const mountStart = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ console.log('[FLOW PERFORMANCE] Mounting component to DOM...');
+ }
+ flowComponent.mount(document.getElementById("flow-container"));
+ const mountEnd = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ console.log(`[FLOW PERFORMANCE] Component mounted in ${(mountEnd - mountStart).toFixed(2)}ms`);
+ }
+
+ // ============================================================
+ // SMOOTH CHECKOUT EXPERIENCE - Enable UI after mount
+ // ============================================================
+ console.log('🔥🔥🔥 [FLOW] Component mounted - enabling UI! 🔥🔥🔥');
+
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+ const saveCardCheckbox = document.querySelector('.cko-save-card-checkbox');
+
+ // Step 1: Hide skeleton loader
+ if (skeleton) {
+ skeleton.classList.remove("show");
+ console.log('[FLOW] ✓ Skeleton loader hidden');
+ }
+
+ // Step 2: Enable Place Order button
+ if (placeOrderBtn) {
+ placeOrderBtn.classList.remove("flow-loading");
+ placeOrderBtn.style.removeProperty('opacity');
+ placeOrderBtn.style.removeProperty('visibility');
+ console.log('[FLOW] ✓ Place Order button enabled');
+ }
+
+ // Step 3: Hide save card checkbox initially
+ if (saveCardCheckbox) {
+ saveCardCheckbox.style.display = 'none';
+ } else {
+ console.log('[FLOW] Mount - Save card checkbox not available (feature disabled)');
+ }
+
+ // Step 4: Mark Flow as ready
+ document.body.classList.add("flow-ready");
+ console.log('[FLOW] ✓ Checkout is now fully interactive');
+
+ // CRITICAL: Listen for user interaction with Flow fields (click, focus, input)
+ // This detects when user actually starts using Flow (not just onChange firing on load)
+ setTimeout(() => {
+ const flowContainer = document.getElementById("flow-container");
+ if (flowContainer) {
+ // Listen for any interaction with Flow component
+ flowContainer.addEventListener('click', function() {
+ if (!window.flowUserInteracted) {
+ console.log('[FLOW] User clicked on Flow component - marking as interacted');
+ window.flowUserInteracted = true;
+ window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow
+ }
+ }, { once: false });
+
+ flowContainer.addEventListener('focus', function(e) {
+ if (!window.flowUserInteracted) {
+ console.log('[FLOW] User focused on Flow field - marking as interacted');
+ window.flowUserInteracted = true;
+ window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow
+ }
+ }, { capture: true });
+
+ flowContainer.addEventListener('input', function(e) {
+ if (!window.flowUserInteracted) {
+ console.log('[FLOW] User typing in Flow field - marking as interacted');
+ window.flowUserInteracted = true;
+ window.flowSavedCardSelected = false; // Reset saved card flag when user interacts with Flow
+ }
+ }, { capture: true });
+
+ console.log('[FLOW] Flow interaction listeners attached');
+ }
+ }, 500);
+
+ } else {
+ // Hide loading overlay.
+ hideLoadingOverlay();
+ console.error("[FLOW] Component is not available.");
+
+ showError(
+ wp.i18n.__(
+ "The selected payment method is not available at this time.",
+ "checkout-com-unified-payments-api"
+ )
+ );
+ }
+ });
+ }
+ } catch (error) {
+ // Hide loading overlay and skeleton.
+ hideLoadingOverlay();
+
+ const skeleton = document.getElementById("flow-skeleton");
+ const placeOrderBtn = document.getElementById("place_order");
+
+ if (skeleton) {
+ skeleton.classList.remove("show");
+ }
+ if (placeOrderBtn) {
+ placeOrderBtn.classList.remove("flow-loading");
+ }
+
+ console.error("[FLOW] Error creating payment session:", error);
+
+ showError(
+ error.message ||
+ wp.i18n.__(
+ "Error creating payment session.",
+ "checkout-com-unified-payments-api"
+ )
+ );
+ }
+ },
+};
+
+/*
+ * Displays error messages at the top of the WooCommerce form.
+ */
+let showError = function (error_message) {
+ if ("string" === typeof error_message) {
+ error_message = [error_message];
+ }
+
+ let ulWrapper = jQuery("").html(value));
+ });
+ }
+
+ let wcNoticeDiv = jQuery("';
+ return;
+ }
+
+ $table_name = $wpdb->prefix . 'cko_pending_webhooks';
+
+ // Check if table exists
+ $table_exists = $wpdb->get_var( $wpdb->prepare( 'SHOW TABLES LIKE %s', $table_name ) );
+
+ if ( ! $table_exists ) {
+ echo '';
+ return;
+ }
+
+ // Get statistics
+ $total_count = $wpdb->get_var( "SELECT COUNT(*) FROM {$table_name}" );
+ $pending_count = $wpdb->get_var( "SELECT COUNT(*) FROM {$table_name} WHERE processed_at IS NULL" );
+ $processed_count = $wpdb->get_var( "SELECT COUNT(*) FROM {$table_name} WHERE processed_at IS NOT NULL" );
+
+ // Get records
+ $records = $wpdb->get_results( "SELECT * FROM {$table_name} ORDER BY created_at DESC LIMIT 100" );
+
+ ?>
+
+
+
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+
+
+
+ get_field_key( $key );
+ ?>
+
+
+
+
+
+
+
+
+ get_field_key( $key );
+
+ // Get the correct path based on server configuration
+ $well_known_info = $this->get_well_known_path();
+ $well_known_dir = $well_known_info['dir'];
+ $is_bitnami = $well_known_info['is_bitnami'];
+
+ // Apple now requires .txt extension
+ $well_known_url = home_url( '/.well-known/apple-developer-merchantid-domain-association.txt' );
+ $file_path = $well_known_dir . '/apple-developer-merchantid-domain-association.txt';
+
+ // Check if config is detected for collapsible sections
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_collapsible = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+
+
+
+ get_field_key( $key );
+ $config_status = $this->detect_existing_configuration();
+ $is_existing_config = $config_status['detected'];
+ ?>
+
+
+
+
+
+
+
+ >>>>>> upstream/feature/flow-integration-v5.0.0-beta
* Show frames js on checkout page.
*/
public function payment_fields() {
@@ -152,8 +796,12 @@ public function payment_fields() {
// Display the button and remove the default place order.
checkoutInitialiseApplePay = function () {
jQuery( '#payment' ) . append(
+<<<<<<< HEAD
'get_option( 'ckocom_apple_type' ) ); ?>" + '" buttonstyle="'
+=======
+ 'get_option( 'ckocom_apple_theme' ) ); ?>" + '" locale="'
+ "get_option( 'ckocom_apple_language' ) ); ?>" + '"> '
);
@@ -512,6 +1160,411 @@ function isValidFormField(fieldList) {
}
/**
+<<<<<<< HEAD
+=======
+ * Handle Apple Pay method API requests.
+ *
+ * @return void
+ */
+ public function handle_wc_api() {
+ // phpcs:disable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing
+ if ( ! empty( $_GET['cko_apple_pay_action'] ) ) {
+ switch ( $_GET['cko_apple_pay_action'] ) {
+
+ case 'express_add_to_cart':
+ $this->cko_express_add_to_cart();
+ break;
+
+ case 'express_get_cart_total':
+ $this->cko_express_get_cart_total();
+ break;
+
+ case 'express_apple_pay_order_session':
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_apple_pay_order_id', isset( $_GET['apple_pay_order_id'] ) ? wc_clean( $_GET['apple_pay_order_id'] ) : '' );
+ $this->cko_express_apple_pay_order_session();
+ break;
+ }
+ }
+ // phpcs:enable
+ exit();
+ }
+
+ /**
+ * Add to cart for Apple Pay Express checkout.
+ *
+ * @return void
+ */
+ public function cko_express_add_to_cart() {
+ if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'checkoutcom_apple_pay_express_add_to_cart' ) ) {
+ wp_send_json( [ 'result' => 'failed' ] );
+ }
+
+ if ( ! defined( 'WOOCOMMERCE_CART' ) ) {
+ define( 'WOOCOMMERCE_CART', true );
+ }
+
+ WC()->shipping->reset_shipping();
+
+ $product_id = isset( $_POST['product_id'] ) ? absint( $_POST['product_id'] ) : 0;
+ $qty = ! isset( $_POST['qty'] ) ? 1 : absint( $_POST['qty'] );
+
+ $product = wc_get_product( $product_id );
+
+ if ( ! $product ) {
+ wp_send_json( [ 'result' => 'error', 'message' => 'Product not found' ] );
+ }
+
+ $product_type = $product->get_type();
+
+ // First empty the cart to prevent wrong calculation.
+ WC()->cart->empty_cart();
+
+ if ( ( 'variable' === $product_type || 'variable-subscription' === $product_type ) && isset( $_POST['attributes'] ) ) {
+ $attributes = wc_clean( wp_unslash( $_POST['attributes'] ) );
+
+ $data_store = WC_Data_Store::load( 'product' );
+ $variation_id = $data_store->find_matching_product_variation( $product, $attributes );
+
+ $is_added_to_cart = WC()->cart->add_to_cart( $product->get_id(), $qty, $variation_id, $attributes );
+ }
+
+ if ( in_array( $product_type, [ 'simple', 'variation', 'subscription', 'subscription_variation' ], true ) ) {
+ $is_added_to_cart = WC()->cart->add_to_cart( $product->get_id(), $qty );
+ }
+
+ WC()->cart->calculate_totals();
+
+ $data = [];
+ $data['result'] = 'success';
+ $data['total'] = WC()->cart->total;
+
+ wp_send_json( $data );
+ }
+
+ /**
+ * Get cart total for Apple Pay Express checkout.
+ *
+ * @return void
+ */
+ public function cko_express_get_cart_total() {
+ // Return cart total directly from WooCommerce
+ // This works for both classic and Blocks cart pages
+
+ // Ensure cart is loaded
+ if ( ! WC()->cart ) {
+ wp_send_json_error( array( 'messages' => 'Cart not initialized' ) );
+ return;
+ }
+
+ if ( WC()->cart->is_empty() ) {
+ wp_send_json_error( array( 'messages' => 'Cart is empty' ) );
+ return;
+ }
+
+ // Recalculate totals to ensure we have the latest
+ WC()->cart->calculate_totals();
+
+ // Get cart total - use 'raw' to get the numeric value directly
+ $cart_total_raw = WC()->cart->get_total( 'raw' );
+
+ // Also get formatted total for display
+ $cart_total_formatted = WC()->cart->get_total( '' );
+
+ // Ensure we have a valid total
+ if ( $cart_total_raw <= 0 ) {
+ wp_send_json_error( array( 'messages' => 'Invalid cart total' ) );
+ return;
+ }
+
+ wp_send_json_success( array(
+ 'total' => floatval( $cart_total_raw ),
+ 'total_formatted' => $cart_total_formatted,
+ 'currency' => get_woocommerce_currency(),
+ ) );
+ }
+
+ /**
+ * Process Apple Pay Express order session.
+ *
+ * @return void
+ */
+ public function cko_express_apple_pay_order_session() {
+ // Express now uses the same flow as classic Apple Pay
+ // Classic Apple Pay sends: cko-apple-card-token
+ // Express now sends the same field, so we can use the same process_payment method
+
+ // Get payment data for email and address extraction
+ $payment_data_json = isset( $_POST['payment_data'] ) ? wp_unslash( $_POST['payment_data'] ) : '';
+ $payment_data = ! empty( $payment_data_json ) ? json_decode( $payment_data_json, true ) : array();
+
+ // Extract email and address from payment data
+ // IMPORTANT: For guest users, both email and address are MANDATORY from Apple Pay
+ // Chrome may send email in a different structure than Safari, so we check multiple locations
+ $email = '';
+ $shipping_address = null;
+ $billing_address = null;
+
+ if ( ! empty( $payment_data ) ) {
+ // Extract email - try multiple locations (Chrome may send it differently)
+ // 1. Top-level email field
+ if ( isset( $payment_data['email'] ) && ! empty( $payment_data['email'] ) ) {
+ $email = sanitize_email( $payment_data['email'] );
+ }
+ // 2. billingContact.emailAddress
+ elseif ( isset( $payment_data['billingContact']['emailAddress'] ) && ! empty( $payment_data['billingContact']['emailAddress'] ) ) {
+ $email = sanitize_email( $payment_data['billingContact']['emailAddress'] );
+ }
+ // 3. shippingContact.emailAddress
+ elseif ( isset( $payment_data['shippingContact']['emailAddress'] ) && ! empty( $payment_data['shippingContact']['emailAddress'] ) ) {
+ $email = sanitize_email( $payment_data['shippingContact']['emailAddress'] );
+ }
+ // 4. Check if billingContact or shippingContact have email (without emailAddress key)
+ elseif ( isset( $payment_data['billingContact']['email'] ) && ! empty( $payment_data['billingContact']['email'] ) ) {
+ $email = sanitize_email( $payment_data['billingContact']['email'] );
+ }
+ elseif ( isset( $payment_data['shippingContact']['email'] ) && ! empty( $payment_data['shippingContact']['email'] ) ) {
+ $email = sanitize_email( $payment_data['shippingContact']['email'] );
+ }
+
+ // Extract shipping address (MANDATORY for express checkout)
+ if ( isset( $payment_data['shippingContact'] ) && ! empty( $payment_data['shippingContact'] ) ) {
+ $shipping_address = $payment_data['shippingContact'];
+ } elseif ( isset( $payment_data['billingContact'] ) && ! empty( $payment_data['billingContact'] ) ) {
+ // Fallback to billing contact if shipping contact not available
+ $shipping_address = $payment_data['billingContact'];
+ }
+
+ // Extract billing address - use billing contact if different, otherwise use shipping contact
+ if ( isset( $payment_data['billingContact'] ) && ! empty( $payment_data['billingContact'] ) ) {
+ $billing_address = $payment_data['billingContact'];
+ } elseif ( isset( $payment_data['shippingContact'] ) && ! empty( $payment_data['shippingContact'] ) ) {
+ $billing_address = $payment_data['shippingContact'];
+ }
+ }
+
+ // Store payment data in session for checkout page field population
+ // This ensures that if user is redirected to checkout, fields will be populated
+ if ( ! empty( $payment_data ) ) {
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_ap_details', $payment_data );
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_ap_id', 'express_' . time() );
+ }
+
+ // Create the order from cart
+ $order = $this->create_express_order_from_cart( $email, $shipping_address, $billing_address );
+
+ if ( ! $order ) {
+ wp_send_json_error( array( 'messages' => 'Failed to create order for Apple Pay Express checkout.' ) );
+ return;
+ }
+
+ // Store order ID in session for checkout page reference
+ WC_Checkoutcom_Utility::cko_set_session( 'cko_apple_pay_order_id', $order->get_id() );
+
+ // process_payment expects the payment method to be set in $_POST
+ $_POST['payment_method'] = 'wc_checkout_com_apple_pay';
+
+ // Use the same process_payment method as classic Apple Pay
+ $result = $this->process_payment( $order->get_id() );
+
+ // process_payment returns an array with 'result' and 'redirect'
+ if ( isset( $result['result'] ) && 'success' === $result['result'] ) {
+ // Payment successful - return success
+ wp_send_json_success(
+ array(
+ 'result' => 'success',
+ 'redirect_url' => isset( $result['redirect'] ) ? $result['redirect'] : $this->get_return_url( $order ),
+ )
+ );
+ } else {
+ // Payment failed
+ $error_message = isset( $result['messages'] ) ? $result['messages'] : 'Payment failed.';
+ wp_send_json_error( array( 'messages' => $error_message ) );
+ }
+ }
+
+ /**
+ * Create express order from cart.
+ *
+ * @param string $email Email address from Apple Pay.
+ * @param array $shipping_address Shipping address from Apple Pay.
+ * @param array $billing_address Billing address from Apple Pay (optional, defaults to shipping address).
+ * @return WC_Order|false
+ */
+ private function create_express_order_from_cart( $email = '', $shipping_address = null, $billing_address = null ) {
+ try {
+ // Determine customer ID and email
+ // IMPORTANT: For Apple Pay Express:
+ // - If user is logged in: Use logged-in user's email (NOT Apple Pay email), address from Apple Pay
+ // - If user is guest: Use email and address from Apple Pay only (mandatory)
+ $customer_id = 0;
+ $customer_email = '';
+
+ // Check if user is logged in
+ if ( is_user_logged_in() ) {
+ $current_user = wp_get_current_user();
+ $customer_id = $current_user->ID;
+ // For logged-in users, always use their account email (NOT Apple Pay email)
+ $customer_email = $current_user->user_email;
+ } else {
+ // For guest users, use email from Apple Pay data only (mandatory)
+ if ( ! empty( $email ) ) {
+ $customer_email = $email;
+ }
+ }
+
+ // Create order with proper customer ID
+ $order = wc_create_order( array( 'customer_id' => $customer_id ) );
+
+ if ( ! $order ) {
+ return false;
+ }
+
+ // Set customer email
+ if ( ! empty( $customer_email ) ) {
+ $order->set_billing_email( $customer_email );
+ }
+
+ // Add cart items to order
+ foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
+ $product = $cart_item['data'];
+ $order->add_product( $product, $cart_item['quantity'] );
+ }
+
+ // Set order addresses from Apple Pay payment data (MANDATORY - addresses must always be copied from Apple Pay)
+ // IMPORTANT: For Apple Pay Express:
+ // - Addresses are MANDATORY from Apple Pay for both logged-in and guest users
+ // - If logged in: Use logged-in user's email (already set above), but ALWAYS copy address from Apple Pay
+ // - If guest: Use Apple Pay email and address (both mandatory from Apple Pay)
+ if ( ! empty( $shipping_address ) ) {
+ // For logged-in users: Don't pass email to set_order_addresses_from_apple_pay_data
+ // because we want to keep the logged-in user's email (already set above)
+ // Addresses are ALWAYS copied from Apple Pay regardless of login status (MANDATORY)
+ // For guest users: Pass Apple Pay email so it gets set in the address
+ $email_for_address = is_user_logged_in() ? '' : $customer_email;
+ // Use billing address if different, otherwise use shipping address for both
+ $billing_address_to_use = ! empty( $billing_address ) ? $billing_address : $shipping_address;
+
+ $this->set_order_addresses_from_apple_pay_data( $order, $shipping_address, $email_for_address, $billing_address_to_use );
+ }
+
+ // Set shipping method if available
+ $shipping_packages = WC()->shipping->get_packages();
+ if ( ! empty( $shipping_packages ) ) {
+ foreach ( $shipping_packages as $package ) {
+ $chosen_methods = WC()->session->get( 'chosen_shipping_methods' );
+ if ( ! empty( $chosen_methods ) ) {
+ $order->set_shipping_method( $chosen_methods[0] );
+ }
+ }
+ }
+
+ // Calculate totals
+ $order->calculate_totals();
+
+ // Set payment method to Apple Pay Express
+ $order->set_payment_method( 'wc_checkout_com_apple_pay' );
+ $order->set_payment_method_title( 'Apple Pay Express' );
+
+ // Set order status
+ $order->set_status( 'pending' );
+ $order->save();
+
+ // Store order ID in session for potential use
+ WC()->session->set( 'order_awaiting_payment', $order->get_id() );
+
+ return $order;
+
+ } catch ( Exception $e ) {
+ WC_Checkoutcom_Utility::logger( 'Error creating Apple Pay Express order: ' . $e->getMessage(), $e );
+ return false;
+ }
+ }
+
+ /**
+ * Set order addresses from Apple Pay payment data.
+ * MANDATORY: Addresses must always be copied from Apple Pay when available.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $shipping_contact Shipping contact from Apple Pay (MANDATORY).
+ * @param string $email Email address (optional, for guest users).
+ * @param array $billing_contact Billing contact from Apple Pay (optional, defaults to shipping contact).
+ * @return void
+ */
+ private function set_order_addresses_from_apple_pay_data( $order, $shipping_contact, $email = '', $billing_contact = null ) {
+ // Addresses are MANDATORY from Apple Pay - if not provided, return
+ if ( empty( $shipping_contact ) ) {
+ return;
+ }
+
+ // Use billing contact if provided, otherwise use shipping contact for billing address
+ $billing_contact_to_use = ! empty( $billing_contact ) ? $billing_contact : $shipping_contact;
+
+ // Extract address fields from Apple Pay shipping contact
+ $shipping_first_name = isset( $shipping_contact['givenName'] ) ? sanitize_text_field( $shipping_contact['givenName'] ) : '';
+ $shipping_last_name = isset( $shipping_contact['familyName'] ) ? sanitize_text_field( $shipping_contact['familyName'] ) : '';
+ $shipping_address_lines = isset( $shipping_contact['addressLines'] ) ? $shipping_contact['addressLines'] : array();
+ $shipping_address_1 = isset( $shipping_address_lines[0] ) ? sanitize_text_field( $shipping_address_lines[0] ) : '';
+ $shipping_address_2 = isset( $shipping_address_lines[1] ) ? sanitize_text_field( $shipping_address_lines[1] ) : '';
+ $shipping_city = isset( $shipping_contact['locality'] ) ? sanitize_text_field( $shipping_contact['locality'] ) : '';
+ $shipping_state = isset( $shipping_contact['administrativeArea'] ) ? sanitize_text_field( $shipping_contact['administrativeArea'] ) : '';
+ $shipping_postcode = isset( $shipping_contact['postalCode'] ) ? sanitize_text_field( $shipping_contact['postalCode'] ) : '';
+ $shipping_country = isset( $shipping_contact['countryCode'] ) ? strtoupper( sanitize_text_field( $shipping_contact['countryCode'] ) ) : '';
+ $shipping_phone = isset( $shipping_contact['phoneNumber'] ) ? sanitize_text_field( $shipping_contact['phoneNumber'] ) : '';
+
+ // Extract address fields from Apple Pay billing contact
+ $billing_first_name = isset( $billing_contact_to_use['givenName'] ) ? sanitize_text_field( $billing_contact_to_use['givenName'] ) : '';
+ $billing_last_name = isset( $billing_contact_to_use['familyName'] ) ? sanitize_text_field( $billing_contact_to_use['familyName'] ) : '';
+ $billing_address_lines = isset( $billing_contact_to_use['addressLines'] ) ? $billing_contact_to_use['addressLines'] : array();
+ $billing_address_1 = isset( $billing_address_lines[0] ) ? sanitize_text_field( $billing_address_lines[0] ) : '';
+ $billing_address_2 = isset( $billing_address_lines[1] ) ? sanitize_text_field( $billing_address_lines[1] ) : '';
+ $billing_city = isset( $billing_contact_to_use['locality'] ) ? sanitize_text_field( $billing_contact_to_use['locality'] ) : '';
+ $billing_state = isset( $billing_contact_to_use['administrativeArea'] ) ? sanitize_text_field( $billing_contact_to_use['administrativeArea'] ) : '';
+ $billing_postcode = isset( $billing_contact_to_use['postalCode'] ) ? sanitize_text_field( $billing_contact_to_use['postalCode'] ) : '';
+ $billing_country = isset( $billing_contact_to_use['countryCode'] ) ? strtoupper( sanitize_text_field( $billing_contact_to_use['countryCode'] ) ) : '';
+ $billing_phone = isset( $billing_contact_to_use['phoneNumber'] ) ? sanitize_text_field( $billing_contact_to_use['phoneNumber'] ) : '';
+
+ // Set billing address (MANDATORY from Apple Pay)
+ // Always set all address fields from Apple Pay, even if some are empty
+ $order->set_billing_first_name( $billing_first_name );
+ $order->set_billing_last_name( $billing_last_name );
+ $order->set_billing_address_1( $billing_address_1 );
+ $order->set_billing_address_2( $billing_address_2 );
+ $order->set_billing_city( $billing_city );
+ $order->set_billing_state( $billing_state );
+ $order->set_billing_postcode( $billing_postcode );
+ $order->set_billing_country( $billing_country );
+ $order->set_billing_phone( $billing_phone );
+
+ // Email handling:
+ // IMPORTANT: Only use Apple Pay email for guest users
+ // - For logged-in users: Keep the account email (already set in create_express_order_from_cart)
+ // - For guest users: Set email from Apple Pay data (mandatory)
+ $current_billing_email = $order->get_billing_email();
+ $is_guest = ! is_user_logged_in();
+
+ if ( $is_guest && ! empty( $email ) ) {
+ // For guest users, always use Apple Pay email (mandatory)
+ $order->set_billing_email( sanitize_email( $email ) );
+ }
+
+ // Set shipping address (MANDATORY from Apple Pay)
+ // Always set all address fields from Apple Pay, even if some are empty
+ $order->set_shipping_first_name( $shipping_first_name );
+ $order->set_shipping_last_name( $shipping_last_name );
+ $order->set_shipping_address_1( $shipping_address_1 );
+ $order->set_shipping_address_2( $shipping_address_2 );
+ $order->set_shipping_city( $shipping_city );
+ $order->set_shipping_state( $shipping_state );
+ $order->set_shipping_postcode( $shipping_postcode );
+ $order->set_shipping_country( $shipping_country );
+ $order->set_shipping_phone( $shipping_phone );
+
+ // Save order to persist address changes
+ $order->save();
+ }
+
+ /**
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
* Apple pay session.
*
* @return void
@@ -691,4 +1744,1581 @@ public function process_refund( $order_id, $amount = null, $reason = '' ) {
// when true is returned, status is changed to refunded automatically.
return true;
}
+<<<<<<< HEAD
+=======
+
+ /**
+ * Enqueue scripts for CSR generation.
+ *
+ * @param string $hook Current admin page hook.
+ */
+ public function enqueue_csr_scripts( $hook ) {
+ // Only load on WooCommerce settings pages
+ if ( 'woocommerce_page_wc-settings' !== $hook ) {
+ return;
+ }
+
+ // Only load on Apple Pay settings page
+ if ( ! isset( $_GET['section'] ) || 'wc_checkout_com_apple_pay' !== $_GET['section'] ) {
+ return;
+ }
+
+ wp_enqueue_script(
+ 'cko-apple-pay-csr',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-csr.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-csr',
+ 'ckoCsrData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_generate_csr' ),
+ 'i18n' => [
+ 'generating' => __( 'Generating CSR...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'CSR generated successfully! Download starting...', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error generating CSR:', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue certificate upload script
+ wp_enqueue_script(
+ 'cko-apple-pay-certificate-upload',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-certificate-upload.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-certificate-upload',
+ 'ckoCertificateData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_upload_certificate' ),
+ 'i18n' => [
+ 'uploading' => __( 'Uploading certificate...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error uploading certificate:', 'checkout-com-unified-payments-api' ),
+ 'noFile' => __( 'Please select a certificate file (.cer) to upload.', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue merchant certificate generation script
+ wp_enqueue_script(
+ 'cko-apple-pay-merchant-certificate',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-merchant-certificate.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-merchant-certificate',
+ 'ckoMerchantCertificateData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_generate_merchant_certificate' ),
+ 'i18n' => [
+ 'generating' => __( 'Generating certificate and key...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Certificate and key generated successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error generating certificate and key:', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue domain association upload script
+ wp_enqueue_script(
+ 'cko-apple-pay-domain-association',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-domain-association.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-domain-association',
+ 'ckoDomainAssociationData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_upload_domain_association' ),
+ 'i18n' => [
+ 'uploading' => __( 'Uploading domain association file...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Domain association file uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error uploading domain association file:', 'checkout-com-unified-payments-api' ),
+ 'noFile' => __( 'Please select a domain association file (.txt) to upload.', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue merchant identity CSR script
+ wp_enqueue_script(
+ 'cko-apple-pay-merchant-identity-csr',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-merchant-identity-csr.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-merchant-identity-csr',
+ 'ckoMerchantIdentityCsrData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_generate_merchant_identity_csr' ),
+ 'i18n' => [
+ 'generating' => __( 'Generating CSR and key...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'CSR and key generated successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error generating CSR and key:', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue merchant identity certificate upload script
+ wp_enqueue_script(
+ 'cko-apple-pay-merchant-identity-certificate',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-merchant-identity-certificate.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-merchant-identity-certificate',
+ 'ckoMerchantIdentityCertificateData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_upload_merchant_identity_certificate' ),
+ 'i18n' => [
+ 'uploading' => __( 'Uploading and converting certificate...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Certificate uploaded and converted successfully!', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Error uploading certificate:', 'checkout-com-unified-payments-api' ),
+ 'noFile' => __( 'Please select a certificate file (.cer) to upload.', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue test certificate script
+ wp_enqueue_script(
+ 'cko-apple-pay-test-certificate',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-test-certificate.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+
+ wp_localize_script(
+ 'cko-apple-pay-test-certificate',
+ 'ckoTestCertificateData',
+ [
+ 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+ 'nonce' => wp_create_nonce( 'cko_test_certificate' ),
+ 'i18n' => [
+ 'testing' => __( 'Testing certificate and key...', 'checkout-com-unified-payments-api' ),
+ 'success' => __( 'Certificate and key test successful!', 'checkout-com-unified-payments-api' ),
+ 'successDetails' => __( 'All paths and configurations are validated with Apple\'s services.', 'checkout-com-unified-payments-api' ),
+ 'error' => __( 'Certificate and key test failed:', 'checkout-com-unified-payments-api' ),
+ 'errorDefault' => __( 'Test Failed. Please verify: 1. Your certificate paths are correct. 2. Your certificate has not expired. 3. You clicked "Verify" in your Apple Developer account for your domain.', 'checkout-com-unified-payments-api' ),
+ ],
+ ]
+ );
+
+ // Enqueue custom CSS for Apple Pay settings page
+ wp_enqueue_style(
+ 'cko-apple-pay-settings',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/css/admin-apple-pay-settings.css',
+ [],
+ WC_CHECKOUTCOM_PLUGIN_VERSION
+ );
+
+ // Enqueue UX enhancements JavaScript
+ wp_enqueue_script(
+ 'cko-apple-pay-settings-ux',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/admin-apple-pay-settings-ux.js',
+ [ 'jquery' ],
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ true
+ );
+ }
+
+ /**
+ * AJAX handler for generating CSR.
+ */
+ public function ajax_generate_csr() {
+ // Log that the handler was called (for debugging)
+ if ( function_exists( 'WC_Checkoutcom_Utility' ) && method_exists( 'WC_Checkoutcom_Utility', 'logger' ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR AJAX Handler Called. POST data: ' . print_r( $_POST, true ),
+ null
+ );
+ }
+
+ // Verify nonce first
+ if ( ! isset( $_POST['nonce'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security token is missing. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'nonce_missing'
+ ] );
+ return;
+ }
+
+ if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_generate_csr' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'nonce_verification_failed'
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'insufficient_permissions'
+ ] );
+ }
+
+ // Get settings
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+
+ if ( empty( $core_settings['ckocom_sk'] ) ) {
+ wp_send_json_error( [ 'message' => __( 'Secret key is not configured. Please configure Checkout.com settings first.', 'checkout-com-unified-payments-api' ) ] );
+ }
+
+ $secret_key_raw = $core_settings['ckocom_sk'];
+ $environment = isset( $core_settings['ckocom_environment'] ) ? $core_settings['ckocom_environment'] : 'sandbox';
+ $account_type = isset( $core_settings['ckocom_account_type'] ) ? $core_settings['ckocom_account_type'] : 'ABC';
+ $region = isset( $core_settings['ckocom_region'] ) ? $core_settings['ckocom_region'] : 'global';
+ $protocol_version = isset( $_POST['protocol_version'] ) ? sanitize_text_field( $_POST['protocol_version'] ) : 'ec_v1';
+
+ // Check if NAS account
+ if ( function_exists( 'cko_is_nas_account' ) && cko_is_nas_account() ) {
+ $account_type = 'NAS';
+ }
+
+ // Build API URL
+ $base_url = 'https://api.checkout.com';
+ if ( 'sandbox' === $environment ) {
+ $base_url = 'https://api.sandbox.checkout.com';
+ }
+
+ // Add region subdomain if not global
+ if ( 'global' !== $region && ! empty( $region ) ) {
+ $base_url = str_replace( 'api.', $region . '.api.', $base_url );
+ }
+
+ $api_url = $base_url . '/applepay/signing-requests';
+
+ // Prepare authorization header
+ // Remove any existing "Bearer " prefix from the secret key
+ $secret_key_clean = str_replace( 'Bearer ', '', trim( $secret_key_raw ) );
+
+ // Apple Pay signing-requests endpoint authentication
+ // For NAS accounts, always use Bearer prefix
+ // For ABC accounts, try direct key first (as per other API calls in the codebase)
+ if ( 'NAS' === $account_type ) {
+ $auth_header = 'Bearer ' . $secret_key_clean;
+ } else {
+ // ABC accounts - try direct key first (no Bearer prefix)
+ // This matches how other ABC API calls work in the codebase
+ $auth_header = $secret_key_clean;
+ }
+
+ // Prepare request body
+ $request_body = [
+ 'protocol_version' => $protocol_version,
+ ];
+
+ // Always log request details for debugging (help diagnose Bad Request errors)
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR Generation Request: ' .
+ 'URL: ' . $api_url . ', ' .
+ 'Account Type: ' . $account_type . ', ' .
+ 'Environment: ' . $environment . ', ' .
+ 'Protocol Version: ' . $protocol_version . ', ' .
+ 'Auth Header Format: ' . ( strpos( $auth_header, 'Bearer' ) !== false ? 'Bearer' : 'Direct' ),
+ null
+ );
+
+ // Make API request
+ $response = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ // Check for errors
+ if ( is_wp_error( $response ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Error making API request:', 'checkout-com-unified-payments-api' ) . ' ' . $response->get_error_message(),
+ ] );
+ }
+
+ $response_code = wp_remote_retrieve_response_code( $response );
+ $response_body = wp_remote_retrieve_body( $response );
+
+ if ( 200 !== $response_code && 201 !== $response_code ) {
+ // Try to parse error message for better user feedback
+ $error_message = $response_body;
+ $error_data = json_decode( $response_body, true );
+
+ if ( $error_data && isset( $error_data['error_type'] ) ) {
+ $error_message = $error_data['error_type'];
+ if ( isset( $error_data['error_codes'] ) && is_array( $error_data['error_codes'] ) ) {
+ $error_message .= ': ' . implode( ', ', $error_data['error_codes'] );
+ }
+ if ( isset( $error_data['message'] ) ) {
+ $error_message .= ' - ' . $error_data['message'];
+ }
+ } elseif ( $error_data && isset( $error_data['message'] ) ) {
+ $error_message = $error_data['message'];
+ }
+
+ // If 401 (Unauthorized) or 400 (Bad Request), try with Bearer for ABC accounts
+ if ( ( 401 === $response_code || 400 === $response_code ) && 'ABC' === $account_type ) {
+ // Retry with Bearer prefix for ABC accounts
+ $auth_header_bearer = 'Bearer ' . $secret_key_clean;
+
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR Generation: Retrying with Bearer authentication for ABC account',
+ null
+ );
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header_bearer,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ // Success with Bearer, use this response
+ $response_code = $retry_code;
+ $response_body = $retry_body;
+ } else {
+ // Log detailed error for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR Generation Failed (both direct key and Bearer): ' .
+ 'Direct Key: ' . $response_code . ' - ' . $response_body . ', ' .
+ 'Bearer: ' . $retry_code . ' - ' . $retry_body,
+ null
+ );
+ }
+ }
+ }
+
+ // If still an error after retry, send error response
+ if ( 200 !== $response_code && 201 !== $response_code ) {
+ // Log detailed error for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay CSR Generation Failed: ' . $response_code . ' - ' . $response_body .
+ ' | URL: ' . $api_url .
+ ' | Account Type: ' . $account_type .
+ ' | Environment: ' . $environment,
+ null
+ );
+
+ // For Bad Request (400), show full response to help diagnose
+ if ( 400 === $response_code ) {
+ $error_message = __( 'Bad Request. Please check your API credentials and account configuration.', 'checkout-com-unified-payments-api' );
+
+ // Try to extract specific error from response
+ if ( $error_data ) {
+ if ( isset( $error_data['error_codes'] ) && is_array( $error_data['error_codes'] ) ) {
+ $error_message .= ' Error codes: ' . implode( ', ', $error_data['error_codes'] );
+ }
+ if ( isset( $error_data['error_type'] ) ) {
+ $error_message .= ' Type: ' . $error_data['error_type'];
+ }
+ }
+ }
+
+ wp_send_json_error( [
+ 'message' => sprintf(
+ /* translators: 1: Response code, 2: Error message */
+ __( 'API request failed (HTTP %1$s). %2$s', 'checkout-com-unified-payments-api' ),
+ $response_code,
+ $error_message
+ ),
+ 'details' => $response_body, // Include full response for debugging
+ 'debug_info' => [
+ 'url' => $api_url,
+ 'account_type' => $account_type,
+ 'environment' => $environment,
+ 'secret_key_prefix' => substr( $secret_key_clean, 0, 10 ) . '...', // First 10 chars for debugging (safe)
+ ],
+ ] );
+ }
+ }
+
+ // Parse response
+ $response_data = json_decode( $response_body, true );
+
+ if ( ! isset( $response_data['content'] ) || empty( $response_data['content'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Invalid response from API. Content field is missing.', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ // Get CSR content
+ $csr_content = $response_data['content'];
+
+ // Ensure CSR content is properly formatted
+ if ( false === strpos( $csr_content, '-----BEGIN CERTIFICATE REQUEST-----' ) ) {
+ $csr_content = "-----BEGIN CERTIFICATE REQUEST-----\n" . $csr_content . "\n-----END CERTIFICATE REQUEST-----";
+ }
+
+ // Return CSR content for download
+ wp_send_json_success( [
+ 'csr_content' => $csr_content,
+ 'filename' => 'cko.csr',
+ ] );
+ }
+
+ /**
+ * AJAX handler for uploading Apple Pay certificate.
+ */
+ public function ajax_upload_certificate() {
+ // Log that the handler was called (for debugging)
+ if ( function_exists( 'WC_Checkoutcom_Utility' ) && method_exists( 'WC_Checkoutcom_Utility', 'logger' ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload AJAX Handler Called. POST data: ' . print_r( $_POST, true ),
+ null
+ );
+ }
+
+ // Verify nonce first
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_upload_certificate' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'nonce_verification_failed'
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ 'error_code' => 'insufficient_permissions'
+ ] );
+ }
+
+ // Get certificate from POST data
+ if ( ! isset( $_POST['certificate'] ) || empty( $_POST['certificate'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Certificate data is missing. Please select a certificate file and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ $certificate_base64_raw = wp_unslash( $_POST['certificate'] );
+
+ // The certificate from Apple is in DER format (binary)
+ // JavaScript FileReader already converts it to base64
+ // According to Checkout.com docs: "Encode the apple_pay.cer in base64"
+ // The command they mention: openssl x509 -inform der -in apple_pay.cer -out base64_converted.cer
+ // This converts DER to PEM format (base64 with headers)
+ // But the API likely expects just the base64 content (PEM without headers)
+
+ // Decode base64 to get DER binary
+ $certificate_der = base64_decode( $certificate_base64_raw, true );
+
+ if ( false === $certificate_der ) {
+ wp_send_json_error( [
+ 'message' => __( 'Invalid certificate format. Could not decode base64 certificate.', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ // Convert DER to PEM format, then extract base64 content
+ $certificate_final = false;
+
+ // Try using OpenSSL PHP functions first
+ if ( function_exists( 'openssl_x509_read' ) ) {
+ $cert_resource = @openssl_x509_read( $certificate_der );
+ if ( false !== $cert_resource ) {
+ $pem_output = '';
+ @openssl_x509_export( $cert_resource, $pem_output );
+ if ( ! empty( $pem_output ) ) {
+ // Extract base64 from PEM (remove headers and whitespace)
+ $certificate_final = preg_replace( '/-----BEGIN CERTIFICATE-----|-----END CERTIFICATE-----|\s/', '', $pem_output );
+ }
+ }
+ }
+
+ // Fallback: use shell command to convert DER to PEM
+ if ( false === $certificate_final && function_exists( 'shell_exec' ) ) {
+ $temp_der = tmpfile();
+ $temp_pem = tmpfile();
+
+ if ( $temp_der && $temp_pem ) {
+ $temp_der_path = stream_get_meta_data( $temp_der )['uri'];
+ $temp_pem_path = stream_get_meta_data( $temp_pem )['uri'];
+
+ file_put_contents( $temp_der_path, $certificate_der );
+
+ // Convert DER to PEM: openssl x509 -inform der -in cert.cer -out cert.pem
+ @shell_exec( sprintf( 'openssl x509 -inform der -in %s -out %s 2>&1', escapeshellarg( $temp_der_path ), escapeshellarg( $temp_pem_path ) ) );
+
+ if ( file_exists( $temp_pem_path ) && filesize( $temp_pem_path ) > 0 ) {
+ $pem_content = file_get_contents( $temp_pem_path );
+ // Extract base64 from PEM (remove headers and whitespace)
+ $certificate_final = preg_replace( '/-----BEGIN CERTIFICATE-----|-----END CERTIFICATE-----|\s/', '', $pem_content );
+ }
+
+ fclose( $temp_der );
+ fclose( $temp_pem );
+ }
+ }
+
+ // Final fallback: clean the original base64 (remove any whitespace)
+ if ( false === $certificate_final ) {
+ $certificate_final = preg_replace( '/\s/', '', $certificate_base64_raw );
+ }
+
+ // Get settings
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+
+ if ( empty( $core_settings['ckocom_sk'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Secret key is not configured. Please configure Checkout.com settings first.', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ $secret_key_raw = $core_settings['ckocom_sk'];
+ $environment = isset( $core_settings['ckocom_environment'] ) ? $core_settings['ckocom_environment'] : 'sandbox';
+ $account_type = isset( $core_settings['ckocom_account_type'] ) ? $core_settings['ckocom_account_type'] : 'ABC';
+ $region = isset( $core_settings['ckocom_region'] ) ? $core_settings['ckocom_region'] : 'global';
+
+ // Check if NAS account
+ if ( function_exists( 'cko_is_nas_account' ) && cko_is_nas_account() ) {
+ $account_type = 'NAS';
+ }
+
+ // Build API URL
+ $base_url = 'https://api.checkout.com';
+ if ( 'sandbox' === $environment ) {
+ $base_url = 'https://api.sandbox.checkout.com';
+ }
+
+ // Add region subdomain if not global
+ if ( 'global' !== $region && ! empty( $region ) ) {
+ $base_url = str_replace( 'api.', $region . '.api.', $base_url );
+ }
+
+ $api_url = $base_url . '/applepay/certificates';
+
+ // Prepare authorization header
+ $secret_key_clean = str_replace( 'Bearer ', '', trim( $secret_key_raw ) );
+
+ if ( 'NAS' === $account_type ) {
+ $auth_header = 'Bearer ' . $secret_key_clean;
+ } else {
+ // ABC accounts - try direct key first
+ $auth_header = $secret_key_clean;
+ }
+
+ // Prepare request body - According to Checkout.com docs:
+ // "Encode the apple_pay.cer in base64 using: openssl x509 -inform der -in apple_pay.cer -out base64_converted.cer"
+ // The command converts DER to PEM, but the API might expect:
+ // Option 1: Raw DER certificate in base64 (what JavaScript FileReader already provides)
+ // Option 2: PEM format (converted from DER)
+ // Option 3: Base64 content from PEM (without headers)
+
+ // Clean the base64 from JavaScript (remove any whitespace)
+ $certificate_clean_base64 = preg_replace( '/\s/', '', $certificate_base64_raw );
+
+ // Try format 1: Raw DER in base64 with field name "certificate"
+ // The API might expect different field names or structures
+ // Based on CSR response format {"content": "..."}, maybe upload expects different structure
+ $request_body = [
+ 'certificate' => $certificate_clean_base64,
+ ];
+
+ // Also prepare alternative structures for fallback
+ $request_body_alternatives = [
+ // Alternative 1: Using "content" field (like CSR response)
+ [ 'content' => $certificate_clean_base64 ],
+ // Alternative 2: Using "certificate_data"
+ [ 'certificate_data' => $certificate_clean_base64 ],
+ // Alternative 3: Nested structure
+ [ 'certificate' => [ 'content' => $certificate_clean_base64 ] ],
+ ];
+
+ // Also prepare PEM format for fallback
+ $pem_with_headers = false;
+ if ( function_exists( 'openssl_x509_read' ) ) {
+ $cert_resource = @openssl_x509_read( $certificate_der );
+ if ( false !== $cert_resource ) {
+ @openssl_x509_export( $cert_resource, $pem_with_headers );
+ }
+ }
+
+ // Extract base64 from PEM if we have it
+ $pem_base64_content = false;
+ if ( false !== $pem_with_headers && ! empty( $pem_with_headers ) ) {
+ $pem_base64_content = preg_replace( '/-----BEGIN CERTIFICATE-----|-----END CERTIFICATE-----|\s/', '', $pem_with_headers );
+ }
+
+ // Log request details for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Request: ' .
+ 'URL: ' . $api_url . ', ' .
+ 'Account Type: ' . $account_type . ', ' .
+ 'Environment: ' . $environment . ', ' .
+ 'Auth Header Format: ' . ( strpos( $auth_header, 'Bearer' ) !== false ? 'Bearer' : 'Direct' ) . ', ' .
+ 'Certificate Length: ' . strlen( $request_body['certificate'] ) . ', ' .
+ 'Certificate First 100 chars: ' . substr( $request_body['certificate'], 0, 100 ) . ', ' .
+ 'Certificate Format: ' . ( strpos( $request_body['certificate'], 'BEGIN' ) !== false ? 'PEM with headers' : 'Base64' ) . ', ' .
+ 'Request Body Structure: ' . json_encode( [ 'certificate' => substr( $request_body['certificate'], 0, 100 ) . '...' ] ),
+ null
+ );
+
+ // Make API request
+ $response = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ // Check for errors
+ if ( is_wp_error( $response ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Error making API request:', 'checkout-com-unified-payments-api' ) . ' ' . $response->get_error_message(),
+ ] );
+ }
+
+ $response_code = wp_remote_retrieve_response_code( $response );
+ $response_body = wp_remote_retrieve_body( $response );
+
+ if ( 200 !== $response_code && 201 !== $response_code ) {
+ // Log the actual request body for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Failed - Request Body: ' . json_encode( $request_body, JSON_UNESCAPED_SLASHES ),
+ null
+ );
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Failed - Response: ' . $response_code . ' - ' . $response_body,
+ null
+ );
+
+ // If 422, try alternative formats and structures
+ if ( 422 === $response_code ) {
+ // Try alternative request body structures first
+ foreach ( $request_body_alternatives as $index => $alt_body ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload: Retrying with alternative structure #' . ( $index + 1 ) . ': ' . json_encode( [ 'field' => array_keys( $alt_body )[0] ] ),
+ null
+ );
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $alt_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+ }
+ }
+
+ // Try format 2: PEM base64 content (without headers)
+ if ( false !== $pem_base64_content && ! empty( $pem_base64_content ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload: Retrying with PEM base64 content (without headers)',
+ null
+ );
+
+ $request_body_retry = [
+ 'certificate' => $pem_base64_content,
+ ];
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body_retry ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+ }
+ }
+
+ // Try format 3: Full PEM format (with headers)
+ if ( false !== $pem_with_headers && ! empty( $pem_with_headers ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload: Retrying with full PEM format (with headers)',
+ null
+ );
+
+ $request_body_retry = [
+ 'certificate' => $pem_with_headers,
+ ];
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body_retry ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+ }
+ }
+ }
+
+ // Try to parse error message
+ $error_message = $response_body;
+ $error_data = json_decode( $response_body, true );
+
+ // Log full error details
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload - Full Error Data: ' . print_r( $error_data, true ),
+ null
+ );
+
+ if ( $error_data && isset( $error_data['error_type'] ) ) {
+ $error_message = $error_data['error_type'];
+ if ( isset( $error_data['error_codes'] ) && is_array( $error_data['error_codes'] ) ) {
+ $error_message .= ': ' . implode( ', ', $error_data['error_codes'] );
+
+ // Log individual error codes for debugging
+ foreach ( $error_data['error_codes'] as $error_code ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload - Error Code: ' . $error_code,
+ null
+ );
+ }
+ }
+ if ( isset( $error_data['message'] ) ) {
+ $error_message .= ' - ' . $error_data['message'];
+ }
+ // Check for additional error details
+ if ( isset( $error_data['details'] ) ) {
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload - Error Details: ' . print_r( $error_data['details'], true ),
+ null
+ );
+ }
+ } elseif ( $error_data && isset( $error_data['message'] ) ) {
+ $error_message = $error_data['message'];
+ }
+
+ // If 401 (Unauthorized) or 400 (Bad Request), try with Bearer for ABC accounts
+ if ( ( 401 === $response_code || 400 === $response_code ) && 'ABC' === $account_type ) {
+ // Retry with Bearer prefix for ABC accounts
+ $auth_header_bearer = 'Bearer ' . $secret_key_clean;
+
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload: Retrying with Bearer authentication for ABC account',
+ null
+ );
+
+ $response_retry = wp_remote_post(
+ $api_url,
+ [
+ 'headers' => [
+ 'Authorization' => $auth_header_bearer,
+ 'Content-Type' => 'application/json',
+ ],
+ 'body' => json_encode( $request_body ),
+ 'timeout' => 30,
+ ]
+ );
+
+ if ( ! is_wp_error( $response_retry ) ) {
+ $retry_code = wp_remote_retrieve_response_code( $response_retry );
+ $retry_body = wp_remote_retrieve_body( $response_retry );
+ if ( 200 === $retry_code || 201 === $retry_code ) {
+ // Success with Bearer
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ } else {
+ // Log detailed error for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Failed (both direct key and Bearer): ' .
+ 'Direct Key: ' . $response_code . ' - ' . $response_body . ', ' .
+ 'Bearer: ' . $retry_code . ' - ' . $retry_body,
+ null
+ );
+ }
+ }
+ }
+
+ // Log detailed error for debugging
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Failed: ' . $response_code . ' - ' . $response_body .
+ ' | URL: ' . $api_url .
+ ' | Account Type: ' . $account_type .
+ ' | Environment: ' . $environment,
+ null
+ );
+
+ // Build detailed error message
+ $detailed_error = $error_message;
+ if ( $error_data ) {
+ if ( isset( $error_data['error_codes'] ) && is_array( $error_data['error_codes'] ) ) {
+ $detailed_error .= ' Error codes: ' . implode( ', ', $error_data['error_codes'] );
+ }
+ if ( isset( $error_data['details'] ) ) {
+ $detailed_error .= ' Details: ' . ( is_array( $error_data['details'] ) ? json_encode( $error_data['details'] ) : $error_data['details'] );
+ }
+ }
+
+ wp_send_json_error( [
+ 'message' => sprintf(
+ /* translators: 1: Response code, 2: Error message */
+ __( 'API request failed (HTTP %1$s). %2$s', 'checkout-com-unified-payments-api' ),
+ $response_code,
+ $detailed_error
+ ),
+ 'details' => $response_body,
+ 'error_data' => $error_data,
+ 'debug_info' => [
+ 'url' => $api_url,
+ 'account_type' => $account_type,
+ 'environment' => $environment,
+ 'certificate_length' => strlen( $request_body['certificate'] ),
+ 'certificate_format' => 'DER base64',
+ ],
+ ] );
+ return;
+ }
+
+ // Success
+ WC_Checkoutcom_Utility::logger(
+ 'Apple Pay Certificate Upload Success: ' . $response_body,
+ null
+ );
+
+ wp_send_json_success( [
+ 'message' => __( 'Certificate uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ ] );
+ }
+
+ /**
+ * AJAX handler for generating merchant certificate and private key.
+ * Generates a self-signed certificate and private key pair for Apple Pay merchant validation.
+ *
+ * @return void
+ */
+ public function ajax_generate_merchant_certificate() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_generate_merchant_certificate' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Check if doing AJAX
+ if ( ! wp_doing_ajax() ) {
+ wp_send_json_error( [
+ 'message' => __( 'Invalid request. This action must be performed via AJAX.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Check if OpenSSL is available
+ if ( ! function_exists( 'openssl_pkey_new' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'OpenSSL is not available on this server. Please contact your hosting provider to enable OpenSSL.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get site domain for certificate subject
+ $site_domain = parse_url( home_url(), PHP_URL_HOST );
+ if ( empty( $site_domain ) ) {
+ $site_domain = 'example.com';
+ }
+
+ // Generate certificate configuration
+ $config = [
+ 'digest_alg' => 'sha256',
+ 'private_key_bits' => 2048,
+ 'private_key_type' => OPENSSL_KEYTYPE_RSA,
+ 'x509_extensions' => 'v3_req',
+ ];
+
+ // Create certificate subject
+ $dn = [
+ 'countryName' => 'US',
+ 'stateOrProvinceName' => 'State',
+ 'localityName' => 'City',
+ 'organizationName' => get_bloginfo( 'name' ),
+ 'organizationalUnitName' => 'Apple Pay',
+ 'commonName' => $site_domain,
+ 'emailAddress' => get_option( 'admin_email', 'admin@example.com' ),
+ ];
+
+ // Generate private key
+ $private_key = openssl_pkey_new( $config );
+ if ( false === $private_key ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to generate private key. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Generate certificate signing request
+ $csr = openssl_csr_new( $dn, $private_key, $config );
+ if ( false === $csr ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to generate certificate signing request. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Sign the certificate (self-signed, valid for 1 year)
+ $cert = openssl_csr_sign( $csr, null, $private_key, 365, $config, time() );
+ if ( false === $cert ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to sign certificate. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Export certificate to PEM format
+ $certificate_pem = '';
+ if ( ! openssl_x509_export( $cert, $certificate_pem ) ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to export certificate. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Export private key to PEM format
+ $private_key_pem = '';
+ if ( ! openssl_pkey_export( $private_key, $private_key_pem ) ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to export private key. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Return certificate and private key as base64 for download
+ wp_send_json_success( [
+ 'message' => __( 'Certificate and private key generated successfully!', 'checkout-com-unified-payments-api' ),
+ 'certificate' => base64_encode( $certificate_pem ),
+ 'private_key' => base64_encode( $private_key_pem ),
+ 'certificate_filename' => 'apple-pay-merchant-certificate.pem',
+ 'private_key_filename' => 'apple-pay-merchant-private-key.key',
+ ] );
+ }
+
+ /**
+ * Get the correct .well-known directory path based on server configuration.
+ * Detects Bitnami installations and uses the Let's Encrypt path.
+ *
+ * @return array Array with 'dir' (directory path) and 'is_bitnami' (boolean).
+ */
+ private function get_well_known_path() {
+ // Check if this is a Bitnami installation
+ $is_bitnami = file_exists( '/opt/bitnami/apps/letsencrypt/.well-known' ) ||
+ file_exists( '/opt/bitnami/apps/letsencrypt' ) ||
+ ( defined( 'ABSPATH' ) && strpos( ABSPATH, '/opt/bitnami/' ) !== false );
+
+ if ( $is_bitnami && file_exists( '/opt/bitnami/apps/letsencrypt/.well-known' ) ) {
+ // Bitnami uses Let's Encrypt directory for .well-known
+ return array(
+ 'dir' => '/opt/bitnami/apps/letsencrypt/.well-known',
+ 'is_bitnami' => true,
+ );
+ }
+
+ // Standard WordPress installation
+ return array(
+ 'dir' => ABSPATH . '.well-known',
+ 'is_bitnami' => false,
+ );
+ }
+
+ /**
+ * AJAX handler for uploading domain association file.
+ */
+ public function ajax_upload_domain_association() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_upload_domain_association' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get file content from POST data
+ if ( ! isset( $_POST['file_content'] ) || empty( $_POST['file_content'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'File content is missing. Please select a domain association file and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $file_content = wp_unslash( $_POST['file_content'] );
+
+ // Get the correct .well-known directory path
+ $well_known_info = $this->get_well_known_path();
+ $well_known_dir = $well_known_info['dir'];
+ $is_bitnami = $well_known_info['is_bitnami'];
+
+ // Create .well-known directory if it doesn't exist
+ if ( ! file_exists( $well_known_dir ) ) {
+ if ( $is_bitnami ) {
+ // For Bitnami, try to create with sudo permissions (user will need to do this manually if it fails)
+ if ( ! wp_mkdir_p( $well_known_dir ) && ! is_dir( $well_known_dir ) ) {
+ wp_send_json_error( [
+ 'message' => sprintf(
+ __( 'Failed to create .well-known directory at %s. For Bitnami installations, you may need to create it manually via SSH: sudo mkdir -p %s && sudo chmod 755 %s', 'checkout-com-unified-payments-api' ),
+ $well_known_dir,
+ $well_known_dir,
+ $well_known_dir
+ ),
+ ] );
+ return;
+ }
+ } else {
+ if ( ! wp_mkdir_p( $well_known_dir ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to create .well-known directory. Please check file permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+ }
+ }
+
+ // Apple now requires the file to have .txt extension
+ // Save file to .well-known/apple-developer-merchantid-domain-association.txt
+ $file_path = $well_known_dir . '/apple-developer-merchantid-domain-association.txt';
+ $file_saved = file_put_contents( $file_path, $file_content );
+
+ if ( false === $file_saved ) {
+ wp_send_json_error( [
+ 'message' => sprintf(
+ __( 'Failed to save domain association file to %s. Please check file permissions. For Bitnami, you may need to set permissions manually: sudo chmod 644 %s', 'checkout-com-unified-payments-api' ),
+ $file_path,
+ $file_path
+ ),
+ ] );
+ return;
+ }
+
+ // Set appropriate file permissions
+ @chmod( $file_path, 0644 );
+
+ // For non-Bitnami installations, ensure .well-known directory is accessible
+ if ( ! $is_bitnami ) {
+ $this->ensure_well_known_accessible();
+ }
+
+ // Also save without .txt extension for backward compatibility (if not Bitnami)
+ if ( ! $is_bitnami ) {
+ $file_path_no_ext = $well_known_dir . '/apple-developer-merchantid-domain-association';
+ file_put_contents( $file_path_no_ext, $file_content );
+ @chmod( $file_path_no_ext, 0644 );
+ }
+
+ wp_send_json_success( [
+ 'message' => __( 'Domain association file uploaded successfully!', 'checkout-com-unified-payments-api' ),
+ 'file_path' => $file_path,
+ 'file_url' => home_url( '/.well-known/apple-developer-merchantid-domain-association.txt' ),
+ 'is_bitnami' => $is_bitnami,
+ ] );
+ }
+
+ /**
+ * AJAX handler for generating Merchant Identity CSR and private key.
+ */
+ public function ajax_generate_merchant_identity_csr() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_generate_merchant_identity_csr' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Check if OpenSSL is available
+ if ( ! function_exists( 'openssl_pkey_new' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'OpenSSL is not available on this server. Please contact your hosting provider to enable OpenSSL.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get site domain for certificate subject
+ $site_domain = parse_url( home_url(), PHP_URL_HOST );
+ if ( empty( $site_domain ) ) {
+ $site_domain = 'example.com';
+ }
+
+ // Generate certificate configuration
+ $config = [
+ 'digest_alg' => 'sha256',
+ 'private_key_bits' => 2048,
+ 'private_key_type' => OPENSSL_KEYTYPE_RSA,
+ ];
+
+ // Create certificate subject
+ $dn = [
+ 'countryName' => 'US',
+ 'stateOrProvinceName' => 'State',
+ 'localityName' => 'City',
+ 'organizationName' => get_bloginfo( 'name' ),
+ 'organizationalUnitName' => 'Apple Pay',
+ 'commonName' => $site_domain,
+ 'emailAddress' => get_option( 'admin_email', 'admin@example.com' ),
+ ];
+
+ // Generate private key
+ $private_key = openssl_pkey_new( $config );
+ if ( false === $private_key ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to generate private key. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Generate certificate signing request
+ $csr = openssl_csr_new( $dn, $private_key, $config );
+ if ( false === $csr ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to generate certificate signing request. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Export CSR to PEM format
+ $csr_pem = '';
+ if ( ! openssl_csr_export( $csr, $csr_pem ) ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to export CSR. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Export private key to PEM format
+ $private_key_pem = '';
+ if ( ! openssl_pkey_export( $private_key, $private_key_pem ) ) {
+ $openssl_error = openssl_error_string();
+ wp_send_json_error( [
+ 'message' => __( 'Failed to export private key. OpenSSL error: ', 'checkout-com-unified-payments-api' ) . $openssl_error,
+ ] );
+ return;
+ }
+
+ // Save private key file on server
+ $upload_dir = wp_upload_dir();
+ if ( $upload_dir['error'] ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to access uploads directory.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $certificate_dir = $upload_dir['basedir'] . '/checkout-com-apple-pay';
+ if ( ! file_exists( $certificate_dir ) ) {
+ wp_mkdir_p( $certificate_dir );
+ }
+
+ // Save key file on server
+ $key_file = $certificate_dir . '/certificate_sandbox.key';
+ $key_saved = file_put_contents( $key_file, $private_key_pem );
+
+ if ( false === $key_saved ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to save private key file on server. Please check file permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Set appropriate file permissions (readable only by owner)
+ chmod( $key_file, 0600 );
+
+ // Return CSR and private key as base64 for download, and also return server paths
+ wp_send_json_success( [
+ 'message' => __( 'CSR and private key generated successfully! Both files have been saved on your server.', 'checkout-com-unified-payments-api' ),
+ 'csr' => base64_encode( $csr_pem ),
+ 'private_key' => base64_encode( $private_key_pem ),
+ 'csr_filename' => 'uploadMe.csr',
+ 'private_key_filename' => 'certificate_sandbox.key',
+ 'key_file_path' => $key_file,
+ 'key_file_url' => $upload_dir['baseurl'] . '/checkout-com-apple-pay/certificate_sandbox.key',
+ ] );
+ }
+
+ /**
+ * AJAX handler for uploading and converting Merchant Identity certificate.
+ */
+ public function ajax_upload_merchant_identity_certificate() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_upload_merchant_identity_certificate' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get certificate from POST data
+ if ( ! isset( $_POST['certificate'] ) || empty( $_POST['certificate'] ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Certificate data is missing. Please select a certificate file and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $certificate_base64 = wp_unslash( $_POST['certificate'] );
+
+ // Decode base64 to get DER format
+ $certificate_der = base64_decode( $certificate_base64 );
+ if ( false === $certificate_der ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to decode certificate. Please ensure the file is valid.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Convert DER to PEM format
+ $certificate_pem = '';
+ if ( function_exists( 'openssl_x509_read' ) ) {
+ // Try to read the certificate from DER format
+ $cert = openssl_x509_read( $certificate_der );
+ if ( false !== $cert ) {
+ openssl_x509_export( $cert, $certificate_pem );
+ }
+ }
+
+ // Fallback to shell command if PHP function fails
+ if ( empty( $certificate_pem ) ) {
+ // Create temporary DER file
+ $temp_der = sys_get_temp_dir() . '/' . uniqid( 'cert_' ) . '.der';
+ file_put_contents( $temp_der, $certificate_der );
+
+ // Convert using openssl command
+ $command = 'openssl x509 -inform DER -in ' . escapeshellarg( $temp_der ) . ' -outform PEM';
+ $certificate_pem = shell_exec( $command );
+
+ // Clean up temp file
+ @unlink( $temp_der );
+ }
+
+ if ( empty( $certificate_pem ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to convert certificate from DER to PEM format. Please ensure OpenSSL is available.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Save certificate to WordPress uploads directory
+ $upload_dir = wp_upload_dir();
+ if ( $upload_dir['error'] ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to access uploads directory.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ $certificate_dir = $upload_dir['basedir'] . '/checkout-com-apple-pay';
+ if ( ! file_exists( $certificate_dir ) ) {
+ wp_mkdir_p( $certificate_dir );
+ }
+
+ // Save as certificate_sandbox.pem to match the key file name
+ $certificate_file = $certificate_dir . '/certificate_sandbox.pem';
+ $file_saved = file_put_contents( $certificate_file, $certificate_pem );
+
+ if ( false === $file_saved ) {
+ wp_send_json_error( [
+ 'message' => __( 'Failed to save certificate file. Please check file permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Set appropriate file permissions
+ chmod( $certificate_file, 0600 );
+
+ // Check if key file exists from previous step
+ $key_file = $certificate_dir . '/certificate_sandbox.key';
+ $key_file_exists = file_exists( $key_file );
+
+ $response_data = [
+ 'message' => __( 'Certificate uploaded and converted successfully! Both files are now saved on your server.', 'checkout-com-unified-payments-api' ),
+ 'certificate_path' => $certificate_file,
+ 'key_path' => $key_file_exists ? $key_file : null,
+ ];
+
+ if ( $key_file_exists ) {
+ $response_data['message'] = __( 'Certificate uploaded and converted successfully! Both certificate (.pem) and key (.key) files are now saved on your server.', 'checkout-com-unified-payments-api' );
+ } else {
+ $response_data['message'] = __( 'Certificate uploaded and converted successfully! The certificate (.pem) file is saved. Make sure the key (.key) file from Step 1 is also saved on your server.', 'checkout-com-unified-payments-api' );
+ }
+
+ wp_send_json_success( $response_data );
+ }
+
+ /**
+ * AJAX handler for testing Apple Pay certificate and key.
+ */
+ public function ajax_test_certificate() {
+ // Verify nonce
+ if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'cko_test_certificate' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Security check failed. Please refresh the page and try again.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( ! current_user_can( 'manage_woocommerce' ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Insufficient permissions.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Get settings
+ $apple_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', [] );
+
+ $merchant_id = isset( $apple_settings['ckocom_apple_mercahnt_id'] ) ? $apple_settings['ckocom_apple_mercahnt_id'] : '';
+ $domain_name = isset( $apple_settings['apple_pay_domain_name'] ) ? $apple_settings['apple_pay_domain_name'] : '';
+ $display_name = isset( $apple_settings['apple_pay_display_name'] ) ? $apple_settings['apple_pay_display_name'] : '';
+ $certificate_path = isset( $apple_settings['ckocom_apple_certificate'] ) ? $apple_settings['ckocom_apple_certificate'] : '';
+ $key_path = isset( $apple_settings['ckocom_apple_key'] ) ? $apple_settings['ckocom_apple_key'] : '';
+
+ // Validate required fields
+ if ( empty( $merchant_id ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Merchant Identifier is required. Please configure it in the Apple Pay Configuration section.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( empty( $domain_name ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Domain Name is required. Please configure it in the Apple Pay Configuration section.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( empty( $display_name ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Display Name is required. Please configure it in the Apple Pay Configuration section.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( empty( $certificate_path ) || ! file_exists( $certificate_path ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Certificate file not found. Please ensure the certificate path is correct and the file exists.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ if ( empty( $key_path ) || ! file_exists( $key_path ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'Private key file not found. Please ensure the key path is correct and the file exists.', 'checkout-com-unified-payments-api' ),
+ ] );
+ return;
+ }
+
+ // Prepare request data
+ $request_data = [
+ 'merchantIdentifier' => $merchant_id,
+ 'displayName' => $display_name,
+ 'domainName' => $domain_name,
+ ];
+
+ // Make request to Apple Pay payment session endpoint
+ $api_url = 'https://apple-pay-gateway.apple.com/paymentservices/paymentSession';
+
+ // Use cURL for certificate-based authentication
+ $ch = curl_init();
+ curl_setopt( $ch, CURLOPT_URL, $api_url );
+ curl_setopt( $ch, CURLOPT_POST, true );
+ curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode( $request_data ) );
+ curl_setopt( $ch, CURLOPT_SSLCERT, $certificate_path );
+ curl_setopt( $ch, CURLOPT_SSLKEY, $key_path );
+ curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
+ curl_setopt( $ch, CURLOPT_VERBOSE, true );
+ curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, true );
+ curl_setopt( $ch, CURLOPT_HTTPHEADER, [
+ 'Content-Type: application/json',
+ ] );
+
+ $response = curl_exec( $ch );
+ $http_code = curl_getinfo( $ch, CURLINFO_HTTP_CODE );
+ $curl_error = curl_error( $ch );
+ curl_close( $ch );
+
+ if ( ! empty( $curl_error ) ) {
+ wp_send_json_error( [
+ 'message' => __( 'cURL error: ', 'checkout-com-unified-payments-api' ) . $curl_error,
+ ] );
+ return;
+ }
+
+ // Check response
+ if ( 200 === $http_code ) {
+ // Simplified success message - don't return full JSON response
+ wp_send_json_success( [
+ 'message' => __( 'Certificate and key test successful! All paths and configurations are validated with Apple\'s services.', 'checkout-com-unified-payments-api' ),
+ ] );
+ } else {
+ // Simplified error message with actionable guidance
+ $error_message = __( 'Test Failed. Please verify:', 'checkout-com-unified-payments-api' );
+ $error_message .= '\n";
+ $htaccess_content .= "RewriteEngine On\n";
+ $htaccess_content .= "RewriteRule ^apple-developer-merchantid-domain-association$ - [L]\n";
+ $htaccess_content .= " \n";
+
+ // Only write if file doesn't exist or doesn't have our rule
+ if ( ! file_exists( $htaccess_file ) || strpos( file_get_contents( $htaccess_file ), 'apple-developer-merchantid-domain-association' ) === false ) {
+ file_put_contents( $htaccess_file, $htaccess_content );
+ chmod( $htaccess_file, 0644 );
+ }
+
+ // Also check main .htaccess and add rule if needed (before WordPress rules)
+ $main_htaccess = ABSPATH . '.htaccess';
+ if ( file_exists( $main_htaccess ) ) {
+ $main_htaccess_content = file_get_contents( $main_htaccess );
+
+ // Check if .well-known rule already exists
+ if ( strpos( $main_htaccess_content, '# BEGIN Allow .well-known' ) === false ) {
+ // Add rule before WordPress rules
+ $well_known_rule = "\n# BEGIN Allow .well-known\n";
+ $well_known_rule .= "\n";
+ $well_known_rule .= "RewriteEngine On\n";
+ $well_known_rule .= "RewriteRule ^\.well-known/ - [L]\n";
+ $well_known_rule .= " \n";
+ $well_known_rule .= "# END Allow .well-known\n";
+
+ // Insert before # BEGIN WordPress if it exists
+ if ( strpos( $main_htaccess_content, '# BEGIN WordPress' ) !== false ) {
+ $main_htaccess_content = str_replace( '# BEGIN WordPress', $well_known_rule . "\n# BEGIN WordPress", $main_htaccess_content );
+ } else {
+ // If no WordPress section, add at the beginning
+ $main_htaccess_content = $well_known_rule . "\n" . $main_htaccess_content;
+ }
+
+ file_put_contents( $main_htaccess, $main_htaccess_content );
+ }
+ }
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
diff --git a/includes/class-wc-gateway-checkout-com-cards.php b/includes/class-wc-gateway-checkout-com-cards.php
index 9884d1fa..404f95ae 100644
--- a/includes/class-wc-gateway-checkout-com-cards.php
+++ b/includes/class-wc-gateway-checkout-com-cards.php
@@ -68,8 +68,18 @@ public function __construct() {
// Redirection hook.
add_action( 'woocommerce_api_wc_checkoutcom_callback', [ $this, 'callback_handler' ] );
+<<<<<<< HEAD
// Webhook handler hook.
add_action( 'woocommerce_api_wc_checkoutcom_webhook', [ $this, 'webhook_handler' ] );
+=======
+ // Webhook handler hook - only register if not in Flow mode
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = $core_settings['ckocom_checkout_mode'] ?? 'classic';
+
+ if ( 'flow' !== $checkout_mode ) {
+ add_action( 'woocommerce_api_wc_checkoutcom_webhook', [ $this, 'webhook_handler' ] );
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
// Payment scripts.
add_action( 'wp_enqueue_scripts', [ $this, 'payment_scripts' ] );
@@ -232,6 +242,16 @@ public function admin_options() {
echo '';
WC_Admin_Settings::output_fields( WC_Checkoutcom_Cards_Settings::webhook_settings() );
echo '
';
+<<<<<<< HEAD
+=======
+ } elseif ( 'webhook_queue' === $screen ) {
+ // Render webhook queue page
+ if ( class_exists( 'WC_Checkoutcom_Webhook_Queue_Admin' ) ) {
+ WC_Checkoutcom_Webhook_Queue_Admin::render_admin_page();
+ } else {
+ echo '';
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
} else {
echo '';
@@ -331,7 +351,11 @@ public function payment_fields() {
*
* @return void
*/
+<<<<<<< HEAD
public function element_form( $iframe_style ) {
+=======
+ public function element_form( $iframe_style ) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
?>
+
+ `;
+ flowContainer.appendChild(waitingMessage);
+ }
+
+ ckoLogger.debug('Showing Flow waiting message');
+}
+
+/**
+ * Hide waiting message in Flow container
+ */
+function hideFlowWaitingMessage() {
+ const flowContainer = document.getElementById("flow-container");
+ if (!flowContainer) {
+ return;
+ }
+
+ const waitingMessage = flowContainer.querySelector('.flow-waiting-message');
+ if (waitingMessage) {
+ waitingMessage.remove();
+ ckoLogger.debug('Hiding Flow waiting message');
+ }
+}
+
+/**
+ * Destroy Flow component
+ */
+function destroyFlowComponent() {
+ if (ckoFlow.flowComponent) {
+ try {
+ // Unmount component if method exists
+ if (typeof ckoFlow.flowComponent.unmount === 'function') {
+ ckoFlow.flowComponent.unmount();
+ }
+ } catch (error) {
+ ckoLogger.error('Error destroying Flow component:', error);
+ }
+ ckoFlow.flowComponent = null;
+ }
+
+ // Clear component root
+ const flowComponentRoot = document.querySelector('[data-testid="checkout-web-component-root"]');
+ if (flowComponentRoot) {
+ flowComponentRoot.innerHTML = '';
+ }
+
+ ckoLogger.debug('Flow component destroyed');
+}
+
+/**
+ * Reload Flow component
+ */
+function reloadFlowComponent() {
+ if (!ckoFlow.flowComponent) {
+ try {
+ initializeFlowIfNeeded();
+ } catch (error) {
+ ckoLogger.error('Error reloading Flow component:', error);
+ }
+ return;
+ }
+
+ ckoLogger.debug('Reloading Flow component due to field change');
+
+ // Destroy existing component
+ destroyFlowComponent();
+
+ // Reset initialization flag
+ ckoFlowInitialized = false;
+
+ // Re-initialize Flow
+ try {
+ initializeFlowIfNeeded();
+ } catch (error) {
+ ckoLogger.error('Error re-initializing Flow:', error);
+ }
+}
+
+/**
+ * Check required fields status and handle Flow accordingly
+ */
+function checkRequiredFieldsStatus() {
+ const wereFilled = window.ckoFlowFieldsWereFilled || false;
+ const areFilled = requiredFieldsFilledAndValid();
+
+ ckoLogger.debug('checkRequiredFieldsStatus:', {
+ wereFilled: wereFilled,
+ areFilled: areFilled,
+ flowInitialized: ckoFlowInitialized,
+ flowComponentExists: !!ckoFlow.flowComponent
+ });
+
+ if (wereFilled && !areFilled) {
+ // Fields became unfilled
+ ckoLogger.debug('Required fields became unfilled - destroying Flow');
+ if (ckoFlowInitialized && ckoFlow.flowComponent) {
+ destroyFlowComponent();
+ showFlowWaitingMessage();
+ ckoFlowInitialized = false;
+ }
+ } else if (!wereFilled && areFilled) {
+ // Fields became filled - initialize Flow
+ ckoLogger.debug('Required fields became filled - initializing Flow');
+ if (!ckoFlowInitialized && !ckoFlowInitializing) {
+ initializeFlowIfNeeded();
+ } else if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow initialization already in progress, skipping');
+ }
+ } else if (areFilled && !ckoFlowInitialized && !ckoFlowInitializing) {
+ // Fields are filled but Flow not initialized - try to initialize
+ ckoLogger.debug('Fields are filled but Flow not initialized - attempting initialization');
+ initializeFlowIfNeeded();
+ } else if (areFilled && ckoFlowInitializing) {
+ ckoLogger.debug('Flow initialization already in progress, skipping duplicate call');
+ }
+
+ window.ckoFlowFieldsWereFilled = areFilled;
+}
+
+/**
+ * Debounced check for Flow reload when critical fields change
+ */
+let reloadFlowTimeout = null;
+function debouncedCheckFlowReload(fieldName, newValue) {
+ // Clear existing timeout
+ if (reloadFlowTimeout) {
+ clearTimeout(reloadFlowTimeout);
+ }
+
+ // Set new timeout
+ reloadFlowTimeout = setTimeout(() => {
+ // Only reload if Flow is initialized and field is actually filled
+ if (!ckoFlowInitialized || !ckoFlow.flowComponent) {
+ return;
+ }
+
+ // Check if all required fields are still filled
+ if (!requiredFieldsFilledAndValid()) {
+ // Fields became invalid - destroy Flow
+ destroyFlowComponent();
+ showFlowWaitingMessage();
+ ckoFlowInitialized = false;
+ return;
+ }
+
+ // Critical field changed - reload Flow
+ ckoLogger.debug(`Critical field ${fieldName} changed - reloading Flow`);
+ reloadFlowComponent();
+ }, 1000); // 1 second debounce for reload check
+}
+
+/**
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ * SIMPLIFIED: Single function to initialize Flow when needed
+ * Only initializes if:
+ * 1. Flow payment method is selected
+ * 2. Flow is not already initialized
+ * 3. Container exists
+<<<<<<< HEAD
+ * 4. All required fields are filled (NEW)
+ */
+function initializeFlowIfNeeded() {
+ // CRITICAL: Prevent multiple simultaneous initializations
+ if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow initialization already in progress, skipping duplicate call');
+ return;
+ }
+
+=======
+ */
+function initializeFlowIfNeeded() {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // CRITICAL: Don't initialize if we're handling a 3DS return
+ // Check flag first (set by early detection)
+ if (window.ckoFlow3DSReturn) {
+ console.log('[FLOW 3DS] ⚠️ initializeFlowIfNeeded: Blocked by 3DS return flag');
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.threeDS('Skipping Flow initialization - 3DS return in progress');
+ }
+ return;
+ }
+
+ // Also check URL parameters as fallback
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ console.log('[FLOW 3DS] ⚠️ initializeFlowIfNeeded: Blocked by 3DS return URL parameters');
+ window.ckoFlow3DSReturn = true;
+ if (typeof ckoLogger !== 'undefined') {
+ ckoLogger.threeDS('Skipping Flow initialization - 3DS return detected in URL');
+ }
+ return;
+ }
+
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ const flowContainer = document.getElementById("flow-container");
+ const flowComponentRoot = document.querySelector('[data-testid="checkout-web-component-root"]');
+
+ ckoLogger.debug('initializeFlowIfNeeded() state check:', {
+ flowPaymentExists: !!flowPayment,
+ flowPaymentChecked: flowPayment?.checked || false,
+ flowContainerExists: !!flowContainer,
+ flowComponentRootExists: !!flowComponentRoot,
+ flowInitialized: ckoFlowInitialized,
+<<<<<<< HEAD
+ flowInitializing: ckoFlowInitializing,
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ flowComponentExists: !!ckoFlow.flowComponent
+ });
+
+ // Check if Flow payment method is selected
+ if (!flowPayment || !flowPayment.checked) {
+ ckoLogger.debug('Flow payment method not selected, skipping initialization');
+ return;
+ }
+
+ // Check if container exists
+ if (!flowContainer) {
+ ckoLogger.debug('Flow container not found, skipping initialization');
+ return;
+ }
+
+ // Check if already initialized and component is mounted
+ if (ckoFlowInitialized && ckoFlow.flowComponent && flowComponentRoot) {
+ ckoLogger.debug('Flow already initialized and mounted, skipping');
+ // Just ensure container is visible
+ flowContainer.style.display = "block";
+ document.body.classList.add("flow-method-selected");
+<<<<<<< HEAD
+ hideFlowWaitingMessage(); // Hide waiting message if shown
+ return;
+ }
+
+ // NEW: Check if Flow can be initialized (validation check)
+ const canInit = canInitializeFlow();
+ ckoLogger.debug('canInitializeFlow() check result:', {
+ canInit: canInit,
+ flowPaymentSelected: !!flowPayment && flowPayment.checked,
+ containerExists: !!flowContainer,
+ cartTotal: cko_flow_vars?.cart_total,
+ isLoggedIn: isUserLoggedIn(),
+ hasBillingAddress: hasBillingAddress(),
+ requiredFieldsFilled: requiredFieldsFilled(),
+ requiredFieldsValid: requiredFieldsFilledAndValid()
+ });
+
+ if (!canInit) {
+ ckoLogger.debug('Cannot initialize Flow - validation failed');
+ // Show waiting message
+ document.body.classList.add("flow-method-selected");
+ showFlowWaitingMessage();
+ // Setup field watchers to check again when fields are filled
+ setupFieldWatchersForInitialization();
+ return;
+ }
+
+ // Hide waiting message if it was shown
+ hideFlowWaitingMessage();
+
+ // Initialize Flow
+ ckoLogger.debug('Initializing Flow - payment selected, container exists, validation passed');
+ document.body.classList.add("flow-method-selected");
+ flowContainer.style.display = "block";
+
+ // Mark fields as filled
+ window.ckoFlowFieldsWereFilled = true;
+
+ // Only initialize if not already initialized
+ if (!ckoFlowInitialized || !ckoFlow.flowComponent) {
+ // Set guard flag to prevent multiple simultaneous initializations
+ // NOTE: This flag will be cleared when component is mounted (in loadFlow callback)
+ // or on error (in catch block of loadFlow)
+ ckoFlowInitializing = true;
+
+ try {
+ ckoLogger.debug('Calling ckoFlow.init()...');
+ ckoFlow.init();
+ // Don't set ckoFlowInitialized = true here - it will be set when component mounts
+ // Don't clear ckoFlowInitializing here - it will be cleared when component mounts
+ } catch (error) {
+ ckoLogger.debug('Error during Flow initialization:', error);
+ ckoFlowInitialized = false;
+ ckoFlowInitializing = false; // Clear guard flag on error
+ throw error; // Re-throw to allow caller to handle
+ }
+=======
+ return;
+ }
+
+ // Initialize Flow
+ ckoLogger.debug('Initializing Flow - payment selected, container exists, not initialized');
+ document.body.classList.add("flow-method-selected");
+ flowContainer.style.display = "block";
+
+ // Only initialize if not already initialized
+ if (!ckoFlowInitialized || !ckoFlow.flowComponent) {
+ ckoLogger.debug('Calling ckoFlow.init()...');
+ ckoFlow.init();
+ ckoFlowInitialized = true;
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ } else {
+ ckoLogger.debug('Skipping ckoFlow.init() - already initialized');
+ }
+}
+
+/**
+<<<<<<< HEAD
+ * Setup field watchers for initialization
+ * Watches required fields and initializes Flow when they become filled
+ */
+function setupFieldWatchersForInitialization() {
+ // Only setup if Flow is not initialized
+ if (ckoFlowInitialized) {
+ return;
+ }
+
+ // Get all required field selectors
+ const requiredLabels = document.querySelectorAll(".woocommerce-checkout label .required");
+ const fieldSelectors = [];
+
+ requiredLabels.forEach((label) => {
+ const fieldId = label.closest("label").getAttribute("for");
+ if (fieldId && !fieldId.startsWith("shipping")) {
+ fieldSelectors.push('#' + fieldId);
+ }
+ });
+
+ // Add critical fields if not already included
+ const criticalFields = ['#billing_email', '#billing_country', '#billing_address_1', '#billing_city', '#billing_postcode'];
+ criticalFields.forEach(selector => {
+ if (!fieldSelectors.includes(selector)) {
+ fieldSelectors.push(selector);
+ }
+ });
+
+ // Setup watchers with debouncing
+ const debouncedCheck = debounce(() => {
+ ckoLogger.debug('Field watcher triggered - checking if Flow can initialize');
+ checkRequiredFieldsStatus();
+
+ // Also directly check if we can initialize now
+ if (!ckoFlowInitialized && canInitializeFlow()) {
+ ckoLogger.debug('Field watcher - all fields valid, initializing Flow');
+ initializeFlowIfNeeded();
+ }
+ }, 300); // Reduced debounce to 300ms for faster response
+
+ // Attach watchers to all required fields
+ fieldSelectors.forEach(selector => {
+ const field = document.querySelector(selector);
+ if (field) {
+ // Remove existing listener to avoid duplicates
+ jQuery(field).off('input change.flow-init');
+ // Add new listener
+ jQuery(field).on('input change.flow-init', debouncedCheck);
+ ckoLogger.debug('Field watcher attached:', selector);
+ }
+ });
+
+ ckoLogger.debug('Field watchers setup for initialization', { fieldCount: fieldSelectors.length });
+
+ // Also check immediately if fields are already filled
+ setTimeout(() => {
+ if (!ckoFlowInitialized && canInitializeFlow()) {
+ ckoLogger.debug('Immediate check after watcher setup - fields already filled, initializing Flow');
+ initializeFlowIfNeeded();
+ }
+ }, 100);
+}
+
+/**
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ * Legacy function name for compatibility
+ * Now just calls the simplified initializeFlowIfNeeded()
+ */
+function handleFlowPaymentSelection() {
+ initializeFlowIfNeeded();
+}
+
+
+/**
+ * SIMPLIFIED: Protect Flow from updated_checkout destruction
+ * When WooCommerce updates checkout, it replaces the HTML which can destroy Flow component
+ * This handler checks if Flow was destroyed AFTER DOM update and re-initializes only if needed
+ */
+<<<<<<< HEAD
+// Track previous cart total for change detection
+let previousCartTotal = typeof cko_flow_vars !== 'undefined' && cko_flow_vars.cart_total ? parseFloat(cko_flow_vars.cart_total) : 0;
+
+jQuery(document).on("updated_checkout", function () {
+ ckoLogger.debug('===== updated_checkout EVENT FIRED =====');
+
+ // Log field values BEFORE DOM update
+ const emailBefore = getCheckoutFieldValue("billing_email");
+ const addressBefore = getCheckoutFieldValue("billing_address_1");
+ const cityBefore = getCheckoutFieldValue("billing_city");
+ const countryBefore = getCheckoutFieldValue("billing_country");
+ const flowPaymentBefore = document.getElementById("payment_method_wc_checkout_com_flow");
+
+ ckoLogger.debug('State BEFORE updated_checkout:', {
+ email: emailBefore || 'EMPTY',
+ address1: addressBefore || 'EMPTY',
+ city: cityBefore || 'EMPTY',
+ country: countryBefore || 'EMPTY',
+ flowPaymentChecked: flowPaymentBefore?.checked || false,
+ flowInitialized: ckoFlowInitialized
+ });
+
+=======
+jQuery(document).on("updated_checkout", function () {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // CRITICAL: Skip if we're handling a 3DS return (don't re-initialize Flow)
+ // Check both the flag and URL parameters
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('Skipping updated_checkout handler - 3DS return flag is set');
+ return;
+ }
+
+ // Also check URL parameters as fallback
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ ckoLogger.threeDS('Skipping updated_checkout handler - 3DS return detected in URL');
+ window.ckoFlow3DSReturn = true;
+ return;
+ }
+
+<<<<<<< HEAD
+ // Check if cart total changed
+ if (typeof cko_flow_vars !== 'undefined' && cko_flow_vars.cart_total) {
+ const currentCartTotal = parseFloat(cko_flow_vars.cart_total) || 0;
+
+ // Check if cart total changed significantly (> 0.01 to avoid floating point issues)
+ if (Math.abs(currentCartTotal - previousCartTotal) > 0.01) {
+ ckoLogger.debug('Cart total changed - will reload Flow', {
+ previous: previousCartTotal,
+ current: currentCartTotal
+ });
+
+ // Update stored total
+ previousCartTotal = currentCartTotal;
+
+ // Reload Flow if initialized (after a small delay to let checkout update complete)
+ setTimeout(() => {
+ if (ckoFlowInitialized && ckoFlow.flowComponent && canInitializeFlow()) {
+ reloadFlowComponent();
+ }
+ }, 300);
+ }
+ }
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ ckoLogger.debug('updated_checkout event fired');
+ ckoLogger.debug('Flow state BEFORE updated_checkout:', {
+ flowInitialized: ckoFlowInitialized,
+ flowComponentExists: !!ckoFlow.flowComponent,
+ flowComponentRootExists: !!document.querySelector('[data-testid="checkout-web-component-root"]'),
+ flowContainerExists: !!document.getElementById("flow-container"),
+ flowPaymentChecked: document.getElementById("payment_method_wc_checkout_com_flow")?.checked || false
+ });
+
+ // CRITICAL: Wait for DOM to be updated by WooCommerce before checking
+ // WooCommerce replaces the HTML asynchronously, so we need to check after it completes
+ setTimeout(function() {
+ // CRITICAL: Check for 3DS return again in setTimeout callback
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('Skipping updated_checkout setTimeout callback - 3DS return in progress');
+ return;
+ }
+
+ // Also check URL parameters as fallback
+ const urlParamsCheck = new URLSearchParams(window.location.search);
+ const paymentIdCheck = urlParamsCheck.get("cko-payment-id");
+ const sessionIdCheck = urlParamsCheck.get("cko-session-id");
+ const paymentSessionIdCheck = urlParamsCheck.get("cko-payment-session-id");
+
+ if (paymentIdCheck || sessionIdCheck || paymentSessionIdCheck) {
+ ckoLogger.threeDS('Skipping updated_checkout setTimeout callback - 3DS return detected in URL');
+ window.ckoFlow3DSReturn = true;
+ return;
+ }
+
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ const flowComponentRoot = document.querySelector('[data-testid="checkout-web-component-root"]');
+ const flowContainer = document.getElementById("flow-container");
+
+<<<<<<< HEAD
+ // Log field values AFTER DOM update (capture before values from closure)
+ const emailAfter = getCheckoutFieldValue("billing_email");
+ const addressAfter = getCheckoutFieldValue("billing_address_1");
+ const cityAfter = getCheckoutFieldValue("billing_city");
+ const countryAfter = getCheckoutFieldValue("billing_country");
+
+ ckoLogger.debug('===== updated_checkout: State AFTER 100ms delay =====');
+ ckoLogger.debug('Field values AFTER updated_checkout:', {
+ email: emailAfter || 'EMPTY',
+ address1: addressAfter || 'EMPTY',
+ city: cityAfter || 'EMPTY',
+ country: countryAfter || 'EMPTY',
+ fieldsChanged: {
+ email: emailBefore !== emailAfter,
+ address1: addressBefore !== addressAfter,
+ city: cityBefore !== cityAfter,
+ country: countryBefore !== countryAfter
+ }
+ });
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ ckoLogger.debug('Flow state AFTER updated_checkout (100ms delay):', {
+ flowPaymentExists: !!flowPayment,
+ flowPaymentChecked: flowPayment?.checked || false,
+ flowComponentRootExists: !!flowComponentRoot,
+ flowContainerExists: !!flowContainer,
+ flowInitialized: ckoFlowInitialized,
+<<<<<<< HEAD
+ flowComponentExists: !!ckoFlow.flowComponent,
+ requiredFieldsFilled: requiredFieldsFilled(),
+ requiredFieldsValid: requiredFieldsFilledAndValid(),
+ canInitialize: canInitializeFlow()
+=======
+ flowComponentExists: !!ckoFlow.flowComponent
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ });
+
+ // Only re-initialize if:
+ // 1. Flow payment method is still selected
+ // 2. Flow component is NOT mounted (was destroyed by updated_checkout)
+ // 3. Flow container exists (DOM was updated)
+<<<<<<< HEAD
+ // 4. Flow is NOT currently initializing (prevent duplicate calls)
+ if (flowPayment && flowPayment.checked && flowContainer) {
+ if (!flowComponentRoot) {
+ // Check if initialization is already in progress
+ if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow component not mounted but initialization already in progress, skipping duplicate call');
+ return;
+ }
+
+=======
+ if (flowPayment && flowPayment.checked && flowContainer) {
+ if (!flowComponentRoot) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ ckoLogger.debug('Flow component was destroyed by updated_checkout, re-initializing...');
+ // Reset flag so Flow can be re-initialized
+ ckoFlowInitialized = false;
+ ckoFlow.flowComponent = null;
+ // Re-initialize
+ initializeFlowIfNeeded();
+ } else {
+ ckoLogger.debug('Flow component still mounted after updated_checkout, no action needed');
+ }
+ } else if (flowPayment && flowPayment.checked && !flowContainer) {
+<<<<<<< HEAD
+ // Check if initialization is already in progress
+ if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow container not found but initialization already in progress, skipping duplicate call');
+ return;
+ }
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ ckoLogger.debug('Flow payment selected but container not found yet, waiting...');
+ // Container might not be ready yet, check again after a short delay
+ setTimeout(function() {
+ const flowContainerRetry = document.getElementById("flow-container");
+ const flowComponentRootRetry = document.querySelector('[data-testid="checkout-web-component-root"]');
+ ckoLogger.debug('Retry check (300ms total):', {
+ flowContainerExists: !!flowContainerRetry,
+<<<<<<< HEAD
+ flowComponentRootExists: !!flowComponentRootRetry,
+ flowInitializing: ckoFlowInitializing
+ });
+ if (flowContainerRetry && !flowComponentRootRetry && !ckoFlowInitializing) {
+=======
+ flowComponentRootExists: !!flowComponentRootRetry
+ });
+ if (flowContainerRetry && !flowComponentRootRetry) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ ckoLogger.debug('Flow container found on retry, re-initializing...');
+ ckoFlowInitialized = false;
+ ckoFlow.flowComponent = null;
+ initializeFlowIfNeeded();
+ } else if (flowContainerRetry && flowComponentRootRetry) {
+ ckoLogger.debug('Flow component found on retry, no re-initialization needed');
+<<<<<<< HEAD
+ } else if (ckoFlowInitializing) {
+ ckoLogger.debug('Flow initialization already in progress on retry, skipping');
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ } else {
+ ckoLogger.debug('Flow container still not found on retry');
+ }
+ }, 200);
+ } else {
+ ckoLogger.debug('Conditions not met for re-initialization:', {
+ flowPaymentExists: !!flowPayment,
+ flowPaymentChecked: flowPayment?.checked || false,
+ flowContainerExists: !!flowContainer
+ });
+ }
+ }, 100); // Wait 100ms for WooCommerce to finish updating DOM
+});
+
+/**
+ * Global handler for saved card selection (works in both new_payment_first and saved_cards_first modes)
+ * When a saved card is selected, show the Place Order button
+ * When new payment method is selected, ensure Flow container is visible and interactive
+ */
+jQuery(document).on(
+ "change",
+ 'input[name="wc-wc_checkout_com_flow-payment-token"]',
+ function () {
+ const selectedToken = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked');
+ const flowContainer = document.getElementById("flow-container");
+ const selectedId = selectedToken.attr('id');
+
+ // If "Use new payment method" is selected
+ if (selectedId === 'wc-wc_checkout_com_flow-payment-token-new') {
+ ckoLogger.debug('New payment method selected - showing Flow container');
+
+ // Show Flow container
+ if (flowContainer) {
+ flowContainer.style.display = "block";
+ }
+
+ // Mark as ready when Flow component is valid
+ if (ckoFlow.flowComponent) {
+ document.body.classList.add("flow-ready");
+ } else {
+ // Flow not initialized yet, wait for it
+ document.body.classList.remove("flow-ready");
+ }
+
+ // Scroll to Flow container
+ setTimeout(() => {
+ if (flowContainer) {
+ flowContainer.scrollIntoView({ behavior: 'smooth', block: 'nearest' });
+ }
+ }, 100);
+ }
+ // If a saved card is selected
+ else if (selectedToken.length > 0) {
+ ckoLogger.debug('Saved card selected - making Place Order button visible');
+ document.body.classList.add("flow-ready");
+
+ // Keep Flow container visible
+ if (flowContainer) {
+ flowContainer.style.display = "block";
+ }
+ }
+ }
+);
+
+/**
+ * Listen for changes in the payment method selection and handle the Flow payment method.
+ *
+ * This event listener listens for changes to the payment method selection form (typically a radio button).
+ * When a change is detected in the selection of the payment method, it checks if the selected input is
+ * the payment method field and triggers the Flow payment selection handler.
+ */
+document.addEventListener("change", function (event) {
+ if (event.target && event.target.name === "payment_method") {
+<<<<<<< HEAD
+ ckoLogger.debug('===== PAYMENT METHOD CHANGE EVENT =====');
+ ckoLogger.debug('Changed payment method:', {
+ targetId: event.target.id,
+ targetValue: event.target.value,
+ targetChecked: event.target.checked
+ });
+
+ // Log all payment methods
+ const allPaymentMethods = document.querySelectorAll('input[name="payment_method"]');
+ const paymentMethodsState = [];
+ allPaymentMethods.forEach(pm => {
+ paymentMethodsState.push({
+ id: pm.id,
+ value: pm.value,
+ checked: pm.checked
+ });
+ });
+ ckoLogger.debug('All payment methods state:', paymentMethodsState);
+
+ // Immediately add flow-method-selected class if Flow is selected
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (flowPayment && flowPayment.checked) {
+ ckoLogger.debug('Checkout.com payment method SELECTED');
+=======
+ // Immediately add flow-method-selected class if Flow is selected
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (flowPayment && flowPayment.checked) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ document.body.classList.add("flow-method-selected");
+ // Remove flow-ready until component is actually ready
+ document.body.classList.remove("flow-ready");
+ } else {
+<<<<<<< HEAD
+ ckoLogger.debug('Checkout.com payment method NOT selected - other method selected');
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // Remove Flow classes for other payment methods
+ document.body.classList.remove("flow-method-selected", "flow-ready");
+ // Reset Flow interaction flags when switching to other payment methods
+ window.flowUserInteracted = false;
+ window.flowSavedCardSelected = false;
+ }
+
+ handleFlowPaymentSelection();
+ }
+});
+
+/**
+ * SIMPLIFIED: Single DOMContentLoaded handler
+ * Handles initial Flow setup when page loads
+ */
+document.addEventListener("DOMContentLoaded", function () {
+ // CRITICAL: Check for 3DS return FIRST - before any other checks
+ // This must be the very first thing we check
+ if (window.ckoFlow3DSReturn) {
+ ckoLogger.threeDS('DOMContentLoaded: 3DS return in progress, skipping ALL Flow initialization');
+ return; // Exit immediately - don't do anything else
+ }
+
+ // Also check URL parameters as a fallback (in case early detection didn't run)
+ const urlParams = new URLSearchParams(window.location.search);
+ const paymentId = urlParams.get("cko-payment-id");
+ const sessionId = urlParams.get("cko-session-id");
+ const paymentSessionId = urlParams.get("cko-payment-session-id");
+
+ if (paymentId || sessionId || paymentSessionId) {
+ ckoLogger.threeDS('DOMContentLoaded: 3DS return detected in URL, skipping Flow initialization');
+ window.ckoFlow3DSReturn = true;
+ return; // Don't initialize Flow during 3DS return
+ }
+
+ // Check if Flow payment method is selected on page load
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+
+<<<<<<< HEAD
+ // If Flow is selected, check if we can initialize it
+ if (flowPayment && flowPayment.checked) {
+ ckoLogger.debug('DOMContentLoaded: Flow payment method is selected');
+ // Try to initialize - validation will happen inside initializeFlowIfNeeded()
+ initializeFlowIfNeeded();
+
+ // Also setup field watchers in case fields aren't filled yet
+ if (!ckoFlowInitialized) {
+ setupFieldWatchersForInitialization();
+
+ // Set up periodic check as fallback (every 2 seconds)
+ // This ensures Flow initializes even if field watchers don't trigger
+ const periodicCheck = setInterval(() => {
+ if (ckoFlowInitialized) {
+ clearInterval(periodicCheck);
+ return;
+ }
+
+ if (canInitializeFlow()) {
+ ckoLogger.debug('Periodic check - Flow can initialize, initializing now');
+ initializeFlowIfNeeded();
+ clearInterval(periodicCheck);
+ }
+ }, 2000);
+
+ // Clear interval after 30 seconds to avoid infinite checking
+ setTimeout(() => {
+ clearInterval(periodicCheck);
+ }, 30000);
+ }
+=======
+ // If Flow is selected, initialize it
+ if (flowPayment && flowPayment.checked) {
+ ckoLogger.debug('DOMContentLoaded: Flow payment method is selected, initializing...');
+ initializeFlowIfNeeded();
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ }
+
+ // Handle order-pay page
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+<<<<<<< HEAD
+ // Check if Flow payment method is selected before initializing
+ const orderPayFlowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (orderPayFlowPayment && orderPayFlowPayment.checked) {
+ ckoLogger.debug('DOMContentLoaded: Order-pay page detected, Flow payment method selected, initializing Flow...');
+ initializeFlowIfNeeded();
+ } else {
+ ckoLogger.debug('DOMContentLoaded: Order-pay page detected, but Flow payment method not selected');
+ }
+=======
+ ckoLogger.debug('DOMContentLoaded: Order-pay page detected, initializing Flow...');
+ initializeFlowIfNeeded();
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ }
+});
+
+/**
+ * Handle Place Order Button with Flow Checkout when ShowPayButton is False.
+ *
+ * This function listens for a click event on the "Place Order" button. If the checkout method
+ * is "Flow" and the user is using the checkout component, it validates the form and proceeds
+ * with the appropriate order placement, either using the Flow component or submitting the form directly.
+ *
+ */
+document.addEventListener("DOMContentLoaded", function () {
+
+ // Listen for saved card clicks to de-emphasize Flow
+ jQuery(document).on('click', 'input[name="wc-wc_checkout_com_flow-payment-token"]', function() {
+ const selectedId = jQuery(this).attr('id');
+ const flowContainer = document.getElementById("flow-container");
+
+ if (selectedId && selectedId !== 'wc-wc_checkout_com_flow-payment-token-new') {
+ ckoLogger.debug('Saved card selected');
+ window.flowUserInteracted = false;
+ window.flowSavedCardSelected = true;
+
+ // Remove the hidden override input if it exists (user switched back to saved card)
+ jQuery('#flow-new-payment-override').remove();
+ } else if (selectedId === 'wc-wc_checkout_com_flow-payment-token-new') {
+ ckoLogger.debug('New payment method selected - activating Flow');
+ window.activateFlowPayment();
+ }
+ });
+
+ // Function to activate Flow and deselect saved cards
+ // Make it globally accessible so onChange callback can use it
+ window.activateFlowPayment = function() {
+ console.log('[FLOW] Activating Flow payment method');
+
+ const flowContainer = document.getElementById("flow-container");
+ if (!flowContainer) return;
+
+ // Uncheck all saved card radio buttons (including any that might be hidden)
+ jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]').each(function() {
+ const radioId = jQuery(this).attr('id');
+ // Don't uncheck the "new payment method" radio
+ if (radioId !== 'wc-wc_checkout_com_flow-payment-token-new') {
+ jQuery(this).prop('checked', false);
+ jQuery(this).removeAttr('checked');
+ }
+ });
+
+ // Try to select "Use new payment method" radio button if it exists
+ const newPaymentRadio = document.getElementById('wc-wc_checkout_com_flow-payment-token-new');
+ if (newPaymentRadio) {
+ newPaymentRadio.checked = true;
+ jQuery(newPaymentRadio).attr('checked', 'checked');
+ jQuery(newPaymentRadio).trigger('change');
+ } else {
+ // If the "new payment method" radio doesn't exist, add a hidden input
+ jQuery('#flow-new-payment-override').remove();
+
+ const overrideInput = jQuery('', {
+ type: 'hidden',
+ id: 'flow-new-payment-override',
+ name: 'wc-wc_checkout_com_flow-payment-token',
+ value: 'new'
+ });
+ jQuery('form.checkout, form#order_review').append(overrideInput);
+ }
+
+ // Flow container is now active for new payment
+
+ // Clear saved card flag and mark for new Flow payment
+ window.flowSavedCardSelected = false;
+ window.flowUserInteracted = false; // Reset to allow user to interact with Flow
+ document.body.classList.add("flow-ready");
+
+ // Ensure Place Order button is visible
+ const placeOrderButton = document.getElementById('place_order');
+ if (placeOrderButton) {
+ placeOrderButton.style.display = 'block';
+ placeOrderButton.style.opacity = '1';
+ placeOrderButton.style.visibility = 'visible';
+ }
+ }
+
+ // Listen for clicks/focus on Flow component fields to auto-activate Flow
+ jQuery(document).on('click focus', '#flow-container input, #flow-container iframe, #flow-container', function(e) {
+ const flowContainer = document.getElementById("flow-container");
+
+ // Only activate if Flow is currently de-emphasized (saved card selected)
+ if (flowContainer && flowContainer.classList.contains('flow-de-emphasized')) {
+ console.log('[FLOW] User clicked on Flow field - auto-activating Flow');
+ window.activateFlowPayment();
+ }
+ });
+
+ /**
+ * Helper function to persist the save card checkbox value to sessionStorage
+ * This ensures the value survives 3DS redirects
+ */
+ function persistSaveCardCheckbox() {
+ const checkbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+
+ if (checkbox) {
+ // Store in sessionStorage to survive 3DS redirects
+ const value = checkbox.checked ? 'yes' : 'no';
+ sessionStorage.setItem('cko_flow_save_card', value);
+ ckoLogger.debug('SAVE CARD: Persisted checkbox value to sessionStorage:', value);
+ ckoLogger.debug('SAVE CARD: Checkbox found:', checkbox);
+ ckoLogger.debug('SAVE CARD: Checkbox checked:', checkbox.checked);
+ ckoLogger.debug('SAVE CARD: Checkbox visible:', checkbox.offsetParent !== null);
+
+ // Also set hidden field as backup
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ if (hiddenField) {
+ hiddenField.value = value;
+ ckoLogger.debug('SAVE CARD: Set hidden field value:', value);
+ } else {
+ ckoLogger.debug('SAVE CARD: WARNING: Hidden field not found!');
+ }
+<<<<<<< HEAD
+
+ // Store in cookie as fallback (survives 3DS redirects)
+ // Set cookie with 1 hour expiry
+ const cookieName = 'cko_flow_save_card_preference';
+ document.cookie = cookieName + '=' + value + '; path=/; max-age=3600; SameSite=Lax';
+ ckoLogger.debug('SAVE CARD: Stored in cookie:', value);
+
+ // Also try to store in WooCommerce session via AJAX (survives 3DS redirects)
+ if (cko_flow_vars && cko_flow_vars.ajax_url && cko_flow_vars.payment_session_nonce) {
+ jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: 'POST',
+ data: {
+ action: 'cko_flow_store_save_card_preference',
+ nonce: cko_flow_vars.payment_session_nonce,
+ save_card_value: value
+ },
+ success: function(response) {
+ if (response.success) {
+ ckoLogger.debug('SAVE CARD: Stored in WooCommerce session:', value);
+ } else {
+ ckoLogger.debug('SAVE CARD: Failed to store in WooCommerce session:', response.data?.message);
+ }
+ },
+ error: function(xhr, status, error) {
+ ckoLogger.debug('SAVE CARD: AJAX error storing in WooCommerce session - Status:', status, 'Error:', error);
+ // Cookie fallback already set above
+ }
+ });
+ }
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ } else {
+ ckoLogger.debug('SAVE CARD: WARNING: Checkbox element not found in DOM!');
+ }
+ }
+
+ /**
+ * Restore save card checkbox value from sessionStorage after 3DS redirect
+ * This runs on every page load
+ */
+ function restoreSaveCardCheckbox() {
+ const savedValue = sessionStorage.getItem('cko_flow_save_card');
+
+ if (savedValue) {
+ ckoLogger.debug('SAVE CARD: Restoring checkbox value from sessionStorage:', savedValue);
+
+ // Set the hidden field value
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ if (hiddenField) {
+ hiddenField.value = savedValue;
+ ckoLogger.debug('SAVE CARD: Set hidden field to:', savedValue);
+ }
+
+ // Also check the checkbox if it exists
+ const checkbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ if (checkbox && savedValue === 'yes') {
+ checkbox.checked = true;
+ ckoLogger.debug('SAVE CARD: Checked the save card checkbox');
+ }
+
+ // Clear sessionStorage after restoring (optional - only clear after successful order)
+ // sessionStorage.removeItem('cko_flow_save_card');
+ }
+ }
+
+ // Restore checkbox value on page load (for 3DS returns)
+ document.addEventListener('DOMContentLoaded', function() {
+ // Check if we're on the order received page
+ const isOrderReceivedPage = window.location.pathname.includes('/order-received/') ||
+ window.location.pathname.includes('/checkout/thank-you/');
+
+ if (isOrderReceivedPage) {
+ // Clear the saved checkbox value after successful order
+ ckoLogger.debug('SAVE CARD: Order completed - clearing sessionStorage');
+ sessionStorage.removeItem('cko_flow_save_card');
+ } else {
+ // Restore checkbox value (for 3DS return to checkout page)
+ restoreSaveCardCheckbox();
+ }
+ });
+
+<<<<<<< HEAD
+ // Listen for checkbox changes to update payment session URLs dynamically
+ jQuery(document).on('change', '#wc-wc_checkout_com_flow-new-payment-method', function() {
+ const checkbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ if (checkbox) {
+ const value = checkbox.checked ? 'yes' : 'no';
+ ckoLogger.debug('[SAVE CARD DEBUG] Checkbox changed - updating sessionStorage, hidden field, and WooCommerce session:', {
+ checked: checkbox.checked,
+ value: value
+ });
+
+ // Update sessionStorage
+ sessionStorage.setItem('cko_flow_save_card', value);
+
+ // Update hidden field
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ if (hiddenField) {
+ hiddenField.value = value;
+ ckoLogger.debug('[SAVE CARD DEBUG] Hidden field updated:', value);
+ }
+
+ // Store in cookie as fallback (survives 3DS redirects)
+ // Set cookie with 1 hour expiry
+ const cookieName = 'cko_flow_save_card_preference';
+ document.cookie = cookieName + '=' + value + '; path=/; max-age=3600; SameSite=Lax';
+ ckoLogger.debug('[SAVE CARD DEBUG] Stored in cookie:', value);
+
+ // Also try to store in WooCommerce session via AJAX (survives 3DS redirects)
+ if (cko_flow_vars && cko_flow_vars.ajax_url && cko_flow_vars.payment_session_nonce) {
+ jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: 'POST',
+ data: {
+ action: 'cko_flow_store_save_card_preference',
+ nonce: cko_flow_vars.payment_session_nonce,
+ save_card_value: value
+ },
+ success: function(response) {
+ if (response.success) {
+ ckoLogger.debug('[SAVE CARD DEBUG] Stored in WooCommerce session:', value);
+ } else {
+ ckoLogger.debug('[SAVE CARD DEBUG] Failed to store in WooCommerce session:', response.data?.message);
+ }
+ },
+ error: function(xhr, status, error) {
+ ckoLogger.debug('[SAVE CARD DEBUG] AJAX error storing in WooCommerce session - Status:', status, 'Error:', error, 'Response:', xhr.responseText);
+ // Cookie fallback already set above
+ }
+ });
+ }
+
+ // Note: Payment session URLs cannot be updated after creation,
+ // but backend will read from WooCommerce session as fallback
+ ckoLogger.debug('[SAVE CARD DEBUG] Checkbox value updated - will be read from WooCommerce session after 3DS redirect');
+ }
+ });
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ // Also try to restore immediately in case DOM is already loaded
+ if (document.readyState === 'loading') {
+ // DOM still loading, listener above will handle it
+ } else {
+ // DOM already loaded, check now
+ const isOrderReceivedPage = window.location.pathname.includes('/order-received/') ||
+ window.location.pathname.includes('/checkout/thank-you/');
+ if (isOrderReceivedPage) {
+ ckoLogger.debug('SAVE CARD: Order completed - clearing sessionStorage');
+ sessionStorage.removeItem('cko_flow_save_card');
+ } else {
+ restoreSaveCardCheckbox();
+ }
+ }
+
+<<<<<<< HEAD
+ /**
+ * Create order before payment processing via AJAX.
+ * This ensures order exists before webhook arrives, preventing race conditions.
+ *
+ * @returns {PromisePlease fill in all required fields to continue with payment.
+Required fields: Email, Billing Address
+")
+ .addClass("woocommerce-NoticeGroup woocommerce-NoticeGroup-checkout")
+ .append(ulWrapper);
+
+ let scrollTarget;
+
+ if (jQuery("form.checkout").length) {
+ jQuery("form.checkout .woocommerce-NoticeGroup").remove();
+ jQuery("form.checkout").prepend(wcNoticeDiv);
+ jQuery(".woocommerce, .form.checkout").removeClass("processing").unblock();
+ scrollTarget = jQuery("form.checkout");
+ } else if (jQuery(".woocommerce-order-pay").length) {
+ jQuery(".woocommerce-order-pay .woocommerce-NoticeGroup").remove();
+ jQuery(".woocommerce-order-pay").prepend(wcNoticeDiv);
+ jQuery(".woocommerce, .woocommerce-order-pay")
+ .removeClass("processing")
+ .unblock();
+ scrollTarget = jQuery(".woocommerce-order-pay");
+ }
+
+ // Scroll to top of checkout form.
+ if (scrollTarget) {
+ jQuery("html, body").animate(
+ {
+ scrollTop: scrollTarget.offset().top - 100,
+ },
+ 1000
+ );
+ }
+};
+
+/**
+ * Initialize Flow interaction tracking flag
+ * This flag tracks whether the user has actively interacted with the Flow component
+ * to differentiate between saved card payments and new Flow payments
+ */
+window.flowUserInteracted = false;
+
+/**
+ * Initializes the observer to monitor the presence of the Flow checkout component in the DOM.
+ *
+ * - Sets the `ckoFlowInitialized` flag to `false` on page load.
+ * - Observes the DOM for any changes using `MutationObserver`.
+ * - If the Flow checkout component (identified by `data-testid="checkout-web-component-root"`)
+ * is removed from the DOM, the flag `ckoFlowInitialized` is reset to `false`.
+ *
+ * This helps ensure that the Flow component can be re-initialized when needed.
+ */
+
+let ckoFlowInitialized = false;
+
+document.addEventListener("DOMContentLoaded", function () {
+ // Track page load time for performance metrics
+ ckoFlow.performanceMetrics.pageLoadTime = performance.now();
+ if (ckoFlow.performanceMetrics.enableLogging) {
+ console.log('[FLOW PERFORMANCE] Page DOMContentLoaded at:', ckoFlow.performanceMetrics.pageLoadTime.toFixed(2) + 'ms');
+ }
+
+ const element = document.querySelector(
+ '[data-testid="checkout-web-component-root"]'
+ );
+ ckoFlowInitialized = false;
+
+ const observer = new MutationObserver(() => {
+ const element = document.querySelector(
+ '[data-testid="checkout-web-component-root"]'
+ );
+
+ // If the element is not present, update ckoFlowInitialized.
+ if (!element) {
+ ckoFlowInitialized = false;
+ }
+ });
+
+ // Observe the entire document for any changes in the DOM.
+ observer.observe(document.body, {
+ childList: true,
+ subtree: true,
+ });
+});
+
+/*
+ * Listens to changes in the payment method radio buttons
+ * and initializes the Flow payment method if selected.
+ *
+ * This function handles the logic for showing or hiding the Flow payment container
+ * and initializing the Flow checkout component when the Flow payment method is selected.
+ * It also manages the visibility of saved payment methods and ensures the Flow component is
+ * initialized when needed.
+ */
+function handleFlowPaymentSelection() {
+
+ // Fetching elemnets required.
+ let flowContainer = document.getElementById("flow-container");
+ let flowPayment = document.getElementById(
+ "payment_method_wc_checkout_com_flow"
+ );
+ let placeOrderElement = document.getElementById("place_order");
+
+ // Logic for saved cards.
+ const ulElements = document.querySelectorAll(".woocommerce-SavedPaymentMethods");
+
+ let totalDataCount = 0;
+ ulElements.forEach((ul) => {
+ const count = parseInt(ul.getAttribute("data-count"), 10);
+ if (!isNaN(count)) {
+ totalDataCount += count;
+ }
+ });
+
+ const dataCount = totalDataCount;
+
+ if (flowPayment && flowPayment.checked) {
+
+ console.log('[FLOW DEBUG] Payment selected - Flow is checked');
+
+ // Always show both Flow and saved cards together
+ document.body.classList.add("flow-method-selected");
+
+ // Initialize Flow
+ if (!ckoFlowInitialized) {
+ ckoFlow.init();
+ ckoFlowInitialized = true;
+ }
+
+ // Show Flow container and make it interactive
+ flowContainer.style.display = "block";
+
+ // Flow container is shown but saved cards take priority
+ console.log('[FLOW DEBUG] Flow container visible - saved cards can be selected');
+
+ // CRITICAL FIX: Ensure saved cards accordion respects CSS rules
+ // Remove any inline display:none that might have been set by other code
+ const accordionContainer = document.querySelector('.saved-cards-accordion-container');
+ if (accordionContainer && accordionContainer.style.display === 'none') {
+ // Let CSS handle visibility via data-saved-payment-order attribute
+ accordionContainer.style.removeProperty('display');
+ console.log('[FLOW DEBUG] Removed inline display:none from accordion, CSS will control visibility');
+ }
+
+ console.log('[FLOW DEBUG] CSS controls saved cards via data-saved-payment-order:', document.body.getAttribute('data-saved-payment-order'));
+ } else {
+ if (flowContainer) {
+ flowContainer.style.display = "none";
+ }
+ if (placeOrderElement) {
+ placeOrderElement.style.display = "block";
+ }
+ // Remove Flow-specific classes when switching to another payment method
+ document.body.classList.remove("flow-method-selected", "flow-ready");
+ }
+}
+
+/**
+ * Global handler for saved card selection (works in both new_payment_first and saved_cards_first modes)
+ * When a saved card is selected, show the Place Order button
+ * When new payment method is selected, ensure Flow container is visible and interactive
+ */
+jQuery(document).on(
+ "change",
+ 'input[name="wc-wc_checkout_com_flow-payment-token"]',
+ function () {
+ const selectedToken = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked');
+ const flowContainer = document.getElementById("flow-container");
+ const selectedId = selectedToken.attr('id');
+
+ // If "Use new payment method" is selected
+ if (selectedId === 'wc-wc_checkout_com_flow-payment-token-new') {
+ console.log('[FLOW DEBUG] New payment method selected - showing Flow container');
+
+ // Show Flow container
+ if (flowContainer) {
+ flowContainer.style.display = "block";
+ }
+
+ // Mark as ready when Flow component is valid
+ if (ckoFlow.flowComponent) {
+ document.body.classList.add("flow-ready");
+ } else {
+ // Flow not initialized yet, wait for it
+ document.body.classList.remove("flow-ready");
+ }
+
+ // Scroll to Flow container
+ setTimeout(() => {
+ if (flowContainer) {
+ flowContainer.scrollIntoView({ behavior: 'smooth', block: 'nearest' });
+ }
+ }, 100);
+ }
+ // If a saved card is selected
+ else if (selectedToken.length > 0) {
+ console.log('[FLOW DEBUG] Saved card selected - making Place Order button visible');
+ document.body.classList.add("flow-ready");
+
+ // Keep Flow container visible
+ if (flowContainer) {
+ flowContainer.style.display = "block";
+ }
+ }
+ }
+);
+
+/**
+ * Listen for changes in the payment method selection and handle the Flow payment method.
+ *
+ * This event listener listens for changes to the payment method selection form (typically a radio button).
+ * When a change is detected in the selection of the payment method, it checks if the selected input is
+ * the payment method field and triggers the Flow payment selection handler.
+ */
+document.addEventListener("change", function (event) {
+ if (event.target && event.target.name === "payment_method") {
+ // Immediately add flow-method-selected class if Flow is selected
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (flowPayment && flowPayment.checked) {
+ document.body.classList.add("flow-method-selected");
+ // Remove flow-ready until component is actually ready
+ document.body.classList.remove("flow-ready");
+ } else {
+ // Remove Flow classes for other payment methods
+ document.body.classList.remove("flow-method-selected", "flow-ready");
+ // Reset Flow interaction flags when switching to other payment methods
+ window.flowUserInteracted = false;
+ window.flowSavedCardSelected = false;
+ }
+
+ handleFlowPaymentSelection();
+ }
+});
+
+/**
+ * Handle case - when Flow is on the order-pay page.
+ *
+ * This event listener ensures Flow-specific logic only runs on the order-pay page,
+ * where the customer is directed to complete payment for an existing order.
+ */
+document.addEventListener("DOMContentLoaded", function () {
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+ handleFlowPaymentSelection();
+ }
+});
+
+/**
+ * Handle case - when Flow is the only payment method or the starting payment method.
+ *
+ * This function listens for the DOMContentLoaded event, then checks if Flow is the only
+ * payment method listed in the available payment methods. If so, it triggers actions
+ * to handle this scenario, such as adding specific classes or handling payment selection.
+ * It also checks if required fields are filled and adjusts the Flow payment selection accordingly.
+ *
+ */
+document.addEventListener("DOMContentLoaded", function () {
+ const paymentMethodsList = document.querySelector("ul.wc_payment_methods");
+
+ if (paymentMethodsList) {
+ const listItems = paymentMethodsList.children;
+
+ // Check if the first list item is for the Flow payment method.
+ if (
+ listItems[0].classList.contains("payment_method_wc_checkout_com_flow")
+ ) {
+
+ // If Flow is the only payment method, add a custom class to the body
+ // and trigger the Flow payment selection handler.
+ if (listItems.length === 1) {
+ document.body.classList.add("flow-method-single");
+
+ // Check if Flow is selected/checked
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (flowPayment && flowPayment.checked) {
+ // Check if we're in saved_cards_first mode with saved cards
+ const ulElements = document.querySelectorAll(".woocommerce-SavedPaymentMethods");
+ let totalDataCount = 0;
+ ulElements.forEach((ul) => {
+ const count = parseInt(ul.getAttribute("data-count"), 10);
+ if (!isNaN(count)) {
+ totalDataCount += count;
+ }
+ });
+
+ // If saved cards exist and we're in saved_cards_first mode, don't hide button
+ if (window.saved_payment === "saved_cards_first" && totalDataCount > 0) {
+ console.log('[FLOW DEBUG] DOMContentLoaded: saved_cards_first with saved cards, adding flow-ready');
+ document.body.classList.add("flow-ready");
+ } else {
+ // Otherwise, hide the button until Flow is ready
+ document.body.classList.add("flow-method-selected");
+ document.body.classList.remove("flow-ready");
+ }
+ }
+
+ // Order-pay.
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+
+ // Check if current URL contains the slug.
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+ handleFlowPaymentSelection();
+ }
+ }
+
+ // If required fields are not filled, trigger Flow payment selection handler.
+ if (!requiredFieldsFilled()) {
+ // Check if Flow is selected
+ const flowPayment = document.getElementById("payment_method_wc_checkout_com_flow");
+ if (flowPayment && flowPayment.checked) {
+ // Check if we're in saved_cards_first mode with saved cards
+ const ulElements = document.querySelectorAll(".woocommerce-SavedPaymentMethods");
+ let totalDataCount = 0;
+ ulElements.forEach((ul) => {
+ const count = parseInt(ul.getAttribute("data-count"), 10);
+ if (!isNaN(count)) {
+ totalDataCount += count;
+ }
+ });
+
+ // If saved cards exist and we're in saved_cards_first mode, don't hide button
+ if (window.saved_payment === "saved_cards_first" && totalDataCount > 0) {
+ console.log('[FLOW DEBUG] DOMContentLoaded (required fields): saved_cards_first with saved cards, adding flow-ready');
+ document.body.classList.add("flow-ready");
+ } else {
+ // Otherwise, hide the button until Flow is ready
+ document.body.classList.add("flow-method-selected");
+ document.body.classList.remove("flow-ready");
+ }
+ }
+ handleFlowPaymentSelection();
+ }
+ }
+ }
+});
+
+/**
+ * Handle Place Order Button with Flow Checkout when ShowPayButton is False.
+ *
+ * This function listens for a click event on the "Place Order" button. If the checkout method
+ * is "Flow" and the user is using the checkout component, it validates the form and proceeds
+ * with the appropriate order placement, either using the Flow component or submitting the form directly.
+ *
+ */
+document.addEventListener("DOMContentLoaded", function () {
+
+ // Listen for saved card clicks to de-emphasize Flow
+ jQuery(document).on('click', 'input[name="wc-wc_checkout_com_flow-payment-token"]', function() {
+ const selectedId = jQuery(this).attr('id');
+ const flowContainer = document.getElementById("flow-container");
+
+ if (selectedId && selectedId !== 'wc-wc_checkout_com_flow-payment-token-new') {
+ console.log('[FLOW] Saved card selected');
+ window.flowUserInteracted = false;
+ window.flowSavedCardSelected = true;
+
+ // Remove the hidden override input if it exists (user switched back to saved card)
+ jQuery('#flow-new-payment-override').remove();
+ } else if (selectedId === 'wc-wc_checkout_com_flow-payment-token-new') {
+ console.log('[FLOW] New payment method selected - activating Flow');
+ window.activateFlowPayment();
+ }
+ });
+
+ // Function to activate Flow and deselect saved cards
+ // Make it globally accessible so onChange callback can use it
+ window.activateFlowPayment = function() {
+ console.log('[FLOW] Activating Flow payment method');
+
+ const flowContainer = document.getElementById("flow-container");
+ if (!flowContainer) return;
+
+ // Uncheck all saved card radio buttons (including any that might be hidden)
+ jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]').each(function() {
+ const radioId = jQuery(this).attr('id');
+ // Don't uncheck the "new payment method" radio
+ if (radioId !== 'wc-wc_checkout_com_flow-payment-token-new') {
+ jQuery(this).prop('checked', false);
+ jQuery(this).removeAttr('checked');
+ }
+ });
+
+ // Try to select "Use new payment method" radio button if it exists
+ const newPaymentRadio = document.getElementById('wc-wc_checkout_com_flow-payment-token-new');
+ if (newPaymentRadio) {
+ newPaymentRadio.checked = true;
+ jQuery(newPaymentRadio).attr('checked', 'checked');
+ jQuery(newPaymentRadio).trigger('change');
+ } else {
+ // If the "new payment method" radio doesn't exist, add a hidden input
+ jQuery('#flow-new-payment-override').remove();
+
+ const overrideInput = jQuery('', {
+ type: 'hidden',
+ id: 'flow-new-payment-override',
+ name: 'wc-wc_checkout_com_flow-payment-token',
+ value: 'new'
+ });
+ jQuery('form.checkout, form#order_review').append(overrideInput);
+ }
+
+ // Flow container is now active for new payment
+
+ // Clear saved card flag and mark for new Flow payment
+ window.flowSavedCardSelected = false;
+ window.flowUserInteracted = false; // Reset to allow user to interact with Flow
+ document.body.classList.add("flow-ready");
+
+ // Ensure Place Order button is visible
+ const placeOrderButton = document.getElementById('place_order');
+ if (placeOrderButton) {
+ placeOrderButton.style.display = 'block';
+ placeOrderButton.style.opacity = '1';
+ placeOrderButton.style.visibility = 'visible';
+ }
+ }
+
+ // Listen for clicks/focus on Flow component fields to auto-activate Flow
+ jQuery(document).on('click focus', '#flow-container input, #flow-container iframe, #flow-container', function(e) {
+ const flowContainer = document.getElementById("flow-container");
+
+ // Only activate if Flow is currently de-emphasized (saved card selected)
+ if (flowContainer && flowContainer.classList.contains('flow-de-emphasized')) {
+ console.log('[FLOW] User clicked on Flow field - auto-activating Flow');
+ window.activateFlowPayment();
+ }
+ });
+
+ /**
+ * Helper function to persist the save card checkbox value to sessionStorage
+ * This ensures the value survives 3DS redirects
+ */
+ function persistSaveCardCheckbox() {
+ const checkbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+
+ if (checkbox) {
+ // Store in sessionStorage to survive 3DS redirects
+ const value = checkbox.checked ? 'yes' : 'no';
+ sessionStorage.setItem('cko_flow_save_card', value);
+ console.log('[FLOW SAVE CARD] Persisted checkbox value to sessionStorage:', value);
+ console.log('[FLOW SAVE CARD] Checkbox found:', checkbox);
+ console.log('[FLOW SAVE CARD] Checkbox checked:', checkbox.checked);
+ console.log('[FLOW SAVE CARD] Checkbox visible:', checkbox.offsetParent !== null);
+
+ // Also set hidden field as backup
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ if (hiddenField) {
+ hiddenField.value = value;
+ console.log('[FLOW SAVE CARD] Set hidden field value:', value);
+ } else {
+ console.log('[FLOW SAVE CARD] WARNING: Hidden field not found!');
+ }
+ } else {
+ console.log('[FLOW SAVE CARD] WARNING: Checkbox element not found in DOM!');
+ }
+ }
+
+ /**
+ * Restore save card checkbox value from sessionStorage after 3DS redirect
+ * This runs on every page load
+ */
+ function restoreSaveCardCheckbox() {
+ const savedValue = sessionStorage.getItem('cko_flow_save_card');
+
+ if (savedValue) {
+ console.log('[FLOW SAVE CARD] Restoring checkbox value from sessionStorage:', savedValue);
+
+ // Set the hidden field value
+ const hiddenField = document.getElementById('cko-flow-save-card-persist');
+ if (hiddenField) {
+ hiddenField.value = savedValue;
+ console.log('[FLOW SAVE CARD] Set hidden field to:', savedValue);
+ }
+
+ // Also check the checkbox if it exists
+ const checkbox = document.getElementById('wc-wc_checkout_com_flow-new-payment-method');
+ if (checkbox && savedValue === 'yes') {
+ checkbox.checked = true;
+ console.log('[FLOW SAVE CARD] Checked the save card checkbox');
+ }
+
+ // Clear sessionStorage after restoring (optional - only clear after successful order)
+ // sessionStorage.removeItem('cko_flow_save_card');
+ }
+ }
+
+ // Restore checkbox value on page load (for 3DS returns)
+ document.addEventListener('DOMContentLoaded', function() {
+ // Check if we're on the order received page
+ const isOrderReceivedPage = window.location.pathname.includes('/order-received/') ||
+ window.location.pathname.includes('/checkout/thank-you/');
+
+ if (isOrderReceivedPage) {
+ // Clear the saved checkbox value after successful order
+ console.log('[FLOW SAVE CARD] Order completed - clearing sessionStorage');
+ sessionStorage.removeItem('cko_flow_save_card');
+ } else {
+ // Restore checkbox value (for 3DS return to checkout page)
+ restoreSaveCardCheckbox();
+ }
+ });
+
+ // Also try to restore immediately in case DOM is already loaded
+ if (document.readyState === 'loading') {
+ // DOM still loading, listener above will handle it
+ } else {
+ // DOM already loaded, check now
+ const isOrderReceivedPage = window.location.pathname.includes('/order-received/') ||
+ window.location.pathname.includes('/checkout/thank-you/');
+ if (isOrderReceivedPage) {
+ console.log('[FLOW SAVE CARD] Order completed - clearing sessionStorage');
+ sessionStorage.removeItem('cko_flow_save_card');
+ } else {
+ restoreSaveCardCheckbox();
+ }
+ }
+
+ document.addEventListener("click", function (event) {
+ const flowPayment = document.getElementById(
+ "payment_method_wc_checkout_com_flow"
+ );
+
+ // If the Place Order button is clicked, proceed.
+ if (event.target && event.target.id === "place_order") {
+
+ // If the Flow payment method is selected, proceed with validation and order placement.
+ if (flowPayment && flowPayment.checked) {
+ event.preventDefault();
+
+ // Persist save card checkbox before form submission
+ persistSaveCardCheckbox();
+
+ const form = jQuery("form.checkout");
+
+ // Handle payment for order-pay page.
+ if ( form.length === 0 ) {
+ const orderPaySlug = cko_flow_vars.orderPaySlug;
+ const orderPayForm = jQuery('form#order_review');
+
+ if (window.location.pathname.includes('/' + orderPaySlug + '/')) {
+ // console.log('[CURRENT VERSION] Order-pay page confirmed, showing flow container');
+
+ document.getElementById("flow-container").style.display = "block";
+
+ // Place order for FLOW.
+ if (ckoFlow.flowComponent) {
+ // console.log('[CURRENT VERSION] Flow component exists');
+
+ // Check if a saved card is actually selected (not just if saved cards are enabled)
+ const selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ const savedCardSelected = selectedSavedCard.length > 0;
+ const savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]').classList.contains('saved-card-is-enabled');
+
+ // console.log('[CURRENT VERSION] Saved card selected:', savedCardSelected);
+ // console.log('[CURRENT VERSION] Saved card enabled:', savedCardEnabled);
+
+ // ALWAYS persist save card checkbox on order-pay page (for new card payments)
+ if (!savedCardSelected) {
+ persistSaveCardCheckbox();
+ console.log('[FLOW] Order-pay: Persisted save card checkbox for new card payment');
+ }
+
+ if( savedCardSelected || savedCardEnabled ) {
+ // console.log('[CURRENT VERSION] Saved card selected/enabled - submitting order-pay form directly');
+ orderPayForm.submit();
+ } else {
+ // console.log('[CURRENT VERSION] No saved card - calling flow component submit');
+ ckoFlow.flowComponent.submit();
+ }
+ } else {
+ // console.log('[CURRENT VERSION] No flow component found');
+ }
+
+ // Place order for saved card.
+ if (!ckoFlow.flowComponent) {
+ // console.log('[CURRENT VERSION] No flow component - submitting order-pay form for saved card');
+ orderPayForm.submit();
+ }
+
+ } else {
+ // console.log('[CURRENT VERSION] Not an order-pay page, skipping');
+ }
+ } else {
+ // console.log('[CURRENT VERSION] Checkout form found - handling regular checkout');
+
+ // Validate checkout before proceeding.
+ validateCheckout(form, function (response) {
+ // console.log('[CURRENT VERSION] Checkout validation response:', response);
+ document.getElementById("flow-container").style.display = "block";
+
+ // Place order for FLOW.
+ if (ckoFlow.flowComponent) {
+ // console.log('[CURRENT VERSION] Flow component exists for checkout');
+
+ // Check if a saved card is actually selected (not just if saved cards are enabled)
+ const selectedSavedCard = jQuery('input[name="wc-wc_checkout_com_flow-payment-token"]:checked:not(#wc-wc_checkout_com_flow-payment-token-new)');
+ const savedCardSelected = selectedSavedCard.length > 0;
+ const savedCardEnabled = document.querySelector('[data-testid="checkout-web-component-root"]').classList.contains('saved-card-is-enabled');
+
+ // console.log('[CURRENT VERSION] Saved card selected for checkout:', savedCardSelected);
+ // console.log('[CURRENT VERSION] Saved card enabled for checkout:', savedCardEnabled);
+
+ if( savedCardSelected || savedCardEnabled ) {
+ // console.log('[CURRENT VERSION] Saved card selected/enabled - submitting checkout form directly');
+ form.submit();
+ } else {
+ // console.log('[CURRENT VERSION] No saved card - calling flow component submit for checkout');
+ ckoFlow.flowComponent.submit();
+ }
+ } else {
+ // console.log('[CURRENT VERSION] No flow component found for checkout');
+ }
+
+ // Place order for saved card.
+ if (!ckoFlow.flowComponent) {
+ // console.log('[CURRENT VERSION] No flow component - submitting checkout form for saved card');
+ form.submit();
+ }
+ });
+
+ }
+ } else {
+ // console.log('[CURRENT VERSION] Flow payment method not selected or not found');
+ }
+ }
+ });
+});
+
+// Removed complex 3DS redirect handling - keeping it simple like the working version
+
+let virtual = false;
+/**
+ * Handle checkout flow-container rendering on various field changes.
+ * Attaches debounced event listeners to checkout inputs to update flow state and cart info dynamically.
+ */
+jQuery(function ($) {
+
+ /**
+ * Main handler function triggered on input/change events.
+ * It performs field checks and updates the checkout flow and cart info accordingly.
+ *
+ * @param {Event} event - The input or change event.
+ */
+ const handleTyping = (event) => {
+
+ let isShippingField = false;
+
+ // Check if the changed field belongs to shipping info.
+ if (event) {
+ const $target = jQuery(event.target);
+ isShippingField = $target.is('[id^="shipping"]');
+ }
+
+ // If the field is a shipping-related field, trigger WooCommerce checkout update and exit early.
+ if (isShippingField) {
+ console.log("Triggered by a shipping field, skipping...");
+ $("body").trigger("update_checkout");
+ return;
+ }
+
+ // Only proceed if all required fields are filled.
+ if (requiredFieldsFilled()) {
+ $("body").trigger("update_checkout");
+
+ // If the event is from checking 'ship to different address' or 'create account', return early.
+ if (
+ jQuery(event.target).is(
+ "#ship-to-different-address-checkbox, #createaccount"
+ ) &&
+ jQuery(event.target).is(":checked")
+ ) {
+ console.log("User just checked the checkbox. Returning early...");
+ return;
+ }
+
+ var targetName = event.target.name || "";
+
+ // If the event is not from billing fields or key checkboxes, exit early.
+ if (
+ !targetName.startsWith("billing") &&
+ !jQuery(event.target).is(
+ "#ship-to-different-address-checkbox, #terms, #createaccount, #coupon_code"
+ )
+ ) {
+ let cartData = $("#cart-info").data("cart");
+ if ( !cartData || !cartData["contains_virtual_product"] ) {
+ console.log(
+ "Neither billing nor the shipping checkbox. Returning early..."
+ );
+ return;
+ }
+ console.log(
+ "Virtual Product found. Triggering FLOW..."
+ );
+ }
+
+ // Use existing cart data instead of fetching via AJAX
+ // The cart info is already available in the HTML data-cart attribute
+ const $cartDiv = jQuery("#cart-info");
+ const existingCartData = $cartDiv.data("cart");
+
+ if (existingCartData) {
+ console.log('[FLOW DEBUG] Using existing cart data:', existingCartData);
+
+ // Update global state and re-trigger payment flow setup.
+ cartInfo = existingCartData;
+ ckoFlowInitialized = false;
+ handleFlowPaymentSelection();
+ } else {
+ console.log('[FLOW DEBUG] No existing cart data found, skipping Flow re-initialization');
+ }
+ }
+ };
+
+ // Debounce the handler to limit how often it's triggered during typing.
+ const debouncedTyping = debounce(handleTyping, 2000);
+
+ // Attach debounced handler to key billing fields.
+ $(
+ "#billing_first_name, #billing_last_name, #billing_email, #billing_phone"
+ ).on("input", function (e) {
+ debouncedTyping(e);
+ });
+
+ // Attach to all other inputs/selects, excluding the key billing fields above.
+ $(
+ "input:not(#billing_first_name, #billing_last_name, #billing_email, #billing_phone), select"
+ ).on("input change", function (e) {
+ debouncedTyping(e);
+ });
+
+ // Attach handler to all input/selects, but ignore payment method fields.
+ $(document).on("input change", "input, select", function (e) {
+ if ($(this).closest(".wc_payment_method").length === 0) {
+
+ debouncedTyping(e);
+
+ }
+
+ let cartData = $("#cart-info").data("cart");
+ if ( !virtual && cartData && cartData["contains_virtual_product"] && $('#ship-to-different-address-checkbox').length === 0 ) {
+ debouncedTyping(e);
+ virtual = true;
+ }
+ });
+});
+
+/**
+ *
+ * Debounce utility function.
+ * Delays the execution of a function until after a specified delay
+ * has passed since the last time it was invoked.
+ *
+ * @param {Function} func - The function to debounce.
+ * @param {number} delay - Delay in milliseconds.
+ *
+ * @returns {Function} - A debounced version of the original function.
+ */
+function debounce(func, delay) {
+ let timer;
+
+ return function (...args) {
+
+ // Clear the existing timer, if any.
+ clearTimeout(timer);
+
+ // Set a new timer to call the function after the delay.
+ timer = setTimeout(() => {
+
+ // Call the original function with the correct context and arguments.
+ func.apply(this, args);
+ }, delay);
+ };
+}
+
+/**
+ * Checks if all non-shipping required fields in the WooCommerce checkout form are filled.
+ *
+ * This function looks for elements marked with a `.required` span inside labels
+ * within the `.woocommerce-checkout` form, extracts the associated input field IDs,
+ * filters out those related to shipping, and then verifies that the corresponding
+ * fields are not empty.
+ *
+ * @returns {boolean} - Returns true if all non-shipping required fields are filled; otherwise, false.
+ */
+function requiredFieldsFilled() {
+
+ // Select all required field indicators within WooCommerce checkout labels.
+ const requiredLabels = document.querySelectorAll(
+ ".woocommerce-checkout label .required"
+ );
+
+ const fieldIds = [];
+
+ requiredLabels.forEach((label) => {
+ const fieldId = label.closest("label").getAttribute("for");
+ if (fieldId) {
+ fieldIds.push(fieldId);
+ }
+ });
+
+ // Filter out fieldIds that start with "shipping".
+ let filteredFieldIds = fieldIds.filter((id) => !id.startsWith("shipping"));
+
+ // Check if login form is hidden.
+ const loginForm = document.querySelector(".woocommerce-form-login");
+ if (loginForm && loginForm.style.display === "none") {
+ // Remove username and password fields if form is hidden.
+ filteredFieldIds = filteredFieldIds.filter(
+ (id) => id !== "username" && id !== "password"
+ );
+ }
+
+ // Check that each field is present and not empty.
+ const result = filteredFieldIds.every((id) => {
+ const field = document.getElementById(id);
+ return field && field.value.trim() !== "";
+ });
+
+ return result;
+}
+
+/**
+ * Validates the checkout form by sending serialized form data to the server
+ * using an AJAX POST request. Executes callback functions based on the response.
+ *
+ * @param {jQuery} form - The jQuery-wrapped form element to be validated.
+ * @param {Function} onSuccess - Callback function executed when validation is successful.
+ * @param {Function} onError - Optional callback function executed when validation fails or an error occurs.
+ */
+function validateCheckout(form, onSuccess, onError) {
+
+ const formData = form.serialize(); // Serialize the form.
+
+ // Perform AJAX POST request for server-side validation.
+ jQuery.ajax({
+ url: cko_flow_vars.ajax_url,
+ type: "POST",
+ data: {
+ action: "cko_validate_checkout",
+ ...Object.fromEntries(new URLSearchParams(formData)),
+ },
+ success: function (response) {
+
+ // If the response indicates success, trigger the onSuccess callback.
+ if (response.success) {
+ onSuccess(response);
+ } else {
+
+ // Show an error message and trigger the onError callback if provided.
+ showError(response.data.message);
+ if (onError) onError(response);
+ }
+ },
+ error: function () {
+
+ // If the request fails, display the flow container and show a generic error message.
+ document.getElementById("flow-container").style.display = "block";
+ showError(
+ wp.i18n.__(
+ "An error occurred. Please try again.",
+ "checkout-com-unified-payments-api"
+ )
+ );
+
+ // Trigger onError callback if provided.
+ if (onError) onError();
+ },
+ });
+}
+
+/**
+ * Handles radio button selection across multiple saved payment method lists.
+ *
+ * This script ensures that only one radio button across multiple
+ * `.woocommerce-SavedPaymentMethods` lists can be selected at a time.
+ *
+ * Behavior:
+ * - If a radio button inside one list is selected, all radios in the other lists are deselected.
+ * - Supports dynamically added elements by using event delegation on `document`.
+ *
+ * Implementation details:
+ * - Uses jQuery's `on('change')` with delegation to handle dynamically loaded content.
+ * - `currentUl` stores the UL containing the selected radio.
+ * - `otherUls` targets all other ULs to clear their selected radios.
+ *
+ * Example:
+ * If the user selects a radio in the first UL and then selects a radio in the second UL,
+ * the first UL's selected radio is automatically deselected.
+ */
+jQuery(function($) {
+ $(document).on('change', '.woocommerce-SavedPaymentMethods input[type="radio"]', function() {
+ const currentUl = $(this).closest('.woocommerce-SavedPaymentMethods'); // Current UL.
+ const otherUls = $('.woocommerce-SavedPaymentMethods').not(currentUl); // All other ULs.
+
+ // Uncheck all radios in the other ULs.
+ otherUls.find('input[type="radio"]').prop('checked', false);
+ });
+});
+
+/**
+ * Toggles the visibility of the Checkout Payment FLOW label based on the presence
+ * of the 'saved-card-is-enabled' class on the web component root.
+ *
+ * Behavior:
+ * 1. Initially hides the label if the body has class 'flow-method-single' and the
+ * root element exists without 'saved-card-is-enabled'.
+ * 2. Shows the label if 'saved-card-is-enabled' class is present on the root element.
+ * 3. Dynamically observes the root element:
+ * - Detects when the root element appears in the DOM.
+ * - Watches for class changes on the root to toggle the label visibility in real-time.
+ *
+ * Uses MutationObserver to handle dynamically loaded elements and class changes.
+ */
+document.addEventListener('DOMContentLoaded', function () {
+ const labelSelector = 'label[for="payment_method_wc_checkout_com_flow"]';
+ const rootSelector = '[data-testid="checkout-web-component-root"]';
+
+ const checkAndToggle = () => {
+ const label = document.querySelector(labelSelector);
+ const rootElement = document.querySelector(rootSelector);
+
+ // Check if we have saved cards (new behavior)
+ const hasSavedCards = document.querySelector('.saved-cards-accordion-container');
+
+ if (label) {
+ // ALWAYS show the label (either with saved cards or without)
+ label.style.removeProperty('display');
+
+ if (hasSavedCards) {
+ console.log('[FLOW LABEL] Label shown - saved cards present');
+ } else {
+ console.log('[FLOW LABEL] Label shown - no saved cards (default label)');
+ }
+
+ /* DISABLED - Old behavior that was hiding the label
+ // Old behavior: only for flow-method-single (no saved cards)
+ if (document.body.classList.contains('flow-method-single') && rootElement) {
+ if (rootElement.classList.contains('saved-card-is-enabled')) {
+ label.style.removeProperty('display'); // Show again.
+ } else {
+ label.style.setProperty('display', 'none', 'important'); // Hide.
+ }
+ }
+ */
+ }
+ };
+
+ // Watch for root element and its class changes.
+ const observer = new MutationObserver(() => {
+ const rootElement = document.querySelector(rootSelector);
+
+ if (rootElement) {
+ // Run once when root appears.
+ checkAndToggle();
+
+ // Now watch the root for class changes.
+ const classObserver = new MutationObserver(checkAndToggle);
+ classObserver.observe(rootElement, { attributes: true, attributeFilter: ['class'] });
+
+ observer.disconnect(); // Stop watching for root element.
+ }
+ });
+
+ observer.observe(document.body, { childList: true, subtree: true });
+
+ // Also check immediately and after a delay for saved cards
+ checkAndToggle();
+ setTimeout(checkAndToggle, 500);
+ setTimeout(checkAndToggle, 1000);
+});
+
+/**
+ * On DOMContentLoaded, checks if the current order payment type is "MOTO".
+ * If so, it ensures that no saved payment tokens are pre-selected.
+ *
+ * - Looks for the #order-pay-info element and reads its "order-pay" data attribute.
+ * - If payment_type is "MOTO" (Admin order + Order-pay page + Guest customer):
+ * - Finds all saved payment token radio inputs from Checkout.com (Flow & Cards).
+ * - Iterates through them and unchecks each one, forcing the user to actively select a payment method.
+ */
+document.addEventListener('DOMContentLoaded', function () {
+ const orderPayInfo = jQuery("#order-pay-info")?.data("order-pay");
+ if ( orderPayInfo?.payment_type === 'MOTO' ) {
+ console.log('here');
+ const radios = document.querySelectorAll(
+ 'input[name="wc-wc_checkout_com_flow-payment-token"], input[name="wc-wc_checkout_com_cards-payment-token"]'
+ );
+ radios.forEach(radio => {
+ radio.checked = false;
+ });
+ }
+});
+
+/**
+ * Handle asynchronous payment return flow.
+ * This checks for a payment ID in the URL, verifies its status via an API call,
+ * and either submits the checkout form or displays an error.
+ */
+
+// Extract the 'cko-payment-id' parameter from the URL query string.
+const paymentId = new URLSearchParams(window.location.search).get(
+ "cko-payment-id"
+);
+// Async payment handler - handles 3DS redirects
+
+
+// Proceed only if a payment ID is found.
+if (paymentId) {
+
+ // Fetch payment status from the server using the async endpoint.
+ fetch(`${cko_flow_vars.async_url}?paymentId=${paymentId}`)
+ .then((res) => res.json())
+ .then((data) => {
+
+ // If payment is approved, set hidden fields with the payment data and submit checkout form.
+ if (data.approved) {
+ jQuery("#cko-flow-payment-id").val(data.id);
+ jQuery("#cko-flow-payment-type").val(data.source?.type || "");
+
+ // Check if we're on order-pay page
+ if (window.location.pathname.includes('/order-pay/')) {
+ console.log('[FLOW] Order-pay page - submitting form#order_review after 3DS using native submit');
+ // Use native DOM submit() to bypass jQuery event handlers and force form POST to server
+ const orderPayForm = document.querySelector('form#order_review');
+ if (orderPayForm) {
+ orderPayForm.submit();
+ } else {
+ console.error('[FLOW] ERROR: form#order_review not found!');
+ }
+ } else {
+ jQuery("form.checkout").submit();
+ }
+ } else {
+
+ // If payment is not approved, show an error message to the user.
+ showError(
+ wp.i18n.__(
+ "Payment Failed. Please try some another payment method.",
+ "checkout-com-unified-payments-api"
+ )
+ );
+
+ // Clean up the URL by removing the query parameters.
+ const urlWithoutQuery =
+ window.location.origin + window.location.pathname;
+ window.history.replaceState({}, document.title, urlWithoutQuery);
+ }
+ })
+ .catch((err) => {
+ // console.log('[CURRENT VERSION] Error fetching payment status:', err);
+
+ // Log any network or parsing errors in the console.
+ console.error("Error fetching payment status:", err);
+ });
+} else {
+ // console.log('[CURRENT VERSION] No payment ID found in URL, skipping async handler');
+}
diff --git a/flow-integration/class-wc-gateway-checkout-com-flow.php b/flow-integration/class-wc-gateway-checkout-com-flow.php
new file mode 100644
index 00000000..f547415f
--- /dev/null
+++ b/flow-integration/class-wc-gateway-checkout-com-flow.php
@@ -0,0 +1,7240 @@
+id = 'wc_checkout_com_flow';
+ $this->method_title = __( 'Checkout.com', 'checkout-com-unified-payments-api' );
+ $this->method_description = __( 'The Checkout.com extension allows shop owners to process online payments through the Checkout.com Payment Gateway.', 'checkout-com-unified-payments-api' );
+<<<<<<< HEAD
+ $this->title = !empty( $core_settings['title'] ) ? trim( __( $core_settings['title'], 'checkout-com-unified-payments-api' ) ) : __( 'Checkout.com', 'checkout-com-unified-payments-api' );
+=======
+ $this->title = !empty( $core_settings['title'] ) ? __( $core_settings['title'], 'checkout-com-unified-payments-api' ) : __( 'Checkout.com', 'checkout-com-unified-payments-api' );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ $this->has_fields = true;
+ $this->supports = array(
+ 'products',
+ 'refunds',
+ 'tokenization',
+ 'subscriptions',
+ 'subscription_cancellation',
+ 'subscription_suspension',
+ 'subscription_reactivation',
+ 'subscription_date_changes',
+ );
+
+ $this->init_form_fields();
+ $this->init_settings();
+
+ $this->flow_enabled();
+
+ // Turn these settings into variables we can use.
+ foreach ( $this->settings as $setting_key => $value ) {
+ $this->$setting_key = $value;
+ }
+
+ add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, array( $this, 'process_admin_options' ) );
+
+ // Webhook handler hook - ENABLED for Flow integration
+ // Flow integration uses direct redirect for successful payments, but webhooks for 3DS, failures, etc.
+ add_action( 'woocommerce_api_wc_checkoutcom_webhook', [ $this, 'webhook_handler' ] );
+
+ // WC API endpoint for processing 3DS returns (similar to PayPal)
+ // This allows direct redirect to order-received page without showing checkout page
+ add_action( 'woocommerce_api_wc_checkoutcom_flow_process', [ $this, 'handle_3ds_return' ] );
+
+ // Detect 3DS return on checkout page load and process server-side (no AJAX)
+ // This handles cases where user returns to checkout page with 3DS parameters
+ // Priority 1 ensures it runs very early, before other template_redirect hooks
+ add_action( 'template_redirect', [ $this, 'detect_and_process_3ds_return_on_checkout' ], 1 );
+
+ // Meta field on subscription edit.
+ add_filter( 'woocommerce_subscription_payment_meta', [ $this, 'add_payment_meta_field' ], 10, 2 );
+<<<<<<< HEAD
+
+ // Store save card preference in order metadata when order is created (before 3DS redirect)
+ add_action( 'woocommerce_checkout_create_order', [ $this, 'store_save_card_preference_in_order' ], 10, 2 );
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+
+ // Secure AJAX handler for creating payment sessions (prevents secret key exposure to frontend)
+ add_action( 'wp_ajax_cko_flow_create_payment_session', [ $this, 'ajax_create_payment_session' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_create_payment_session', [ $this, 'ajax_create_payment_session' ] );
+<<<<<<< HEAD
+
+ // AJAX handler for creating orders before payment processing (early order creation)
+ add_action( 'wp_ajax_cko_flow_create_order', [ $this, 'ajax_create_order' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_create_order', [ $this, 'ajax_create_order' ] );
+
+ // AJAX handler for creating failed orders when payment is declined before form submission
+ add_action( 'wp_ajax_cko_flow_create_failed_order', [ $this, 'ajax_create_failed_order' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_create_failed_order', [ $this, 'ajax_create_failed_order' ] );
+
+ // AJAX handler for storing save card preference in WooCommerce session
+ add_action( 'wp_ajax_cko_flow_store_save_card_preference', [ $this, 'ajax_store_save_card_preference' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_store_save_card_preference', [ $this, 'ajax_store_save_card_preference' ] );
+
+ // AJAX handler for saving payment session ID to order immediately after payment session creation
+ add_action( 'wp_ajax_cko_flow_save_payment_session_id', [ $this, 'ajax_save_payment_session_id' ] );
+ add_action( 'wp_ajax_nopriv_cko_flow_save_payment_session_id', [ $this, 'ajax_save_payment_session_id' ] );
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ }
+
+ /**
+ * Check if the gateway is available.
+ *
+ * Override parent method to ensure gateway is available when enabled and checkout mode is 'flow'.
+ * This bypasses WooCommerce's default currency/country restrictions.
+ *
+ * @return bool
+ */
+ public function is_available() {
+<<<<<<< HEAD
+ // Log availability check start (only in debug mode to reduce log spam)
+ $is_debug = defined( 'WP_DEBUG' ) && WP_DEBUG;
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Checking if Flow gateway is available...' );
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway enabled setting: ' . ( isset( $this->enabled ) ? $this->enabled : 'NOT SET' ) );
+ }
+
+ // First check if gateway is enabled
+ if ( 'yes' !== $this->enabled ) {
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway is NOT available - enabled setting is not "yes"' );
+ }
+=======
+ // Log availability check start
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Checking if Flow gateway is available...' );
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway enabled setting: ' . ( isset( $this->enabled ) ? $this->enabled : 'NOT SET' ) );
+
+ // First check if gateway is enabled
+ if ( 'yes' !== $this->enabled ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway is NOT available - enabled setting is not "yes"' );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ return false;
+ }
+
+ // Check if checkout mode is set to 'flow'
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+<<<<<<< HEAD
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Checkout mode: ' . $checkout_mode );
+ }
+
+ if ( 'flow' !== $checkout_mode ) {
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway is NOT available - checkout mode is not "flow" (current: ' . $checkout_mode . ')' );
+ }
+=======
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Checkout mode: ' . $checkout_mode );
+
+ if ( 'flow' !== $checkout_mode ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway is NOT available - checkout mode is not "flow" (current: ' . $checkout_mode . ')' );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ return false;
+ }
+
+ // Check if API credentials are set
+ $secret_key = isset( $checkout_setting['ckocom_secret_key'] ) ? $checkout_setting['ckocom_secret_key'] : '';
+ $public_key = isset( $checkout_setting['ckocom_public_key'] ) ? $checkout_setting['ckocom_public_key'] : '';
+
+<<<<<<< HEAD
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Secret key: ' . ( ! empty( $secret_key ) ? 'SET (' . substr( $secret_key, 0, 10 ) . '...)' : 'NOT SET' ) );
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Public key: ' . ( ! empty( $public_key ) ? 'SET (' . substr( $public_key, 0, 10 ) . '...)' : 'NOT SET' ) );
+ }
+
+ if ( empty( $secret_key ) || empty( $public_key ) ) {
+ // Log warning but don't block availability (credentials might be set later)
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] WARNING: API credentials not set, but gateway is still available' );
+ }
+=======
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Secret key: ' . ( ! empty( $secret_key ) ? 'SET (' . substr( $secret_key, 0, 10 ) . '...)' : 'NOT SET' ) );
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Public key: ' . ( ! empty( $public_key ) ? 'SET (' . substr( $public_key, 0, 10 ) . '...)' : 'NOT SET' ) );
+
+ if ( empty( $secret_key ) || empty( $public_key ) ) {
+ // Log warning but don't block availability (credentials might be set later)
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] WARNING: API credentials not set, but gateway is still available' );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ }
+
+ // Gateway is available if enabled and checkout mode is 'flow'
+ // We bypass currency/country restrictions as Flow supports all currencies/countries
+<<<<<<< HEAD
+ if ( $is_debug ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway IS available - all checks passed' );
+ }
+=======
+ WC_Checkoutcom_Utility::logger( '[FLOW AVAILABILITY] Gateway IS available - all checks passed' );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ return true;
+ }
+
+ /**
+ * Check if the gateway is valid for use.
+ *
+ * Override parent method to bypass currency/country restrictions.
+ * Flow supports all currencies and countries, so we always return true
+ * when the gateway is enabled and checkout mode is 'flow'.
+ *
+ * @return bool
+ */
+ public function valid_for_use() {
+ // Log valid_for_use check start
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Checking if Flow gateway is valid for use...' );
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Gateway enabled setting: ' . ( isset( $this->enabled ) ? $this->enabled : 'NOT SET' ) );
+
+ // Check if gateway is enabled
+ if ( 'yes' !== $this->enabled ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Gateway is NOT valid - enabled setting is not "yes"' );
+ return false;
+ }
+
+ // Check if checkout mode is set to 'flow'
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings', array() );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Checkout mode: ' . $checkout_mode );
+
+ if ( 'flow' !== $checkout_mode ) {
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Gateway is NOT valid - checkout mode is not "flow" (current: ' . $checkout_mode . ')' );
+ return false;
+ }
+
+ // Flow supports all currencies and countries, so always return true
+ // This bypasses WooCommerce's default currency/country restrictions
+ WC_Checkoutcom_Utility::logger( '[FLOW VALID FOR USE] Gateway IS valid for use - all checks passed' );
+ return true;
+ }
+
+ /**
+ * Add subscription order payment meta field.
+ *
+ * @param array $payment_meta associative array of meta data required for automatic payments.
+ * @param WC_Subscription $subscription An instance of a subscription object.
+ * @return array
+ */
+<<<<<<< HEAD
+ /**
+ * Store save card preference in order metadata when order is created.
+ * This ensures the preference survives 3DS redirects.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $data The order data.
+ * @return void
+ */
+ public function store_save_card_preference_in_order( $order, $data ) {
+ // Only process if this is a Flow payment
+ if ( $this->id !== $order->get_payment_method() ) {
+ return;
+ }
+
+ // Check if customer wants to save card (from POST data during order creation)
+ $save_card_hidden = isset( $_POST['cko-flow-save-card-persist'] ) ? sanitize_text_field( $_POST['cko-flow-save-card-persist'] ) : '';
+ $save_card_post = isset( $_POST['wc-wc_checkout_com_flow-new-payment-method'] ) ? sanitize_text_field( $_POST['wc-wc_checkout_com_flow-new-payment-method'] ) : '';
+ $save_card_session = WC()->session->get( 'wc-wc_checkout_com_flow-new-payment-method' );
+
+ // Determine if checkbox was checked
+ $save_card_preference = 'no';
+ if ( 'yes' === $save_card_hidden ) {
+ $save_card_preference = 'yes';
+ } elseif ( 'true' === $save_card_post || 'yes' === $save_card_post ) {
+ $save_card_preference = 'yes';
+ } elseif ( 'yes' === $save_card_session ) {
+ $save_card_preference = 'yes';
+ }
+
+ // Store in order metadata
+ $order->update_meta_data( '_cko_save_card_preference', $save_card_preference );
+ WC_Checkoutcom_Utility::logger( '[FLOW SAVE CARD] Stored save card preference in order metadata: ' . $save_card_preference . ' (Order ID: ' . $order->get_id() . ')' );
+ }
+
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+ public function add_payment_meta_field( $payment_meta, $subscription ) {
+ $source_id = $subscription->get_meta( '_cko_source_id' );
+
+ $payment_meta[ $this->id ] = [
+ 'post_meta' => [
+ '_cko_source_id' => [
+ 'value' => $source_id,
+ 'label' => 'Checkout.com FLOW Source ID',
+ ],
+ ],
+ ];
+
+ return $payment_meta;
+ }
+
+ /**
+ * Show module configuration in backend.
+ *
+ * @return string|void
+ */
+ public function init_form_fields() {
+ $this->form_fields = WC_Checkoutcom_Cards_Settings::flow_settings();
+ $this->form_fields = array_merge(
+ $this->form_fields,
+ array(
+ 'screen_button' => array(
+ 'id' => 'screen_button',
+ 'type' => 'screen_button',
+ 'title' => __( 'Other Settings', 'checkout-com-unified-payments-api' ),
+ ),
+ )
+ );
+ }
+
+ /**
+ * Generate links for the admin page.
+ *
+ * @param string $key The key.
+ * @param array $value The value.
+ */
+ public function generate_screen_button_html( $key, $value ) {
+ WC_Checkoutcom_Admin::generate_links( $key, $value );
+ }
+
+ /**
+ * Show frames js on checkout page.
+ */
+ public function payment_fields() {
+
+ $save_card = WC_Admin_Settings::get_option( 'ckocom_card_saved' );
+
+ // Safely get flow saved card setting with fallback
+ $flow_settings = get_option( 'woocommerce_wc_checkout_com_flow_settings', array() );
+ $flow_saved_card = isset( $flow_settings['flow_saved_payment'] ) ? $flow_settings['flow_saved_payment'] : 'saved_cards_first';
+<<<<<<< HEAD
+ $flow_debug_logging = isset( $flow_settings['flow_debug_logging'] ) && 'yes' === $flow_settings['flow_debug_logging'];
+=======
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
+
+ $order_pay_order_id = null;
+ $order_pay_order = null;
+ if ( is_wc_endpoint_url( 'order-pay' ) ) {
+ global $wp;
+ // We are on the order-pay page. Retrives order_id from order-pay page
+ $order_pay_order_id = absint( $wp->query_vars['order-pay'] ?? 0 );
+ $order_pay_order = wc_get_order( $order_pay_order_id );
+ }
+
+ if ( ! empty( $this->get_option( 'description' ) ) ) {
+ echo esc_html( $this->get_option( 'description' ) );
+ }
+ ?>
+
+
+
+
+
+
+ is_created_via( 'admin' );
+ $is_guest_customer = $order_pay_order->get_customer_id() == 0;
+ $is_moto_order = $is_admin_created && $is_guest_customer;
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
';
+ } );
+ }
+ }
+ }
+
+ /**
+ * Render admin page.
+ */
+ public static function render_admin_page() {
+ global $wpdb;
+
+ if ( ! class_exists( 'WC_Checkout_Com_Webhook_Queue' ) ) {
+ echo '
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ saved_payment_methods();
+ }
+
+ // Render Save Card input.
+ $this->element_form_save_card( $save_card );
+ }
+
+ /**
+ * Override saved_payment_methods to show tokens from BOTH Flow and Classic Cards gateways.
+ * This allows merchants upgrading from Classic Cards to Flow to see their existing saved cards.
+ * No migration needed - the backend already handles both token types seamlessly.
+ *
+ * @since 5.0.0
+ * @return void
+ */
+ public function saved_payment_methods() {
+ if ( ! is_user_logged_in() ) {
+ return;
+ }
+
+ $user_id = get_current_user_id();
+
+ // Get tokens from BOTH gateways
+ $flow_tokens = WC_Payment_Tokens::get_customer_tokens( $user_id, $this->id );
+
+ $classic_gateway = new WC_Gateway_Checkout_Com_Cards();
+ $classic_tokens = WC_Payment_Tokens::get_customer_tokens( $user_id, $classic_gateway->id );
+
+ // Merge both token arrays
+ $all_tokens = array_merge( $flow_tokens, $classic_tokens );
+
+ // Log token retrieval for debugging
+ WC_Checkoutcom_Utility::logger( '=== MULTI-GATEWAY TOKEN RETRIEVAL ===' );
+ WC_Checkoutcom_Utility::logger( 'User ID: ' . $user_id );
+ WC_Checkoutcom_Utility::logger( 'Flow tokens found: ' . count( $flow_tokens ) );
+ WC_Checkoutcom_Utility::logger( 'Classic Cards tokens found: ' . count( $classic_tokens ) );
+ WC_Checkoutcom_Utility::logger( 'Total tokens (before dedup): ' . count( $all_tokens ) );
+
+ if ( empty( $all_tokens ) ) {
+ WC_Checkoutcom_Utility::logger( 'No saved cards found - skipping display' );
+ return;
+ }
+
+ // Remove duplicates based on token value (source ID)
+ $unique_tokens = array();
+ $seen_tokens = array();
+ foreach ( $all_tokens as $token ) {
+ $token_value = $token->get_token();
+ if ( ! in_array( $token_value, $seen_tokens, true ) ) {
+ $unique_tokens[] = $token;
+ $seen_tokens[] = $token_value;
+ }
+ }
+
+ WC_Checkoutcom_Utility::logger( 'Unique tokens (after dedup): ' . count( $unique_tokens ) );
+ WC_Checkoutcom_Utility::logger( '=== END MULTI-GATEWAY TOKEN RETRIEVAL ===' );
+
+ // Display saved payment methods (without extra label - already handled by accordion)
+ ?>
+ -
+ get_id() == $default_token_id );
+ $gateway_source = ( $token->get_gateway_id() === $this->id ) ? 'Flow' : 'Classic';
+ ?>
+
- + + class="woocommerce-SavedPaymentMethods-tokenInput" + data-gateway-source="" /> + + + +
- + /> + + +
' . esc_html__( 'Old webhooks cleaned up successfully.', 'checkout-com-unified-payments-api' ) . '
' . esc_html__( 'Webhook Queue', 'checkout-com-unified-payments-api' ) . '
'; + echo '' . esc_html__( 'Webhook Queue class not found.', 'checkout-com-unified-payments-api' ) . '
' . esc_html__( 'Webhook Queue', 'checkout-com-unified-payments-api' ) . '
'; + echo '' . sprintf(
+ esc_html__( 'Table %s does not exist. Please ensure the plugin is activated.', 'checkout-com-unified-payments-api' ),
+ '' . esc_html( $table_name ) . ''
+ ) . '
+
+
+
+
+
+ 100 ) : ?>
+
+ >>>>>> upstream/feature/flow-integration-v5.0.0-beta
use Checkout\Payments\ThreeDsRequest;
use Checkout\Payments\VoidRequest;
use Checkout\Tokens\ApplePayTokenData;
@@ -39,6 +43,25 @@
class WC_Checkoutcom_Api_Request {
/**
+<<<<<<< HEAD
+=======
+ * Helper function to safely get SDK builder with null check
+ *
+ * @param Checkout_SDK $checkout SDK instance
+ * @param string $operation Operation name for logging
+ * @return mixed|null Builder instance or null if SDK not initialized
+ */
+ private static function get_safe_builder( $checkout, $operation = 'operation' ) {
+ $builder = $checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( "Checkout.com SDK not initialized - cannot perform $operation" );
+ return null;
+ }
+ return $builder;
+ }
+
+ /**
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
* Create payment and return response.
*
* @param WC_Order $order Order object.
@@ -79,8 +102,18 @@ public static function create_payment( WC_Order $order, $arg, $subscription = nu
$cko_idempotency_key .= '-' . gmdate( 'Y-m-d h:i:s' );
}
+<<<<<<< HEAD
// Call to create charge.
$response = $checkout->get_builder()->getPaymentsClient()->requestPayment( $request_param, $cko_idempotency_key );
+=======
+ // Call to create charge.
+ $builder = $checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot request payment' );
+ return array( 'error' => 'Payment gateway not properly configured. Please contact support.' );
+ }
+ $response = $builder->getPaymentsClient()->requestPayment( $request_param, $cko_idempotency_key );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
// Check if payment successful.
if ( WC_Checkoutcom_Utility::is_successful( $response ) ) {
@@ -191,7 +224,12 @@ private static function get_request_param( WC_Order $order, $arg, $subscription
$card_scheme = $arg['preferred_scheme'];
}
+<<<<<<< HEAD
$customer_address = WC_Checkoutcom_Api_Request::customer_address( $post_data );
+=======
+ // For express checkout, if POST data doesn't have address info, get it from order
+ $customer_address = WC_Checkoutcom_Api_Request::customer_address( $post_data, $order );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
// Prepare payment parameters.
if ( 'wc_checkout_com_cards' === $post_data['payment_method'] ) {
@@ -236,6 +274,63 @@ private static function get_request_param( WC_Order $order, $arg, $subscription
$method = new RequestPayPalSource();
+<<<<<<< HEAD
+=======
+ } elseif ( 'wc_checkout_com_flow' === $post_data['payment_method'] ) {
+ $payment_option = 'Flow';
+
+ if ( self::is_using_saved_payment_method() ) {
+ // Saved card used with Flow.
+ // Load token id ($arg).
+ $token = WC_Payment_Tokens::get( $arg );
+
+ // Enhanced error handling for old saved cards
+ if ( ! $token ) {
+ WC_Checkoutcom_Utility::logger( 'Error: Token not found for ID: ' . $arg );
+ return array(
+ 'error' => array(
+ 'type' => 'token_error',
+ 'message' => 'Saved payment method not found. Please try using a new payment method.',
+ ),
+ );
+ }
+
+ // Get source_id from $token with validation
+ $source_id = $token->get_token();
+ if ( empty( $source_id ) ) {
+ WC_Checkoutcom_Utility::logger( 'Error: Empty source_id for token ID: ' . $arg );
+ return array(
+ 'error' => array(
+ 'type' => 'token_error',
+ 'message' => 'Invalid saved payment method. Please try using a new payment method.',
+ ),
+ );
+ }
+
+ // Safely get card scheme metadata (may not exist in old tokens)
+ $card_scheme = $token->get_meta( 'preferred_scheme' );
+ if ( empty( $card_scheme ) ) {
+ WC_Checkoutcom_Utility::logger( 'Warning: No preferred_scheme metadata for token ID: ' . $arg . ' (likely old saved card)' );
+ }
+
+ $method = new RequestIdSource();
+ $method->id = $source_id;
+
+ $is_save_card = true;
+
+ if ( WC_Admin_Settings::get_option( 'ckocom_card_require_cvv' ) ) {
+ $method->cvv = $post_data['wc_checkout_com_flow-card-cvv'];
+ }
+
+ WC_Checkoutcom_Utility::logger( 'Flow saved card processing - Token ID: ' . $arg . ', Source ID: ' . $source_id . ', Card Scheme: ' . ( $card_scheme ?: 'none' ) );
+ } else {
+ // New payment via Flow - this shouldn't happen as Flow handles new payments differently
+ // But we need to handle it to prevent null method
+ $method = new RequestTokenSource();
+ $method->token = $arg;
+ }
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
} elseif ( in_array( $arg, $apms_selected, true ) ) {
// Alternative payment method selected.
$method = WC_Checkoutcom_Api_Request::get_apm_method( $post_data, $order, $arg );
@@ -247,6 +342,20 @@ private static function get_request_param( WC_Order $order, $arg, $subscription
$method->id = $arg['source_id'];
}
+<<<<<<< HEAD
+=======
+ // Safety check to prevent null method error
+ if ( null === $method ) {
+ WC_Checkoutcom_Utility::logger( 'Error: Payment method is null in get_request_param' );
+ return array(
+ 'error' => array(
+ 'type' => 'request_error',
+ 'message' => 'Payment method not supported or invalid.',
+ ),
+ );
+ }
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
if ( 'klarna' !== $method->type ) {
// Set billing address in $method.
if ( ! empty( $customer_address['billing_address_1'] ) && ! empty( $customer_address['billing_country'] ) ) {
@@ -271,12 +380,26 @@ private static function get_request_param( WC_Order $order, $arg, $subscription
$payment->source = $method;
+<<<<<<< HEAD
$email = $post_data['billing_email'];
$name = $post_data['billing_first_name'] . ' ' . $post_data['billing_last_name'];
+=======
+ // Get email and name from POST data or order (for express checkout)
+ $email = isset( $post_data['billing_email'] ) ? $post_data['billing_email'] : '';
+ $name = isset( $post_data['billing_first_name'] ) && isset( $post_data['billing_last_name'] )
+ ? $post_data['billing_first_name'] . ' ' . $post_data['billing_last_name']
+ : '';
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
// Pay Order Page.
$is_pay_order = ! empty( $get_data['pay_for_order'] ) && (bool) $get_data['pay_for_order'];
+<<<<<<< HEAD
+=======
+ // Check if this is express checkout (POST data doesn't have address info)
+ $is_express_checkout = empty( $customer_address['billing_address_1'] ) && empty( $customer_address['billing_city'] ) && ! empty( $order );
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
if ( $is_pay_order ) {
if ( ! empty( $get_data['order_id'] ) ) {
$order_id = $get_data['order_id'];
@@ -288,6 +411,13 @@ private static function get_request_param( WC_Order $order, $arg, $subscription
$email = $order->get_billing_email();
$name = $order->get_billing_first_name() . ' ' . $order->get_billing_last_name();
+<<<<<<< HEAD
+=======
+ } elseif ( $is_express_checkout && ! empty( $order ) ) {
+ // Express checkout: Get email and name from order when POST data is empty
+ $email = $order->get_billing_email();
+ $name = $order->get_billing_first_name() . ' ' . $order->get_billing_last_name();
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
// Customer.
@@ -448,10 +578,21 @@ private static function get_request_param( WC_Order $order, $arg, $subscription
}
}
+<<<<<<< HEAD
// If this is MOTO order(Created via admin paid by customer from email).
if ( $order->is_created_via( 'admin' ) ) {
$payment->payment_type = PaymentType::$moto;
unset( $payment->three_ds );
+=======
+ // If this is MOTO order (Admin-created order + Order-pay page + Guest customer).
+ $is_order_pay_page = ! empty( $_GET['pay_for_order'] ) && (bool) $_GET['pay_for_order'];
+ $is_guest_customer = $order->get_customer_id() == 0; // Guest customer = no customer account
+
+ if ( $order->is_created_via( 'admin' ) && $is_order_pay_page && $is_guest_customer ) {
+ $payment->payment_type = PaymentType::$moto;
+ unset( $payment->three_ds );
+ WC_Checkoutcom_Utility::logger( 'MOTO payment type set - Admin order + Order-pay page + Guest customer. Order ID: ' . $order->get_id() );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
// PayPal add items to payment.
@@ -471,11 +612,20 @@ private static function get_request_param( WC_Order $order, $arg, $subscription
/**
* Return customer address.
*
+<<<<<<< HEAD
* @param array $data Post data.
*
* @return array
*/
private static function customer_address( $data ) {
+=======
+ * @param array $data Post data.
+ * @param WC_Order $order Order object (optional, used for express checkout when POST data is empty).
+ *
+ * @return array
+ */
+ private static function customer_address( $data, $order = null ) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
// Pay Order Page.
$is_pay_order = ! empty( $_GET['pay_for_order'] ) ? (bool) $_GET['pay_for_order'] : false;
@@ -488,6 +638,12 @@ private static function customer_address( $data ) {
$billing_postcode = empty( $data['billing_postcode'] ) ? '' : wc_clean( $data['billing_postcode'] );
$billing_country = empty( $data['billing_country'] ) ? '' : wc_clean( $data['billing_country'] );
+<<<<<<< HEAD
+=======
+ // Check if POST data is empty (express checkout scenario) and we have an order
+ $is_express_checkout = empty( $billing_address_1 ) && empty( $billing_city ) && ! empty( $order );
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
if ( isset( $data['ship_to_different_address'] ) ) {
$shipping_first_name = empty( $data['shipping_first_name'] ) ? '' : wc_clean( $data['shipping_first_name'] );
$shipping_last_name = empty( $data['shipping_last_name'] ) ? '' : wc_clean( $data['shipping_last_name'] );
@@ -527,6 +683,28 @@ private static function customer_address( $data ) {
$shipping_postcode = $order->get_shipping_postcode();
$shipping_country = $order->get_shipping_country();
+<<<<<<< HEAD
+=======
+ } elseif ( $is_express_checkout && ! empty( $order ) ) {
+ // Express checkout: Get billing and shipping details from order when POST data is empty
+ $billing_first_name = $order->get_billing_first_name();
+ $billing_last_name = $order->get_billing_last_name();
+ $billing_address_1 = $order->get_billing_address_1();
+ $billing_address_2 = $order->get_billing_address_2();
+ $billing_city = $order->get_billing_city();
+ $billing_state = $order->get_billing_state();
+ $billing_postcode = $order->get_billing_postcode();
+ $billing_country = $order->get_billing_country();
+
+ $shipping_first_name = $order->get_shipping_first_name();
+ $shipping_last_name = $order->get_shipping_last_name();
+ $shipping_address_1 = $order->get_shipping_address_1();
+ $shipping_address_2 = $order->get_shipping_address_2();
+ $shipping_city = $order->get_shipping_city();
+ $shipping_state = $order->get_shipping_state();
+ $shipping_postcode = $order->get_shipping_postcode();
+ $shipping_country = $order->get_shipping_country();
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
} else {
$shipping_first_name = $billing_first_name;
$shipping_last_name = $billing_last_name;
@@ -573,8 +751,18 @@ public static function verify_session( $session_id ) {
try {
+<<<<<<< HEAD
// Get payment response.
$response = $checkout->get_builder()->getPaymentsClient()->getPaymentDetails( $session_id );
+=======
+ // Get payment response.
+ $builder = $checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot get payment details' );
+ return array( 'error' => 'Payment gateway not properly configured. Please contact support.' );
+ }
+ $response = $builder->getPaymentsClient()->getPaymentDetails( $session_id );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
// Check if payment is successful.
if ( WC_Checkoutcom_Utility::is_successful( $response ) ) {
@@ -640,9 +828,44 @@ public static function verify_session( $session_id ) {
* @return mixed
*/
public static function generate_google_token() {
+<<<<<<< HEAD
$protocol_version = sanitize_text_field( $_POST['cko-google-protocolVersion'] );
$signature = sanitize_text_field( $_POST['cko-google-signature'] );
$signed_message = stripslashes( $_POST['cko-google-signedMessage'] );
+=======
+ // Protocol version is safe to sanitize
+ $protocol_version = sanitize_text_field( $_POST['cko-google-protocolVersion'] );
+
+ // Signature and signedMessage are base64-encoded strings that should NOT be sanitized
+ // as sanitize_text_field can corrupt base64 data.
+ // IMPORTANT: For classic Google Pay, form POST data is automatically processed by WordPress
+ // For express AJAX, the data comes directly and may already be in the correct format
+ // wp_unslash on signedMessage can reduce it from 672 to 658 chars, corrupting it
+ // So we should check if wp_unslash changes the length, and if so, use the original
+ $signature_raw = $_POST['cko-google-signature'];
+ $signed_message_raw = $_POST['cko-google-signedMessage'];
+
+ // Apply wp_unslash to match classic Google Pay form POST behavior
+ $signature = wp_unslash( $signature_raw );
+ $signed_message_unslashed = wp_unslash( $signed_message_raw );
+
+ // If wp_unslash reduced the signedMessage length, it's corrupting it
+ // Use the original instead (for express AJAX, it's already in the correct format)
+ if ( strlen( $signed_message_unslashed ) < strlen( $signed_message_raw ) ) {
+ $signed_message = $signed_message_raw;
+
+ // Check if signedMessage has escaped quotes (from AJAX POST)
+ // If signedMessage has \" instead of ", we need to unescape it
+ if ( strpos( $signed_message, '\\"' ) !== false ) {
+ // Unescape quotes: \" -> "
+ $signed_message = str_replace( '\\"', '"', $signed_message );
+ // Also unescape backslashes: \\ -> \
+ $signed_message = str_replace( '\\\\', '\\', $signed_message );
+ }
+ } else {
+ $signed_message = $signed_message_unslashed;
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
$checkout = new Checkout_SDK();
@@ -659,7 +882,16 @@ public static function generate_google_token() {
$google_pay_token_request = new GooglePayTokenRequest();
$google_pay_token_request->token_data = $google_pay;
+<<<<<<< HEAD
$token = $checkout->get_builder()->getTokensClient()->requestWalletToken( $google_pay_token_request );
+=======
+ $builder = $checkout->get_builder();
+ if ( ! $builder ) {
+ WC_Checkoutcom_Utility::logger( 'Checkout.com SDK not initialized - cannot request Google Pay token' );
+ return array( 'error' => 'Payment gateway not properly configured. Please contact support.' );
+ }
+ $token = $builder->getTokensClient()->requestWalletToken( $google_pay_token_request );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
return [
'token' => $token['token'],
@@ -668,6 +900,10 @@ public static function generate_google_token() {
} catch ( CheckoutApiException $ex ) {
$error_message = __( 'An error has occurred while processing your Google pay payment.', 'checkout-com-unified-payments-api' );
WC_Checkoutcom_Utility::logger( $error_message, $ex );
+<<<<<<< HEAD
+=======
+ return array( 'error' => $error_message . ' ' . $ex->getMessage() );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
}
@@ -1191,12 +1427,17 @@ public static function klarna_session() {
*
* @return array
*/
+<<<<<<< HEAD
public static function get_cart_info() {
+=======
+ public static function get_cart_info( $flow = false ) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
if ( ! WC()->cart ) {
return [];
}
+<<<<<<< HEAD
$items = WC()->cart->get_cart();
$products = [];
@@ -1204,6 +1445,22 @@ public static function get_cart_info() {
$amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_amount, get_woocommerce_currency() );
foreach ( $items as $item => $values ) {
+=======
+ $items = WC()->cart->get_cart();
+ $products = [];
+
+ $total_amount = WC()->cart->total;
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_amount, get_woocommerce_currency() );
+
+ // Initialize virtual product flag
+ $contains_virtual_product = false;
+ // Initialize subscription flags
+ $contains_subscription_product = false;
+ $regular_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$regular : 'Regular';
+ $recurring_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$recurring : 'Recurring';
+
+ foreach ( $items as $item => $values ) {
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
$_product = wc_get_product( $values['data']->get_id() );
$wc_product = wc_get_product( $values['product_id'] );
@@ -1221,6 +1478,7 @@ public static function get_cart_info() {
$reset_tax = reset( $tax )['rate'];
$tax_rate = round( $reset_tax );
+<<<<<<< HEAD
} else {
$tax_rate = 0;
$total_tax_amount_cents = 0;
@@ -1238,6 +1496,84 @@ public static function get_cart_info() {
'total_discount_amount' => 0,
];
+=======
+ } else {
+ $tax_rate = 0;
+ $total_tax_amount_cents = 0;
+ }
+
+ // Check if product is virtual
+ if ( $_product->is_virtual() ) {
+ $contains_virtual_product = true;
+ }
+
+ // Check if product is a subscription product
+ $is_subscription_product = false;
+ $product_id = $_product->get_id();
+ $product_type = $_product->get_type();
+
+ if ( function_exists( 'wcs_is_subscription_product' ) ) {
+ $is_subscription_product = wcs_is_subscription_product( $_product );
+ if ( $is_subscription_product ) {
+ $contains_subscription_product = true;
+ }
+ } else {
+ // Fallback: Check if product has subscription meta
+ $subscription_period = get_post_meta( $product_id, '_subscription_period', true );
+ $subscription_price = get_post_meta( $product_id, '_subscription_price', true );
+ if ( ! empty( $subscription_period ) || ! empty( $subscription_price ) ) {
+ $is_subscription_product = true;
+ $contains_subscription_product = true;
+ }
+ }
+
+ // Additional check: product type might be 'subscription' or 'variable-subscription'
+ if ( ! $is_subscription_product && ( $product_type === 'subscription' || $product_type === 'variable-subscription' ) ) {
+ $is_subscription_product = true;
+ $contains_subscription_product = true;
+ }
+
+ if( $flow ) {
+ $quantity = $values['quantity'];
+ $line_subtotal = $values['line_subtotal'];
+ $line_total = $values['line_total'];
+
+ // Discount Price
+ $unit_discount = ( $line_subtotal - $line_total ) / $quantity;
+ $discount_total_cents = WC_Checkoutcom_Utility::value_to_decimal( $unit_discount * $quantity, get_woocommerce_currency() );
+
+ // Flow-specific logic for cart items
+ $product_data = [
+ 'name' => $_product->get_title(),
+ 'quantity' => $quantity,
+ 'unit_price' => $unit_price_cents,
+ 'total_amount' => ( $unit_price_cents * $quantity ) - $discount_total_cents,
+ 'tax_amount' => $total_tax_amount_cents,
+ 'type' => 'physical',
+ 'reference' => $_product->get_sku(),
+ 'discount_amount' => $discount_total_cents,
+ ];
+
+ // Add subscription flag to product data if it's a subscription product
+ if ( $is_subscription_product ) {
+ $product_data['is_subscription'] = true;
+ }
+
+ $products[] = $product_data;
+ } else {
+ $products[] = [
+ 'name' => $_product->get_title(),
+ 'quantity' => $values['quantity'],
+ 'unit_price' => $unit_price_cents,
+ 'tax_rate' => $tax_rate * 100,
+ 'total_amount' => $unit_price_cents * $values['quantity'],
+ 'total_tax_amount' => $total_tax_amount_cents,
+ 'type' => 'physical',
+ 'reference' => $_product->get_sku(),
+ 'total_discount_amount' => 0,
+ ];
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
$chosen_methods = wc_get_chosen_shipping_method_ids();
@@ -1268,6 +1604,7 @@ public static function get_cart_info() {
$total_tax_amount_cents = 0;
}
+<<<<<<< HEAD
$products[] = [
'name' => $chosen_shipping,
'quantity' => 1,
@@ -1279,6 +1616,32 @@ public static function get_cart_info() {
'reference' => $chosen_shipping,
'total_discount_amount' => 0,
];
+=======
+ // Only add total_tax_amount and total_discount_amount if flow is false.
+ if ( ! $flow ) {
+ $products[] = [
+ 'name' => $chosen_shipping,
+ 'quantity' => 1,
+ 'unit_price' => $shipping_amount_cents,
+ 'tax_rate' => $shipping_tax_rate,
+ 'total_amount' => $shipping_amount_cents,
+ 'total_tax_amount' => $total_tax_amount_cents,
+ 'type' => 'shipping_fee',
+ 'reference' => $chosen_shipping,
+ 'total_discount_amount' => 0,
+ ];
+ } else {
+ $products[] = [
+ 'name' => $chosen_shipping,
+ 'quantity' => 1,
+ 'unit_price' => $shipping_amount_cents,
+ 'total_amount' => $shipping_amount_cents,
+ 'tax_amount' => $total_tax_amount_cents,
+ 'reference' => $chosen_shipping,
+ 'discount_amount' => 0,
+ ];
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
}
@@ -1286,7 +1649,17 @@ public static function get_cart_info() {
$locale = substr( $woo_locale, 0, 5 );
$total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( WC()->cart->get_total_tax(), get_woocommerce_currency() );
+<<<<<<< HEAD
return [
+=======
+ // Determine payment type based on subscription detection
+ $payment_type = $regular_payment_type;
+ if ( $contains_subscription_product ) {
+ $payment_type = $recurring_payment_type;
+ }
+
+ $cart_info = [
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
'purchase_country' => WC()->customer->get_billing_country(),
'purchase_currency' => get_woocommerce_currency(),
'locale' => strtolower( $locale ),
@@ -1305,7 +1678,229 @@ public static function get_cart_info() {
'order_amount' => $amount_cents,
'order_tax_amount' => $total_tax_amount_cents,
'order_lines' => $products,
+<<<<<<< HEAD
+ ];
+=======
+ 'contains_virtual_product' => $contains_virtual_product,
];
+
+ // Add subscription flags and payment type for Flow integration
+ if ( $flow ) {
+ $cart_info['contains_subscription_product'] = $contains_subscription_product;
+ $cart_info['payment_type'] = $payment_type;
+ }
+
+ return $cart_info;
+}
+
+ /**
+ * Get order information for Flow integration.
+ * Similar to get_cart_info() but for existing orders.
+ *
+ * @param int $order_id Order ID.
+ * @param bool $flow Whether this is for Flow integration (affects field names).
+ *
+ * @return array
+ */
+ public static function get_order_info( $order_id, $flow = false ) {
+ $order = wc_get_order( $order_id );
+
+ if ( ! $order ) {
+ return [];
+ }
+
+ $items = $order->get_items();
+ $products = [];
+
+ $total_amount = $order->get_total();
+ $amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $total_amount, $order->get_currency() );
+
+ // Initialize subscription flags
+ $contains_subscription_product = false;
+ $regular_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$regular : 'Regular';
+ $recurring_payment_type = class_exists('Checkout\\Payments\\PaymentType') ? \Checkout\Payments\PaymentType::$recurring : 'Recurring';
+
+ foreach ( $items as $item ) {
+ $product = $item->get_product();
+
+ if ( ! $product ) {
+ continue;
+ }
+
+ // Check if product is a subscription product
+ $is_subscription_product = false;
+ if ( function_exists( 'wcs_is_subscription_product' ) ) {
+ $is_subscription_product = wcs_is_subscription_product( $product );
+ if ( $is_subscription_product ) {
+ $contains_subscription_product = true;
+ }
+ }
+
+ $line_subtotal = $item->get_subtotal();
+ $quantity = $item->get_quantity();
+ $line_total = $item->get_total();
+
+ if ( $flow ) {
+ $unit_price = $line_subtotal / $quantity;
+ $unit_discount = ( $line_subtotal - $line_total ) / $quantity;
+ $discounted_unit = $unit_price - $unit_discount;
+ $unit_price_cents = WC_Checkoutcom_Utility::value_to_decimal( $discounted_unit, $order->get_currency() );
+ $discount_total_cents = WC_Checkoutcom_Utility::value_to_decimal( $unit_discount * $quantity, $order->get_currency() );
+ $tax_amount = $item->get_subtotal_tax();
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $tax_amount, $order->get_currency() );
+
+ $product_data = [
+ 'name' => $item->get_name(),
+ 'quantity' => $quantity,
+ 'unit_price' => $unit_price_cents,
+ 'total_amount' => $unit_price_cents * $quantity,
+ 'tax_amount' => $total_tax_amount_cents,
+ 'type' => 'physical',
+ 'reference' => $product->get_sku() ?: $product->get_id(),
+ 'discount_amount' => $discount_total_cents,
+ ];
+
+ // Add subscription flag to product data if it's a subscription product
+ if ( $is_subscription_product ) {
+ $product_data['is_subscription'] = true;
+ }
+
+ $products[] = $product_data;
+ } else {
+ $price_excl_tax = $item->get_subtotal();
+ $unit_price_cents = WC_Checkoutcom_Utility::value_to_decimal( $price_excl_tax / $item->get_quantity(), $order->get_currency() );
+
+ $tax_amount = $item->get_subtotal_tax();
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $tax_amount, $order->get_currency() );
+
+ // Calculate tax rate
+ $tax_rate = 0;
+ if ( $price_excl_tax > 0 ) {
+ $tax_rate = round( ( $tax_amount / $price_excl_tax ) * 100 );
+ }
+
+ $products[] = [
+ 'name' => $item->get_name(),
+ 'quantity' => $item->get_quantity(),
+ 'unit_price' => $unit_price_cents,
+ 'tax_rate' => $tax_rate * 100,
+ 'total_amount' => WC_Checkoutcom_Utility::value_to_decimal( $price_excl_tax, $order->get_currency() ),
+ 'total_tax_amount' => $total_tax_amount_cents,
+ 'type' => 'physical',
+ 'reference' => $product->get_sku() ?: $product->get_id(),
+ 'total_discount_amount' => WC_Checkoutcom_Utility::value_to_decimal( $item->get_subtotal() - $item->get_total(), $order->get_currency() ),
+ ];
+ }
+ }
+
+ // Add shipping if present
+ $shipping_total = $order->get_shipping_total();
+ if ( $shipping_total > 0 ) {
+ $shipping_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $shipping_total, $order->get_currency() );
+ $shipping_tax = $order->get_shipping_tax();
+ $shipping_tax_cents = WC_Checkoutcom_Utility::value_to_decimal( $shipping_tax, $order->get_currency() );
+
+ $shipping_tax_rate = 0;
+ if ( $shipping_total > 0 ) {
+ $shipping_tax_rate = round( ( $shipping_tax / $shipping_total ) * 100 );
+ }
+
+ // Only add total_tax_amount and total_discount_amount if flow is false.
+ if ( ! $flow ) {
+ $products[] = [
+ 'name' => 'Shipping',
+ 'quantity' => 1,
+ 'unit_price' => $shipping_amount_cents,
+ 'tax_rate' => $shipping_tax_rate * 100,
+ 'total_amount' => $shipping_amount_cents,
+ 'total_tax_amount' => $shipping_tax_cents,
+ 'type' => 'shipping_fee',
+ 'reference' => 'shipping',
+ 'total_discount_amount' => 0,
+ ];
+ } else {
+ $products[] = [
+ 'name' => 'Shipping',
+ 'quantity' => 1,
+ 'unit_price' => $shipping_amount_cents,
+ 'total_amount' => $shipping_amount_cents,
+ 'tax_amount' => $shipping_tax_cents,
+ 'reference' => 'shipping',
+ 'discount_amount' => 0,
+ ];
+ }
+ }
+
+ $woo_locale = str_replace( '_', '-', get_locale() );
+ $locale = substr( $woo_locale, 0, 5 );
+ $total_tax_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $order->get_total_tax(), $order->get_currency() );
+
+ $order_info = [
+ 'purchase_country' => $order->get_billing_country(),
+ 'purchase_currency' => $order->get_currency(),
+ 'locale' => strtolower( $locale ),
+ 'billing_address' => [
+ 'given_name' => $order->get_billing_first_name(),
+ 'family_name' => $order->get_billing_last_name(),
+ 'email' => $order->get_billing_email(),
+ 'street_address' => $order->get_billing_address_1(),
+ 'street_address2' => $order->get_billing_address_2(),
+ 'postal_code' => $order->get_billing_postcode(),
+ 'city' => $order->get_billing_city(),
+ 'region' => $order->get_billing_state(),
+ 'phone' => $order->get_billing_phone(),
+ 'country' => $order->get_billing_country(),
+ ],
+ 'order_amount' => $amount_cents,
+ 'order_tax_amount' => $total_tax_amount_cents,
+ 'order_lines' => $products,
+ ];
+
+ // Add payment type information if requested (for MOTO orders and subscriptions)
+ if ( $flow ) {
+ // MOTO only for: Admin-created order + Order-pay page + Guest customer
+ $is_order_pay_page = ! empty( $_GET['pay_for_order'] ) && (bool) $_GET['pay_for_order'];
+ $is_guest_customer = $order->get_customer_id() == 0; // Guest customer = no customer account
+ $is_admin_created = $order->is_created_via( 'admin' );
+ $is_moto_payment = $is_admin_created && $is_order_pay_page && $is_guest_customer;
+
+ // Check if order contains subscription (using WooCommerce Subscriptions function)
+ $order_contains_subscription = false;
+ if ( function_exists( 'wcs_order_contains_subscription' ) ) {
+ $order_contains_subscription = wcs_order_contains_subscription( $order, 'parent' );
+ }
+
+ // Determine payment type: Priority: MOTO > Subscription > Regular
+ if ( $is_moto_payment ) {
+ $payment_type = 'MOTO';
+ } elseif ( $order_contains_subscription || $contains_subscription_product ) {
+ $payment_type = $recurring_payment_type;
+ } else {
+ $payment_type = $regular_payment_type;
+ }
+
+ // Enhanced debug logging with more details
+ WC_Checkoutcom_Utility::logger( 'Order info payment type detection - Order ID: ' . $order->get_id() .
+ ', Admin created: ' . ($is_admin_created ? 'YES' : 'NO') .
+ ', Order-pay page: ' . ($is_order_pay_page ? 'YES' : 'NO') .
+ ', Guest customer: ' . ($is_guest_customer ? 'YES' : 'NO') .
+ ', Contains subscription product: ' . ($contains_subscription_product ? 'YES' : 'NO') .
+ ', Order contains subscription: ' . ($order_contains_subscription ? 'YES' : 'NO') .
+ ', Payment type: ' . $payment_type
+ );
+
+ $order_info['payment_type'] = $payment_type;
+ $order_info['contains_subscription_product'] = $contains_subscription_product || $order_contains_subscription;
+
+ if ( $is_moto_payment ) {
+ WC_Checkoutcom_Utility::logger( 'Order info: MOTO payment type set - Admin order + Order-pay page + Guest customer. Order ID: ' . $order->get_id() );
+ } elseif ( $order_contains_subscription || $contains_subscription_product ) {
+ WC_Checkoutcom_Utility::logger( 'Order info: Recurring payment type set - Order contains subscription. Order ID: ' . $order->get_id() );
+ }
+ }
+
+ return $order_info;
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
/**
@@ -1317,7 +1912,11 @@ public static function get_cart_info() {
* @return array
*/
public static function get_paypal_products( $order ) {
+<<<<<<< HEAD
$cart_info = WC_Checkoutcom_Api_Request::get_cart_info();
+=======
+ $cart_info = WC_Checkoutcom_Api_Request::get_cart_info(false);
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
$products = [];
if ( $cart_info ) {
diff --git a/includes/api/class-wc-checkoutcom-utility.php b/includes/api/class-wc-checkoutcom-utility.php
index 27fff67f..59252c34 100644
--- a/includes/api/class-wc-checkoutcom-utility.php
+++ b/includes/api/class-wc-checkoutcom-utility.php
@@ -198,6 +198,7 @@ public static function logger( $error_message, $exception = null ) {
// Get file logging from module setting.
$file_logging = 'yes' === WC_Admin_Settings::get_option( 'cko_file_logging', 'no' );
+<<<<<<< HEAD
// Check if file logging is enabled.
if ( $file_logging ) {
// Log error message with exception.
@@ -206,6 +207,40 @@ public static function logger( $error_message, $exception = null ) {
} else {
// Log only error message.
$logger->error( $error_message, $context );
+=======
+ // Determine log level from message prefix
+ $log_level = 'error'; // Default to error for backward compatibility
+
+ // Check for debug/info prefixes (case-insensitive)
+ if ( preg_match( '/\[FLOW\s+DEBUG\]|\[DEBUG\]|\[ADDRESS\s+DEBUG\]/i', $error_message ) ) {
+ $log_level = 'debug';
+ } elseif ( preg_match( '/\[FLOW\s+INFO\]|\[INFO\]/i', $error_message ) ) {
+ $log_level = 'info';
+ } elseif ( preg_match( '/\[FLOW\s+WARNING\]|\[WARNING\]|\[WARN\]/i', $error_message ) ) {
+ $log_level = 'warning';
+ } elseif ( preg_match( '/\[FLOW\s+ERROR\]|\[ERROR\]/i', $error_message ) ) {
+ $log_level = 'error';
+ } elseif ( preg_match( '/\[FLOW\s+SERVER\]|\[VALIDATE\s+CHECKOUT\]|\[PROCESS\s+PAYMENT\]|\[CREATE\s+ORDER\]|\[FLOW\s+VALID\s+FOR\s+USE\]|\[FLOW\s+AVAILABILITY\]|\[FLOW\s+SAVE\s+CARD\]/i', $error_message ) ) {
+ // Server-side informational logs - use info level
+ $log_level = 'info';
+ }
+
+ // Check if file logging is enabled.
+ if ( $file_logging ) {
+ // Log message with appropriate level
+ $logger->log( $log_level, $error_message, $context );
+ if ( null !== $exception ) {
+ // If exception is an array, print it properly
+ if ( is_array( $exception ) ) {
+ $logger->log( $log_level, $error_message . ' Data: ' . wc_print_r( $exception, true ), $context );
+ } else {
+ $logger->log( $log_level, wc_print_r( $exception, true ), $context );
+ }
+ }
+ } else {
+ // Log only message (still respect log level)
+ $logger->log( $log_level, $error_message, $context );
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
}
@@ -514,6 +549,25 @@ public static function is_cart_contains_subscription() {
return false;
}
+<<<<<<< HEAD
+=======
+ /**
+ * Track if unified express checkout container has been rendered.
+ *
+ * @param bool $set Optional. Set the flag to true.
+ * @return bool True if container has been rendered, false otherwise.
+ */
+ public static function express_checkout_container_rendered( $set = false ) {
+ static $rendered = false;
+
+ if ( $set ) {
+ $rendered = true;
+ }
+
+ return $rendered;
+ }
+
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
public static function is_paypal_express_available() {
$paypal_settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings' );
@@ -521,10 +575,188 @@ public static function is_paypal_express_available() {
$available_payment_methods = WC()->payment_gateways()->get_available_payment_gateways();
+<<<<<<< HEAD
if ( isset( $available_payment_methods['wc_checkout_com_paypal'] ) && $is_express_enable ) {
return true;
+=======
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ if ( $checkout_mode === 'classic' ) {
+ /**
+ * If checkout_mode is classic, show express-paypal if enabled and
+ * if 'wc_checkout_com_paypal' is an available payment method on checkout.
+ *
+ * Note: On shop/cart pages, gateways might not be "available" yet, so we also
+ * check if the gateway exists in all gateways (not just available ones).
+ */
+ $all_gateways = WC()->payment_gateways()->payment_gateways();
+ $paypal_exists = isset( $all_gateways['wc_checkout_com_paypal'] );
+
+ if ( ( isset( $available_payment_methods['wc_checkout_com_paypal'] ) || $paypal_exists ) && $is_express_enable ) {
+ return true;
+ }
+ }
+ else {
+ /**
+ * If checkout_mode is flow, show express-paypal if enabled.
+ */
+ if ( $is_express_enable ) {
+ return true;
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
return false;
}
+<<<<<<< HEAD
+=======
+
+ /**
+ * Check if Google Pay Express is available.
+ *
+ * @return bool True if Google Pay Express is available, false otherwise.
+ */
+ public static function is_google_pay_express_available() {
+ $google_pay_settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings' );
+
+ $is_express_enable = ! empty( $google_pay_settings['google_pay_express'] ) && 'yes' === $google_pay_settings['google_pay_express'];
+
+ $available_payment_methods = WC()->payment_gateways()->get_available_payment_gateways();
+
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ if ( $checkout_mode === 'classic' ) {
+ /**
+ * If checkout_mode is classic, show express-google-pay if enabled and
+ * if 'wc_checkout_com_google_pay' is an available payment method on checkout.
+ *
+ * Note: On shop/cart pages, gateways might not be "available" yet, so we also
+ * check if the gateway exists in all gateways (not just available ones).
+ */
+ $all_gateways = WC()->payment_gateways()->payment_gateways();
+ $google_pay_exists = isset( $all_gateways['wc_checkout_com_google_pay'] );
+
+ if ( ( isset( $available_payment_methods['wc_checkout_com_google_pay'] ) || $google_pay_exists ) && $is_express_enable ) {
+ return true;
+ }
+ }
+ else {
+ /**
+ * If checkout_mode is flow, show express-google-pay if enabled.
+ */
+ if ( $is_express_enable ) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Check if Apple Pay Express is available.
+ *
+ * @return bool True if Apple Pay Express is available, false otherwise.
+ */
+ public static function is_apple_pay_express_available() {
+ $apple_pay_settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings' );
+
+ $is_express_enable = ! empty( $apple_pay_settings['apple_pay_express'] ) && 'yes' === $apple_pay_settings['apple_pay_express'];
+
+ $available_payment_methods = WC()->payment_gateways()->get_available_payment_gateways();
+
+ $checkout_setting = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ $checkout_mode = isset( $checkout_setting['ckocom_checkout_mode'] ) ? $checkout_setting['ckocom_checkout_mode'] : 'classic';
+
+ if ( $checkout_mode === 'classic' ) {
+ /**
+ * If checkout_mode is classic, show express-apple-pay if enabled and
+ * if 'wc_checkout_com_apple_pay' is an available payment method on checkout.
+ *
+ * Note: On shop/cart pages, gateways might not be "available" yet, so we also
+ * check if the gateway exists in all gateways (not just available ones).
+ */
+ $all_gateways = WC()->payment_gateways()->payment_gateways();
+ $apple_pay_exists = isset( $all_gateways['wc_checkout_com_apple_pay'] );
+
+ if ( ( isset( $available_payment_methods['wc_checkout_com_apple_pay'] ) || $apple_pay_exists ) && $is_express_enable ) {
+ return true;
+ }
+ }
+ else {
+ /**
+ * If checkout_mode is flow, show express-apple-pay if enabled.
+ */
+ if ( $is_express_enable ) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Get express button height from settings.
+ *
+ * @param string $payment_method Payment method: 'apple_pay', 'google_pay', or 'paypal'.
+ * @return array Returns array with 'height' (in pixels or 'native') and 'use_native' (boolean).
+ */
+ public static function get_express_button_height( $payment_method = 'apple_pay' ) {
+ // Map payment method to settings key
+ $settings_key_map = array(
+ 'apple_pay' => 'woocommerce_wc_checkout_com_apple_pay_settings',
+ 'google_pay' => 'woocommerce_wc_checkout_com_google_pay_settings',
+ 'paypal' => 'woocommerce_wc_checkout_com_paypal_settings',
+ );
+
+ $settings_key = isset( $settings_key_map[ $payment_method ] )
+ ? $settings_key_map[ $payment_method ]
+ : 'woocommerce_wc_checkout_com_apple_pay_settings';
+
+ $settings = get_option( $settings_key, array() );
+
+ $size_preset = isset( $settings[ $payment_method . '_express_button_size_preset' ] )
+ ? $settings[ $payment_method . '_express_button_size_preset' ]
+ : 'native';
+
+ // If native, return native
+ if ( 'native' === $size_preset ) {
+ return array(
+ 'height' => 'native',
+ 'use_native' => true,
+ );
+ }
+
+ // Map presets to heights (matching Stripe's approach)
+ $preset_heights = array(
+ 'small' => 40, // Small (40px) - matching Stripe
+ 'default' => 48, // Default (48px) - matching Stripe
+ 'large' => 56, // Large (56px) - matching Stripe
+ );
+
+ // If custom, get custom height
+ if ( 'custom' === $size_preset ) {
+ $custom_height = isset( $settings[ $payment_method . '_express_button_custom_height' ] )
+ ? absint( $settings[ $payment_method . '_express_button_custom_height' ] )
+ : 40;
+
+ // Validate custom height (36-60px)
+ $custom_height = max( 36, min( 60, $custom_height ) );
+
+ return array(
+ 'height' => $custom_height,
+ 'use_native' => false,
+ );
+ }
+
+ // Use preset height
+ $height = isset( $preset_heights[ $size_preset ] ) ? $preset_heights[ $size_preset ] : 40;
+
+ return array(
+ 'height' => $height,
+ 'use_native' => false,
+ );
+ }
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
diff --git a/includes/apms/class-wc-gateway-checkout-com-alternative-payments-klarna.php b/includes/apms/class-wc-gateway-checkout-com-alternative-payments-klarna.php
index 80ad4c1d..fb436656 100644
--- a/includes/apms/class-wc-gateway-checkout-com-alternative-payments-klarna.php
+++ b/includes/apms/class-wc-gateway-checkout-com-alternative-payments-klarna.php
@@ -6,6 +6,10 @@
*/
use Checkout\CheckoutApiException;
+<<<<<<< HEAD
+=======
+use Checkout\CheckoutUtils;
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
/**
* Class WC_Gateway_Checkout_Com_Alternative_Payments_Klarna
@@ -135,9 +139,35 @@ private function create_payment( WC_Order $order, $payment_method ) {
try {
$checkout = new Checkout_SDK();
+<<<<<<< HEAD
$payment_request_param = $checkout->get_payment_request();
$payment_request_param->payment_context_id = $payment_context_id;
$payment_request_param->reference = $order->get_order_number();
+=======
+ // Build metadata for Klarna payment
+ global $wp_version;
+ $woocommerce = WC();
+
+ $udf5 = sprintf(
+ 'Platform Data - WordPress %s / Woocommerce %s, Integration Data - Checkout.com %s, SDK Data - PHP SDK %s, Order ID - %s, Server - %s',
+ $wp_version,
+ $woocommerce->version,
+ WC_CHECKOUTCOM_PLUGIN_VERSION,
+ CheckoutUtils::PROJECT_VERSION,
+ $order->get_order_number(),
+ get_site_url()
+ );
+
+ $metadata = [
+ 'udf5' => $udf5,
+ 'order_id' => $order->get_id(),
+ ];
+
+ $payment_request_param = $checkout->get_payment_request();
+ $payment_request_param->payment_context_id = $payment_context_id;
+ $payment_request_param->reference = $order->get_order_number();
+ $payment_request_param->metadata = $metadata;
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
$response = $checkout->get_builder()->getPaymentsClient()->requestPayment( $payment_request_param );
$response_code = $response['http_metadata']->getStatusCode();
diff --git a/includes/blocks/class-wc-checkoutcom-blocks-admin-notice.php b/includes/blocks/class-wc-checkoutcom-blocks-admin-notice.php
new file mode 100644
index 00000000..7406af57
--- /dev/null
+++ b/includes/blocks/class-wc-checkoutcom-blocks-admin-notice.php
@@ -0,0 +1,111 @@
+
+
+
+
+ id ||
+ 'woocommerce_page_wc-orders' === $screen->id ||
+ 'woocommerce_page_wc-reports' === $screen->id
+ );
+ }
+}
+
+// Initialize the admin notice
+WC_Checkoutcom_Blocks_Admin_Notice::init();
diff --git a/includes/blocks/class-wc-checkoutcom-blocks-integration.php b/includes/blocks/class-wc-checkoutcom-blocks-integration.php
new file mode 100644
index 00000000..b66e412f
--- /dev/null
+++ b/includes/blocks/class-wc-checkoutcom-blocks-integration.php
@@ -0,0 +1,111 @@
+register(
+ new WC_Checkoutcom_Cards_Blocks_Integration()
+ );
+ }
+
+ // Register Checkout.com PayPal
+ if ( class_exists( 'WC_Checkoutcom_PayPal_Blocks_Integration' ) ) {
+ $payment_method_registry->register(
+ new WC_Checkoutcom_PayPal_Blocks_Integration()
+ );
+ }
+
+ // Register Checkout.com Google Pay
+ if ( class_exists( 'WC_Checkoutcom_GooglePay_Blocks_Integration' ) ) {
+ $payment_method_registry->register(
+ new WC_Checkoutcom_GooglePay_Blocks_Integration()
+ );
+ }
+
+ // Register Checkout.com Apple Pay
+ if ( class_exists( 'WC_Checkoutcom_ApplePay_Blocks_Integration' ) ) {
+ $payment_method_registry->register(
+ new WC_Checkoutcom_ApplePay_Blocks_Integration()
+ );
+ }
+
+ // Register Checkout.com Flow (if enabled)
+ if ( class_exists( 'WC_Gateway_Checkout_Com_Flow' ) && class_exists( 'WC_Checkoutcom_Flow_Blocks_Integration' ) ) {
+ $payment_method_registry->register(
+ new WC_Checkoutcom_Flow_Blocks_Integration()
+ );
+ }
+ } catch ( Exception $e ) {
+ // Log error but don't break the site
+ error_log( 'Checkout.com Blocks Integration Error: ' . $e->getMessage() );
+ }
+ }
+}
+
+// Initialize the integration only if WooCommerce is active
+if ( class_exists( 'WooCommerce' ) ) {
+ WC_Checkoutcom_Blocks_Integration::init();
+}
diff --git a/includes/blocks/payment-methods/class-wc-checkoutcom-applepay-blocks.php b/includes/blocks/payment-methods/class-wc-checkoutcom-applepay-blocks.php
new file mode 100644
index 00000000..5e2da7ba
--- /dev/null
+++ b/includes/blocks/payment-methods/class-wc-checkoutcom-applepay-blocks.php
@@ -0,0 +1,98 @@
+settings = get_option( 'woocommerce_wc_checkout_com_apple_pay_settings', [] );
+ }
+
+ /**
+ * Returns if this payment method should be active.
+ *
+ * @return boolean
+ */
+ public function is_active() {
+ return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled'];
+ }
+
+ /**
+ * Returns an array of scripts/handles to be registered for this payment method.
+ *
+ * @return array
+ */
+ public function get_payment_method_script_handles() {
+ $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/applepay-blocks.asset.php';
+ $version = WC_CHECKOUTCOM_PLUGIN_VERSION;
+ $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ];
+
+ if ( file_exists( $asset_path ) ) {
+ $asset = require $asset_path;
+ $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version;
+ $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies;
+ }
+
+ wp_register_script(
+ 'wc-checkoutcom-applepay-blocks',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/applepay-blocks.js',
+ $dependencies,
+ $version,
+ true
+ );
+
+ return [ 'wc-checkoutcom-applepay-blocks' ];
+ }
+
+ /**
+ * Returns an array of key=>value pairs of data made available to the payment methods script.
+ *
+ * @return array
+ */
+ public function get_payment_method_data() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] );
+ $environment = 'sandbox' === ( $core_settings['ckocom_environment'] ?? 'sandbox' );
+
+ return [
+ 'title' => $this->get_setting( 'title' ),
+ 'description' => $this->get_setting( 'description' ),
+ 'supports' => $this->get_supported_features(),
+ 'environment' => $environment ? 'TEST' : 'PRODUCTION',
+ 'public_key' => $core_settings['ckocom_pk'] ?? '',
+ 'merchant_id' => $this->get_setting( 'ckocom_apple_merchant_id' ),
+ 'currency' => get_woocommerce_currency(),
+ ];
+ }
+
+ /**
+ * Returns an array of supported features.
+ *
+ * @return string[]
+ */
+ public function get_supported_features() {
+ return apply_filters( 'wc_checkoutcom_applepay_supported_features', [
+ 'products',
+ 'refunds',
+ ] );
+ }
+}
diff --git a/includes/blocks/payment-methods/class-wc-checkoutcom-cards-blocks.php b/includes/blocks/payment-methods/class-wc-checkoutcom-cards-blocks.php
new file mode 100644
index 00000000..edfc231b
--- /dev/null
+++ b/includes/blocks/payment-methods/class-wc-checkoutcom-cards-blocks.php
@@ -0,0 +1,113 @@
+settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] );
+ }
+
+ /**
+ * Returns if this payment method should be active.
+ *
+ * @return boolean
+ */
+ public function is_active() {
+ return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled'];
+ }
+
+ /**
+ * Returns an array of scripts/handles to be registered for this payment method.
+ *
+ * @return array
+ */
+ public function get_payment_method_script_handles() {
+ $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/index.asset.php';
+ $version = WC_CHECKOUTCOM_PLUGIN_VERSION;
+ $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ];
+
+ if ( file_exists( $asset_path ) ) {
+ $asset = require $asset_path;
+ $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version;
+ $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies;
+ }
+
+ wp_register_script(
+ 'wc-checkoutcom-cards-blocks',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/cards-blocks.js',
+ $dependencies,
+ $version,
+ true
+ );
+
+ return [ 'wc-checkoutcom-cards-blocks' ];
+ }
+
+ /**
+ * Returns an array of key=>value pairs of data made available to the payment methods script.
+ *
+ * @return array
+ */
+ public function get_payment_method_data() {
+ return [
+ 'title' => $this->get_setting( 'title' ),
+ 'description' => $this->get_setting( 'description' ),
+ 'supports' => $this->get_supported_features(),
+ 'environment' => $this->get_setting( 'ckocom_environment' ),
+ 'public_key' => $this->get_setting( 'ckocom_pk' ),
+ 'checkout_mode' => $this->get_setting( 'ckocom_checkout_mode' ),
+ ];
+ }
+
+ /**
+ * Returns an array of supported features.
+ *
+ * @return string[]
+ */
+ public function get_supported_features() {
+ return apply_filters( 'wc_checkoutcom_cards_supported_features', [
+ 'products',
+ 'refunds',
+ ] );
+ }
+}
diff --git a/includes/blocks/payment-methods/class-wc-checkoutcom-flow-blocks.php b/includes/blocks/payment-methods/class-wc-checkoutcom-flow-blocks.php
new file mode 100644
index 00000000..665a52c9
--- /dev/null
+++ b/includes/blocks/payment-methods/class-wc-checkoutcom-flow-blocks.php
@@ -0,0 +1,99 @@
+settings = get_option( 'woocommerce_wc_checkout_com_flow_settings', [] );
+ }
+
+ /**
+ * Returns if this payment method should be active.
+ *
+ * @return boolean
+ */
+ public function is_active() {
+ return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled'];
+ }
+
+ /**
+ * Returns an array of scripts/handles to be registered for this payment method.
+ *
+ * @return array
+ */
+ public function get_payment_method_script_handles() {
+ $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/flow-blocks.asset.php';
+ $version = WC_CHECKOUTCOM_PLUGIN_VERSION;
+ $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ];
+
+ if ( file_exists( $asset_path ) ) {
+ $asset = require $asset_path;
+ $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version;
+ $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies;
+ }
+
+ wp_register_script(
+ 'wc-checkoutcom-flow-blocks',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/flow-blocks.js',
+ $dependencies,
+ $version,
+ true
+ );
+
+ return [ 'wc-checkoutcom-flow-blocks' ];
+ }
+
+ /**
+ * Returns an array of key=>value pairs of data made available to the payment methods script.
+ *
+ * @return array
+ */
+ public function get_payment_method_data() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] );
+ $environment = 'sandbox' === ( $core_settings['ckocom_environment'] ?? 'sandbox' );
+
+ return [
+ 'title' => $this->get_setting( 'title' ),
+ 'description' => $this->get_setting( 'description' ),
+ 'supports' => $this->get_supported_features(),
+ 'environment' => $environment ? 'TEST' : 'PRODUCTION',
+ 'public_key' => $core_settings['ckocom_pk'] ?? '',
+ 'currency' => get_woocommerce_currency(),
+ 'enabled_payment_methods' => $this->get_setting( 'flow_enabled_payment_methods', [] ),
+ 'saved_payment_display_order' => $this->get_setting( 'saved_payment_display_order', 'saved_cards_first' ),
+ ];
+ }
+
+ /**
+ * Returns an array of supported features.
+ *
+ * @return string[]
+ */
+ public function get_supported_features() {
+ return apply_filters( 'wc_checkoutcom_flow_supported_features', [
+ 'products',
+ 'refunds',
+ ] );
+ }
+}
diff --git a/includes/blocks/payment-methods/class-wc-checkoutcom-googlepay-blocks.php b/includes/blocks/payment-methods/class-wc-checkoutcom-googlepay-blocks.php
new file mode 100644
index 00000000..cfe5486b
--- /dev/null
+++ b/includes/blocks/payment-methods/class-wc-checkoutcom-googlepay-blocks.php
@@ -0,0 +1,99 @@
+settings = get_option( 'woocommerce_wc_checkout_com_google_pay_settings', [] );
+ }
+
+ /**
+ * Returns if this payment method should be active.
+ *
+ * @return boolean
+ */
+ public function is_active() {
+ return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled'];
+ }
+
+ /**
+ * Returns an array of scripts/handles to be registered for this payment method.
+ *
+ * @return array
+ */
+ public function get_payment_method_script_handles() {
+ $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/googlepay-blocks.asset.php';
+ $version = WC_CHECKOUTCOM_PLUGIN_VERSION;
+ $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ];
+
+ if ( file_exists( $asset_path ) ) {
+ $asset = require $asset_path;
+ $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version;
+ $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies;
+ }
+
+ wp_register_script(
+ 'wc-checkoutcom-googlepay-blocks',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/googlepay-blocks.js',
+ $dependencies,
+ $version,
+ true
+ );
+
+ return [ 'wc-checkoutcom-googlepay-blocks' ];
+ }
+
+ /**
+ * Returns an array of key=>value pairs of data made available to the payment methods script.
+ *
+ * @return array
+ */
+ public function get_payment_method_data() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] );
+ $environment = 'sandbox' === ( $core_settings['ckocom_environment'] ?? 'sandbox' );
+
+ return [
+ 'title' => $this->get_setting( 'title' ),
+ 'description' => $this->get_setting( 'description' ),
+ 'supports' => $this->get_supported_features(),
+ 'environment' => $environment ? 'TEST' : 'PRODUCTION',
+ 'public_key' => $core_settings['ckocom_pk'] ?? '',
+ 'merchant_id' => $this->get_setting( 'ckocom_google_merchant_id' ),
+ 'currency' => get_woocommerce_currency(),
+ 'button_type' => $this->get_setting( 'ckocom_google_style', 'google-pay-black' ),
+ ];
+ }
+
+ /**
+ * Returns an array of supported features.
+ *
+ * @return string[]
+ */
+ public function get_supported_features() {
+ return apply_filters( 'wc_checkoutcom_googlepay_supported_features', [
+ 'products',
+ 'refunds',
+ ] );
+ }
+}
diff --git a/includes/blocks/payment-methods/class-wc-checkoutcom-paypal-blocks.php b/includes/blocks/payment-methods/class-wc-checkoutcom-paypal-blocks.php
new file mode 100644
index 00000000..36bfddbb
--- /dev/null
+++ b/includes/blocks/payment-methods/class-wc-checkoutcom-paypal-blocks.php
@@ -0,0 +1,99 @@
+settings = get_option( 'woocommerce_wc_checkout_com_paypal_settings', [] );
+ }
+
+ /**
+ * Returns if this payment method should be active.
+ *
+ * @return boolean
+ */
+ public function is_active() {
+ return ! empty( $this->settings['enabled'] ) && 'yes' === $this->settings['enabled'];
+ }
+
+ /**
+ * Returns an array of scripts/handles to be registered for this payment method.
+ *
+ * @return array
+ */
+ public function get_payment_method_script_handles() {
+ $asset_path = WC_CHECKOUTCOM_PLUGIN_PATH . '/build/paypal-blocks.asset.php';
+ $version = WC_CHECKOUTCOM_PLUGIN_VERSION;
+ $dependencies = [ 'wc-blocks-registry', 'wc-settings', 'wp-element', 'wp-html-entities' ];
+
+ if ( file_exists( $asset_path ) ) {
+ $asset = require $asset_path;
+ $version = is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : $version;
+ $dependencies = is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : $dependencies;
+ }
+
+ wp_register_script(
+ 'wc-checkoutcom-paypal-blocks',
+ WC_CHECKOUTCOM_PLUGIN_URL . '/assets/js/blocks/paypal-blocks.js',
+ $dependencies,
+ $version,
+ true
+ );
+
+ return [ 'wc-checkoutcom-paypal-blocks' ];
+ }
+
+ /**
+ * Returns an array of key=>value pairs of data made available to the payment methods script.
+ *
+ * @return array
+ */
+ public function get_payment_method_data() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings', [] );
+ $environment = 'sandbox' === ( $core_settings['ckocom_environment'] ?? 'sandbox' );
+
+ return [
+ 'title' => $this->get_setting( 'title' ),
+ 'description' => $this->get_setting( 'description' ),
+ 'supports' => $this->get_supported_features(),
+ 'environment' => $environment ? 'TEST' : 'PRODUCTION',
+ 'public_key' => $core_settings['ckocom_pk'] ?? '',
+ 'merchant_id' => $this->get_setting( 'ckocom_paypal_merchant_id' ),
+ 'currency' => get_woocommerce_currency(),
+ 'express_enabled' => $this->get_setting( 'paypal_express' ) === 'yes',
+ ];
+ }
+
+ /**
+ * Returns an array of supported features.
+ *
+ * @return string[]
+ */
+ public function get_supported_features() {
+ return apply_filters( 'wc_checkoutcom_paypal_supported_features', [
+ 'products',
+ 'refunds',
+ ] );
+ }
+}
diff --git a/includes/class-wc-checkout-com-webhook-queue.php b/includes/class-wc-checkout-com-webhook-queue.php
new file mode 100644
index 00000000..c92fad35
--- /dev/null
+++ b/includes/class-wc-checkout-com-webhook-queue.php
@@ -0,0 +1,398 @@
+prefix . 'cko_pending_webhooks';
+ }
+
+ /**
+ * Create the pending webhooks table.
+ *
+ * @return void
+ */
+ public static function create_table() {
+ global $wpdb;
+ $table_name = self::get_table_name();
+ $charset_collate = $wpdb->get_charset_collate();
+
+ $sql = "CREATE TABLE IF NOT EXISTS {$table_name} (
+ id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
+ payment_id VARCHAR(255) NOT NULL,
+ order_id VARCHAR(50) NULL,
+ payment_session_id VARCHAR(255) NULL,
+ webhook_type VARCHAR(50) NOT NULL,
+ webhook_data LONGTEXT NOT NULL,
+ created_at DATETIME NOT NULL,
+ processed_at DATETIME NULL,
+ INDEX idx_payment_id (payment_id),
+ INDEX idx_order_id (order_id),
+ INDEX idx_payment_session_id (payment_session_id),
+ INDEX idx_processed (processed_at),
+ INDEX idx_created (created_at)
+ ) {$charset_collate};";
+
+ require_once ABSPATH . 'wp-admin/includes/upgrade.php';
+ dbDelta( $sql );
+ }
+
+ /**
+ * Check if webhook debug logging is enabled.
+ *
+ * @return bool
+ */
+ private static function is_webhook_debug_enabled() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ return ( isset( $core_settings['cko_gateway_responses'] ) && $core_settings['cko_gateway_responses'] === 'yes' );
+ }
+
+ /**
+ * Save a pending webhook to the queue.
+ *
+ * @param string $payment_id Payment ID from Checkout.com.
+ * @param string|null $order_id Order ID (may be null for Flow payments).
+ * @param string|null $payment_session_id Payment session ID (may be null).
+ * @param string $webhook_type Webhook type ('payment_approved' or 'payment_captured').
+ * @param object $webhook_data Full webhook payload.
+ * @return bool True if saved successfully, false otherwise.
+ */
+ public static function save_pending_webhook( $payment_id, $order_id, $payment_session_id, $webhook_type, $webhook_data ) {
+ global $wpdb;
+ $table_name = self::get_table_name();
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Attempting to queue webhook - Type: ' . $webhook_type . ', Payment ID: ' . $payment_id . ', Order ID: ' . ( $order_id ?? 'NULL' ) . ', Session ID: ' . ( $payment_session_id ?? 'NULL' ) );
+ }
+
+ // Validate webhook type (only auth and capture)
+ if ( ! in_array( $webhook_type, array( 'payment_approved', 'payment_captured' ), true ) ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Invalid webhook type for queuing: ' . $webhook_type );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (FAILED - Invalid Type) ===' );
+ }
+ return false;
+ }
+
+ // Validate payment_id (required)
+ if ( empty( $payment_id ) ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Cannot queue webhook - payment_id is required' );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (FAILED - Missing Payment ID) ===' );
+ }
+ return false;
+ }
+
+ // Encode webhook data as JSON
+ $webhook_data_json = wp_json_encode( $webhook_data );
+ if ( false === $webhook_data_json ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Failed to encode webhook data as JSON' );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (FAILED - JSON Encode Error) ===' );
+ }
+ return false;
+ }
+
+ // Sanitize inputs
+ $payment_id = sanitize_text_field( $payment_id );
+ $order_id = ! empty( $order_id ) ? sanitize_text_field( $order_id ) : null;
+ $payment_session_id = ! empty( $payment_session_id ) ? sanitize_text_field( $payment_session_id ) : null;
+ $webhook_type = sanitize_text_field( $webhook_type );
+
+ $result = $wpdb->insert(
+ $table_name,
+ array(
+ 'payment_id' => $payment_id,
+ 'order_id' => $order_id,
+ 'payment_session_id' => $payment_session_id,
+ 'webhook_type' => $webhook_type,
+ 'webhook_data' => $webhook_data_json,
+ 'created_at' => current_time( 'mysql' ),
+ 'processed_at' => null,
+ ),
+ array(
+ '%s', // payment_id
+ '%s', // order_id
+ '%s', // payment_session_id
+ '%s', // webhook_type
+ '%s', // webhook_data
+ '%s', // created_at
+ null, // processed_at
+ )
+ );
+
+ if ( false === $result ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Failed to save webhook to queue - ' . $wpdb->last_error );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (FAILED - Database Error) ===' );
+ }
+ return false;
+ }
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Successfully queued webhook - Queue ID: ' . $wpdb->insert_id . ', Type: ' . $webhook_type . ', Payment ID: ' . $payment_id );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: save_pending_webhook END (SUCCESS) ===' );
+ } else {
+ // Always log successful queue operations (even if debug disabled)
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Webhook queued successfully - Type: ' . $webhook_type . ', Payment ID: ' . $payment_id . ', Order ID: ' . ( $order_id ?? 'NULL' ) );
+ }
+
+ return true;
+ }
+
+ /**
+ * Get pending webhooks for an order.
+ *
+ * @param WC_Order $order WooCommerce order object.
+ * @return array Array of pending webhook objects.
+ */
+ public static function get_pending_webhooks_for_order( $order ) {
+ global $wpdb;
+ $table_name = self::get_table_name();
+
+ $payment_id = $order->get_meta( '_cko_payment_id' );
+ $payment_session_id = $order->get_meta( '_cko_payment_session_id' );
+ $order_id = $order->get_id();
+
+ // Build WHERE clause with priority: payment_id > payment_session_id > order_id
+ $where_conditions = array();
+ $where_values = array();
+
+ if ( ! empty( $payment_id ) ) {
+ $where_conditions[] = 'payment_id = %s';
+ $where_values[] = $payment_id;
+ }
+
+ if ( ! empty( $payment_session_id ) ) {
+ $where_conditions[] = 'payment_session_id = %s';
+ $where_values[] = $payment_session_id;
+ }
+
+ if ( ! empty( $order_id ) ) {
+ $where_conditions[] = 'order_id = %s';
+ $where_values[] = (string) $order_id;
+ }
+
+ // If no identifiers available, return empty array
+ if ( empty( $where_conditions ) ) {
+ return array();
+ }
+
+ $where_clause = '(' . implode( ' OR ', $where_conditions ) . ') AND processed_at IS NULL';
+
+ $query = "SELECT * FROM {$table_name}
+ WHERE {$where_clause}
+ ORDER BY
+ CASE webhook_type
+ WHEN 'payment_approved' THEN 1
+ WHEN 'payment_captured' THEN 2
+ ELSE 3
+ END,
+ created_at ASC";
+
+ if ( ! empty( $where_values ) ) {
+ $query = $wpdb->prepare( $query, $where_values );
+ }
+
+ $results = $wpdb->get_results( $query );
+
+ return $results ? $results : array();
+ }
+
+ /**
+ * Process pending webhooks for an order.
+ *
+ * @param WC_Order $order WooCommerce order object.
+ * @return int Number of webhooks processed.
+ */
+ public static function process_pending_webhooks_for_order( $order ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+ $pending_webhooks = self::get_pending_webhooks_for_order( $order );
+
+ if ( empty( $pending_webhooks ) ) {
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: No pending webhooks found for Order ID: ' . $order->get_id() );
+ }
+ return 0;
+ }
+
+ $order_id = $order->get_id();
+ $processed_count = 0;
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: process_pending_webhooks_for_order START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Found ' . count( $pending_webhooks ) . ' pending webhook(s) for Order ID: ' . $order_id );
+ } else {
+ // Always log when processing queued webhooks (even if debug disabled)
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Processing ' . count( $pending_webhooks ) . ' pending webhook(s) for Order ID: ' . $order_id );
+ }
+
+ foreach ( $pending_webhooks as $queued_webhook ) {
+ // Decode webhook data
+ $webhook_data = json_decode( $queued_webhook->webhook_data );
+
+ if ( ! $webhook_data ) {
+ WC_Checkoutcom_Utility::logger(
+ 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Failed to decode webhook data for queued webhook ID: ' . $queued_webhook->id
+ );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Skipping webhook ID: ' . $queued_webhook->id . ' due to decode error' );
+ }
+ continue;
+ }
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Processing queued webhook - Queue ID: ' . $queued_webhook->id . ', Type: ' . $queued_webhook->webhook_type . ', Payment ID: ' . $queued_webhook->payment_id );
+ }
+
+ // Ensure order_id is set in metadata for processing functions
+ if ( ! isset( $webhook_data->data->metadata ) ) {
+ $webhook_data->data->metadata = new stdClass();
+ }
+ $webhook_data->data->metadata->order_id = $order_id;
+
+ // Process webhook based on type
+ $success = false;
+ if ( 'payment_approved' === $queued_webhook->webhook_type ) {
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Calling authorize_payment() for queued webhook' );
+ }
+ $success = WC_Checkout_Com_Webhook::authorize_payment( $webhook_data );
+ } elseif ( 'payment_captured' === $queued_webhook->webhook_type ) {
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Calling capture_payment() for queued webhook' );
+ }
+ $success = WC_Checkout_Com_Webhook::capture_payment( $webhook_data );
+ }
+
+ if ( $success ) {
+ // Mark as processed
+ global $wpdb;
+ $table_name = self::get_table_name();
+ $wpdb->update(
+ $table_name,
+ array( 'processed_at' => current_time( 'mysql' ) ),
+ array( 'id' => $queued_webhook->id ),
+ array( '%s' ),
+ array( '%d' )
+ );
+
+ $processed_count++;
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger(
+ 'WEBHOOK PROCESS: WEBHOOK QUEUE: Successfully processed queued webhook - ' .
+ 'Queue ID: ' . $queued_webhook->id . ', ' .
+ 'Order ID: ' . $order_id . ', ' .
+ 'Type: ' . $queued_webhook->webhook_type . ', ' .
+ 'Payment ID: ' . $queued_webhook->payment_id
+ );
+ } else {
+ // Always log successful processing (even if debug disabled)
+ WC_Checkoutcom_Utility::logger(
+ 'WEBHOOK PROCESS: WEBHOOK QUEUE: Successfully processed queued webhook - ' .
+ 'Order ID: ' . $order_id . ', ' .
+ 'Type: ' . $queued_webhook->webhook_type . ', ' .
+ 'Payment ID: ' . $queued_webhook->payment_id
+ );
+ }
+ } else {
+ WC_Checkoutcom_Utility::logger(
+ 'WEBHOOK PROCESS: WEBHOOK QUEUE: ERROR - Failed to process queued webhook - ' .
+ 'Queue ID: ' . $queued_webhook->id . ', ' .
+ 'Order ID: ' . $order_id . ', ' .
+ 'Type: ' . $queued_webhook->webhook_type . ', ' .
+ 'Payment ID: ' . $queued_webhook->payment_id . ' - ' .
+ 'Will remain in queue for retry'
+ );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Webhook processing returned false - check webhook handler logs for details' );
+ }
+ }
+ }
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Processed ' . $processed_count . ' of ' . count( $pending_webhooks ) . ' queued webhook(s) for Order ID: ' . $order_id );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: === WEBHOOK QUEUE: process_pending_webhooks_for_order END ===' );
+ } else {
+ // Always log summary (even if debug disabled)
+ if ( $processed_count > 0 ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: WEBHOOK QUEUE: Completed processing - ' . $processed_count . ' webhook(s) processed successfully for Order ID: ' . $order_id );
+ }
+ }
+
+ return $processed_count;
+ }
+
+ /**
+ * Cleanup old processed webhooks.
+ *
+ * @param int $days Number of days to keep processed webhooks (default 7).
+ * @return int Number of webhooks deleted.
+ */
+ public static function cleanup_old_webhooks( $days = 7 ) {
+ global $wpdb;
+ $table_name = self::get_table_name();
+
+ $cutoff_date = date( 'Y-m-d H:i:s', strtotime( "-{$days} days" ) );
+
+ $deleted = $wpdb->query(
+ $wpdb->prepare(
+ "DELETE FROM {$table_name} WHERE processed_at IS NOT NULL AND processed_at < %s",
+ $cutoff_date
+ )
+ );
+
+ if ( false !== $deleted ) {
+ WC_Checkoutcom_Utility::logger( "WEBHOOK QUEUE: Cleaned up {$deleted} old processed webhook(s) older than {$days} days" );
+ }
+
+ return $deleted ? $deleted : 0;
+ }
+
+ /**
+ * Cleanup old unprocessed webhooks (orphaned webhooks).
+ *
+ * @param int $days Number of days to keep unprocessed webhooks (default 7).
+ * @return int Number of webhooks deleted.
+ */
+ public static function cleanup_old_unprocessed_webhooks( $days = 7 ) {
+ global $wpdb;
+ $table_name = self::get_table_name();
+
+ $cutoff_date = date( 'Y-m-d H:i:s', strtotime( "-{$days} days" ) );
+
+ $deleted = $wpdb->query(
+ $wpdb->prepare(
+ "DELETE FROM {$table_name} WHERE processed_at IS NULL AND created_at < %s",
+ $cutoff_date
+ )
+ );
+
+ if ( false !== $deleted ) {
+ WC_Checkoutcom_Utility::logger( "WEBHOOK QUEUE: Cleaned up {$deleted} old unprocessed webhook(s) older than {$days} days" );
+ }
+
+ return $deleted ? $deleted : 0;
+ }
+}
+
+
+
+
diff --git a/includes/class-wc-checkout-com-webhook.php b/includes/class-wc-checkout-com-webhook.php
index 61f5d39c..59a2ac9a 100644
--- a/includes/class-wc-checkout-com-webhook.php
+++ b/includes/class-wc-checkout-com-webhook.php
@@ -12,6 +12,16 @@
*/
class WC_Checkout_Com_Webhook {
+ /**
+ * Check if webhook debug logging is enabled.
+ *
+ * @return bool
+ */
+ private static function is_webhook_debug_enabled() {
+ $core_settings = get_option( 'woocommerce_wc_checkout_com_cards_settings' );
+ return ( isset( $core_settings['cko_gateway_responses'] ) && $core_settings['cko_gateway_responses'] === 'yes' );
+ }
+
/**
* Process webhook for authorize payment.
*
@@ -20,44 +30,128 @@ class WC_Checkout_Com_Webhook {
* @return boolean
*/
public static function authorize_payment( $data ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: authorize_payment START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_approved' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) );
+ }
+
$webhook_data = $data->data;
- $order_id = $webhook_data->metadata->order_id;
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Webhook data extracted: ' . print_r($webhook_data, true) );
+ }
+
+ $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null;
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Reference: ' . ($webhook_data->reference ?? 'NULL') );
+
+ // Log all available metadata
+ if (isset($webhook_data->metadata)) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: All metadata: ' . print_r($webhook_data->metadata, true) );
+ }
+ }
// Return false if no order id.
- if ( empty( $order_id ) ) {
+ if ( empty( $order_id ) || ! is_numeric( $order_id ) ) {
+ // Always log errors, even if debug is disabled
+ WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: Order ID type: " . gettype($order_id) );
+ WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: Order ID is_numeric: " . (is_numeric($order_id) ? 'YES' : 'NO') );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: authorize_payment END (FAILED - Invalid Order ID) ===' );
+ }
return false;
}
// Load order form order id.
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id );
+ }
$order = self::get_wc_order( $order_id );
+
+ if ( ! $order ) {
+ // Always log errors, even if debug is disabled
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: authorize_payment END (FAILED - Order Not Found) ===' );
+ }
+ return false;
+ }
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() );
+ }
$already_captured = $order->get_meta( 'cko_payment_captured' );
+ $current_status = $order->get_status();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Current order status: ' . $current_status );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Already captured: ' . ( $already_captured ? 'YES' : 'NO' ) );
+ }
+
+ $payment_id = $webhook_data->id;
+ $action_id = $webhook_data->action_id;
+ $message = sprintf( 'Webhook received from checkout.com. Payment Authorized - Payment ID: %s, Action ID: %s', $payment_id, $action_id );
+ // CRITICAL: Check if already captured FIRST (most important check)
+ // Don't update status if already captured (even if not authorized yet)
+ // This prevents downgrading from processing back to on-hold
if ( $already_captured ) {
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Payment already captured, skipping status update to prevent downgrade' );
+ }
+ // Payment already captured - just add note and update meta, don't change status
+ $order->set_transaction_id( $action_id );
+ $order->update_meta_data( '_cko_payment_id', $payment_id );
+ $order->update_meta_data( 'cko_payment_authorized', true );
+ $order->add_order_note( $message );
return true;
}
$already_authorized = $order->get_meta( 'cko_payment_authorized' );
$auth_status = WC_Admin_Settings::get_option( 'ckocom_order_authorised', 'on-hold' );
- $message = 'Webhook received from checkout.com. Payment Authorized';
- // Add note to order if Authorized already.
+ // Don't update status if already authorized AND status matches
if ( $already_authorized && $order->get_status() === $auth_status ) {
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Already authorized with matching status, adding note only' );
+ }
$order->add_order_note( $message );
return true;
}
- // Get action id from webhook data.
- $action_id = $webhook_data->action_id;
+ // Don't update status if order is already in a more advanced state (processing, completed)
+ // This prevents race conditions where capture webhook updated status but meta not saved yet
+ if ( in_array( $current_status, array( 'processing', 'completed' ), true ) ) {
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: authorize_payment - Order already in advanced state (' . $current_status . '), skipping status update to prevent downgrade' );
+ }
+ // Order is already processing/completed - don't downgrade to on-hold
+ // Just add note and update meta, but don't change status
+ $order->set_transaction_id( $action_id );
+ $order->update_meta_data( '_cko_payment_id', $payment_id );
+ $order->update_meta_data( 'cko_payment_authorized', true );
+ $order->add_order_note( $message );
+ return true;
+ }
// Set action id as woo transaction id.
$order->set_transaction_id( $action_id );
- $order->update_meta_data( '_cko_payment_id', $webhook_data->id );
+ $order->update_meta_data( '_cko_payment_id', $payment_id );
$order->update_meta_data( 'cko_payment_authorized', true );
$order->add_order_note( $message );
$order->update_status( $auth_status );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $auth_status );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: authorize_payment END (SUCCESS) ===' );
+ }
return true;
}
@@ -69,19 +163,55 @@ public static function authorize_payment( $data ) {
* @return bool
*/
public static function card_verified( $data ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: card_verified START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: card_verified' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) );
+ }
+
$webhook_data = $data->data;
- $order_id = $webhook_data->metadata->order_id;
- $action_id = $webhook_data->action_id;
+ $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null;
+ $action_id = isset($webhook_data->action_id) ? $webhook_data->action_id : null;
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Action ID: ' . ($action_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') );
+ }
// Return false if no order id.
- if ( empty( $order_id ) ) {
+ if ( empty( $order_id ) || ! is_numeric( $order_id ) ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: card_verified END (FAILED - Invalid Order ID) ===' );
+ }
return false;
}
// Load order form order id.
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id );
+ }
$order = self::get_wc_order( $order_id );
+
+ if ( ! $order ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: card_verified END (FAILED - Order Not Found) ===' );
+ }
+ return false;
+ }
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() );
+ }
- $order->add_order_note( __( 'Checkout.com Card verified webhook received', 'checkout-com-unified-payments-api' ) );
+ $payment_id = $webhook_data->id;
+ $order->add_order_note( sprintf( __( 'Checkout.com Card verified webhook received - Payment ID: %s, Action ID: %s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id ) );
// Set action id as woo transaction id.
$order->set_transaction_id( $action_id );
@@ -91,6 +221,10 @@ public static function card_verified( $data ) {
// update status of the order.
$order->update_status( $status );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: card_verified END (SUCCESS) ===' );
+ }
return true;
}
@@ -102,31 +236,75 @@ public static function card_verified( $data ) {
* @return bool
*/
public static function capture_payment( $data ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_payment START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_captured' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) );
+ }
+
$webhook_data = $data->data;
- $order_id = $webhook_data->metadata->order_id;
+ $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null;
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Amount: ' . (isset($webhook_data->amount) ? $webhook_data->amount : 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Action ID: ' . (isset($webhook_data->action_id) ? $webhook_data->action_id : 'NULL') );
+ }
// Return false if no order id.
- if ( empty( $order_id ) ) {
+ if ( empty( $order_id ) || ! is_numeric( $order_id ) ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_payment END (FAILED - Invalid Order ID) ===' );
+ }
return false;
}
// Load order form order id.
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id );
+ }
$order = self::get_wc_order( $order_id );
+
+ if ( ! $order ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_payment END (FAILED - Order Not Found) ===' );
+ }
+ return false;
+ }
+
$order_id = $order->get_id();
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order_id . ', Status: ' . $order->get_status() );
+ }
// Check if payment is already captured.
$already_captured = $order->get_meta( 'cko_payment_captured' );
- $message = 'Webhook received from checkout.com Payment captured';
+ $payment_id = $webhook_data->id;
+
+ // Get action id from webhook data.
+ $action_id = $webhook_data->action_id;
+ $amount = $webhook_data->amount;
+ $order_amount = $order->get_total();
+ $order_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $order_amount, $order->get_currency() );
+
+ $message = sprintf( 'Webhook received from checkout.com Payment captured - Payment ID: %s, Action ID: %s', $payment_id, $action_id );
$already_authorized = $order->get_meta( 'cko_payment_authorized' );
- /**
- * We return false here as payment approved webhook is not yet delivered
- * Gateway will retry sending the captured webhook.
- */
+ // If not already authorized, set it now (capture implies authorization)
+ // This handles cases where capture webhook arrives before auth webhook
if ( ! $already_authorized ) {
- WC_Checkoutcom_Utility::logger( 'Payment approved webhook not received yet : ' . $order_id, null );
- return false;
+ $order->update_meta_data( 'cko_payment_authorized', true );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Capture webhook arrived before auth - setting authorization status automatically for order: ' . $order_id );
+ }
}
// Add note to order if captured already.
@@ -135,13 +313,7 @@ public static function capture_payment( $data ) {
return true;
}
- $order->add_order_note( __( 'Checkout.com Payment Capture webhook received', 'checkout-com-unified-payments-api' ) );
-
- // Get action id from webhook data.
- $action_id = $webhook_data->action_id;
- $amount = $webhook_data->amount;
- $order_amount = $order->get_total();
- $order_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $order_amount, $order->get_currency() );
+ $order->add_order_note( sprintf( __( 'Checkout.com Payment Capture webhook received - Payment ID: %s', 'checkout-com-unified-payments-api' ), $payment_id ) );
// Set action id as woo transaction id.
$order->set_transaction_id( $action_id );
@@ -150,19 +322,23 @@ public static function capture_payment( $data ) {
// Get cko capture status configured in admin.
$status = WC_Admin_Settings::get_option( 'ckocom_order_captured', 'processing' );
- /* translators: %s: Action ID. */
- $order_message = sprintf( esc_html__( 'Checkout.com Payment Captured - Action ID : %s', 'checkout-com-unified-payments-api' ), $action_id );
+ /* translators: %1$s: Payment ID, %2$s: Action ID. */
+ $order_message = sprintf( esc_html__( 'Checkout.com Payment Captured - Payment ID: %1$s, Action ID: %2$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id );
// Check if webhook amount is less than order amount.
if ( $amount < $order_amount_cents ) {
- /* translators: %s: Action ID. */
- $order_message = sprintf( esc_html__( 'Checkout.com Payment partially captured - Action ID : %s', 'checkout-com-unified-payments-api' ), $action_id );
+ /* translators: %1$s: Payment ID, %2$s: Action ID. */
+ $order_message = sprintf( esc_html__( 'Checkout.com Payment partially captured - Payment ID: %1$s, Action ID: %2$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id );
}
// add notes for the order and update status.
$order->add_order_note( $order_message );
$order->update_status( $status );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_payment END (SUCCESS) ===' );
+ }
return true;
}
@@ -174,22 +350,70 @@ public static function capture_payment( $data ) {
* @return bool
*/
public static function capture_declined( $data ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_declined START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_capture_declined' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) );
+ }
+
$webhook_data = $data->data;
- $order_id = $webhook_data->metadata->order_id;
+ $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null;
+ $payment_id = isset($webhook_data->id) ? $webhook_data->id : null;
+ $action_id = isset($webhook_data->action_id) ? $webhook_data->action_id : null;
+ $response_summary = isset($webhook_data->response_summary) ? $webhook_data->response_summary : 'N/A';
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($payment_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Action ID: ' . ($action_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Response summary: ' . $response_summary );
+ }
// Return false if no order id.
- if ( empty( $order_id ) ) {
+ if ( empty( $order_id ) || ! is_numeric( $order_id ) ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_declined END (FAILED - Invalid Order ID) ===' );
+ }
return false;
}
// Load order form order id.
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id );
+ }
$order = self::get_wc_order( $order_id );
+
+ if ( ! $order ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_declined END (FAILED - Order Not Found) ===' );
+ }
+ return false;
+ }
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() );
+ }
- $message = 'Webhook received from checkout.com. Payment capture declined. Reason : ' . $webhook_data->response_summary;
+ // Include Payment ID and Action ID (if available) in the order note for consistency with other webhook handlers
+ if ( ! empty( $action_id ) ) {
+ $message = sprintf( 'Webhook received from checkout.com. Payment capture declined - Payment ID: %s, Action ID: %s, Reason: %s', $payment_id, $action_id, $response_summary );
+ } else {
+ $message = sprintf( 'Webhook received from checkout.com. Payment capture declined - Payment ID: %s, Reason: %s', $payment_id, $response_summary );
+ }
// Add note to order if capture declined.
$order->add_order_note( $message );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Capture declined note added to order' );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: capture_declined END (SUCCESS) ===' );
+ }
return true;
}
@@ -201,21 +425,60 @@ public static function capture_declined( $data ) {
* @return bool
*/
public static function void_payment( $data ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_voided' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) );
+ }
+
$webhook_data = $data->data;
- $order_id = $webhook_data->metadata->order_id;
+ $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null;
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') );
+ }
// Return false if no order id.
- if ( empty( $order_id ) ) {
+ if ( empty( $order_id ) || ! is_numeric( $order_id ) ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment END (FAILED - Invalid Order ID) ===' );
+ }
return false;
}
// Load order form order id.
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id );
+ }
$order = self::get_wc_order( $order_id );
+
+ if ( ! $order ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment END (FAILED - Order Not Found) ===' );
+ }
+ return false;
+ }
+
$order_id = $order->get_id();
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order_id . ', Status: ' . $order->get_status() );
+ }
// check if payment is already captured.
$already_voided = $order->get_meta( 'cko_payment_voided' );
- $message = 'Webhook received from checkout.com. Payment voided';
+ $payment_id = $webhook_data->id;
+
+ // Get action id from webhook data.
+ $action_id = $webhook_data->action_id;
+
+ $message = sprintf( 'Webhook received from checkout.com. Payment voided - Payment ID: %s, Action ID: %s', $payment_id, $action_id );
// Add note to order if captured already.
if ( $already_voided ) {
@@ -223,10 +486,7 @@ public static function void_payment( $data ) {
return true;
}
- $order->add_order_note( esc_html__( 'Checkout.com Payment Void webhook received', 'checkout-com-unified-payments-api' ) );
-
- // Get action id from webhook data.
- $action_id = $webhook_data->action_id;
+ $order->add_order_note( sprintf( esc_html__( 'Checkout.com Payment Void webhook received - Payment ID: %s', 'checkout-com-unified-payments-api' ), $payment_id ) );
// Set action id as woo transaction id.
$order->set_transaction_id( $action_id );
@@ -235,13 +495,17 @@ public static function void_payment( $data ) {
// Get cko capture status configured in admin.
$status = WC_Admin_Settings::get_option( 'ckocom_order_void', 'cancelled' );
- /* translators: %s: Action ID. */
- $order_message = sprintf( esc_html__( 'Checkout.com Payment Voided - Action ID : %s', 'checkout-com-unified-payments-api' ), $action_id );
+ /* translators: %1$s: Payment ID, %2$s: Action ID. */
+ $order_message = sprintf( esc_html__( 'Checkout.com Payment Voided - Payment ID: %1$s, Action ID: %2$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id );
// add notes for the order and update status.
$order->add_order_note( $order_message );
$order->update_status( $status );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: void_payment END (SUCCESS) ===' );
+ }
return true;
}
@@ -256,21 +520,56 @@ public static function void_payment( $data ) {
* @return bool
*/
public static function refund_payment( $data ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_refunded' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) );
+ }
+
$webhook_data = $data->data;
- $order_id = $webhook_data->metadata->order_id;
+ $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null;
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($webhook_data->id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Refund amount: ' . (isset($webhook_data->amount) ? $webhook_data->amount : 'NULL') );
+ }
// Return false if no order id.
- if ( empty( $order_id ) ) {
+ if ( empty( $order_id ) || ! is_numeric( $order_id ) ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( "WEBHOOK PROCESS: ERROR - Invalid/Empty order_id: " . ($order_id ?? 'NULL') );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment END (FAILED - Invalid Order ID) ===' );
+ }
return false;
}
// Load order form order id.
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id );
+ }
$order = self::get_wc_order( $order_id );
+
+ if ( ! $order ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment END (FAILED - Order Not Found) ===' );
+ }
+ return false;
+ }
+
$order_id = $order->get_id();
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order_id . ', Status: ' . $order->get_status() );
+ }
// check if payment is already refunded.
$already_refunded = $order->get_meta( 'cko_payment_refunded' );
- $message = 'Webhook received from checkout.com. Payment refunded';
+ $payment_id = $webhook_data->id;
// Get action id from webhook data.
$action_id = $webhook_data->action_id;
@@ -279,6 +578,8 @@ public static function refund_payment( $data ) {
$order_amount_cents = WC_Checkoutcom_Utility::value_to_decimal( $order_amount, $order->get_currency() );
$get_transaction_id = $order->get_transaction_id();
+ $message = sprintf( 'Webhook received from checkout.com. Payment refunded - Payment ID: %s, Action ID: %s', $payment_id, $action_id );
+
if ( $get_transaction_id === $action_id ) {
return true;
}
@@ -289,7 +590,7 @@ public static function refund_payment( $data ) {
return true;
}
- $order->add_order_note( esc_html__( 'Checkout.com Payment Refund webhook received', 'checkout-com-unified-payments-api' ) );
+ $order->add_order_note( sprintf( esc_html__( 'Checkout.com Payment Refund webhook received - Payment ID: %s', 'checkout-com-unified-payments-api' ), $payment_id ) );
// Set action id as woo transaction id.
$order->set_transaction_id( $action_id );
@@ -297,13 +598,13 @@ public static function refund_payment( $data ) {
$refund_amount = WC_Checkoutcom_Utility::decimal_to_value( $amount, $order->get_currency() );
- /* translators: %s: Action ID. */
- $order_message = sprintf( esc_html__( 'Checkout.com Payment Refunded - Action ID : %s', 'checkout-com-unified-payments-api' ), $action_id );
+ /* translators: %1$s: Payment ID, %2$s: Action ID. */
+ $order_message = sprintf( esc_html__( 'Checkout.com Payment Refunded - Payment ID: %1$s, Action ID: %2$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id );
// Check if webhook amount is less than order amount - partial refund.
if ( $amount < $order_amount_cents ) {
- /* translators: %s: Action ID. */
- $order_message = sprintf( esc_html__( 'Checkout.com Payment partially refunded - Action ID : %s', 'checkout-com-unified-payments-api' ), $action_id );
+ /* translators: %1$s: Payment ID, %2$s: Action ID. */
+ $order_message = sprintf( esc_html__( 'Checkout.com Payment partially refunded - Payment ID: %1$s, Action ID: %2$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id );
$refund = wc_create_refund(
[
@@ -316,8 +617,8 @@ public static function refund_payment( $data ) {
} elseif ( $amount == $order_amount_cents ) { // PHPCS:ignore WordPress.PHP.StrictComparisons.LooseComparison
// Full refund.
- /* translators: %s: Action ID. */
- $order_message = sprintf( esc_html__( 'Checkout.com Payment fully refunded - Action ID : %s', 'checkout-com-unified-payments-api' ), $action_id );
+ /* translators: %1$s: Payment ID, %2$s: Action ID. */
+ $order_message = sprintf( esc_html__( 'Checkout.com Payment fully refunded - Payment ID: %1$s, Action ID: %2$s', 'checkout-com-unified-payments-api' ), $payment_id, $action_id );
$refund = wc_create_refund(
[
@@ -332,6 +633,10 @@ public static function refund_payment( $data ) {
// add notes for the order and update status.
$order->add_order_note( $order_message );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Refund processed successfully' );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: refund_payment END (SUCCESS) ===' );
+ }
return true;
}
@@ -343,28 +648,68 @@ public static function refund_payment( $data ) {
* @return bool
*/
public static function cancel_payment( $data ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_canceled' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) );
+ }
+
$webhook_data = $data->data;
- $payment_id = $webhook_data->id;
- $gateway_debug = 'yes' === WC_Admin_Settings::get_option( 'cko_gateway_responses', 'no' );
+ $payment_id = isset($webhook_data->id) ? $webhook_data->id : null;
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($payment_id ?? 'NULL') );
+ }
// Initialize the Checkout Api.
$checkout = new Checkout_SDK();
try {
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Fetching payment details from Checkout.com for payment ID: ' . $payment_id );
+ }
// Check if payment is already voided or captured on checkout.com hub.
$details = $checkout->get_builder()->getPaymentsClient()->getPaymentDetails( $payment_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment details retrieved: ' . print_r($details, true) );
+ }
$order_id = ! empty( $details['metadata']['order_id'] ) ? $details['metadata']['order_id'] : null;
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from payment details metadata: ' . ($order_id ?? 'NULL') );
+ }
// Return false if no order id.
- if ( empty( $order_id ) ) {
- WC_Checkoutcom_Utility::logger( 'No order id', null );
-
+ if ( empty( $order_id ) || ! is_numeric( $order_id ) ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - No valid order_id found in payment details' );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment details metadata: ' . print_r(isset($details['metadata']) ? $details['metadata'] : 'N/A', true) );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (FAILED - Invalid Order ID) ===' );
+ }
return false;
}
// Load order form order id.
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id );
+ }
$order = self::get_wc_order( $order_id );
+
+ if ( ! $order ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (FAILED - Order Not Found) ===' );
+ }
+ return false;
+ }
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() );
+ }
$status = 'wc-cancelled';
$message = 'Webhook received from checkout.com. Payment cancelled';
@@ -373,18 +718,31 @@ public static function cancel_payment( $data ) {
$order->add_order_note( $message );
$order->update_status( $status );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (SUCCESS) ===' );
+ }
return true;
} catch ( CheckoutApiException $ex ) {
- $error_message = 'An error has occurred while processing your cancel request.';
+ // Always log errors
+ $error_message = 'WEBHOOK PROCESS: ERROR - An error has occurred while processing cancel request.';
+ WC_Checkoutcom_Utility::logger( $error_message );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Exception message: ' . $ex->getMessage() );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Exception code: ' . $ex->getCode() );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Exception trace: ' . $ex->getTraceAsString() );
+ }
// Check if gateway response is enabled from module settings.
- if ( $gateway_debug ) {
+ if ( $webhook_debug_enabled ) {
$error_message .= $ex->getMessage();
}
WC_Checkoutcom_Utility::logger( $error_message, $ex );
-
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: cancel_payment END (FAILED - Exception) ===' );
+ }
return false;
}
}
@@ -398,26 +756,70 @@ public static function cancel_payment( $data ) {
* @return bool
*/
public static function decline_payment( $data ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment START ===' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Event type: payment_declined/payment_authentication_failed' );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Full webhook data structure: ' . print_r($data, true) );
+ }
+
$webhook_data = $data->data;
- $order_id = $webhook_data->metadata->order_id;
- $payment_id = $webhook_data->id;
- $response_summary = $webhook_data->response_summary;
-
- if ( empty( $order_id ) ) {
- WC_Checkoutcom_Utility::logger( 'No order id for payment ' . $payment_id, null );
+ $order_id = isset($webhook_data->metadata->order_id) ? $webhook_data->metadata->order_id : null;
+ $payment_id = isset($webhook_data->id) ? $webhook_data->id : null;
+ $action_id = isset($webhook_data->action_id) ? $webhook_data->action_id : null;
+ $response_summary = isset($webhook_data->response_summary) ? $webhook_data->response_summary : null;
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order ID from metadata: ' . ($order_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Payment ID: ' . ($payment_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Action ID: ' . ($action_id ?? 'NULL') );
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Response summary: ' . ($response_summary ?? 'NULL') );
+ }
+ if ( empty( $order_id ) || ! is_numeric( $order_id ) ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - No valid order_id for payment: ' . ($payment_id ?? 'NULL') );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment END (FAILED - Invalid Order ID) ===' );
+ }
return false;
}
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Attempting to load order ID: ' . $order_id );
+ }
$order = self::get_wc_order( $order_id );
+
+ if ( ! $order ) {
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: ERROR - Order not found for ID: ' . $order_id );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment END (FAILED - Order Not Found) ===' );
+ }
+ return false;
+ }
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order loaded successfully - Order ID: ' . $order->get_id() . ', Status: ' . $order->get_status() );
+ }
$status = 'wc-failed';
- $message = 'Webhook received from checkout.com. Payment declined Reason : ' . $response_summary;
+ // Include Payment ID and Action ID (if available) in the order note for consistency with other webhook handlers
+ if ( ! empty( $action_id ) ) {
+ $message = sprintf( 'Webhook received from checkout.com. Payment declined - Payment ID: %s, Action ID: %s, Reason: %s', $payment_id, $action_id, $response_summary );
+ } else {
+ $message = sprintf( 'Webhook received from checkout.com. Payment declined - Payment ID: %s, Reason: %s', $payment_id, $response_summary );
+ }
// Add notes for the order and update status.
$order->add_order_note( $message );
$order->update_status( $status );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: Order status updated to: ' . $status );
+ WC_Checkoutcom_Utility::logger( '=== WEBHOOK PROCESS: decline_payment END (SUCCESS) ===' );
+ }
return true;
}
@@ -429,19 +831,41 @@ public static function decline_payment( $data ) {
* @return bool|mixed|WC_Order|WC_Order_Refund
*/
private static function get_wc_order( $order_id ) {
+ $webhook_debug_enabled = self::is_webhook_debug_enabled();
+
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - Looking up order ID: ' . $order_id );
+ }
+
$order = wc_get_order( $order_id );
+
+ if ( $order ) {
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - Order found via wc_get_order - ID: ' . $order->get_id() . ', Status: ' . $order->get_status() );
+ }
+ return $order;
+ }
// Query order by order number to check if order exist.
- if ( ! $order ) {
- $orders = wc_get_orders(
- [
- 'order_number' => $order_id,
- ]
- );
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - Order not found via wc_get_order, trying order_number lookup' );
+ }
+ $orders = wc_get_orders(
+ [
+ 'order_number' => $order_id,
+ ]
+ );
+ if ( ! empty( $orders ) && isset( $orders[0] ) ) {
$order = $orders[0];
+ if ( $webhook_debug_enabled ) {
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - Order found via order_number lookup - ID: ' . $order->get_id() . ', Status: ' . $order->get_status() );
+ }
+ return $order;
}
-
- return $order;
+
+ // Always log errors
+ WC_Checkoutcom_Utility::logger( 'WEBHOOK PROCESS: get_wc_order - ERROR - Order not found by ID or order_number: ' . $order_id );
+ return false;
}
}
diff --git a/includes/class-wc-gateway-checkout-com-apple-pay.php b/includes/class-wc-gateway-checkout-com-apple-pay.php
index 3d640439..09874e6f 100644
--- a/includes/class-wc-gateway-checkout-com-apple-pay.php
+++ b/includes/class-wc-gateway-checkout-com-apple-pay.php
@@ -8,6 +8,10 @@
defined( 'ABSPATH' ) || exit;
require_once 'settings/class-wc-checkoutcom-cards-settings.php';
+<<<<<<< HEAD
+=======
+require_once 'express/apple-pay/class-apple-pay-express.php';
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
/**
* Class WC_Gateway_Checkout_Com_Apple_Pay for Apple Pay method.
@@ -48,6 +52,56 @@ public function __construct() {
add_action( 'woocommerce_api_wc_checkoutcom_session', [ $this, 'applepay_sesion' ] );
add_action( 'woocommerce_api_wc_checkoutcom_generate_token', [ $this, 'applepay_token' ] );
+<<<<<<< HEAD
+=======
+
+ add_action( 'woocommerce_api_' . strtolower( 'CKO_Apple_Pay_Woocommerce' ), [ $this, 'handle_wc_api' ] );
+
+ // CSR generation scripts (AJAX handler is registered in main plugin file)
+ add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_csr_scripts' ] );
+ }
+
+ /**
+ * Check if existing Apple Pay configuration is detected.
+ *
+ * @return array Array with 'detected' (boolean) and 'details' (array of detected fields).
+ */
+ private function detect_existing_configuration() {
+ $detected_fields = [];
+
+ // Check for migrated configuration fields
+ $merchant_id = $this->get_option( 'ckocom_apple_mercahnt_id' );
+ $certificate_path = $this->get_option( 'ckocom_apple_certificate' );
+ $key_path = $this->get_option( 'ckocom_apple_key' );
+ $domain_name = $this->get_option( 'apple_pay_domain_name' );
+ $display_name = $this->get_option( 'apple_pay_display_name' );
+
+ if ( ! empty( $merchant_id ) ) {
+ $detected_fields['merchant_id'] = true;
+ }
+ if ( ! empty( $certificate_path ) && file_exists( $certificate_path ) ) {
+ $detected_fields['certificate'] = true;
+ }
+ if ( ! empty( $key_path ) && file_exists( $key_path ) ) {
+ $detected_fields['key'] = true;
+ }
+ if ( ! empty( $domain_name ) ) {
+ $detected_fields['domain'] = true;
+ }
+ if ( ! empty( $display_name ) ) {
+ $detected_fields['display_name'] = true;
+ }
+
+ // Configuration is detected if we have merchant ID, certificate, and key
+ $is_detected = ! empty( $merchant_id ) &&
+ ! empty( $certificate_path ) &&
+ ! empty( $key_path );
+
+ return [
+ 'detected' => $is_detected,
+ 'details' => $detected_fields,
+ ];
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
}
/**
@@ -56,16 +110,37 @@ public function __construct() {
* @return string|void
*/
public function init_form_fields() {
+<<<<<<< HEAD
$this->form_fields = WC_Checkoutcom_Cards_Settings::apple_settings();
$this->form_fields = array_merge(
$this->form_fields,
+=======
+ $settings = WC_Checkoutcom_Cards_Settings::apple_settings();
+ // Add navigation links at the beginning, right after the first title section
+ $this->form_fields = array_merge(
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
[
'screen_button' => [
'id' => 'screen_button',
'type' => 'screen_button',
'title' => __( 'Other Settings', 'checkout-com-unified-payments-api' ),
],
+<<<<<<< HEAD
]
+=======
+ 'existing_config_banner' => [
+ 'id' => 'existing_config_banner',
+ 'type' => 'existing_config_banner',
+ 'title' => '',
+ ],
+ 'two_system_notice' => [
+ 'id' => 'two_system_notice',
+ 'type' => 'two_system_notice',
+ 'title' => '',
+ ],
+ ],
+ $settings
+>>>>>>> upstream/feature/flow-integration-v5.0.0-beta
);
}
@@ -80,6 +155,575 @@ public function generate_screen_button_html( $key, $value ) {
}
/**
+<<<<<<< HEAD
+=======
+ * Generate existing configuration banner HTML.
+ *
+ * @param string $key The key.
+ * @param array $value The value.
+ */
+ public function generate_existing_config_banner_html( $key, $value ) {
+ $config_status = $this->detect_existing_configuration();
+
+ if ( ! $config_status['detected'] ) {
+ return; // Don't show banner if no existing config detected
+ }
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 0 ) : ?>
+
+
+
+
+
+
+
+
+
+
+
+
+ | + | + | + | + | + | + | + | + | + |
|---|---|---|---|---|---|---|---|---|
| id ); ?> | +payment_id ); ?> |
+ order_id ?: '—' ); ?> | +payment_session_id ?: '—' ); ?> |
+ + + | ++ processed_at ) : ?> + + + + + | +created_at ); ?> | +processed_at ?: '—' ); ?> | +
+
+
+
+ + + |
+
+ +
+ + +
+
+ + ℹ️ +
++ +
+>
+
+
+
+
+
+ + + +
+ Required + + ✓ Configuration detected, click to renew + + +
+
+
+
+
+
+
+
+ >
+
+
+
+
+
+ + + +
+ Required + + ✓ Configuration detected, click to renew + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ [Your Server Path]/.well-known/apple-developer-merchantid-domain-association.txt
+
+
+ https://[YOUR-DOMAIN.COM]/.well-known/apple-developer-merchantid-domain-association.txt
+
+ + +
+ +
+
+
+
+
+
+
+ sudo cp /path/to/apple-developer-merchantid-domain-association.txt
+ sudo chmod 644
+
>
+
+
+
+
+
+ + + +
+ Required + + ✓ Configuration detected, click to renew + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + + + + - YOUR NEXT STEP + +
+ Required +
+
+
+
+
+
+
+
+
+
+ +
+
+
+
+
+
+
+ + +
+-
+
+
+
+
+
+
- ';
+ $error_message .= '
- ' . __( 'Your certificate paths are correct', 'checkout-com-unified-payments-api' ) . ' '; + $error_message .= '
- ' . __( 'Your certificate has not expired', 'checkout-com-unified-payments-api' ) . ' '; + $error_message .= '
- ' . __( 'You clicked "Verify" in your Apple Developer account for your domain', 'checkout-com-unified-payments-api' ) . ' '; + $error_message .= '
' . esc_html__( 'Webhook Queue Admin class not found.', 'checkout-com-unified-payments-api' ) . '