Version 0.14.0 Release Notes for the Buy with Prime Cartridge
Buy with Prime API is now available for early access
Sign up for early access to the Buy with Prime API using the 'Sign Up' button below. The API may change as Amazon receives feedback and iterates on it.
Version 0.14.0 of the Buy with Prime cartridge for Salesforce Commerce Cloud uses Buy with Prime API version 2024-11-01.
The prerequisites for using the cartridge remain the same as for earlier versions of the cartridge. For details about dependencies, see Install the Buy with Prime Cartridge.
Consider the following changes in cartridge version 0.14.0.
Salesforce Commerce Cloud customer experience improvements
Version 0.14.0 introduces several customer experience improvements to enhance the Buy with Prime shopping journey on SFCC storefronts.
Buy Now button
The Buy Now button automatically adds the current product to the cart and directs the shopper to checkout. The cartridge only enables Buy Now for products that are eligible for Buy with Prime. After choosing Buy Now, the shopper can still select any available checkout method.
Configuration
BWP_PDP_Buy_Now_Enabled: Global setting to enable the Buy Now button for products that are eligible for Buy with Prime. By default, this is set toFALSE.isBuyNowEnabled: Enable or disable the Buy Now button for specific products.
Prime sign-in shipping method
The Prime sign-in shipping method lets the shopper view the Prime delivery option before they sign in. The cartridge displays a dedicated Buy with Prime shipping method with a Prime badge during checkout. The cartridge displays this shipping method when the shopper hasn't signed in to indicate availability of Prime benefits.
The shipping method includes a sign-in button. When the shopper signs in, the cartridge redirects them to Amazon authentication and displays the estimated delivery date and free shipping label.
Sign-in capability from product detail page Delivery Promise card
This improvement lets the shopper sign in with the Delivery Promise card within the product detail page (PDP), increasing visibility and accessibility of the sign-in option for Prime members. When the shopper signs in, the cartridge now automatically applies Prime delivery options and data to the order.
Enhanced delivery card help
The delivery card now includes an information link that provides an overview of Prime shipping benefits to help the shopper understand the Prime delivery promise without leaving the page.
Custom fields for OMS integration
Custom fields in the storefront order document
The Salesforce Cartridge now populates custom fields in the storefront order document to meet order management system (OMS) requirements. The cartridge structures fields to support integration with major ERP systems and includes proper mapping for Amazon identifiers and fulfillment data.
The cartridge populates the following custom Buy with Prime attributes:
Order-level attributes
| Attribute name | Attribute level | Type | Attribute identifier | Description |
|---|---|---|---|---|
| Order Country | Order | String | c_orderCountry | Identifies the geolocation for the order. Defaults to US for Buy with Prime Release 1.0 |
Order-line level attributes
| Attribute name | Attribute level | Type | Attribute identifier | Description |
|---|---|---|---|---|
| Amazon Order ID | Order-line | String | c_amazonBwpOrderID | Order ID for the line. Contains data when the storefront submits the order to Amazon. |
| Delivery Provider | Order-line | String | c_deliveryProvider | Fulfillment provider for the line. Values: AMAZON or MERCHANT |
| Amazon Line Item Alias | Order-line | String | c_BWP_EXTERNAL_LI_ID | Line item identifier for the line. The cartridge populates this field during order submission to Amazon. |
| Is Amazon Fulfillable | Order-line | String | c_isAmazonFulfillable | Returns Y for all Buy with Prime and Amazon MCF lines. Otherwise, returns N. |
| Is Prime Eligible | Order-line | Boolean | c_isPrimeBuyable | Returns True for all Buy with Prime eligible lines. Otherwise, returns False |
| Amazon Delivery Preview ID | Order-line | String | c_deliveryPreviewId | Delivery Preview ID for Buy with Prime lines. |
| Amazon Delivery Offer ID | Order-line | String | c_deliveryOfferId | Delivery offer ID for Buy with Prime lines. |
| Is Amazon Return Eligible | Order-line | Boolean | c_isAmazonReturnEligible | Returns True when eligible for Amazon return. |
Technical improvements
- Enhanced order object structure to include all required custom Buy with Prime fields.
- Improved test coverage for custom fields validation.
Enable custom fields
To upload the new metadata file, do the following.
- On the Administration menu, choose Site Development, and then choose Import & Export.
- Upload the metadata file:
link_amazon_bwp/metadata/meta/system-objecttype-definitions.xml. - Import the metadata file.
Related topics
Updated about 8 hours ago