2023

Commerce API release notes for 2023.

2023/12/11

We have introduced new features in Global Commerce that allow you to manage product combinations in the cart more efficiently. With the latest update, you can create a single product by combining multiple sellable SKUs (components) and setting the price and configuration of the bundled products per your pricing or product combination strategies.

In addition, we have added the ability to handle the cancellation and return of all components of a product combination together. When enabled, this feature will cancel unfulfilled items while setting fulfilled ones for return, making it easier to manage returns and cancellations.

Furthermore, you can set a Cart Item Limit for a Commerce API environment while configuring Global Commerce site settings. This setting enables you to restrict the number of items per cart, ensuring an optimal order size and improving processing performance.

You now can access your combined product and component details directly from the API payloads. This empowers you to use Commerce APIs to adjust your Product Detail Page, Cart Page, and Return/Refund pages. Some of the supported APIs include, but are not limited to:

• GET /v1/shoppers/me/products/{productId}

• GET /v1/shoppers/me/carts/active

• POST /v1/shoppers/me/carts/active

• GET /v1/shoppers/me/carts/active/line-items/{lineItemId}

• POST /v1/shoppers/me/carts/active/line-items/{lineItemId}

• GET /v1/shoppers/me/orders/{orderId}

• POST /v1/shoppers/me/orders/{orderId}/returns

• POST /orders/{orderId}/refunds

The Commerce API Webhook Service is now easier to use. Previously, you could only authenticate the endpoint via OAuth using API configuration. However, now you can manage OAuth authentication effortlessly through Global Commerce!

2023/11/13

We added support for recurring payments to Apple Pay.

2023/10/5

• We added a tax_service_invalid_hsCode_warning to Warnings to let you know when your provided HS code is incorrect when creating a product.

• Digital River implemented a new feature that enhances tax calculation for certain US states by adding ZIP Codes and geocodes support. This feature addresses the specific tax calculation needs of regions that rely on geocodes and ZIP Codes. This enhancement will significantly improve tax calculation accuracy for users in regions where both ZIP Codes and geocodes are essential. This feature is available automatically; there is no need to enable anything. We also added the invalid-postal-code to the list of 409 Conflict codes.

2023/10/3

We added support for tax-inclusive landed costs with a pretty price. The tax-inclusive landed cost enhancement ensures that the prices specified by the client for the product price and shipping cost become the final prices for the order. Tax-inclusive landed cost includes the following enhancements:

• Users can now set the product price and shipping cost as tax-inclusive in Global Commerce.

• Users can see the landed cost for the shipping charge in the payload.

2023/9/28

We added examples for creating a Digital River-hosted and client-hosted shopper and initiating an authenticated session for a Digital River-hosted and client-hosted shopper.

2023/8/31

• Digital River has recently added CCAvenue to its payment method options. CCAvenue is a payment processing option for Digital River clients with an Indian bank account. This auto-settle payment method offers various local payment options in India, such as Credit Cards, Wallet, Net Banking, and UPI.

• We added Testing the CCAvenue payment method to Testing scenarios.

• We also added the Payment required columns to the Supported payment methods table.

2023/8/24

In Commerce API, we added.

• Payment flow descriptions to ensure a smooth payment process for each payment type. These payment flows follow Digital River's recommended best practices.

• An Addendum required column to the Supported payment methods table.

2023/8/23

We updated the shopper token information for the OAuth Token in the Shopper APIs reference.

2023/8/22

We added the following reasons to the validation-error in 400 Bad Request.

• The total product quantity for the current subscription plan and midterm change exceeds the product quantity restriction.

2023/5/22

We have included a guide on how to handle bulk product uploads asynchronously.

2023/5/12

We are excited to announce our new feature, Product Combination Supporting Subscriptions for Global Commerce. This feature allows you to include subscription products in a product combination and adjust the price to match your pricing or product combination strategies. Combining multiple SKUs from different product lines into a single product combination allows you to recognize revenue for each product line based on the component price. This feature also helps you address compliance concerns and minimize revenue loss from customers trying to break bundle offers and purchase products at a reduced price.

2023/5/10

With our mixed cart feature, a shopper can create a cart that includes physical and digital products. Our feature uses the landed cost solution to calculate the total cost of your purchase, which is only determined once all items in the cart are deemed eligible. If you need help enabling landed cost and pretty price, don't hesitate to contact your Customer Success Manager for assistance.

2023/4/5

• We enabled GitBook AI, a semantic search tool, on the Documentation Portal.

  To find GitBook AI, click the Search bar in the upper right corner.

  

  Type your question in the Ask or search field and click Ask "{{Search content}} using GitBook AI. You can ask GitBook AI anything regarding Digital River features. It will give you plain English answers in seconds. For example, you can ask for an overview of a feature, and GitBook AI will return a quick and concise answer. Note: While semantic search can provide robust answers, sometimes the answers may be wrong. If you think the answer is incorrect, use the regular search to locate information."

  

  Additionally, GitBook AI will provide follow-up questions that you might be interested in.

  

  You can also see where GitBook AI found the information and click to read more.

  

  You can ask for a code snippet for an API.

  

  You can ask for the steps to perform a specific task.

  
• We added Box Shadow as an available custom style when configuring custom styles for DigitalRiver.js with Elements.

2023/3/29

• We made the following enhancements to the Admin APIs service:

  • We added Order Management to the Admin APIs. This API lets you fetch the complete information for anonymous and authenticated orders with an admin token.

  • We added the Retrieve Invoice API to the Admin APIs. This API allows you to download invoices for both anonymous and authenticated orders with an admin token. Users can subscribe to the order.invoice.created event to receive a notification when an invoice is ready for download.

  To start using the new Admin API services, ask your Digital River representatives to add the service to your key. To receive notifications from the webhook service, enable the webhook service on your site. Contact your Digital River representatives for assistance with the service enablement and configure all self-service webhooks through Global Commerce.

• We replaced the Commerce API reference with a Commerce API suite that includes the following API references:

  • Shopper APIs reference: This API reference provides the resources for an end-to-end eCommerce experience used when our Global Commerce platform is the system of record. The Shopper APIs allow clients to build a storefront, create shopper workflows, operate their store, and display products. For more information, see Shopper APIs, Shopper APIs reference, Common Shopper and Admin APIs, and Common Shopper and Admin APIs reference.

  • Admin APIs reference: This API allows administrators to programmatically create, update, deploy, and retire products on your storefront, create and edit products in bulk, manage product data, and manage sites and subscriptions. Use the Admin APIs to host the Cart and Checkout pages and manage your products via API. For more information, see Admin APIs, Admin APIs reference, Common Shopper and Admin APIs, and Common Shopper and Admin APIs reference.

• We updated the following topics:

  • Getting started

  • Error codes

• We added the following information:

  • How to resume cart submission

  • Considerations for landed costs

  • Best practice flows by payment type

• We added the following subscription notification enhancements:

  • Sending an expired credit card notification

  • Sending a subscription renewal reminder

  • Sending a payment failure notification

2023/3/16

Digital River adds Clearpay to the payment method roster! By leveraging Afterpay, your shoppers can buy now and pay for their purchases in 3 interest-free payments over 60 days. Learn how you can add Clearpay here.

2023/3/14

Amazon Pay is a global digital wallet paving the way for your brand to gain visibility and access to millions of existing Amazon customers. This payment method boasts a highly secure and seamless checkout experience, leveraging saved shipping and payment information in the shopper's Amazon account. As a result, the shopper can complete their transactions in 3 simple clicks and almost twice as fast as other payment options. Digital River supports Amazon Pay Checkout.