--- schema_version: "1" id: 6d6640f0bc219af06271b0cb28fcbd13e4d9c0d05699b53706b9391fd3155777 title: Point of Sale API Release Notes collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/retail-cloud/reference/about/about.md canonical_url: https://developer.salesforce.com/docs/commerce/retail-cloud/references/about-retail-cloud-api/about.html source_site: developer.salesforce.com content_type: documentation content_hash: 7b915805a3404b63e01b4a8927f559503e4be40827ef2a7f46eb82eaf59c8204 products: - Point of Sale for Developers - Salesforce APIs --- # Point of Sale API Release Notes Use Point of Sale (POS) APIs, Service Provider Interfaces (SPIs), and webhooks to extend your retail operations. - To learn about using POS APIs, see the [Guides](/docs/commerce/retail-cloud/guide). - To browse the API endpoints, use the left navigation. POS APIs are broken into three main groups: APIs, SPIs, and webhooks. - To download the full specification, see [POS API (Full Specification)](https://developer.salesforce.com/docs/commerce/retail-cloud/references/pos-oas?meta=Summary). ## 08/17/2026 ### API Updates - [Fulfillment Order API](https://developer.salesforce.com/docs/commerce/retail-cloud/references/fulfillment-order-api?meta=Summary): New cancellation endpoint and request field added: - **Cancel BOPIS Items** (`POST /merchant/v1/sa/fulfillment/orders/{bopisOrderId}/stores/{storeId}/bopis/cancel`): Cancel BOPIS (Buy Online, Pick up in Store) items for a specific order and store, with support for cancellation reasons. - **`lastPickupDate`** (optional field on `FulfillmentOrder` request): Specifies the deadline for BOPIS order pickup in ISO_LOCAL_DATE format (`yyyy-MM-dd`). Used for display purposes and automated cancellation logic. ## 07/14/2026 ### New SPI: Payment Gateway SPI (Beta) - [Payment Gateway SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/references/payment-spi?meta=Summary): **Beta.** Integrate third-party payment gateway terminals (for example, Worldpay or Stripe Terminal) with POS. A store-local proxy server acts as an intermediary between the POS iOS client and payment gateway terminals, handling terminal communication, gateway protocol translation, and real-time event streaming over WebSockets so that new gateway integrations can be added without modifying the iOS application. For architecture, security modes, and client-side timeouts, see [Integrate Payment Gateways Using the Payment Gateway SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/guide/payment-gateway-spi.html). This SPI is maintained in its own specification, outside of the [POS API (Full Specification)](https://developer.salesforce.com/docs/commerce/retail-cloud/references/pos-oas?meta=Summary). Use of this beta service is subject to the [Beta Services Terms](https://www.salesforce.com/company/legal/agreements/). ## 05/28/2026 ### Point of Sale API Version 2.3.4 Release #### New APIs and SPIs - [Fiscal SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/references/fiscal-spi?meta=Summary): New SPI for fiscal integration operations. This SPI enables POS to delegate fiscal operations (SALE, RETURN, LOGIN, LOGOUT, etc.) to a merchant-provided SI connector and includes three endpoints: - **Fiscal Health Check SPI**: Verify fiscal middleware/service availability before processing operations. - **Fiscal Control Transaction SPI**: Handle control transactions such as LOGIN, LOGOUT, ABORT_TRANSACTION, CASH_IN, CASH_OUT, STORE_CLOSE, ZERO_RECEIPT, and DELETE_CART_ITEM. - **Fiscal Transaction SPI**: Handle fiscal transactions for SALE, RETURN, EXCHANGE, and DUPLICATE_PRINT operations. - Configure in CMS under **Store Management** | **Integration** | **Custom API Connectors** with API Key `FISCAL_SERVICE`. - [Visual Search SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/references/visual-search-spi?meta=Summary): New SPI for visual product search that uses external image recognition providers. This SPI enables store associates to search products by photographing them with the POS device camera and includes two endpoints: - **Visual Search API** (`POST /products/upload`): Uploads an image for visual product search using multipart/form-data. Maps to `VISUAL_SEARCH_UPLOAD` connector. **Required.** - **Product Filter API** (`POST /products`): Filters, sorts, or paginates visual search results using JSON body with searchId. Maps to `VISUAL_SEARCH` connector. **Optional** - only required if supporting pagination, filtering, or sorting. - Configure in CMS under **Store Management** | **Integration** | **Custom API Connectors** with API Keys `VISUAL_SEARCH_UPLOAD` and `VISUAL_SEARCH`. - Enable in **Modules** | **Search** | **Visual Search** to show camera icon in Retail Cloud POS. - [Wishlist SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/references/wishlist-spi?meta=Summary): New SPI to perform wishlist operations via a customer-managed provider adapter. This SPI enables retailers to integrate any wishlist provider without Retail Cloud engineering involvement and includes one endpoint with three operations: - **Get Customer Wishlist** (`GET`): Retrieves customer wishlist as a list of product IDs. - **Add Products to Wishlist** (`POST`): Adds one or more products to customer wishlist. Supports bulk operations. - **Remove Product from Wishlist** (`DELETE`): Removes a product from customer wishlist using query parameter. - The API returns product IDs only; POS enriches them with full product details from Solr. - Configure in CMS under **Store Management** | **Integration** | **Custom API Connectors** with API Key `WISHLIST`. #### API Updates - [Fulfillment Order API](https://developer.salesforce.com/docs/commerce/retail-cloud/references/fulfillment-order-api?meta=Summary): New cancellation endpoints added: - **Cancel BOFIS Items** (`POST /merchant/v1/sa/fulfillment/orders/{bofisOrderId}/stores/{storeId}/bofis/cancel`): Cancel BOFIS (Buy Online, Fulfill In Store) items. - **Cancel ROPIS Items** (`POST /merchant/v1/sa/fulfillment/orders/{orderId}/stores/{storeId}/ropis/cancel`): Cancel ROPIS (Reserve Online, Pick In Store) items. --- ## 04/20/2026 ### Point of Sale API Version 2.3.3 Release #### New APIs and SPIs - [Gift Card SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/references/gift-card-spi?meta=Summary): New SPI for gift card operations including balance check, activation, adding funds, redemption, and void/reversal operations. Configure in CMS under **Store Management** | **Integrations** | **Custom Connectors** with API Key `GIFT_CARD_SERVICE`. - [Warranty SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/references/warranty-spi?meta=Summary): New SPI for warranty eligibility checks. Implement this endpoint to retrieve eligible warranty products for merchandise items in the cart. Configure in CMS with API Key `WARRANTY_LOOKUP`. - [Quote SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/references/quote-spi?meta=Summary): New SPI for quote management operations. - [Promotion Events Webhook](https://developer.salesforce.com/docs/commerce/retail-cloud/references/promotion-events-webhook?meta=Summary): New webhook for promotion event notifications. #### API Updates - Merchant API endpoints now document v1 as the only supported version. - [Store Group Management API](https://developer.salesforce.com/docs/commerce/retail-cloud/references/store-group-management-api?meta=Summary): Request bodies are now documented. #### SPI Updates - [Clienteling SPI](https://developer.salesforce.com/docs/commerce/retail-cloud/references/clienteling-spi?meta=Summary) (Create/Update Customer): - `addressList` deprecated in requests only (still returned in responses). - `customerLoyaltyProfile` field deprecated from spec (use `loyaltyProfile` instead). - Customer Profile and Wallet: New fields added to support card-on-file and payment imprint functionality. #### Documentation Updates - Full [Point of Sale API specification](https://developer.salesforce.com/docs/commerce/retail-cloud/references/pos-oas?meta=Summary) is now available for download.