portage-ucp-bigcommerce 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a71c96dc602da8be5b13f7356611d8172038c49c8b9d42d8d5b2208e9e2213f
-  data.tar.gz: 0137c7b98d2e2578320aa73608b85acbc5a7f5d826f4ea0e34a6cab9e4e6e5b2
+  metadata.gz: 608b4a53ae0a7392f15442bba6232678962d390314e7174715ffca940dba6496
+  data.tar.gz: f55e4cbc4d56e73bc35c5368c59a8d2f831d2895b9110c03383fff81851384a8
 SHA512:
-  metadata.gz: f8760851e94163dfa43272181da97bd191b137f7315076b1471aed3469b10fa88b840897986b4836d5a5a72da1949b180684b6427beff6c0f99313fca40a8c68
-  data.tar.gz: 638a13c5fd1441e3ad7d4b42196e4ce7aac87034de7580ecfc33d20dbf780bb9fe6f67f246c7b320e8c42779f96152fc7d06a89ba613ddc9f01170fa2771ef12
+  metadata.gz: b76a1bd7332fc964e495da185bde5bc6943c7f2f193587fdcb9a5001d18ca01fe4f8284f25931cfe505809bd199c088fb02c48d1e667cf7bfd05bfdcb1b89283
+  data.tar.gz: e228f872c5e017b451074dc422b02a601b6b28908e8819211686b7c00508d51b83bd33c851b5ef8eeeb9385adcf8a6cfe7b95d6f5a576671ede013a81fb3c17b

data/CHANGELOG.md

@@ -6,6 +6,10 @@ pre-1.0, so APIs may still shift between minor versions.
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-10-07
+
+- **Fixed: a checkout the shopper paid for in the browser now reads as `completed` from a new process.** Status lived only in the creating process, so `portage orders reconcile` always saw `incomplete`, and once BigCommerce deleted the paid cart, not-found. `#get_checkout` now asks v2 List Orders for an order with this `cart_id` in a paid status (Shipped, Awaiting Fulfillment, Completed and the like; not Awaiting Payment, Pending or Incomplete) and then reports `completed` with the `order` confirmation, rebuilding the checkout from that order if the cart is gone. No order, or a failed lookup, keeps `incomplete`/not-found. Needs `portage-ucp` 0.13.0 for the `CheckoutState` platform hook, so the gem now requires `portage-ucp` `~> 0.13`. Patch-level.
+
 ## [0.2.0] - 2026-10-05
 
 - **Removed the unused `Client#v2_post` and `Client#v3_put`.** Nothing in the gem called them. They were public on the client class, so this is **breaking** for any caller using them directly; minor-level for a pre-1.0 gem.

data/lib/portage/ucp/bigcommerce/adapter.rb

@@ -43,6 +43,16 @@ module Portage
         # than an empty body, which UCP's reads report as nil.
         include Portage::Ucp::Support::NotFound
 
+        # Order statuses that mean the shopper placed and paid the order
+        # (https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-status/get-order-statuses):
+        # 2 Shipped, 3 Partially Shipped, 4 Refunded, 8 Awaiting Pickup,
+        # 9 Awaiting Shipment, 10 Completed, 11 Awaiting Fulfillment ("payment
+        # has been confirmed"), 13 Disputed, 14 Partially Refunded. Left out:
+        # 0 Incomplete and 1 Pending (checkout not finished), 7 Awaiting
+        # Payment (not confirmed yet), 12 Manual Verification Required, and
+        # 5 Cancelled / 6 Declined, which stay pending rather than guess.
+        PLACED_ORDER_STATUS_IDS = [2, 3, 4, 8, 9, 10, 11, 13, 14].freeze
+
         def initialize(client:, site_url:, currency:, payment_gateway_id: nil)
           super()
           @client = client
@@ -114,11 +124,16 @@ module Portage
           end
         end
 
+        # A paid checkout's cart is deleted ("Once the order is paid, the
+        # cart is deleted", Create an Order docs), so a not-found here falls
+        # back to the order BigCommerce placed from it, if any (see
+        # #platform_checkout_order).
         def get_checkout(checkout_id:)
-          nil_on_not_found do
-            node = fetch_checkout_node(checkout_id)
-            node && Mapper.checkout(node, id: checkout_id, status: checkout_status(checkout_id))
-          end
+          node = nil_on_not_found { fetch_checkout_node(checkout_id) }
+          return checkout_from_platform_order(checkout_id) unless node
+
+          Mapper.checkout(node, id: checkout_id, status: checkout_status(checkout_id),
+                                order: checkout_order(checkout_id))
         end
 
         # Full replacement, same rationale as #update_cart — BigCommerce's
@@ -158,6 +173,20 @@ module Portage
 
         private
 
+        # Support::CheckoutState's platform hook. v2 List Orders filters on
+        # `cart_id`, "the cart ID from which this order originated", and the
+        # checkout id here *is* the cart id
+        # (https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/get-orders).
+        # v2 answers an empty list with 204 and no body, which parses as {}.
+        def platform_checkout_order(checkout_id)
+          orders = @client.v2_get("/orders?cart_id=#{URI.encode_www_form_component(checkout_id)}")
+          placed = Array(orders).find { |o| o.is_a?(Hash) && PLACED_ORDER_STATUS_IDS.include?(o["status_id"]) }
+          return nil unless placed
+
+          Mapper.order(placed, products: @client.v2_get("/orders/#{placed['id']}/products"), site_url: @site_url,
+                               checkout_id: checkout_id)
+        end
+
         def fetch_cart_node(cart_id)
           include_param = "line_items.physical_items.options,line_items.digital_items.options"
           @client.v3_get("/carts/#{cart_id}?include=#{include_param}")["data"]

data/lib/portage/ucp/bigcommerce/version.rb

@@ -1,7 +1,7 @@
 module Portage
   module Ucp
     module BigCommerce
-      VERSION = "0.2.0".freeze
+      VERSION = "0.2.1".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: portage-ucp-bigcommerce
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Tom Whitbread
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-05 00:00:00.000000000 Z
+date: 2026-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: portage-ucp
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.13'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.13'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement