Ctrlk
System Status
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Returns

The Returns resource in the Digital River API allows businesses to handle returning items from an order. It supports full and partial returns, offering flexibility in managing customer requests to return goods. This resource allows businesses to process returns, initiate refunds, and update inventory and order statuses accordingly. See Return basics for more information.

Returns a list of returns

get

Get all returns.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
endingBeforestringOptional

A cursor for use in pagination. The endingBefore parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with xyz your subsequent calls can include endingBefore=xyz in order to fetch the previous page of the list.

startingAfterstringOptional

A cursor for use in pagination. The startingAfter parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with xyz, your subsequent calls can include startingAfter=xyz in order to fetch the next page of the list.

limitinteger · min: 1 · max: 100Optional

A limit on the number of objects returned. Limit can range between 1 and 100, and the default is 10.

idsstring[]Optional

Only return objects with these IDs.

statestringOptional

Only return objects in the given state

orderIdstringOptional

The order to retrieve returns for.

skuIdstringOptional

The sku to retrieve returns for.

Responses
200

200 OK

application/json
hasMorebooleanOptional

Whether or not there are more elements available after this set. If false this set represents the end of the list.

Example: true
get/returns
GET /returns HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "hasMore": true,
  "data": [
    {
      "id": "ret_5823594809",
      "createdTime": "2018-04-25T20:36:00Z",
      "updatedTime": "2018-04-25T20:36:00Z",
      "orderId": "ord_6645940010",
      "currency": "USD",
      "items": [
        {
          "itemId": "99341140336",
          "skuId": "sku_5823594809",
          "amount": 899,
          "quantity": 1,
          "quantityAccepted": 1,
          "state": "created"
        }
      ],
      "reason": "requested_by_customer",
      "failureReason": "text",
      "state": "created",
      "location": {
        "address": {
          "line1": "10380 Bren Rd W",
          "line2": "text",
          "city": "Minnetonka",
          "postalCode": "55129",
          "state": "MN",
          "country": "US"
        },
        "name": "John Smith",
        "phone": "952-111-1111",
        "email": "jsmith@digitalriver.com"
      },
      "liveMode": false,
      "metadata": {
        "coupon": "iOS"
      },
      "refundIds": [
        "0848750667"
      ]
    }
  ]
}

Creates a return

post

Returns all or part of a previously created order.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdstringRequired

The unique identifier of the Order associated with the Return.

Example: ord_6645940010
reasonstring · max: 64Optional

The reason for the return.

Example: requested_by_customer
Responses
201

201 Created

application/json
idstringRead-onlyOptional

The unique identifier of the return.

Example: ret_5823594809
createdTimestring · date-timeRead-onlyOptional

Time at which the return was created.

Example: 2018-04-25T20:36:00Z
orderIdstringRead-onlyOptional

The unique identifier of the order.

Example: ord_6645940010
currencystringOptional

Three-letter ISO currency code.

Example: USD
reasonstringOptional

The reason for the return.

Example: requested_by_customer
statestring · enumOptional

Enumeration indicating the state of the return.

Example: createdPossible values:
livemodebooleanOptional

Has the value true if the object exists in live mode or the value false if the object exists in test mode.

Example: false
refundIdsstring[]Read-onlyOptional

The identifier of a refund requested for this return.

Example: ref_0848750667
post/returns
POST /returns HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 371

{
  "orderId": "ord_6645940010",
  "reason": "requested_by_customer",
  "items": [
    {
      "itemId": "99341140336",
      "skuId": "99341140336",
      "quantity": 1
    }
  ],
  "location": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "name": "John Smith",
    "phone": "952-111-1111",
    "email": "jsmith@digitalriver.com"
  },
  "metadata": {
    "coupon": "iOS"
  }
}
{
  "id": "ret_5823594809",
  "createdTime": "2018-04-25T20:36:00Z",
  "orderId": "ord_6645940010",
  "currency": "USD",
  "items": [
    {
      "itemId": "99341140336",
      "skuId": "sku_5823594809",
      "amount": 899,
      "quantity": 1,
      "quantityAccepted": 1,
      "state": "created"
    }
  ],
  "reason": "requested_by_customer",
  "state": "created",
  "location": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "name": "John Smith",
    "phone": "952-111-1111",
    "email": "jsmith@digitalriver.com"
  },
  "livemode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "refundIds": [
    "ref_0848750667"
  ]
}

Gets a return by ID

get

Retrieves the details of a return. Supply the unique identifier of the return.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired

Return ID

Responses
200

OK.

application/json
idstringRead-onlyOptional

The unique identifier of the return.

Example: ret_5823594809
createdTimestring · date-timeRead-onlyOptional

The time at which the return was created.

Example: 2018-04-25T20:36:00Z
updatedTimestring · date-timeRead-onlyOptional

The time at which the return was updated.

Example: 2018-04-25T20:36:00Z
orderIdstringRead-onlyOptional

The unique identifier of the order.

Example: ord_6645940010
currencystringOptional

A three-letter ISO currency code.

Example: USD
reasonstringOptional

The reason for the return.

Example: requested_by_customer
failureReasonstringOptional

An enumeration indicating the reason for the return failure, if known.

statestring · enumOptional

An enumeration indicating the state of the return.

Example: createdPossible values:
liveModebooleanOptional

Has the value true if the object exists in live mode or the value false if the object exists in test mode.

Example: false
refundIdsstring[]Read-onlyOptional

The identifier of a refund issued for this return.

Example: 0848750667
get/returns/{id}
GET /returns/{id} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "ret_5823594809",
  "createdTime": "2018-04-25T20:36:00Z",
  "updatedTime": "2018-04-25T20:36:00Z",
  "orderId": "ord_6645940010",
  "currency": "USD",
  "items": [
    {
      "itemId": "99341140336",
      "skuId": "sku_5823594809",
      "amount": 899,
      "quantity": 1,
      "quantityAccepted": 1,
      "state": "created"
    }
  ],
  "reason": "requested_by_customer",
  "failureReason": "text",
  "state": "created",
  "location": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "name": "John Smith",
    "phone": "952-111-1111",
    "email": "jsmith@digitalriver.com"
  },
  "liveMode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "refundIds": [
    "0848750667"
  ]
}

Updates an existing return

post

Updates an existing return.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired

Return ID

Body
statestring · enumOptional

Enumeration indicating the state of the return.

Example: acceptedPossible values:
Responses
200

200 OK

application/json
idstringRead-onlyOptional

The unique identifier of the return.

Example: ret_5823594809
createdTimestring · date-timeRead-onlyOptional

The time at which the return was created.

Example: 2018-04-25T20:36:00Z
updatedTimestring · date-timeRead-onlyOptional

The time at which the return was updated.

Example: 2018-04-25T20:36:00Z
orderIdstringRead-onlyOptional

The unique identifier of the order.

Example: ord_6645940010
currencystringOptional

A three-letter ISO currency code.

Example: USD
reasonstringOptional

The reason for the return.

Example: requested_by_customer
failureReasonstringOptional

An enumeration indicating the reason for the return failure, if known.

statestring · enumOptional

An enumeration indicating the state of the return.

Example: createdPossible values:
liveModebooleanOptional

Has the value true if the object exists in live mode or the value false if the object exists in test mode.

Example: false
refundIdsstring[]Read-onlyOptional

The identifier of a refund issued for this return.

Example: 0848750667
post/returns/{id}
POST /returns/{id} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 349

{
  "location": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "name": "John Smith",
    "phone": "952-111-1111",
    "email": "jsmith@digitalriver.com"
  },
  "state": "accepted",
  "items": [
    {
      "itemId": "99596460336",
      "skuId": "99596460336",
      "quantity": 1,
      "state": "accepted"
    }
  ],
  "metadata": {
    "coupon": "iOS"
  }
}
{
  "id": "ret_5823594809",
  "createdTime": "2018-04-25T20:36:00Z",
  "updatedTime": "2018-04-25T20:36:00Z",
  "orderId": "ord_6645940010",
  "currency": "USD",
  "items": [
    {
      "itemId": "99341140336",
      "skuId": "sku_5823594809",
      "amount": 899,
      "quantity": 1,
      "quantityAccepted": 1,
      "state": "created"
    }
  ],
  "reason": "requested_by_customer",
  "failureReason": "text",
  "state": "created",
  "location": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "name": "John Smith",
    "phone": "952-111-1111",
    "email": "jsmith@digitalriver.com"
  },
  "liveMode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "refundIds": [
    "0848750667"
  ]
}
PreviousReservations
NextSales summaries

Last updated