Order Return Details

Order Return

Use the order return business process when a client needs to reverse a customer's order based on a customer service issue that the customer is experiencing. In this case, you can call the Order Return API to reverse the transaction on the Digital River side. The Order Return API notifies Digital River to disable the customer’s download URL. 

Note:

If you send an OrderReturn for an order that previously resulted in a 202/503 error, Digital River will submit an order cancellation.

The Order Return business process works in a similar fashion to the Order Create business process in that it leverages XML and HTTPS and has a request and response message passing sequence.

Business Process Specifics

Characteristic
Specification
Business Process Type
Real-Time
Communication Protocols
HTTPS only
Data Formats Available
XML

Order Return Request XML Schema and Example

See the Order Return Schemas section for schema and XML examples.

Order Return Response XML Schema and Example

This response's XML format follows a specific XML schema provided in the Order Return Schemas section. The following example shows an order return response sent to a Client.

<?xml version="1.0" encoding="UTF-8"?>
<ns1:returnReceipt
   returnRequestUri="http://dealer.acme.com/order/1636395390/1”
   uri=" https://drh1sys.digitalriver.com/integration/job/request/DRRWS?r=returnLiID/4562889"
   xmlns:rws="http://integration.digitalriver.com/2005/10/RetailWebService"
   xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance>
    <status>
        <code>201</code>
        <message>The return unit request has been submitted successfully.</message>
    </status>
</ns1:returnReceipt>

Cancellation Example

<?xml version="1.0" encoding="UTF-8"?>
<ns1:returnReceipt
   returnRequestUri="http://dealer.acme.com/order/1636395390/1”
   uri=" https://drh1sys.digitalriver.com/integration/job/request/DRRWS?r=unit/6353179490-0"
   xmlns:rws="http://integration.digitalriver.com/2005/10/RetailWebService"
   xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance>
    <status>
        <code>201</code>
        <message>The return unit request has been submitted successfully.</message>
    </status>
</ns1:returnReceipt>