Appendix

Learn more about tax codes and view the sequence diagram.

Exhibit A: Eligible tax group, type, and code

Click this link to see which tax codes are available in the Digital River API.

A Digital River account is required to use this extension. If you do not have a Digital River account, you can sign up for one here.

Exhibit B: Sequence diagrams

446KB

Adobe Ext. Sequence Diagram.png

image

54KB

Adobe Extenstion Sequence Diagram for Refunds.png

image

Appendix C: Initiating Refunds

Digital River settles against the payment instrument upon fulfillment of all or part of the order items. Before fulfillment, we collect no funds from the shopper and cannot issue refunds.

Click the Refund Offline button on the Credit Memo page in the Magento Admin UI to issue a refund. When you submit the refund, the system acknowledges it in real-time and, therefore, is not an offline process even though the name of the button is Refund Offline per the Magento convention.

The completion of the refund triggers a webhook. Magento receives the webhook and adds a note regarding the refund in the order’s comment section.

Digital River supports the following Magento refund types: quantity, line level, order level, shipping, tax, and adjustment.

When you submit an Adjustment Refund for a portion of an order, you should submit all subsequent refunds for that order as Adjustment Refunds.

Appendix D: Permitted checkout error codes

During the configuration of Adobe Commerce Extension, select the DR API error codes you want to be displayed to the shopper during checkout. The table below lists the error codes currently supported:

Status Code	Error code and error message
400	{ "code": "invalid_parameter", "parameter": "address.postalCode", "message": "A required address parameter, postal code, is invalid." }
400	{ "code": "invalid_parameter", "parameter": "address.state", "message": "A required address parameter, state/province, is invalid." }
400	{ "code": "invalid_parameter", "parameter": "billingAddress.postalCode", "message": "A required address parameter, postalCode, is invalid." }
400	{ "code": "invalid_parameter", "parameter": "billingAddress.postalCode", "message": "A required address parameter, postalCode, is invalid." }
400	{ "code": "invalid_parameter", "parameter": "billingAddress.state", "message": "A required address parameter, state, is invalid." }
400	{ "code": "invalid_parameter", "parameter": "billingAddress.state", "message": "A required address parameter, state, is invalid." }
400	{ "code": "invalid_parameter", "parameter": "billTo.email", "message": "'xxxxx [e-mail]' is not a valid email." }
400	{ "code": "invalid_parameter", "parameter": "email", "message": "'xxxxx [e-mail]' is not a valid email." }
400	{ "code": "invalid_parameter", "parameter": "shippingAddress.postalCode", "message": "A required address parameter, postalCode, is invalid." }
400	{ "code": "missing_parameter", "message": "itemBreadcrumb and description required" }
400	{ "code": "missing_parameter", "message": "itemBreadcrumb and description required" }
401	{ "code": "missing_parameter", "message": "itemBreadcrumb and description required" }
404	{ "code": "missing_parameter", "parameter": "address.line1", "message": "A parameter is missing." }
409	{ "code": "missing_parameter", "parameter": "address.line1", "message": "A parameter is missing." }
409	{ "code": "missing_parameter", "parameter": "address.city", "message": "A parameter is missing." }
409	{ "code": "missing_parameter", "parameter": "address.state", "message": "A parameter is missing." }
409	{ "code": "missing_parameter", "parameter": "billingAddress.postalCode", "message": "A parameter is missing." }
409	{ "code": "missing_parameter", "parameter": "items", "message": "A parameter is missing." }
409	{ "code": "missing_parameter", "parameter": "items[1]", "message": "One of skuId, productDetails are required parameters." }
409	{ "code": "missing_parameter", "parameter": "shipFrom.address.country", "message": "A parameter is missing." }
409	{ "code": "missing_parameter", "parameter": "shippingAddress.state", "message": "A parameter is missing." }
409	{ "code": "missing_parameter", "parameter": "sku or skuGroupId", "message": "An item of type sku is missing a sku or skuGroupId parameter." }
500	{ "code": "unauthorized", "message": "An authorization error has occurred." }