# 2021 ## 2021/12/30 You can now use Global Logistics, an end-to-end cross-border delivery management solution. ## 2021/12/14 * When [sending product data in checkouts](/digital-river-api/integration-options/checkouts/creating-checkouts/describing-the-items.md#sending-product-data), you can now use [`productDetails`](/digital-river-api/product-management/using-product-details.md). * When Digital River receives a [chargeback request](/digital-river-api/order-management/returns-and-refunds-1/disputes-and-chargebacks.md), we now move the associated order's [`state`](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/orders/order-basics#order-states-and-events) to `dispute`. ## 2021/12/13 {% hint style="warning" %} **Breaking changes** In [version ](https://docs.digitalriver.com/digital-river-api-reference/digital-river-api-reference-guide/versioning)`2021-12-13`, the following changes have been deployed: * In [registered checkouts](/digital-river-api/integration-options/checkouts/creating-checkouts/using-the-checkout-identifier.md#registered-checkouts-or-invoices), Digital River no longer, by default, uses the associated [customer’s ](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/customers)data to populate certain undefined [checkout ](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/checkouts)attributes. For each [attribute common to customers and checkouts](/digital-river-api/integration-options/checkouts/creating-checkouts/using-the-checkout-identifier.md#common-attributes), you must now define that attribute in checkouts. * Digital River has removed [`allowOversell`](/digital-river-api/product-management/creating-and-updating-skus.md#allow-oversell) from SKUs. {% endhint %} ## 2021/12/7 We made the following changes to [Digital River Dashboard](https://dashboard.digitalriver.com): * You can now add, edit, and delete a fee from the [SKU details](/digital-river-api/administration/dashboard/catalog/skus/viewing-the-sku-details.md) page. * You can now view the metadata associated with an order from the [Order details](/digital-river-api/administration/dashboard/order-management/orders/viewing-the-order-details.md) page. * The [Checkout details](/digital-river-api/administration/dashboard/order-management/checkouts/viewing-the-checkout-details.md) page now displays the full checkout details. ## 2021/11/22 We added the ability to [download a credit memo](/digital-river-api/administration/dashboard/order-management/orders/downloading-a-credit-memo.md) from the Dashboard. ## 2021/10/25 You're no longer allowed to [attach non-reusable sources to customers](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#attaching-sources-to-customers). ## 2021/10/19 You can now subscribe to the [`order.cancelled`](/digital-river-api/order-management/creating-and-updating-an-order.md#the-order-cancelled-event) event. ## 2021/10/15 Every physical SKU that is shipped cross-border into Switzerland must now contain a `weight` and `weightUnit`. Refer to the [weight and weightUnit](/digital-river-api/product-management/creating-and-updating-skus.md#weight-and-weight-unit) section on the [Managing SKUs](/digital-river-api/product-management/creating-and-updating-skus.md) page for details. ## 2021/10/8 We added the ability to [manage customers](/digital-river-api/administration/dashboard/customers.md) from the [Digital River Dashboard](https://dashboard.digitalriver.com). You can also [attach a tax certificate](/digital-river-api/administration/dashboard/customers/tax-ids/adding-a-tax-certificate.md) or [tax ID](/digital-river-api/administration/dashboard/customers/tax-ids/adding-a-tax-id.md) to a customer. ## 2021/10/4 We added a new [legal entity](/digital-river-api/integration-options/checkouts/creating-checkouts/selling-entities.md), Digital River UK Limited. ## 2021/10/1 We added the ability to [fulfill an order either partially or fully](/digital-river-api/administration/dashboard/order-management/orders/fulfilling-items.md) and [cancel a fulfillment order either fully or partially](/digital-river-api/administration/dashboard/order-management/orders/cancelling-items.md) from the [Digital River Dashboard](https://dashboard.digitalriver.com/login). ## 2021/9/10 We now provide [test tax identifiers](/digital-river-api/integration-options/checkouts/creating-checkouts/tax-identifiers.md#test-tax-identifiers). ## 2021/9/9 * We now conduct enhanced [validation of SKU group identifiers](/digital-river-api/product-management/setting-up-sku-groups.md#unique-identifier). * We created new [rules for deleting SKU groups](/digital-river-api/product-management/setting-up-sku-groups.md#deleting-sku-groups). * You can now use query parameters to return a list of SKU groups. * You can now [search for SKUs by `skuGroupId`](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/skus#skus-id). ## 2021/9/1 We expanded the pay later options now available in the [PayPal Wallet](/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/paypal.md#paypal-express-checkout-digital-wallet), including [PayPal RatenZahlung](/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/paypal.md#paypal-ratenzahlung) for German shoppers. ## 2021/8/25 You can now [use `applicability` to filter tax identifiers](/digital-river-api/integration-options/checkouts/creating-checkouts/tax-identifiers.md#filtering-applicable-tax-identifiers). ## 2021/8/24 Digital River now supports the use of [SEPA Direct Debit with Store Credit](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#combining-primary-and-secondary-payment-sources). ## 2021/8/17 You can now [group products](/digital-river-api/product-management/setting-up-sku-groups.md) that share a basic Harmonized System code and are exported to the same countries. ## 2021/8/13 You can now schedule and process recurring payments using [Digital River's subscription service](/digital-river-api/integration-options/checkouts/subscriptions/digital-river-coordinated-subscriptions.md). ## 2021/8/6 We added `supportsStorage` to indicate whether a payment method supports storage to [Retrieving available payment methods](/digital-river-api/developer-resources/reference/digitalriver-object.md#retrieving-available-payment-methods). ## 2021/7/29 We expanded the pay later options that are now available in the [PayPal Wallet](/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/paypal.md#paypal-express-checkout-digital-wallet), including[ PayPal Pay in 4](/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/paypal.md#paypal-pay-in-4) for shoppers in Australia and France, and [PayPal Pay in 3](/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/paypal.md#paypal-pay-in-3) and [PayPal Credit](/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/paypal.md#paypal-credit) for UK shoppers. ## 2021/7/27 You can now use the [Delayed Payment Instructions element](/digital-river-api/developer-resources/reference/elements/delayed-payment-instructions-element.md) to generate a template containing instructions for completing payments for delayed payment types such as Konbini and Wire Transfer. ## 2021/7/22 Digital River now supports the use of [Online Banking with Store Credit](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#combining-primary-and-secondary-payment-sources). ## 2021/7/6 We added the ability to [manage payment methods](/digital-river-api/administration/dashboard/settings/payment-methods.md). You can now[ view payment methods](/digital-river-api/administration/dashboard/settings/payment-methods/viewing-your-payment-methods.md) and their [details](/digital-river-api/administration/dashboard/settings/payment-methods/viewing-payment-method-details.md), [enable currencies](/digital-river-api/administration/dashboard/settings/payment-methods/viewing-payment-method-details/enabling-currencies.md), [manage countries](/digital-river-api/administration/dashboard/settings/payment-methods/viewing-payment-method-details/managing-countries.md), and [disable a payment method](/digital-river-api/administration/dashboard/settings/payment-methods/disabling-a-payment-method.md). ## 2021/7/2 We added support for [Pay in 3](/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/paypal.md#paypal-pay-in-3) to the [PayPal ](/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/paypal.md#paypal)payment method. ## 2021/6/28 * You can now [add](/digital-river-api/administration/dashboard/catalog/skus/adding-a-sku.md), [edit](/digital-river-api/administration/dashboard/catalog/skus/editing-a-sku.md), and [delete a SKU](/digital-river-api/administration/dashboard/catalog/skus/deleting-a-sku.md) from the [Digital River Dashboard](https://dashboard.digitalriver.com/login). * You can now [accept a return](/digital-river-api/administration/dashboard/order-management/orders/accepting-a-return.md) from the [Digital River Dashboard](https://dashboard.digitalriver.com/login). ## 2021/6/22 You can now use [`POST /invoices/{id}/sources/{sourceId}`](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/invoices#invoices-id-sources-sourceid) and [`DELETE /invoices/{id}/sources/{sourceId}`](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/invoices#invoices-id-sources-sourceid-1) to attach and detach sources from invoices. ## 2021/6/17 Digital River now supports the use of [bPay with Store Credit](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#combining-primary-and-secondary-payment-sources). ## 2021/6/11 * Using the [Files API](https://www.digitalriver.com/docs/digital-river-api-reference/#tag/Files), the [maximum file size](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/files/file-basics#size-and-type) you can upload to Digital River's servers is 10 MB. * You can now [search](/digital-river-api/administration/dashboard/catalog/skus/searching-for-skus.md), [filter](/digital-river-api/administration/dashboard/catalog/skus/filtering-your-skus.md), and [view ](/digital-river-api/administration/dashboard/catalog/skus/viewing-the-sku-details.md)your SKUs on the [Digital River Dashboard](https://dashboard.digitalriver.com/login). ## 2021/6/7 Digital River now supports the use of [Konbini with Store Credit](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#combining-primary-and-secondary-payment-sources). ## 2021/6/3 You can now [access details on product-level fee amounts](/digital-river-api/integration-options/checkouts/creating-checkouts/accessing-regulatory-fee-information.md#getting-information-on-specific-fees) from the [Invoices ](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/invoices)resource. ## 2021/6/1 We added OAuth as an additional authentication method when [creating ](/digital-river-api/order-management/events-and-webhooks-1/webhooks/creating-a-webhook.md)or [editing a webhook](/digital-river-api/administration/dashboard/developers/webhooks/editing-a-webhook.md) in the [Digital River Dashboard](https://dashboard.digitalriver.com/login). ## 2021/5/17 Digital River now supports [Alipay with Store Credit](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#combining-primary-and-secondary-payment-sources), allowing you to offer Alipay with store credit on an order. ## 2021/5/13 You can no longer issue order-level fee refunds. In addition to standard refunds, the types of order-level and product-level refunds we support are listed [here](/digital-river-api/order-management/returns-and-refunds-1/refunds/issuing-refunds.md#specifying-the-type-of-refund). ## 2021/4/29 You can now include [bill to information](/digital-river-api/integration-options/checkouts/creating-checkouts/providing-address-information.md#bill-to-address) in a `POST /invoices` request. Additionally, when we give you back an Invoice, it now contains a `billTo` value. This is true even when you did not send `billTo` in the payload of a `POST /invoices`. ## 2021/4/28 The following physical attributes have been added to the Sales summaries and Transactions in the Digital River Dashboard: client upstream ID, payment type, ship from country, ship to country, bill to country, and SKU tax code. These attributes appear when you [export transactions](/digital-river-api/administration/dashboard/finance/transactions/exporting-your-transactions.md) or [sales summary details](/digital-river-api/administration/dashboard/finance/sales-summaries/exporting-your-sales-summary-details..md) in the [Finance ](/digital-river-api/administration/dashboard/finance.md)section. ## 2021/4/27 You can now [access details on product-level fee amounts](/digital-river-api/integration-options/checkouts/creating-checkouts/accessing-regulatory-fee-information.md#getting-information-on-specific-fees). ## 2021/4/21 For troubleshooting purposes, we have implemented the following HTTP request headers: [`upstream-id`](https://docs.digitalriver.com/digital-river-api-reference/digital-river-api-reference-guide/api-structure#upstream-identifier), [`upstream-session-id`](https://docs.digitalriver.com/digital-river-api-reference/digital-river-api-reference-guide/api-structure#upstream-session-identifier), and [`upstream-application-id`](https://docs.digitalriver.com/digital-river-api-reference/digital-river-api-reference-guide/api-structure#upstream-application-identifier). As a [best practice](https://docs.digitalriver.com/digital-river-api-reference/digital-river-api-reference-guide/best-practices), we recommend including these headers in your requests. ## 2021/4/13 You can now [configure SKUs for Digital River managed fulfillments](/digital-river-api/product-management/creating-and-updating-skus.md#managed-fulfillments). Once properly configured, you can use them in the [Digital River fulfillment model](/digital-river-api/order-management/fulfillments.md#automated-fulfillment-model). ## 2021/3/31 * We made the following changes to the [Dashboard](/digital-river-api/administration/dashboard.md): * We now provide the order ID, upstream ID, status, tax type, tax ID, and tax state on the [Order Details](/digital-river-api/administration/dashboard/order-management/orders/viewing-the-order-details.md) page in the Dashboard. * We also add fees, landed cost (including importer duty and importer tax), discounts, and tax for a line item on the [Order Details](/digital-river-api/administration/dashboard/order-management/orders/viewing-the-order-details.md) page in the Dashboard. * You can now [download an invoice](/digital-river-api/administration/dashboard/order-management/orders/downloading-an-invoice.md) on the Order Details page. ## 2021/3/24 You can now [receive mock tax invoices and credit memos](/digital-river-api/order-management/creating-and-updating-an-order.md#mock-tax-invoices-and-credit-memos) when performing testing ## 2021/3/23 {% hint style="warning" %} **Breaking changes** In [version ](https://docs.digitalriver.com/digital-river-api-reference/digital-river-api-reference-guide/versioning)`2021-03-23`, the [checkout ](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/checkouts)and [order ](https://docs.digitalriver.com/digital-river-api-reference/2021-12-13/orders)resources now return the first-class `payment` attribute. This attribute contains the array of applied payment sources, the array of charges created from those sources, and additional payment session information. You can use this new session information to [determine when to convert a checkout to an order](/digital-river-api/integration-options/checkouts/creating-checkouts/payment-sessions.md#how-to-determine-when-to-create-an-order). {% endhint %} * We now provide you the ability to: * [Create secondary payment sources](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#creating-secondary-sources) with `POST /sources`. * Attach [multiple secondary sources](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#attaching-sources-to-checkouts) to a checkout. * Use [`POST /checkouts/{id}/sources/{sourceId}`](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#passing-the-source-identifier-as-a-path-parameter) to attach a source to a checkout. * Use [`DELETE /checkouts/{id}/sources/{sourceId}`](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#detaching-sources-from-checkouts) to detach a source from a checkout. * When [combining primary and secondary sources](/digital-river-api/payments/payment-sources/using-the-source-identifier.md#combining-primary-and-secondary-payment-sources), you should know how to sequence their application in guest and registered checkout workflows. ## 2021/3/11 Added the `continue` type to the list of button types for [Drop-in](/digital-river-api/payments/payment-integrations-1/drop-in.md) and make it the default type in [Customizing the text of the Drop-in button](/digital-river-api/payments/payment-integrations-1/drop-in/drop-in-integration-guide.md#customizing-the-text-of-the-drop-in-button). ## 2021/3/10 When [sequencing address information in your checkout workflows](/digital-river-api/integration-options/checkouts/creating-checkouts/providing-address-information.md#sequencing-address-information-in-checkout-workflows), you can now use [`billTo`](/digital-river-api/integration-options/checkouts/creating-checkouts/providing-address-information.md#bill-to-address) to obtain an accurate tax calculation before you attach a payment source to the checkout. ## 2021/2/23 {% hint style="warning" %} **Breaking changes** We made the following changes in [version ](https://docs.digitalriver.com/digital-river-api-reference/digital-river-api-reference-guide/versioning)`2021-02-23`: * You can now access the [tax identifiers resource](/digital-river-api/integration-options/checkouts/creating-checkouts/tax-identifiers.md). * Tax identifiers must be created using the Tax Identifiers API. You can no longer use the Customers API to perform this operation. * Once you've upgraded, any tax identifiers you previously created with the Customers API will no longer be available. Contact us to have your data migrated. {% endhint %} ## 2021/2/16 For [Digital River coordinated fulfillments](/digital-river-api/order-management/fulfillments.md#digital-river-coordinated-fulfillments), you should now send [shipment identifiers](/digital-river-api/order-management/informing-digital-river-of-a-fulfillment.md#shipment-identifiers) in `POST/fulfillments` requests. ## 2021/1/18 You can now use the Digital River API to [manage an order's physical fulfillment](/digital-river-api/integration-options/checkouts/handling-digital-river-coordinated-fulfillments/global-fulfillments.md). ## 2021/1/15 You can now use the [`authenticateSource` method](/digital-river-api/developer-resources/reference/digitalriver-object.md#authenticating-sources) to determine whether the saved payment source selected by a customer during the checkout process requires [Strong Customer Authentication (SCA)](/digital-river-api/payments/psd2-and-sca.md). ## 2021/1/11 * 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 in the future. The parameter is available in both [Drop-in](/digital-river-api/payments/payment-integrations-1/drop-in/drop-in-integration-guide.md#specifying-a-sources-future-use) and [DigitalRiver.js](/digital-river-api/developer-resources/reference/digitalriver-object.md#specifying-a-sources-future-use). We recommend you use it when building [purchase](/digital-river-api/integration-options/checkouts/building-you-workflows.md#credit-card-details-saved-by-customer-during-checkout) and [account management](/digital-river-api/integration-options/checkouts/building-you-workflows.md#account-management-flows) workflows that allow customers to save their credit card information. * When [creating an instance of Drop-in](/digital-river-api/payments/payment-integrations-1/drop-in/drop-in-integration-guide.md#step-6-allow-the-shopper-to-interact-with-hydrate), you can now [customize the button's text](/digital-river-api/payments/payment-integrations-1/drop-in/drop-in-integration-guide.md#customizing-the-text-of-the-drop-in-button). Additionally, we created new [Drop-in options](/digital-river-api/payments/payment-integrations-1/drop-in/drop-in-integration-guide.md#drop-in-options) that allow you to set the `showTermsOfSaleDisclosure` and `disableAutomaticRedirects` parameters. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.digitalriver.com/digital-river-api/general-resources/release-notes/2021.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.