> For the complete documentation index, see [llms.txt](https://docs.digitalriver.com/digital-river-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalriver.com/digital-river-api/general-resources/release-notes/2021.md). # 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.