Changeset 3692533

Timestamp:

09/12/2026 09:48:37 AM (6 weeks ago)

Author:

vayapin

Message:

Release 2.3.2: mobile bottom sheet for the checkout widget, VayaConnect, address mapping and pin creation fixes

Location:

vayapin/trunk

Files:

• README.md (modified) (1 diff)
• README.txt (modified) (3 diffs)
• framework/ajax-methods.php (modified) (8 diffs)
• framework/backend-ui/admin-ui.php (modified) (6 diffs)
• framework/backend-ui/assets/tab-icons/group.svg (added)
• framework/backend-ui/css/admin-redesign.css (modified) (1 diff)
• framework/backend-ui/js/admin-redesign.js (modified) (2 diffs)
• framework/backend-ui/js/connect-partners.js (added)
• framework/backend-ui/partials/settings-page-redesign.php (modified) (3 diffs)
• framework/backend-ui/webhook-logs.php (modified) (1 diff)
• framework/connect (added)
• framework/connect/connect-config.php (added)
• framework/connect/dev-simulate.php (added)
• framework/connect/label-intl.php (added)
• framework/connect/partners.php (added)
• framework/connect/record.php (added)
• framework/connect/request-store.php (added)
• framework/connect/vayapin-intl-label-template.php (added)
• framework/frontend-ui/checkout-ui.php (modified) (1 diff)
• framework/styles-scripts/styles-scripts.php (modified) (2 diffs)
• framework/vayapin/api-methods.php (modified) (2 diffs)
• framework/vayapin/connect-api.php (added)
• framework/vayapin/connect-webhook.php (added)
• includes/class-vayapin-activator.php (modified) (1 diff)
• public/css/vayapin-sheet.css (added)
• public/js/vayapin-public.js (modified) (7 diffs)
• public/js/vayapin-select2.js (modified) (5 diffs)
• public/js/vayapin-sheet.js (added)
• uninstall.php (modified) (1 diff)
• vayapin.php (modified) (3 diffs)

vayapin/trunk/README.md

@@ -8 +8 @@
 | **WooCommerce** | 3.0+ (tested up to 11.x) |
 | **Requires PHP** | 7.4+ |
-| **Stable tag** | 2.1.2 |
+| **Stable tag** | 2.3.2 |
 | **License** | GPLv2 or later |
 

vayapin/trunk/README.txt

@@ -4 +4 @@
 Requires at least: 6.0
 Tested up to: 7.1
-Stable tag: 2.1.2
+Stable tag: 2.3.2
 Requires PHP: 7.4
 License: GPLv2 or later
@@ -140 +140 @@
 == Changelog ==
 
-= 2.1.2 =
-* Compatibility: tested against WordPress 7.1 and WooCommerce 11.0.
-* Compatibility: declares support for WooCommerce High-Performance Order Storage (HPOS), so stores can switch order storage with the plugin active.
-* Housekeeping: added the "WC requires at least" and "WC tested up to" plugin headers.
+= 2.3.2 =
+* Change: the mobile sheet takes the widget's own background colour instead of white, so the panel and the pin field read as one surface. The colour follows the merchant's accent setting.
+* Fix: the sheet's back arrow disappeared under storefront button styling (themes match plain buttons through [type=button], which ties on specificity and loads last). The sheet's own controls are now insulated from it.
+
+= 2.3.1 =
+* Fix: inside the mobile sheet the pin row lost its styling (oversized GO button, collapsed input) because the widget styles hang off a class that stayed behind on the original container. The row now matches the desktop layout exactly.
+* Fix: the sheet's back button and search field no longer inherit storefront button and input styling.
+
+= 2.3.0 =
+* New: on phones the whole widget flow opens in a bottom sheet: pin entry, country picking with search and full-size rows, drag or flick down to dismiss. Desktop keeps the existing popup.
+* Fix: the widget scripts relied on jQuery's removed `.load()` shortcut and only ran on sites that still load jQuery Migrate.
+
+= 2.2.9 =
+* Fix: typing and backspace were blocked in the VayaPin field after the country list had been opened. The list was hidden by class only, which left the country plugin's key handler bound and it cancelled every key press.
+* Fix: the "Not found. Please enter a valid VayaPin." message stayed on screen after closing the popup. It is cleared on close, on reopen, and as soon as the code is edited.
+
+= 2.2.8 =
+* Fix: checkout autofill left "Street address" and "Apartment" empty for pins that store the street number or the building name in separate fields (JP pins among them). The street line is now built from road + house number, the second line from building name + addition.
+* Fix: city and state fall back to their "_part" counterparts when the primary field is empty.
+
+= 2.2.7 =
+* Fix: checkout autofill now clears the "required field" validation errors on the fields it fills, instead of leaving them red until the field is touched manually.
+* Fix: new VayaPin creation sent only the last name in the `name` field, which the API rejected with HTTP 422 ("name: must include a last name"). Full first + last name is sent now, per the /v1/pins contract.
+* Fix: API validation errors were logged with an empty message, so a failed pin creation showed a bare HTTP_422 with no reason. The error code, message and per-field errors are parsed and stored now.
+* Change: Pin Creation History CSV export includes the raw API response for failed attempts.
+
+= 2.2.0 =
+* New: VayaConnect — request a VayaPin address from any customer. Adds a Partners tab listing WooCommerce customers with their VayaPin status (verified / pending / none) and a "Request VayaPin address" button.
+* New: inbound `pin.address_updated` webhook receiver (REST: /wp-json/vayapin/v1/webhooks) with HMAC-SHA256 verification and replay idempotency. The verified record (VayaPin ID, every script, GPS, QR) is written back to the customer/order automatically.
+* New: VayaConnect record surface on the order detail screen and customer profile.
+* New: carrier-ready international label (dual-script + QR) at /vayapin-intl-label/{order_id}.
+* New: VayaConnect on/off toggle (off by default). The outbound request verb is behind a single contract seam pending the VayaCore backend.
 
 = 2.1.1 =
@@ -161 +189 @@
 == Upgrade Notice ==
 
-= 2.1.2 =
-Compatibility release for WordPress 7.1 and WooCommerce 11. No functional changes; safe update for all stores.
+= 2.3.2 =
+Mobile sheet visual fixes: single tinted surface and a visible back arrow.
+
+= 2.3.1 =
+Fixes the pin row layout inside the mobile sheet.
+
+= 2.3.0 =
+Adds the mobile bottom sheet and fixes empty street fields after autofill. Test the checkout widget on a phone after updating.
+
+= 2.2.9 =
+Fixes the VayaPin input becoming uneditable after opening the country list, and the stale "Not found" message.
+
+= 2.2.8 =
+Fixes empty street address fields after autofill for pins with a separate house number or building name.
+
+= 2.2.7 =
+Fixes checkout validation errors sticking after autofill and VayaPin creation failing with HTTP 422. Recommended for all stores.
+
+= 2.2.0 =
+Adds VayaConnect (Partners tab + inbound address webhook). Disabled by default — enable it under the Partners tab and set a webhook secret. Re-save permalinks if the international label URL 404s.
 
 = 2.1.1 =

vayapin/trunk/framework/ajax-methods.php

@@ -171 +171 @@
     }
     
+    // A pin splits its address across more fields than WooCommerce has lines:
+    // road + house_number + house (building) + addition, and settlement/region each
+    // have a "_part" sibling. Reading only address_road/address_addition drops the
+    // street entirely for pins that carry the number or the building name instead
+    // (e.g. JP pins: "Marunouchi 1 Chome 9-1" + "Gran Tokyo North Tower").
+    $road            = $get_field_value($data_source['address_road'] ?? '');
+    $house_number    = $get_field_value($data_source['address_house_number'] ?? '');
+    $house           = $get_field_value($data_source['address_house'] ?? '');
+    $addition        = $get_field_value($data_source['address_addition'] ?? '');
+    $settlement      = $get_field_value($data_source['address_settlement'] ?? '');
+    $settlement_part = $get_field_value($data_source['address_settlement_part'] ?? '');
+    $region          = $get_field_value($data_source['address_region'] ?? '');
+    $region_part     = $get_field_value($data_source['address_region_part'] ?? '');
+
+    $join = function( $parts, $glue ) {
+        $parts = array_filter( array_map( 'trim', $parts ), function ( $part ) {
+            return '' !== $part;
+        } );
+        return implode( $glue, $parts );
+    };
+
+    $address_1 = $join( array( $road, $house_number ), ' ' );
+    $address_2 = $join( array( $house, $addition ), ', ' );
+
+    // Never leave line 1 empty while line 2 has the only street data.
+    if ( '' === $address_1 && '' !== $address_2 ) {
+        $address_1 = $address_2;
+        $address_2 = '';
+    }
+
+    $city_value  = '' !== $settlement ? $settlement : $settlement_part;
+    $state_value = '' !== $region ? $region : $region_part;
+
     $data = [
         'company'    => sanitize_text_field($title_value),
@@ -180 +213 @@
         'email'      => !empty($email_value) ? sanitize_email($email_value) : '',
         'country'    => sanitize_text_field(strtoupper($data_source['country'] ?? '')),
-        'city'       => sanitize_text_field($get_field_value($data_source['address_settlement'] ?? '')),
-        'state'      => sanitize_text_field($get_field_value($data_source['address_region'] ?? '')),
+        'city'       => sanitize_text_field($city_value),
+        'state'      => sanitize_text_field($state_value),
         'postcode'   => sanitize_text_field($get_field_value($data_source['address_postcode'] ?? '')),
         'phone'      => sanitize_text_field($get_field_value($data_source['phone'] ?? '')),
-        'address_1'  => sanitize_text_field($get_field_value($data_source['address_road'] ?? '')),
-        'address_2'  => sanitize_text_field($get_field_value($data_source['address_addition'] ?? '')),
+        'address_1'  => sanitize_text_field($address_1),
+        'address_2'  => sanitize_text_field($address_2),
         'debug'      => $debug_data
     ];
@@ -353 +386 @@
     
     // Generate CSV content
-    $csv_content = "Timestamp,Order ID,Activity Type,Status,Error Code,Error Message,VayaPin ID\n";
+    $csv_content = "Timestamp,Order ID,Activity Type,Status,Error Code,Error Message,VayaPin ID,API Response\n";
 
     foreach ($logs as $log) {
@@ -370 +403 @@
         $vayapin_id    = $log->vayapin_id ? $log->vayapin_id : '';
 
+        // Raw body of the failed call: without it a 422 cannot be diagnosed outside the DB.
+        $raw_response = '';
+        if ( 'failed' === $log->status && $log->api_response ) {
+            $raw_response = str_replace(
+                array( "\r", "\n", '"' ),
+                array( ' ', ' ', '""' ),
+                mb_substr( $log->api_response, 0, 2000 )
+            );
+        }
+
         $csv_content .= sprintf(
-            '"%s","%s","%s","%s","%s","%s","%s"' . "\n",
+            '"%s","%s","%s","%s","%s","%s","%s","%s"' . "\n",
             $timestamp,
             $order_id,
@@ -378 +421 @@
             $error_code,
             $error_message,
-            $vayapin_id
+            $vayapin_id,
+            $raw_response
         );
     }
@@ -465 +509 @@
     $logs = $wpdb->get_results( $query );
 
-    $csv_content = "Timestamp,Event Type,Webhook URL,Status,Response Code,Error Message\n";
+    $csv_content = "Timestamp,Event Type,Webhook URL,Status,Response Code,Error Message,Payload\n";
     foreach ( $logs as $log ) {
         $timestamp   = date_i18n( 'Y-m-d H:i:s', strtotime( $log->timestamp ) );
@@ -473 +517 @@
         $resp_code   = $log->response_code ? (string) $log->response_code : '';
         $err_message = $log->error_message ? str_replace( array( "\r", "\n", '"' ), array( ' ', ' ', '""' ), (string) $log->error_message ) : '';
+        $payload     = isset( $log->payload ) && '' !== (string) $log->payload ? str_replace( array( "\r", "\n", '"' ), array( ' ', ' ', '""' ), (string) $log->payload ) : '';
 
         $csv_content .= sprintf(
-            '"%s","%s","%s","%s","%s","%s"' . "\n",
+            '"%s","%s","%s","%s","%s","%s","%s"' . "\n",
             $timestamp,
             $event_type,
@@ -481 +526 @@
             $status,
             $resp_code,
-            $err_message
+            $err_message,
+            $payload
         );
     }

vayapin/trunk/framework/backend-ui/admin-ui.php

@@ -57 +57 @@
         'analytics_enabled'       => '1',
         'analytics_weekly_email'  => '1',
+        'vayaconnect_enabled'     => '0',
         'label_generation'        => '1',
         'order_confirmation_notice' => '1',
@@ -1606 +1607 @@
     $new_input['analytics_enabled']     = $vp_on( 'analytics_enabled' ) ? '1' : '0';
     $new_input['analytics_weekly_email'] = $vp_on( 'analytics_weekly_email' ) ? '1' : '0';
+    $new_input['vayaconnect_enabled']    = $vp_on( 'vayaconnect_enabled' ) ? '1' : '0';
 
     $allowed_widget_positions = array( 'above_billing', 'below_billing', 'above_shipping', 'custom' );
@@ -1687 +1689 @@
             $new_input['webhook_secret'] = $options['webhook_secret'];
         }
+    }
+
+    // VayaConnect inbound webhook secret (separate from the outbound Notifications secret).
+    if ( isset( $input['vayaconnect_webhook_secret'] ) ) {
+        $vc_secret = sanitize_text_field( $input['vayaconnect_webhook_secret'] );
+
+        $existing_encrypted = $options['vayaconnect_webhook_secret'] ?? '';
+        $existing_decrypted = vayapin_decrypt_api_key( $existing_encrypted );
+        $masked_existing    = vayapin_mask_api_key( $existing_decrypted );
+
+        if ( empty( $vc_secret ) ) {
+            $new_input['vayaconnect_webhook_secret'] = '';
+        } elseif ( $vc_secret === $masked_existing && ! empty( $existing_encrypted ) ) {
+            // Unchanged masked value — keep the stored encrypted secret.
+            $new_input['vayaconnect_webhook_secret'] = $existing_encrypted;
+        } else {
+            $new_input['vayaconnect_webhook_secret'] = vayapin_encrypt_api_key( $vc_secret );
+        }
+    } elseif ( isset( $options['vayaconnect_webhook_secret'] ) ) {
+        $new_input['vayaconnect_webhook_secret'] = $options['vayaconnect_webhook_secret'];
     }
 
@@ -2170 +2192 @@
                         </td>
                     </tr>
+                    <?php if ( isset( $log->payload ) && '' !== (string) $log->payload ) : ?>
+                        <tr class="vp-log-payload-row">
+                            <td colspan="6">
+                                <details>
+                                    <summary><?php esc_html_e( 'Payload', 'vayapin-woocommerce' ); ?></summary>
+                                    <pre class="vp-log-payload"><?php echo esc_html( (string) $log->payload ); ?></pre>
+                                </details>
+                            </td>
+                        </tr>
+                    <?php endif; ?>
                 <?php endforeach; ?>
                 </tbody>
@@ -2258 +2290 @@
                 'resetAction' => 'vayapin_reset_settings_defaults',
                 'iconBaseUrl' => plugins_url( 'icon/', __FILE__ ),
+                'connect'     => array(
+                    'nonce'           => wp_create_nonce( 'vayapin_connect' ),
+                    'listAction'      => 'vayapin_connect_partners_list',
+                    'requestAction'   => 'vayapin_connect_send_request',
+                    'createAction'    => 'vayapin_connect_add_recipient',
+                    'deleteAction'    => 'vayapin_connect_delete_request',
+                    'recordAction'    => 'vayapin_connect_get_record',
+                    'i18n'            => array(
+                        'requesting'   => __( 'Sending…', 'vayapin-woocommerce' ),
+                        'removing'     => __( 'Removing…', 'vayapin-woocommerce' ),
+                        'failed'       => __( 'Failed. Try again.', 'vayapin-woocommerce' ),
+                        'emailInvalid' => __( 'Enter a valid email address.', 'vayapin-woocommerce' ),
+                    ),
+                ),
                 'i18n'        => array(
                     'resetError' => __( 'Something went wrong. Please try again.', 'vayapin-woocommerce' ),
@@ -2265 +2311 @@
                 ),
             )
+        );
+        wp_enqueue_script(
+            'vayapin-connect-partners',
+            plugins_url( 'js/connect-partners.js', __FILE__ ),
+            array( 'jquery', 'vayapin-admin-redesign' ),
+            defined( 'VAYAPIN_VERSION' ) ? VAYAPIN_VERSION : '1.0.0',
+            true
         );
     }

vayapin/trunk/framework/backend-ui/css/admin-redesign.css

@@ -3175 +3175 @@
   }
 }
+
+/* ── VayaConnect · Partners tab ─────────────────────────────────── */
+.status-pill.vp-pill-none {
+  background: #f3f4f6;
+  color: #6b7280;
+}
+.status-pill.vp-pill-none .status-pill-dot {
+  background: #9ca3af;
+}
+
+.vp-partners-toolbar {
+  display: flex;
+  gap: 0.625rem;
+  flex-wrap: wrap;
+  align-items: center;
+}
+.vp-partners-toolbar #vp_partners_search {
+  flex: 1 1 220px;
+  min-width: 180px;
+}
+.vp-partners-toolbar #vp_partners_filter {
+  flex: 0 0 auto;
+  min-width: 160px;
+}
+.vp-partners-toolbar .vp-partners-add-toggle {
+  flex: 0 0 auto;
+  margin-left: auto;
+}
+
+.vp-partners-add-form {
+  margin-top: 0.75rem;
+  padding: 1rem;
+  border: 1px solid var(--border, #e5e7eb);
+  border-radius: 0.625rem;
+  background: var(--surface-subtle, #f9fafb);
+}
+.vp-partners-add-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(11rem, 1fr));
+  gap: 0.75rem;
+}
+.vp-partners-add-field {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  font-size: 0.75rem;
+  color: #6b7280;
+}
+.vp-partners-add-field > span {
+  font-weight: 600;
+}
+.vp-req {
+  color: #dc2626;
+}
+.vp-partners-add-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 0.5rem;
+  margin-top: 0.75rem;
+}
+
+.vp-partner-check-cell {
+  width: 2.5rem;
+  text-align: center;
+}
+.vp-partner-check,
+#vp_partners_check_all {
+  width: 1rem;
+  height: 1rem;
+  cursor: pointer;
+}
+.vp-partners-bulkbar {
+  display: flex;
+  align-items: center;
+  gap: 0.625rem;
+  margin-top: 0.75rem;
+  padding: 0.5rem 0.75rem;
+  border: 1px solid var(--border, #e5e7eb);
+  border-radius: 0.625rem;
+  background: var(--surface-subtle, #f9fafb);
+}
+.vp-partners-bulkbar #vp_partners_bulk_count {
+  margin-right: auto;
+}
+
+.vp-log-payload-row > td {
+  background: var(--surface-subtle, #f9fafb);
+}
+.vp-log-payload-row summary {
+  cursor: pointer;
+  font-size: 0.75rem;
+  color: #6b7280;
+}
+.vp-log-payload {
+  margin: 0.25rem 0 0;
+  padding: 0.5rem 0.75rem;
+  max-height: 20rem;
+  overflow: auto;
+  white-space: pre-wrap;
+  word-break: break-all;
+  font-size: 0.75rem;
+  font-family: ui-monospace, Menlo, monospace;
+  border: 1px solid var(--border, #e5e7eb);
+  border-radius: 0.375rem;
+  background: #fff;
+}
+
+.vp-partners-table th,
+.vp-partners-table td {
+  vertical-align: middle;
+}
+.vp-partner-name {
+  font-weight: 600;
+  color: var(--graphite-dark, #454545);
+}
+.vp-partner-email {
+  font-size: 0.75rem;
+  color: #6b7280;
+}
+.vp-partner-action-cell {
+  white-space: nowrap;
+  text-align: right;
+}
+.vp-partners-verified-note {
+  font-family: ui-monospace, Menlo, monospace;
+  font-size: 0.75rem;
+  color: var(--green-dark, #0d9488);
+}
+.vp-partners-empty {
+  text-align: center;
+  color: #9ca3af;
+  padding: 1.5rem 1rem !important;
+}
+.vp-muted {
+  color: #9ca3af;
+}
+
+.vp-partners-footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-top: 0.75rem;
+  gap: 0.625rem;
+  flex-wrap: wrap;
+}
+.vp-partners-pager {
+  display: flex;
+  gap: 0.375rem;
+}
+
+.vp-dev-badge {
+  display: inline-block;
+  font-size: 0.625rem;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  color: #92400e;
+  background: #fff8eb;
+  border: 1px solid #f0deb6;
+  border-radius: 4px;
+  padding: 0.05rem 0.35rem;
+  margin-right: 0.35rem;
+  vertical-align: middle;
+}
+
+/* ── VayaConnect · record modal + toast ─────────────────────────── */
+.vayapin-settings-redesign .vp-record-modal__dialog {
+  max-width: 30rem;
+}
+.vayapin-settings-redesign .vp-record-modal__head {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 0.75rem;
+  margin-bottom: 0.875rem;
+}
+.vayapin-settings-redesign .vp-record-modal__eyebrow {
+  font-size: 0.625rem;
+  font-weight: 700;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: var(--green-dark, #0d9488);
+  margin-bottom: 0.125rem;
+}
+.vayapin-settings-redesign .vp-record-modal__title {
+  margin: 0;
+  font-size: 1.125rem;
+}
+.vayapin-settings-redesign .vp-record-modal__body {
+  margin-bottom: 1rem;
+}
+.vayapin-settings-redesign .vp-rec-table {
+  border: 1px solid var(--border);
+  border-radius: 0.625rem;
+  overflow: hidden;
+}
+.vayapin-settings-redesign .vp-rec-row {
+  display: flex;
+  align-items: baseline;
+  gap: 0.75rem;
+  padding: 0.625rem 0.875rem;
+  border-bottom: 1px solid var(--border);
+}
+.vayapin-settings-redesign .vp-rec-row:last-child {
+  border-bottom: 0;
+}
+.vayapin-settings-redesign .vp-rec-key {
+  flex: 0 0 8.5rem;
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--graphite-mid, #6b7280);
+}
+.vayapin-settings-redesign .vp-rec-val {
+  flex: 1;
+  font-size: 0.8125rem;
+  color: var(--graphite-dark, #454545);
+  text-align: right;
+  word-break: break-word;
+}
+.vayapin-settings-redesign .vp-rec-mono {
+  font-family: ui-monospace, Menlo, monospace;
+  font-size: 0.78rem;
+}
+.vayapin-settings-redesign .vp-rec-script {
+  font-size: 0.85rem;
+}
+.vayapin-settings-redesign .vp-rec-qr {
+  display: flex;
+  justify-content: center;
+  margin-top: 0.875rem;
+}
+.vayapin-settings-redesign .vp-rec-qr img {
+  width: 7.5rem;
+  height: 7.5rem;
+  object-fit: contain;
+  border: 1px solid var(--border);
+  border-radius: 0.5rem;
+  padding: 0.25rem;
+  background: #fff;
+}
+.vayapin-settings-redesign .vp-rec-foot {
+  margin: 0.875rem 0 0;
+  font-size: 0.72rem;
+  color: var(--graphite-light, #9ca3af);
+  text-align: center;
+}
+.vayapin-settings-redesign .vp-toast-modal__dialog {
+  max-width: 22rem;
+}
+
+/* ── VayaConnect · verified action spacing + secret gate ────────── */
+.vayapin-settings-redesign .vp-partner-action-cell .vp-partners-view-btn {
+  margin-right: 0.75rem;
+}
+.vayapin-settings-redesign .vp-partner-action-cell .vp-partners-verified-note {
+  margin-left: 0.25rem;
+  white-space: nowrap;
+}
+
+.vayapin-settings-redesign .vp-partners-gate {
+  text-align: center;
+  padding: 2rem 1.25rem;
+  border: 1px dashed var(--border);
+  border-radius: 0.75rem;
+  background: var(--green-light, #f0fcf6);
+}
+.vayapin-settings-redesign .vp-partners-gate__icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2.5rem;
+  height: 2.5rem;
+  border-radius: 50%;
+  background: #fff;
+  border: 1px solid var(--border);
+  color: var(--green-dark, #0d9488);
+  margin-bottom: 0.625rem;
+}
+.vayapin-settings-redesign .vp-partners-gate__icon svg {
+  width: 1.125rem;
+  height: 1.125rem;
+}
+.vayapin-settings-redesign .vp-partners-gate__title {
+  font-size: 0.95rem;
+  font-weight: 700;
+  color: var(--graphite-dark, #454545);
+  margin-bottom: 0.375rem;
+}
+.vayapin-settings-redesign .vp-partners-gate__text {
+  margin: 0 auto;
+  max-width: 28rem;
+  font-size: 0.8125rem;
+  color: var(--graphite-mid, #6b7280);
+  line-height: 1.5;
+}
+
+/* VayaConnect · pending "Request sent" as text, not a button */
+.vayapin-settings-redesign .vp-partner-action-cell .vp-partners-sent-note {
+  font-size: 0.8125rem;
+  color: var(--graphite-light, #9ca3af);
+  margin-right: 0.75rem;
+}

vayapin/trunk/framework/backend-ui/js/admin-redesign.js

@@ -14 +14 @@
                 analytics: 1,
                 badge: 1,
+                partners: 1,
         };
         var VP_TAB_PREF_CLASSES = [
@@ -21 +22 @@
                 'vp-tab-pref-analytics',
                 'vp-tab-pref-badge',
+                'vp-tab-pref-partners',
         ];
 

vayapin/trunk/framework/backend-ui/partials/settings-page-redesign.php

@@ -174 +174 @@
                         }
                         var t = localStorage.getItem('vayapin_settings_active_tab');
-                        var ok = { connection: 1, checkout: 1, delivery: 1, notifications: 1, analytics: 1, badge: 1 };
+                        var ok = { connection: 1, checkout: 1, delivery: 1, notifications: 1, analytics: 1, badge: 1, partners: 1 };
                         if (!t || !ok[t] || t === 'connection') {
                                 return;
@@ -258 +258 @@
                                         <button type="button" class="tab-btn" data-vtab="notifications"><?php echo vayapin_admin_inline_tab_icon_svg( 'mail', 'tab-icon' ); ?> <?php esc_html_e( 'Notifications', 'vayapin-woocommerce' ); ?></button>
                                         <button type="button" class="tab-btn" data-vtab="analytics"><?php echo vayapin_admin_inline_tab_icon_svg( 'stats-report', 'tab-icon' ); ?> <?php esc_html_e( 'Analytics', 'vayapin-woocommerce' ); ?></button>
+                                        <button type="button" class="tab-btn" data-vtab="partners"><?php echo vayapin_admin_inline_tab_icon_svg( 'group', 'tab-icon' ); ?> <?php esc_html_e( 'Partners', 'vayapin-woocommerce' ); ?></button>
                                 </div>
 
@@ -871 +872 @@
                                 </div>
 
+                                <?php
+                                $vayaconnect_enabled = '1' === vayapin_get_option( 'vayaconnect_enabled', '0' );
+                                $vc_receiver_url     = function_exists( 'vayapin_connect_webhook_receiver_url' ) ? vayapin_connect_webhook_receiver_url() : '';
+                                $vc_secret_encrypted = vayapin_get_option( 'vayaconnect_webhook_secret', '' );
+                                $vc_secret_decrypted = function_exists( 'vayapin_connect_get_inbound_secret' ) ? vayapin_connect_get_inbound_secret() : '';
+                                $vc_secret_masked    = ( '' !== $vc_secret_decrypted && function_exists( 'vayapin_mask_api_key' ) ) ? vayapin_mask_api_key( $vc_secret_decrypted ) : '';
+                                $vc_secret_display   = '' !== $vc_secret_decrypted ? $vc_secret_masked : '';
+                                $vc_initial          = ( $vayaconnect_enabled && '' !== (string) $vc_secret_decrypted && function_exists( 'vayapin_connect_get_partners' ) )
+                                        ? vayapin_connect_get_partners( array( 'paged' => 1, 'per_page' => 15 ) )
+                                        : array( 'rows' => array(), 'total' => 0, 'paged' => 1, 'per_page' => 15 );
+                                ?>
+                                <div id="tab-partners" class="tab-panel">
+                                        <div class="section-card">
+                                                <div class="section-header">
+                                                        <div class="section-icon"><?php echo vayapin_admin_inline_tab_icon_svg( 'group' ); ?></div>
+                                                        <div class="section-title-wrap">
+                                                                <div class="section-title"><?php esc_html_e( 'VayaConnect', 'vayapin-woocommerce' ); ?></div>
+                                                                <div class="section-desc"><?php esc_html_e( 'Request a VayaPin address from any customer. They drop one GPS pin in their own language; the verified address returns to you automatically — no foreign characters typed.', 'vayapin-woocommerce' ); ?></div>
+                                                        </div>
+                                                </div>
+                                                <div class="section-body">
+                                                        <div class="vp-checkbox-wrap">
+                                                                <input type="checkbox" class="vp-checkbox" name="vayapin_woocommerce_options[vayaconnect_enabled]" value="1" id="vp_chk_vayaconnect" <?php checked( $vayaconnect_enabled ); ?>>
+                                                                <label class="vp-checkbox-text" for="vp_chk_vayaconnect">
+                                                                        <div class="vp-checkbox-title"><?php esc_html_e( 'Enable VayaConnect', 'vayapin-woocommerce' ); ?></div>
+                                                                        <div class="vp-checkbox-desc"><?php esc_html_e( 'Turns on the partner list, the "Request VayaPin address" button, and the inbound address webhook receiver. Save after changing.', 'vayapin-woocommerce' ); ?></div>
+                                                                </label>
+                                                        </div>
+                                                        <?php if ( $vc_receiver_url ) : ?>
+                                                        <div class="field-row" style="margin-top:1rem;">
+                                                                <div>
+                                                                        <div class="field-label"><?php esc_html_e( 'Inbound webhook URL', 'vayapin-woocommerce' ); ?></div>
+                                                                        <div class="field-hint"><?php esc_html_e( 'Give this URL and the VayaConnect secret below to VayaPin so address updates are pushed back to your store.', 'vayapin-woocommerce' ); ?></div>
+                                                                </div>
+                                                                <div class="field-control">
+                                                                        <input class="vp-input mono" type="text" value="<?php echo esc_attr( $vc_receiver_url ); ?>" readonly onclick="this.select();">
+                                                                </div>
+                                                        </div>
+                                                        <?php endif; ?>
+                                                        <div class="field-row">
+                                                                <div>
+                                                                        <div class="field-label"><?php esc_html_e( 'VayaConnect webhook secret', 'vayapin-woocommerce' ); ?></div>
+                                                                        <div class="field-hint"><?php esc_html_e( 'Verifies HMAC-SHA256 signatures on inbound pin.address_updated payloads. Separate from the outbound Notifications secret. Required for the inbound webhook receiver.', 'vayapin-woocommerce' ); ?></div>
+                                                                </div>
+                                                                <div class="field-control">
+                                                                        <div class="input-wrap">
+                                                                                <input class="vp-input mono vp-input--with-actions" type="password" name="vayapin_woocommerce_options[vayaconnect_webhook_secret]" id="vp_vc_secret_input" value="<?php echo esc_attr( $vc_secret_display ); ?>" data-real="<?php echo esc_attr( $vc_secret_decrypted ); ?>" data-masked="<?php echo esc_attr( $vc_secret_masked ); ?>" placeholder="<?php esc_attr_e( 'Paste the secret from VayaPin', 'vayapin-woocommerce' ); ?>" autocomplete="off">
+                                                                        </div>
+                                                                        <div class="vp-mono-helper" style="margin-top:0.5rem;">
+                                                                                <span class="field-hint"><?php esc_html_e( 'Paste the signing secret VayaPin gave you for this endpoint, then click Save settings.', 'vayapin-woocommerce' ); ?></span>
+                                                                                                                                                        </div>
+                                                                </div>
+                                                        </div>
+                                                </div>
+                                        </div>
+
+                                        <div class="section-card" style="margin-top:1rem;">
+                                                <div class="section-header">
+                                                        <div class="section-icon"><?php echo vayapin_admin_inline_tab_icon_svg( 'package' ); ?></div>
+                                                        <div class="section-title-wrap">
+                                                                <div class="section-title"><?php esc_html_e( 'Partners', 'vayapin-woocommerce' ); ?></div>
+                                                                <div class="section-desc"><?php esc_html_e( 'Your WooCommerce customers and their VayaPin status. Send an address request to anyone who has no VayaPin yet.', 'vayapin-woocommerce' ); ?></div>
+                                                        </div>
+                                                </div>
+                                                <div class="section-body">
+                                                        <?php
+                                                        $vc_has_secret = '' !== (string) $vc_secret_decrypted;
+                                                        if ( ! $vayaconnect_enabled ) :
+                                                        ?>
+                                                                <p class="vp-muted"><?php esc_html_e( 'Enable VayaConnect above and save to load your partner list.', 'vayapin-woocommerce' ); ?></p>
+                                                        <?php elseif ( ! $vc_has_secret ) : ?>
+                                                                <div class="vp-partners-gate">
+                                                                        <div class="vp-partners-gate__icon"><?php echo vayapin_admin_inline_tab_icon_svg( 'lock' ); ?></div>
+                                                                        <div class="vp-partners-gate__title"><?php esc_html_e( 'Set a webhook secret to continue', 'vayapin-woocommerce' ); ?></div>
+                                                                        <p class="vp-partners-gate__text"><?php esc_html_e( 'Generate the VayaConnect webhook secret above and click Save settings. The partner list and address requests unlock once the inbound receiver can verify signatures.', 'vayapin-woocommerce' ); ?></p>
+                                                                </div>
+                                                        <?php else : ?>
+                                                                <div class="vp-partners-toolbar">
+                                                                        <input type="search" id="vp_partners_search" class="vp-input" placeholder="<?php esc_attr_e( 'Search name or email…', 'vayapin-woocommerce' ); ?>" autocomplete="off">
+                                                                        <select id="vp_partners_filter" class="vp-select">
+                                                                                <option value="all"><?php esc_html_e( 'All statuses', 'vayapin-woocommerce' ); ?></option>
+                                                                                <option value="none"><?php esc_html_e( 'No VayaPin', 'vayapin-woocommerce' ); ?></option>
+                                                                                <option value="pending"><?php esc_html_e( 'Pending', 'vayapin-woocommerce' ); ?></option>
+                                                                                <option value="verified"><?php esc_html_e( 'Verified', 'vayapin-woocommerce' ); ?></option>
+                                                                        </select>
+                                                                        <button type="button" class="btn btn-primary btn-sm vp-partners-add-toggle" id="vp_partners_add_toggle" aria-expanded="false" aria-controls="vp_partners_add_form">+ <?php esc_html_e( 'Add recipient', 'vayapin-woocommerce' ); ?></button>
+                                                                </div>
+                                                                <?php
+                                                                $vc_base_country = '';
+                                                                $vc_countries    = array();
+                                                                if ( function_exists( 'WC' ) && WC()->countries ) {
+                                                                        $vc_countries = WC()->countries->get_countries();
+                                                                        $vc_base      = function_exists( 'wc_get_base_location' ) ? wc_get_base_location() : array();
+                                                                        $vc_base_country = isset( $vc_base['country'] ) ? $vc_base['country'] : '';
+                                                                }
+                                                                ?>
+                                                                <div id="vp_partners_add_form" class="vp-partners-add-form" hidden>
+                                                                        <div class="vp-partners-add-grid">
+                                                                                <label class="vp-partners-add-field">
+                                                                                        <span><?php esc_html_e( 'Name', 'vayapin-woocommerce' ); ?></span>
+                                                                                        <input type="text" id="vp_add_name" class="vp-input" autocomplete="off">
+                                                                                </label>
+                                                                                <label class="vp-partners-add-field">
+                                                                                        <span><?php esc_html_e( 'Email', 'vayapin-woocommerce' ); ?> <span class="vp-req">*</span></span>
+                                                                                        <input type="email" id="vp_add_email" class="vp-input" autocomplete="off">
+                                                                                </label>
+                                                                                <label class="vp-partners-add-field">
+                                                                                        <span><?php esc_html_e( 'Phone', 'vayapin-woocommerce' ); ?></span>
+                                                                                        <input type="text" id="vp_add_phone" class="vp-input" autocomplete="off" placeholder="+45…">
+                                                                                </label>
+                                                                                <label class="vp-partners-add-field">
+                                                                                        <span><?php esc_html_e( 'Country', 'vayapin-woocommerce' ); ?></span>
+                                                                                        <select id="vp_add_country" class="vp-select">
+                                                                                                <?php foreach ( $vc_countries as $vc_code => $vc_label ) : ?>
+                                                                                                        <option value="<?php echo esc_attr( $vc_code ); ?>" <?php selected( $vc_code, $vc_base_country ); ?>><?php echo esc_html( $vc_label ); ?></option>
+                                                                                                <?php endforeach; ?>
+                                                                                        </select>
+                                                                                </label>
+                                                                                <label class="vp-partners-add-field">
+                                                                                        <span><?php esc_html_e( 'Address line 1', 'vayapin-woocommerce' ); ?></span>
+                                                                                        <input type="text" id="vp_add_address_1" class="vp-input" autocomplete="off">
+                                                                                </label>
+                                                                                <label class="vp-partners-add-field">
+                                                                                        <span><?php esc_html_e( 'City', 'vayapin-woocommerce' ); ?></span>
+                                                                                        <input type="text" id="vp_add_city" class="vp-input" autocomplete="off">
+                                                                                </label>
+                                                                                <label class="vp-partners-add-field">
+                                                                                        <span><?php esc_html_e( 'ZIP / Postcode', 'vayapin-woocommerce' ); ?></span>
+                                                                                        <input type="text" id="vp_add_zip" class="vp-input" autocomplete="off">
+                                                                                </label>
+                                                                        </div>
+                                                                        <p class="field-hint" style="margin-top:0.5rem;"><?php esc_html_e( 'VayaPin needs a rough address (varies by country) to start the request; the recipient refines it into a precise pin. For existing customers this is pulled from their order automatically.', 'vayapin-woocommerce' ); ?></p>
+                                                                        <div class="vp-partners-add-actions">
+                                                                                <button type="button" class="btn btn-ghost btn-sm" id="vp_partners_add_cancel"><?php esc_html_e( 'Cancel', 'vayapin-woocommerce' ); ?></button>
+                                                                                <button type="button" class="btn btn-primary btn-sm" id="vp_partners_add_submit"><?php esc_html_e( 'Send request', 'vayapin-woocommerce' ); ?></button>
+                                                                        </div>
+                                                                </div>
+                                                                <div class="vayapin-table-wrapper" style="margin-top:0.75rem;">
+                                                                        <div id="vp_partners_bulkbar" class="vp-partners-bulkbar" hidden><span id="vp_partners_bulk_count" class="vp-muted"></span><button type="button" class="btn btn-primary btn-sm" id="vp_partners_bulk_request"><?php esc_html_e( 'Request VayaPin address', 'vayapin-woocommerce' ); ?></button><button type="button" class="btn btn-ghost btn-sm" id="vp_partners_bulk_clear"><?php esc_html_e( 'Clear', 'vayapin-woocommerce' ); ?></button></div>
+                                                                                <table class="vayapin-logs-table vp-partners-table">
+                                                                                <thead>
+                                                                                        <tr>
+                                                                                                <th class="vp-partner-check-cell"><input type="checkbox" id="vp_partners_check_all" aria-label="<?php esc_attr_e( 'Select all', 'vayapin-woocommerce' ); ?>"></th><th><?php esc_html_e( 'Customer', 'vayapin-woocommerce' ); ?></th>
+                                                                                                <th><?php esc_html_e( 'Phone', 'vayapin-woocommerce' ); ?></th>
+                                                                                                <th><?php esc_html_e( 'Status', 'vayapin-woocommerce' ); ?></th>
+                                                                                                <th><?php esc_html_e( 'Action', 'vayapin-woocommerce' ); ?></th>
+                                                                                        </tr>
+                                                                                </thead>
+                                                                                <tbody id="vp_partners_tbody">
+                                                                                        <?php echo vayapin_connect_render_partner_rows( $vc_initial ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within renderer. ?>
+                                                                                </tbody>
+                                                                        </table>
+                                                                </div>
+                                                                <div class="vp-partners-footer">
+                                                                        <span id="vp_partners_count" class="vp-muted"><?php echo esc_html( sprintf( /* translators: %d: total partner count */ _n( '%d customer', '%d customers', (int) $vc_initial['total'], 'vayapin-woocommerce' ), (int) $vc_initial['total'] ) ); ?></span>
+                                                                        <div class="vp-partners-pager">
+                                                                                <button type="button" class="btn btn-ghost btn-sm" id="vp_partners_prev" disabled>&larr; <?php esc_html_e( 'Prev', 'vayapin-woocommerce' ); ?></button>
+                                                                                <button type="button" class="btn btn-ghost btn-sm" id="vp_partners_next"><?php esc_html_e( 'Next', 'vayapin-woocommerce' ); ?> &rarr;</button>
+                                                                        </div>
+                                                                </div>
+                                                        <?php endif; ?>
+                                                </div>
+                                        </div>
+                                </div>
+
+                                <div id="vp_record_modal" class="vp-reset-modal vp-record-modal" aria-hidden="true">
+                                        <div class="vp-reset-modal__backdrop" tabindex="-1" data-vp-record-close></div>
+                                        <div class="vp-reset-modal__dialog vp-record-modal__dialog" role="dialog" aria-modal="true" aria-labelledby="vp_record_modal_title">
+                                                <div class="vp-record-modal__head">
+                                                        <div>
+                                                                <div class="vp-record-modal__eyebrow"><?php esc_html_e( 'Verified contact record', 'vayapin-woocommerce' ); ?></div>
+                                                                <h2 id="vp_record_modal_title" class="vp-reset-modal__title vp-record-modal__title"></h2>
+                                                        </div>
+                                                        <span class="status-pill connected"><span class="status-pill-dot" aria-hidden="true"></span><?php esc_html_e( 'VayaPin verified', 'vayapin-woocommerce' ); ?></span>
+                                                </div>
+                                                <div class="vp-record-modal__body" id="vp_record_modal_body"></div>
+                                                <div class="vp-reset-modal__actions">
+                                                        <button type="button" class="btn btn-secondary vp-record-modal__close" data-vp-record-close><?php esc_html_e( 'Close', 'vayapin-woocommerce' ); ?></button>
+                                                </div>
+                                        </div>
+                                </div>
+
+                                <div id="vp_toast_modal" class="vp-reset-modal vp-toast-modal" aria-hidden="true">
+                                        <div class="vp-reset-modal__backdrop" tabindex="-1" data-vp-toast-close></div>
+                                        <div class="vp-reset-modal__dialog vp-toast-modal__dialog" role="alertdialog" aria-modal="true" aria-labelledby="vp_toast_modal_title">
+                                                <h2 id="vp_toast_modal_title" class="vp-reset-modal__title"></h2>
+                                                <p class="vp-reset-modal__text" id="vp_toast_modal_text"></p>
+                                                <div class="vp-reset-modal__actions">
+                                                        <button type="button" class="btn btn-primary vp-toast-modal__ok" data-vp-toast-close><?php esc_html_e( 'OK', 'vayapin-woocommerce' ); ?></button>
+                                                </div>
+                                        </div>
+                                </div>
+
                                 <div class="save-footer-meta">
                                         <div class="save-footer-version"><?php

vayapin/trunk/framework/backend-ui/webhook-logs.php

@@ -304 +304 @@
                                                 </td>
                                             </tr>
+                                            <?php if ( isset( $log->payload ) && '' !== (string) $log->payload ) : ?>
+                                                <tr class="vp-log-payload-row">
+                                                    <td colspan="6">
+                                                        <details>
+                                                            <summary><?php esc_html_e( 'Payload', 'vayapin-woocommerce' ); ?></summary>
+                                                            <pre class="vp-log-payload"><?php echo esc_html( (string) $log->payload ); ?></pre>
+                                                        </details>
+                                                    </td>
+                                                </tr>
+                                            <?php endif; ?>
                                         <?php endforeach; ?>
                                     </tbody>

vayapin/trunk/framework/frontend-ui/checkout-ui.php

@@ -399 +399 @@
             $pin_fields = array(
                 'country'       => $order->get_billing_country(),
+                // POST /v1/pins expects `name` as "first last"; a single token is rejected with
+                // "name: must include a last name" (see openapi.json, /v1/pins request body).
                 'name'          => trim($order->get_billing_first_name() . ' ' . $order->get_billing_last_name()),
                 'email'         => $order->get_billing_email(),

vayapin/trunk/framework/styles-scripts/styles-scripts.php

@@ -41 +41 @@
     );
 
+    // Mobile sheet: hosts the whole widget flow on phone-width screens.
+    $vayapin_sheet_css_path    = plugin_dir_path( dirname( __DIR__ ) ) . 'public/css/vayapin-sheet.css';
+    $vayapin_sheet_css_version = file_exists( $vayapin_sheet_css_path ) ? filemtime( $vayapin_sheet_css_path ) : '1.0.0';
+
+    wp_enqueue_style(
+        'vayapin-sheet-css',
+        plugin_dir_url( dirname( __DIR__ ) ) . 'public/css/vayapin-sheet.css',
+        array( 'vayapin-country-select-css' ),
+        $vayapin_sheet_css_version
+    );
+
+    $vayapin_sheet_js_path    = plugin_dir_path( dirname( __DIR__ ) ) . 'public/js/vayapin-sheet.js';
+    $vayapin_sheet_js_version = file_exists( $vayapin_sheet_js_path ) ? filemtime( $vayapin_sheet_js_path ) : '1.0.0';
+
+    wp_enqueue_script(
+        'vayapin-sheet',
+        plugin_dir_url( dirname( __DIR__ ) ) . 'public/js/vayapin-sheet.js',
+        array( 'jquery', 'vayapin-country-select-js' ),
+        $vayapin_sheet_js_version,
+        true
+    );
+
     // Enqueue and localize custom JS for initializing Select2 on desired elements
     $vayapin_select2_js_path    = plugin_dir_path( dirname( __DIR__ ) ) . 'public/js/vayapin-select2.js';
@@ -48 +70 @@
         'vayapin-select2-init',
         plugin_dir_url( dirname( __DIR__ ) ) . 'public/js/vayapin-select2.js',
-        array( 'jquery', 'select2-js' ),
+        array( 'jquery', 'select2-js', 'vayapin-sheet' ),
         $vayapin_select2_js_version,
         true

vayapin/trunk/framework/vayapin/api-methods.php

@@ -207 +207 @@
         error_log($e->getMessage());
     }
+}
+
+/**
+ * Pull code and message out of a VayaPin API error body.
+ *
+ * The API answers a 422 with { error: { code, message }, data: { errors: { field: [...] } } },
+ * older builds answered with a plain string in `error`. Reading only `$result['error']`
+ * yields an array on the current format, which silently logs an empty message.
+ *
+ * @param mixed $result        Decoded response body.
+ * @param int   $response_code HTTP status.
+ * @return array { code, message }
+ */
+function vayapin_extract_api_error( $result, $response_code ) {
+    $code    = '';
+    $message = '';
+
+    if ( is_array( $result ) ) {
+        if ( isset( $result['error'] ) && is_array( $result['error'] ) ) {
+            $code    = isset( $result['error']['code'] ) ? (string) $result['error']['code'] : '';
+            $message = isset( $result['error']['message'] ) ? (string) $result['error']['message'] : '';
+        } elseif ( isset( $result['error'] ) && is_string( $result['error'] ) ) {
+            $message = $result['error'];
+        }
+
+        if ( '' === $code && isset( $result['error_code'] ) && is_string( $result['error_code'] ) ) {
+            $code = $result['error_code'];
+        }
+        if ( '' === $message && isset( $result['message'] ) && is_string( $result['message'] ) ) {
+            $message = $result['message'];
+        }
+
+        // Per-field validation errors: { data: { errors: { phone_number: ["can't be blank"] } } }.
+        $field_errors = isset( $result['data']['errors'] ) ? $result['data']['errors'] : null;
+        if ( is_array( $field_errors ) ) {
+            $parts = array();
+            foreach ( $field_errors as $field => $messages ) {
+                $messages = is_array( $messages ) ? $messages : array( $messages );
+                $messages = array_filter( array_map( 'strval', $messages ) );
+                if ( $messages ) {
+                    $parts[] = $field . ': ' . implode( ', ', $messages );
+                }
+            }
+            if ( $parts ) {
+                $joined  = implode( '; ', $parts );
+                $message = '' !== $message ? $message . ' (' . $joined . ')' : $joined;
+            }
+        }
+    }
+
+    if ( '' === $code ) {
+        $code = 'HTTP_' . (int) $response_code;
+    }
+    if ( '' === $message ) {
+        $message = 'Unknown error (HTTP ' . (int) $response_code . ')';
+    }
+
+    return array(
+        'code'    => $code,
+        'message' => $message,
+    );
 }
 
@@ -293 +354 @@
     } else {
         // Failed
-        $error_code = isset($result['error_code']) ? $result['error_code'] : 'HTTP_' . $response_code;
-        $error_message = isset($result['error']) ? $result['error'] : (isset($result['message']) ? $result['message'] : 'Unknown error');
-        vayapin_log_pin_creation($order_id, 'failed', $error_code, $error_message, null, $result);
-        return new WP_Error('api_error', $error_message, array('status' => $response_code, 'response' => $result));
-    }
-}
+        $error = vayapin_extract_api_error($result, $response_code);
+        // Keep the raw body when it is not JSON, otherwise the reason is lost for good.
+        $logged_response = is_array($result) ? $result : array('raw_body' => (string) $body, 'http_code' => (int) $response_code);
+        vayapin_log_pin_creation($order_id, 'failed', $error['code'], $error['message'], null, $logged_response);
+        return new WP_Error('api_error', $error['message'], array('status' => $response_code, 'response' => $result));
+    }
+}

vayapin/trunk/includes/class-vayapin-activator.php

@@ -33 +33 @@
                 Vayapin_Activator::create_pin_logs_table();
                 Vayapin_Activator::create_webhook_logs_table();
+
+                // VayaConnect request-state table (function loaded from framework/connect/request-store.php).
+                if ( function_exists( 'vayapin_connect_create_requests_table' ) ) {
+                        vayapin_connect_create_requests_table();
+                }
+
+                // Flush rewrites so the /vayapin-intl-label/{id} route resolves.
+                flush_rewrite_rules();
         }
 

vayapin/trunk/public/js/vayapin-public.js

@@ -4 +4 @@
   var allowClose = true;
 
-  $(window).load(function () {
+  /**
+   * Close the country list through the plugin instance. Hiding the list by class
+   * alone leaves countrySelect's document-level keydown handler bound, and that
+   * handler calls preventDefault() on every key, which blocks typing and backspace
+   * in the VayaPin input.
+   */
+  function closeCountryList() {
+    var instance = $("#country_selector").data("plugin_countrySelect");
+
+    if (instance && typeof instance._closeDropdown === "function") {
+      instance._closeDropdown();
+      return;
+    }
+
+    $(".vayapin-pin-country-wrapper .country-list")
+      .addClass("hide")
+      .removeClass("v-hide");
+    $(".vayapin-pin-country-wrapper .selected-flag .arrow").removeClass("up");
+  }
+
+  function closeVayapinPopup() {
+    if (window.vayapinSheet && window.vayapinSheet.isOpen()) {
+      window.vayapinSheet.close(0);
+      $(".vayapin-checkout-button").attr("aria-expanded", "false");
+      return;
+    }
+
+    closeCountryList();
+    $(".vayapin-overlay").fadeOut(100);
+    $(".vayapin-checkout-dropdown").fadeOut(100);
+    $(".vayapin-checkout-button").attr("aria-expanded", "false");
+    // Stale "Not found" from the previous attempt must not greet the next one.
+    $(".vayapin-error-text").hide();
+  }
+
+  // jQuery 3 removed the .load() shortcut; it only still runs on sites that kept
+  // jQuery Migrate, and silently kills this file on the ones that dropped it.
+  $(window).on("load", function () {
     $(".vayapin-checkout-button").on("click", function (e) {
       e.stopPropagation();
+      $(".vayapin-error-text").hide();
+
+      // Phones get the whole flow in a bottom sheet, not a popup over the form.
+      if (window.vayapinSheet && window.vayapinSheet.shouldUse()) {
+        $(this).attr("aria-expanded", "true");
+        window.vayapinSheet.open();
+        return;
+      }
       $(".vayapin-overlay").fadeIn(100);
       $(".vayapin-checkout-dropdown").fadeIn(100);
@@ -14 +59 @@
     $(".vayapin-checkout-dropdown-close").on("click", function (e) {
       e.preventDefault();
-      $(".vayapin-overlay").fadeOut(100);
-      $(".vayapin-checkout-dropdown").fadeOut(100);
-      $(".vayapin-checkout-button").attr("aria-expanded", "false");
+      closeVayapinPopup();
     });
 
@@ -22 +65 @@
       if (e.key === "Escape" || e.keyCode === 27) {
         if ($(".vayapin-checkout-dropdown").is(":visible")) {
-          $(".vayapin-overlay").fadeOut(100);
-          $(".vayapin-checkout-dropdown").fadeOut(100);
-          $(".vayapin-checkout-button").attr("aria-expanded", "false");
+          closeVayapinPopup();
         }
       }
@@ -40 +81 @@
         // it bubbles up the country list is already hidden, so .has() misses it
         // and the whole popup would wrongly close (notably on mobile/touch).
-        !$(e.target).closest(".country-select, .country-list").length
+        !$(e.target).closest(".country-select, .country-list").length &&
+        // The mobile country sheet lives at body level, so any tap inside it
+        // counts as "outside" the popup unless excluded here.
+        !$(e.target).closest(".vp-sheet").length
       ) {
-        $(".vayapin-overlay").fadeOut(100);
-        $dropdown.fadeOut(100);
-        $(".vayapin-checkout-button").attr("aria-expanded", "false");
+        closeVayapinPopup();
       }
     });
@@ -64 +106 @@
     $(document).on(
       "touchstart mousedown",
-      ".country-select, .country-list",
+      ".country-select, .country-list, .vp-sheet",
       function () {
         allowClose = false;
@@ -75 +117 @@
     $(document).on(
       "touchend mouseup",
-      ".country-select, .country-list",
+      ".country-select, .country-list, .vp-sheet",
       function () {
         if (countryCloseTimer) {
@@ -92 +134 @@
       // sees this click because we stopPropagation() below.
       if (!$(e.target).closest(".country-select").length) {
-        $(".vayapin-pin-country-wrapper .country-list")
-          .addClass("hide")
-          .removeClass("v-hide");
-        $(".vayapin-pin-country-wrapper .selected-flag .arrow").removeClass(
-          "up"
-        );
+        closeCountryList();
       }
       e.stopPropagation();

vayapin/trunk/public/js/vayapin-select2.js

@@ -2 +2 @@
   "use strict";
 
-  $(window).load(function () {
+  // jQuery 3 removed the .load() shortcut; it only still runs on sites that kept
+  // jQuery Migrate, and silently kills this file on the ones that dropped it.
+  $(window).on("load", function () {
     /**
      * Initialize select2
@@ -161 +163 @@
         e.stopPropagation();
 
+        // Phone width gets the sheet's country screen instead of the anchored dropdown.
+        if (window.vayapinSheet && window.vayapinSheet.shouldUse()) {
+          window.vayapinSheet.openCountryView();
+          return;
+        }
+
         var $list = instance.countryList;
         if (!$list || !$list.length) return;
@@ -192 +200 @@
     });
 
+    // countrySelect binds a document-level keydown that preventDefault()s every key
+    // while its list is open. Without stopping the bubble here, typing and backspace
+    // in the VayaPin field are swallowed and the text cannot be edited.
+    $("#vayapin_input").on("keydown", function (e) {
+      e.stopPropagation();
+    });
+
     // Set the vaya pin in local storage and auto-set country
     $("#vayapin_input").on("input", function (e) {
+      // Editing the code means the previous "Not found" no longer applies.
+      $(".vayapin-error-text").hide();
+
       var value = $(this).val();
       $(this).val(value.toUpperCase());
@@ -253 +271 @@
         },
         success: function (response) {
+          if (window.vayapinSheet && window.vayapinSheet.isOpen()) {
+            window.vayapinSheet.close(0);
+          }
           $(".vayapin-overlay").fadeOut(100);
           $(".vayapin-checkout-dropdown").fadeOut(100);
@@ -281 +302 @@
 
   /**
+   * Write a value into a checkout field and let WooCommerce re-run its own
+   * validation for it. WooCommerce binds validate_field to "input validate change",
+   * so without a trigger a "required field" error raised before the autofill keeps
+   * showing on a field that now has a value.
+   */
+  function setCheckoutField($field, value) {
+    if (!$field.length) return;
+
+    $field.val(value);
+
+    // Empty value: leave whatever validation state the field already had.
+    if (value === undefined || value === null || value === "") return;
+
+    $field.trigger("input").trigger("change").trigger("validate");
+  }
+
+  /**
+   * Remove the summary block from a previous failed "Place order" attempt once no
+   * field is flagged invalid anymore. Only the checkout notice group is touched,
+   * so coupon/payment notices stay.
+   */
+  function clearStaleCheckoutNotices() {
+    var $form = $("form.checkout");
+    if (!$form.length) return;
+    if ($form.find(".woocommerce-invalid").length) return;
+
+    $(".woocommerce-NoticeGroup-checkout").remove();
+  }
+
+  /**
    * Fill out fields in the checkout form
    */
   function fillOutFields(data) {
-    // Fill first name field (from title)
-    $("#billing_first_name").val(data.title);
-
-    // Fill last name field (from subtitle)
-    $("#billing_last_name").val(data.subtitle);
-
-    // Fill company field (from description)
-    $("#billing_company").val(data.description);
-
-    // Fill email field
-    $("#billing_email").val(data.email);
-
-    // Fill phone field
-    $("#billing_phone").val(data.phone);
-
-    // Fill address fields
-    $("#billing_address_1").val(data.address_1);
-
-    $("#billing_address_2").val(data.address_2);
-
-    // Fill city field
-    $("#billing_city").val(data.city);
-
-    // Fill postcode field
-    $("#billing_postcode").val(data.postcode);
-
-    // Set country first and wait for state field to update
-    $("#billing_country").val(data.country).trigger("change");
+    setCheckoutField($("#billing_first_name"), data.title);
+    setCheckoutField($("#billing_last_name"), data.subtitle);
+    setCheckoutField($("#billing_company"), data.description);
+    setCheckoutField($("#billing_email"), data.email);
+    setCheckoutField($("#billing_phone"), data.phone);
+    setCheckoutField($("#billing_address_1"), data.address_1);
+    setCheckoutField($("#billing_address_2"), data.address_2);
+    setCheckoutField($("#billing_city"), data.city);
+    setCheckoutField($("#billing_postcode"), data.postcode);
+
+    // Country rebuilds the state field, so it goes first and on its own.
+    var $country = $("#billing_country");
+    if ($country.length && data.country) {
+      $country.val(data.country).trigger("change").trigger("validate");
+    }
+
+    clearStaleCheckoutNotices();
 
     // Wait for country change to complete and state field to reload
     setTimeout(function () {
       var $stateField = $("#billing_state");
-      if (
-        $stateField.length &&
-        $stateField.hasClass("select2-hidden-accessible")
-      ) {
-        var stateValue = data.state;
-        var stateText = data.state;
-
-        // Create option if it doesn't exist
-        var $existingOption = $stateField.find(
-          "option[value='" + stateValue + "']"
-        );
-        if ($existingOption.length === 0) {
-          var $newOption = new Option(stateText, stateValue, true, true);
-          $stateField.append($newOption);
+
+      if ($stateField.length && data.state) {
+        if ($stateField.is("select")) {
+          var stateValue = data.state;
+          var $existingOption = $stateField.find(
+            "option[value='" + stateValue + "']"
+          );
+
+          if ($existingOption.length === 0) {
+            $stateField.append(new Option(stateValue, stateValue, true, true));
+          } else {
+            $existingOption.prop("selected", true);
+          }
+
+          $stateField.val(stateValue).trigger("change").trigger("validate");
+
+          if ($stateField.hasClass("select2-hidden-accessible")) {
+            $stateField.trigger("select2:select", {
+              params: { data: { id: stateValue, text: stateValue } },
+            });
+          }
         } else {
-          $existingOption.prop("selected", true);
-        }
-
-        // Modern Select2 approach
-        $stateField.val(stateValue).trigger("change");
-
-        // Alternative: trigger select2:select event
-        $stateField.trigger("select2:select", {
-          params: { data: { id: stateValue, text: stateText } },
-        });
-      }
+          setCheckoutField($stateField, data.state);
+        }
+      }
+
+      clearStaleCheckoutNotices();
     }, 500);
   }

vayapin/trunk/uninstall.php

@@ -36 +36 @@
 $wpdb->query( "DROP TABLE IF EXISTS {$wpdb->prefix}vayapin_notification_logs" );
 
+// Drop VayaConnect request-state table (added in 2.2.0).
+$wpdb->query( "DROP TABLE IF EXISTS {$wpdb->prefix}vayapin_connect_requests" );
+
 // Strip removed option keys from the main options array so re-installs start clean.
 $vp_options = get_option( 'vayapin_woocommerce_options' );

vayapin/trunk/vayapin.php

@@ -17 +17 @@
  * Plugin URI:        https://vayapin.com
  * Description:       Add VayaPin checkout autofill and delivery QR stickers to your WooCommerce store.
- * Version:           2.1.2
+ * Version:           2.3.2
  * Author:            Vayapin
  * Author URI:        https://vayapin.com/
@@ -38 +38 @@
  * Rename this for your plugin and update it as you release new versions.
  */
-define( 'VAYAPIN_VERSION', '2.1.2' );
+define( 'VAYAPIN_VERSION', '2.3.2' );
 
 if ( ! defined( 'VAYAPIN_PLUGIN_FILE' ) ) {
@@ -102 +102 @@
 
 /**
+ * VayaConnect: outbound request + inbound webhook receiver + Partners surface.
+ * Contract-dependent pieces are stubbed behind framework/connect/connect-config.php.
+ */
+require_once 'framework/connect/connect-config.php';
+require_once 'framework/connect/request-store.php';
+require_once 'framework/connect/partners.php';
+require_once 'framework/connect/record.php';
+require_once 'framework/connect/label-intl.php';
+require_once 'framework/vayapin/connect-api.php';
+require_once 'framework/vayapin/connect-webhook.php';
+
+/**
  * Begins execution of the plugin.
  *