Release notes

Search…
Release notes
Keep track of changes and updates to the Commerce API.
V1 is the base version of the Commerce API. The following dates indicate when we released updates to this version.
2022/6/16
We added support for applying store credit to non-recurring transactions. Store credit allows merchants to offer customers a store credit as a payment type at checkout.
We now support two payments in a cart.
You can now detach a payment from a cart.
You can now create secondary sources through the Sources API by sending your confidential API key in a POST /sources request.
2022/6/1
We restructured the API tags and descriptions for the Shopper API as follows:
Renamed Apply Payment Methods to Apply or Detach Payment Methods and added the Detach all applied payment methods from the cart.
Restructured the offer API tags and revised their descriptions for Retrieve all POP offers for a cart and Retrieve all offers.
Updated the sample payload for Retrieve cart applied offers.
Added Update shopper payment options.
We moved the following webhook APIs under Webhook Event Management:
​Get all webhook subscriptions​
​Create a new webhook​
​Get a specific webhook by ID​
​Delete a webhook​
​Update a webhook​
We added Payment Source and added the following source APIs:
​Get a source by source by identifier​
​Create a secondary source​
Added cart-charge-failure to the list of 409 Conflict errors in Error codes.
2022/5/6
We updated the authorization decline codes for customer-initiated and merchant-initiated transactions.
We added more error codes, including the credit card error codes and a DNS outage error message.
2022/4/1
We upgraded Google Pay to offer the up-to-date Google Pay wallet experience. You can now configure the dynamic Google Pay button by applying your preferred button styles.
2022/3/28
We added support for the iDEAL payment method.
2022/3/16
We added support for the Bancontact payment method.
2022/1/26
We added support for the Boleto payment method.
2021/12/3
We added the ability to update the subscription billing email address and shipping email address. 
We added the applyEmailToSubscriptions field to Update current shopper.
2021/10/4
We added a new legal entity, Digital River UK Limited.
2021/10/1
We added the ability to create a refund for a delayed payment method such as Konbini, and Wire Transfer.
2021/9/29
We added the ability to receive payment detail update notifications when a shopper updates their payment details for a subscription.
2021/9/16
We added the ability to remove a tax identifier from a cart.
We added the trigger to the offer object response. The possible values are: 
Always Triggered–The offer is available to any shopper in your store. Shoppers simply have to meet the conditions you set up in the offer for the offer to be triggered and redeemed by shoppers.
User Triggered–To redeem an offer, the shopper must take additional actions such as click a link or enter a coupon code.
You can set the trigger when you configure the offer type in Global Commerce.
We added the ability to add or remove the organization identifier (client_reference_id) to a cart for the TreviPay payment method.
2021/9/7
We added the ability to set the renew reminders for trial subscriptions.
2021/9/1
We added the ability for a Customer Service Representative to cancel an order in Global Commerce.​
We added the ability to use the Expired Card Optimizer (ECO) for third-party subscription engine renewal orders. 
We added support for attaching a tax ID to a cart using the tax registration resource. 
We expanded the pay later options that are now available in the PayPal Wallet, including PayPal RatenZahlung for German shoppers.
2021/8/12
We added instructions on how to get the inventory for a specific product.
2021/8/6
We added supportsStorage to indicate whether a payment method supports storage to Retrieving available payment methods.
2021/7/29
We expanded the pay later options that are now available in the PayPal Wallet, including PayPal Pay in 4 for shoppers in Australia and France, as well as PayPal Pay in 3 and PayPal Credit for UK shoppers.
2021/7/27
You can now use the Delayed Payment Instructions element to generate a template that contains the instructions that explain how to complete payment for delayed payment types such as Konbini and Wire Transfer.
2021/7/26
You can now customize and control your subscription email notifications through events notifications and webhooks. This feature allows you to control your communications with your consumers, including integrating the capabilities of leading notification providers.
2021/7/7
We added the ability to create a trial subscription for a subscription product and configure trial renewal reminders in Global Commerce.
2021/7/2
We added support for Pay in 3 to the PayPal payment method.
2021/6/3
We made the following changes to Subscriptions API:
In the response for GET /v1/subscriptions/{subscriptionId} , added shopper and renewalPrice to the subscription information attributes. We also added renewalPrice to the addOn object.
We made the following changes to the Shopper API to allow you to suppress an order confirmation email.
Added the suppressorderconfirmationemail parameter to Add line items to a cart and Update current cart.
Added the suppressOrderConfirmationEmail parameter to the Update current cart payload.
To use this feature, contact your Digital River representative.
We revised the statements for subtotal and discount at the order level for the Submit the cart and create an order. 
2021/5/18
We add test and use cases to help you when you're developing and testing the Commerce API and your commerce connector.
We updated the error codes that provide you with:
Additional credit card decline reason codes and metadata responses. You can then perform reporting and analytics to better understand why authorizations are declined so you can optimize your business.
Greater visibility into why a transaction failed, reducing the work you need to do to determine why the transaction failed.
Data points to determine when you should or shouldn't retry a renewal attempt. This feature categorized credit card decline reason codes into two categories: "soft" and "hard declines."
2021/5/14
We added Site Management to the Commerce API Reference that includes the following resources:
​/authorized-shipping-countries​
​/authorized-billing-countries​
2021/5/6
You can now programmatically retrieve a list of your site's authorized billing or shipping countries using your Global Commerce user credentials.
2021/4/29
We replaced Supported geographies for each payment method in DigitalRiver.js with Supported markets. To find information on supported markets and currencies for Drop-in and DigitalRiver.js, go to:
Payment Method Guide: digitalriver.com/payment-method-guide​
Country Guide: digitalriver.com/country-guide/​
2021/4/27
We made the following to the Commerce API Reference:
Removed x-siteid and x-companyId headers for Subscription APIs. You only need to provide a token now.
  
 
Removed sku and displayName from the product object in the response for preview, preview-cart, and reduce resources.
Removed proratedUnitPrice from the reduce resource.
Updated the payload for the API trigger offer request.
Updated the order states for the GET and POST orders APIs by adding In Review, Pending Payment, and Complete. 
Updated the customAttributes for the get shopper order.
Added chargeType to apply shopper to cart, apply billing address to cart, apply shipping address to cart, apply payment method to cart, apply shipping option to cart, and get current cart.
Corrected the API path domain in the examples. It's now api.digitalriver.com. 
2021/3/31
We added information on how to sell subscriptions with add-ons and manage subscriptions.
Digital River Clients now can extend a branded, fully managed line of credit program to their business buyers that is engineered to increase purchase frequency, average order values, brand loyalty, and cashflow, while mitigating risk. By offering TreviPay you cultivate a consumer-like purchase experience for buyers, so they can purchase what they need now and pay later with net terms – all online.
Learn how you can offer TreviPay to your buyers! 
2021/3/30
You can now use thechargeType in a Cart without a subscription line item to initiate a charge. 
2021/3/11
We added the continue type to the list of button types for Drop-in and made it the default type in Customizing the text of the Drop-in button.
2021/3/10
We added information on initiating a charge. 
We moved the Declined messages under Submitting a cart and renamed it  Authorization declines. 
You can now find the error codes In the Commerce API doc.
2021/3/9
We updated the information on landed cost.
2021/2/1
We improved the error format for transactional errors using a credit card saved in the payment source and added a declined message (declinedMessage) to provide more information.
We moved the description of API keys from the Commerce API Reference to Best practices.
2021/1/15
You can now use the authenticateSource method to determine whether the saved payment source selected by a customer during the checkout process requires Strong Customer Authentication (SCA).
2021/1/12
When creating a source, you can now configure the usage parameter. It allows you to specify the type of transaction the source will likely be used for in the future. The parameter is available in both Drop-in and DigitalRiver.js. We recommend you use it when building purchase and account management workflows that allow customers to save their credit card information. 
When creating an instance of Drop-in, you can now customize the text of the button. Additionally, we created new Drop-in options that allow you to set the showTermsOfSaleDisclosure and disableAutomaticRedirects parameters.
2021/1/8
We added information on creating a cart with a perpetual unit price using  POST /v1/shoppers/me/carts/active/line-items resource.
2021/1/6
A note to Apply shopper to cart stating this method requires an authenticated shopper token.
Added the following to the response schema for GET /v1/shoppers/me/payment-options:
PaymentOptionsResponseLegacy
PaymentOptionsResponseLegacyExpand
PaymentOptionsResponsePaymentSource
PaymentOptionsResponsePaymentSourceExpand
A sourceId to GET /v1/shoppers/me/payment-options.
The following to the response schema for POST /v1/shoppers/me/carts/active/apply-payment-method:
ApplyPaymentMethodLegacy
ApplyPaymentMethodPaymentSource
The following to the response schema for GET /v1/shoppers/me/orders/{orderId}/line-items:
DefaultOrderLineItems
ExpandedOrderLineItems
lineItemStateDetails
A chargeType to the subscriptionInfo section in the request and response.  See Providing subscription information for more details.
2021/1/5
We added the best practices for using the Commerce API that includes Authentication, Creating authenticated shopper tokens, Caching responses, Capturing the customer's IP address, and Elements. 
2020/12/30
You can now modify a subscription during a midterm change. That includes applying a midterm change with price override, assigning a perpetual price, or reducing the subscription quantity.
2020/12/28
We updated the supported geographies for Klarna to show the minimum and maximum order amount and the payment method type.
2020/12/16
We updated the examples and added information on how to create a merchant-initiated transaction (MIT) in Providing subscription information.
2020/12/10
We added more custom styles for styling an element container in DigitalRiver.js.
2020/11/30
We added error types to Error types, codes, and objects.
2020/11/19
We added support for Pay in 4 to the PayPal payment method.
2020/11/17
We added support for landed costs.
You can now set a price list or shipping costs to tax inclusive or exclusive.
2020/11/10
We added a list of error codes for DigitalRiver.js.
2020/11/6
As part of the PSD2 Strong Customer Authentication (SCA) initiative, payment processors require extra information when processing merchant-initiated credit card transactions. To ensure that you adhere to the new mandate, you can now make use of billing agreements.
You can now update subscription information in  the LineItem array to the POST/carts, POST /line-items, or POST /line-items/{lineItemsId} requests.
2020/10/29
You can now subscribe to receive the latest Commerce API information.
2020/10/28
You can now apply a shipping discount to a customer's order
2020/10/14
We added information on configuring taxes.
We added the taxInclusive attribute to the response for Apply shopper to cart, Add or update cart billing address,  Apply billing address to cart, Apply shipping address to cart, Submit car and create and order, Apply payment method to cart, Apply shipping option to cart,  Get current cart, Update current cart, API trigger offer, Get shopper order, and Apply shopper to cart​
2020/10/12
We added information on the tax identifier element to DigitalRiver.js.
2020/10/1
We added support for Union Pay to Credit Cards.
2020/9/30
We added PSD2 and SCA integration support to Payment integrations.  
We added information on migrating to payment sessions to Payment integrations. 
2020/9/24
We added support for the Korea – PayCo payment methods.
2020/9/23
We added support for the Klarna payment method.
2020/9/18
We updated the Drop-in documentation.
2020/9/9
We updated the Digital River App for Salesforce B2B Commerce documentation.
We added Spark from Tryzens for the Salesforce Commerce Cloud to our partner integrations.
2020/8/11
We updated the API error codes.
2020/8/10
We now provide a list of IP addresses we use to send Webhook notifications. You'll need to open your firewall to these IP addresses.
2020/8/5
You can now use DigitalRiver.js to retrieve an array of available payment methods.
You can now use DigitalRiver.js  to trigger a return event when a customer presses the Return key while the input field has focus.
2020/6/02
The initial value for termsOfSaleAcceptance is now null if tosAccepted is null in the database. 
We now provide a breakdown of the tax fee at the line-item level for Carts, Orders, and Submit Cart.
Changed the lineItem under DefaultCart to an array. 
Changedfee to feeTax under lineItem.pricing. 
Added the feePricing object under ExpandedLineItem. 
Added the LineItemFeePricing schema for feePricing under ExpandedLineItem. 
2020/5/20
Added phonetic fields to the billing and shipping addresses.
Added the following schemas:
PostShopperAddressRequest for the request body of the shopper's address
BillingAddress for the response body of the billing address
ShippingAddress for the response body of the billing address
Updated the response for PUT billing and shipping address to 204 No Content.
Added phonetic fields to the following schemas: DefaultAddress and ExpandedAddress.
2020/5/7
You can now create a price override at the item level.
You can now override the unit price and line item price programmatically. See Price Override in the API Reference.
Added these schemas: CartUnitPriceOverrideRequest and CartAggregatePriceOverrideRequest.
2020/05/04
You can now capture when a customer accepts the Terms of Sale.
Added phonetic fields to Orders and Order Lookup resources.
Added productTax and shippingTax to the Carts, Orders, and Submit Cart resources. 
Developer Resources - Previous
Rate limiting
Last modified 28m ago