2021
Commerce API release notes for 2021.
We added the ability to create a refund for a delayed payment method such as Konbini, and Wire Transfer.
We added the ability to receive payment detail update notifications when a shopper updates their payment details for a subscription.
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.
- We added the ability to use the Expired Card Optimizer (ECO) for third-party subscription engine renewal orders.
- We expanded the pay later options that are now available in the PayPal Wallet, including PayPal RatenZahlung for German shoppers.
We added
supportsStorage
to indicate whether a payment method supports storage to Retrieving available payment methods.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.
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.
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.
We added the ability to create a trial subscription for a subscription product and configure trial renewal reminders in Global Commerce.
- In the response for
GET /v1/subscriptions/{subscriptionId}
, addedshopper
andrenewalPrice
to the subscription information attributes. We also addedrenewalPrice
to theaddOn
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.
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.
- We add test and use cases to help you when you're developing and testing the Commerce API and your commerce connector.
- 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."
You can now programmatically retrieve a list of your site's authorized billing or shipping countries using your Global Commerce user credentials.
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:
- Removed
x-siteid
andx-companyId
headers for Subscription APIs. You only need to provide a token now. - Removed
sku
anddisplayName
from theproduct
object in the response forpreview
,preview-cart
, andreduce
resources. - Updated the order states for the GET and POST orders APIs by adding In
Review
,Pending Payment
, andComplete
. - Corrected the API path domain in the examples. It's now
api.digitalriver.com
.

- 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!
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.- 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.
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).- 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
anddisableAutomaticRedirects
parameters.
We added information on creating a cart with a perpetual unit price using
POST /v1/shoppers/me/carts/active/line-items
resource.PaymentOptionsResponseLegacy
PaymentOptionsResponseLegacyExpand
PaymentOptionsResponsePaymentSource
PaymentOptionsResponsePaymentSourceExpand
ApplyPaymentMethodLegacy
ApplyPaymentMethodPaymentSource
DefaultOrderLineItems
ExpandedOrderLineItems
lineItemStateDetails
- A
chargeType
to thesubscriptionInfo
section in the request and response. See Providing subscription information for more details.
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.
Last modified 4mo ago