LogoLogo
System Status
2020-01-07
2020-01-07
  • 2020-01-07
  • Charges
  • Checkouts
  • Country specifications
  • Customers
  • Events
  • Fees
  • File links
  • Files
  • Fulfillments
  • Orders
  • Payouts
  • Refunds
  • Returns
  • SKUs
  • Sales summaries
  • Sales transactions
  • Sources
  • Webhooks
Powered by GitBook
On this page

Checkouts

PreviousChargesNextCountry specifications

Last updated 6 months ago

The Checkouts resource in the Digital River API allows businesses to manage the entire checkout process for an end customer. This resource provides functionality to create new checkout sessions, retrieve existing sessions, update session details, and delete checkouts when necessary. Additionally, it supports querying all checkouts to analyze and track transaction data, ensuring a smooth and efficient customer checkout experience. See for more information.

Gets a checkout by ID

get

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

Path parameters
idstringRequired

Checkout ID

Responses
200
OK.
application/json
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
404
404 Not Found
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
get
GET /checkouts/{id} HTTP/1.1
Host: api.digitalriver.com
Accept: */*
{
  "id": "5823594809",
  "createdTime": "2025-05-09T05:01:09.863Z",
  "updatedTime": "2025-05-09T05:01:09.863Z",
  "customerId": "cus_5774321009",
  "sourceId": "src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37",
  "currency": "USD",
  "email": "jsmith@digitalriver.com",
  "locale": "en_US",
  "browserIp": "111.111.111.111",
  "applicationId": "68f72e0c-cb7d-48e1-93c8-998668ad0ff4",
  "shipFrom": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "shipTo": {
    "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",
    "organization": "Digital River",
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "subtotal": 1094.5,
  "totalTax": 82.76,
  "importerOfRecordTax": true,
  "totalFees": 0,
  "totalDuty": 0,
  "totalDiscount": 0,
  "totalShipping": 5.76,
  "totalAmount": 1180.26,
  "discount": {
    "amountOff": 5.95
  },
  "chargeType": "merchant_initiated",
  "purchaseLocation": {
    "country": "US",
    "state": "MN",
    "postalCode": "55364"
  },
  "customerType": "individual",
  "sellingEntity": {
    "id": "DR_IRELAND-ENTITY",
    "name": "Digital River Ireland"
  },
  "items": [
    [
      {
        "skuId": "sku_5823594809",
        "amount": 18.58,
        "discount": {
          "percentOff": 10
        }
      },
      {
        "skuId": "sku_9234276173",
        "amount": 18.58,
        "quantity": 2
      }
    ]
  ],
  "shippingChoice": {
    "amount": 5.95,
    "taxAmount": 0.1,
    "description": "USPS: Priority (1 day delivery)",
    "serviceLevel": "SG"
  },
  "paymentSessionId": "ps_8cecaa32-f692-44cc-b103-4cf24dc93913",
  "liveMode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "upstreamId": "7765374748"
}

Deletes a checkout by ID

delete

Permanently deletes a checkout. Supply the unique identifier of the checkout.

Path parameters
idstringRequired

Checkout ID

Responses
204
204 No Content
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
404
401 Not Found
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
409
409 Conflict
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
delete
DELETE /checkouts/{id} HTTP/1.1
Host: api.digitalriver.com
Accept: */*

No content

  • GETReturns a list of checkouts
  • POSTCreates a new checkout
  • GETGets a checkout by ID
  • POSTUpdates an existing checkout
  • DELETEDeletes a checkout by ID

Updates an existing checkout

post

Updates an existing checkout.

Path parameters
idstringRequired

Checkout ID

Body
customerIdstringOptional

The identifier of the Customer associated with the Checkout.

Example: 5774321008
sourceIdstringOptional

The unique identifier of a Source.

Example: src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37
currencystringOptional

A three-letter ISO currency code.

Example: USD
emailstring · emailOptional

The customer's email address.

Example: jsmith@digitalriver.com
localestringOptional

A designator that combines the two-letter ISO 639-1 language code with the ISO 3166-1 alpha-2 country code.

Example: en_US
browserIpstringOptional

The IP address of the browser used by the customer when placing the order.

Example: 111.111.111.111
applicationIdstringRead-onlyOptional

An arbitrary string identifier that can be used to track the application type.

Example: 68f72e0c-cb7d-48e1-93c8-998668ad0ff4
shippingDiscountone ofOptional

The discount applied to shipping.

or
chargeTypestring · enumOptional

Represents the charge type.

Example: merchant_initiatedPossible values:
customerTypestring · enumOptional

The type of customer.

Example: individualPossible values:
upstreamIdstringOptional

The user checkout ID if it is different from the Digital River checkout ID.

Example: 7765374748
metadataany ofOptional
or
or
Responses
200
200 OK
application/json
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
404
401 Not Found
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
409
409 Conflict
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
post
POST /checkouts/{id} HTTP/1.1
Host: api.digitalriver.com
Content-Type: application/json
Accept: */*
Content-Length: 852

{
  "customerId": "5774321008",
  "sourceId": "src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37",
  "currency": "USD",
  "email": "jsmith@digitalriver.com",
  "locale": "en_US",
  "browserIp": "111.111.111.111",
  "shipTo": {
    "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",
    "organization": "Digital River",
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "shippingDiscount": {
    "percentOff": 100
  },
  "chargeType": "merchant_initiated",
  "customerType": "individual",
  "shippingChoice": {
    "amount": 5.95,
    "description": "USPS: Priority (1 day delivery)",
    "serviceLevel": "SG"
  },
  "purchaseLocation": {
    "country": "US",
    "state": "MN",
    "postalCode": "55364"
  },
  "upstreamId": "7765374748",
  "metadata": {
    "coupon": "iOS"
  }
}
{
  "id": "5823594809",
  "createdTime": "2025-05-09T05:01:09.863Z",
  "updatedTime": "2025-05-09T05:01:09.863Z",
  "customerId": "cus_5774321009",
  "sourceId": "src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37",
  "currency": "USD",
  "email": "jsmith@digitalriver.com",
  "locale": "en_US",
  "browserIp": "111.111.111.111",
  "applicationId": "68f72e0c-cb7d-48e1-93c8-998668ad0ff4",
  "shipFrom": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "shipTo": {
    "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",
    "organization": "Digital River",
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "subtotal": 1094.5,
  "totalTax": 82.76,
  "importerOfRecordTax": true,
  "totalFees": 0,
  "totalDuty": 0,
  "totalDiscount": 0,
  "totalShipping": 5.76,
  "totalAmount": 1180.26,
  "discount": {
    "amountOff": 5.95
  },
  "chargeType": "merchant_initiated",
  "purchaseLocation": {
    "country": "US",
    "state": "MN",
    "postalCode": "55364"
  },
  "customerType": "individual",
  "sellingEntity": {
    "id": "DR_IRELAND-ENTITY",
    "name": "Digital River Ireland"
  },
  "items": [
    [
      {
        "skuId": "sku_5823594809",
        "amount": 18.58,
        "discount": {
          "percentOff": 10
        }
      },
      {
        "skuId": "sku_9234276173",
        "amount": 18.58,
        "quantity": 2
      }
    ]
  ],
  "shippingChoice": {
    "amount": 5.95,
    "taxAmount": 0.1,
    "description": "USPS: Priority (1 day delivery)",
    "serviceLevel": "SG"
  },
  "paymentSessionId": "ps_8cecaa32-f692-44cc-b103-4cf24dc93913",
  "liveMode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "upstreamId": "7765374748"
}

Returns a list of checkouts

get

Get all checkouts.

Query parameters
createdTimestring · date-timeOptional

A filter on the list based on the createdTime field. The value can be a string with an ISO-8601 UTC format datetime or it can be a dictionary with the following options:

  • gt–return values where the createdTime field is after this timestamp
  • gte–return values where the createdTime field is after or equal to this timestamp
  • lt–return values where the createdTime field is before this timestamp
  • lte–return values where the createdTime field is before or equal to this timestamp
updatedTimestring · date-timeOptional

A filter on the list based on the updatedTime field. The value can be a string with an ISO-8601 UTC format datetime or it can be a dictionary with the following options:

  • gt–return values where the updatedTime field is after this timestamp
  • gte–return values where the updatedTime field is after or equal to this timestamp
  • lt–return values where the updatedTime field is before this timestamp
  • lte–return values where the updatedTime field is before or equal to this timestamp
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.

upstreamIdsstring[]Optional

Only return objects with these upstreamIds.

customerIdstringOptional

Only return checkouts for the given customer

applicationIdstringOptional

Only return checkouts for the given application

emailstringOptional

Only return checkouts with the given email

currencystringOptional

Only return checkouts in the given currency

totalAmountstringOptional

A filter on the list based on the checkout totalAmount field. The value can be a string or it can be a dictionary with the following options:

  • gt - return values where the totalAmount field is greater than this amount
  • gte - return values where the totalAmount field is greater than or equal to this amount
  • lt - return values where the totalAmount field is less than this amount
  • lte - return values where the totalAmount field is less than or equal to this amount
localestringOptional

Only return checkouts with this locale

chargeTypestringOptional

Only return checkouts with this charge type

customerTypestringOptional

Only return checkouts with this customer type

subscriptionIdsstring[]Optional

Only return checkouts with the given subscription identifiers

browser_ipstringOptional

Only return checkouts with the given browser IP

Responses
200
200 OK
application/json
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
get
GET /checkouts HTTP/1.1
Host: api.digitalriver.com
Accept: */*
{
  "hasMore": true,
  "data": [
    {
      "id": "5823594809",
      "createdTime": "2025-05-09T05:01:09.863Z",
      "updatedTime": "2025-05-09T05:01:09.863Z",
      "customerId": "cus_5774321009",
      "sourceId": "src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37",
      "currency": "USD",
      "email": "jsmith@digitalriver.com",
      "locale": "en_US",
      "browserIp": "111.111.111.111",
      "applicationId": "68f72e0c-cb7d-48e1-93c8-998668ad0ff4",
      "shipFrom": {
        "address": {
          "line1": "10380 Bren Rd W",
          "line2": "text",
          "city": "Minnetonka",
          "postalCode": "55129",
          "state": "MN",
          "country": "US"
        },
        "additionalAddressInfo": {
          "neighborhood": "Centro",
          "division": "営業部",
          "phoneticName": "ヤマダ タロ"
        }
      },
      "shipTo": {
        "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",
        "organization": "Digital River",
        "additionalAddressInfo": {
          "neighborhood": "Centro",
          "division": "営業部",
          "phoneticName": "ヤマダ タロ"
        }
      },
      "subtotal": 1094.5,
      "totalTax": 82.76,
      "importerOfRecordTax": true,
      "totalFees": 0,
      "totalDuty": 0,
      "totalDiscount": 0,
      "totalShipping": 5.76,
      "totalAmount": 1180.26,
      "discount": {
        "amountOff": 5.95
      },
      "chargeType": "merchant_initiated",
      "purchaseLocation": {
        "country": "US",
        "state": "MN",
        "postalCode": "55364"
      },
      "customerType": "individual",
      "sellingEntity": {
        "id": "DR_IRELAND-ENTITY",
        "name": "Digital River Ireland"
      },
      "items": [
        [
          {
            "skuId": "sku_5823594809",
            "amount": 18.58,
            "discount": {
              "percentOff": 10
            }
          },
          {
            "skuId": "sku_9234276173",
            "amount": 18.58,
            "quantity": 2
          }
        ]
      ],
      "shippingChoice": {
        "amount": 5.95,
        "taxAmount": 0.1,
        "description": "USPS: Priority (1 day delivery)",
        "serviceLevel": "SG"
      },
      "paymentSessionId": "ps_8cecaa32-f692-44cc-b103-4cf24dc93913",
      "liveMode": false,
      "metadata": {
        "coupon": "iOS"
      },
      "upstreamId": "7765374748"
    }
  ]
}

Creates a new checkout

post

Creates a new checkout object.

Body
customerIdstringOptional

The identifier of the Customer associated with the Checkout.

Example: 5774321009
sourceIdstringOptional

The unique identifier of a Source.

Example: src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37
currencystringRequired

A three-letter ISO currency code.

Example: USD
emailstring · emailOptional

The customer's email address.

Example: jsmith@digitalriver.com
localestringOptional

A designator that combines the two-letter ISO 639-1 language code with the ISO 3166-1 alpha-2 country code.

Example: en_US
applicationIdstringOptional

An arbitrary string identifier that can be used to track the application type.

Example: 68f72e0c-cb7d-48e1-93c8-998668ad0ff4
browserIpstringOptional

The IP address of the browser used by the customer when placing the order.

Example: 111.111.111.111
discountone ofOptional

Represents the discount applied to the Checkout.

or
shippingDiscountone ofOptional

The discount applied to shipping.

or
taxInclusivebooleanOptional

If true, indicates that the prices supplied are tax inclusive.

Example: true
chargeTypestring · enumOptional

Represents the charge type.

Example: merchant_initiatedPossible values:
customerTypestring · enumOptional

The type of customer.

Example: individualPossible values:
metadataany ofOptional
or
or
upstreamIdstringOptional

The user checkout identifier if it is different from the Digital River checkout identifier.

Example: 7765374748
Responses
201
201 Created
application/json
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
409
409 Conflict
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
post
POST /checkouts HTTP/1.1
Host: api.digitalriver.com
Content-Type: application/json
Accept: */*
Content-Length: 1435

{
  "customerId": "5774321009",
  "sourceId": "src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37",
  "currency": "USD",
  "email": "jsmith@digitalriver.com",
  "locale": "en_US",
  "applicationId": "68f72e0c-cb7d-48e1-93c8-998668ad0ff4",
  "browserIp": "111.111.111.111",
  "shipFrom": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "shipTo": {
    "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",
    "organization": "Digital River",
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "shippingChoice": {
    "amount": 5.95,
    "description": "USPS: Priority (1 day delivery)",
    "serviceLevel": "SG"
  },
  "discount": {
    "percentOff": 100
  },
  "items": [
    {
      "skuId": "5823594809",
      "price": 9.99,
      "discount": {
        "quantity 1": null,
        "amountOff": 10
      }
    },
    {
      "skuId": "5823594809",
      "price": 9.99,
      "quantity": 2,
      "discount": {
        "quantity 2": null,
        "amountOff": 10
      }
    },
    {
      "skuId": "9234276173",
      "price": 9.99,
      "quantity": 2
    }
  ],
  "shippingDiscount": {
    "percentOff": 100
  },
  "taxInclusive": true,
  "chargeType": "merchant_initiated",
  "customerType": "individual",
  "metadata": {
    "coupon": "iOS"
  },
  "purchaseLocation": {
    "country": "US",
    "state": "MN",
    "postalCode": "55364"
  },
  "upstreamId": "7765374748"
}
{
  "id": "5823594809",
  "createdTime": "2025-05-09T05:01:09.863Z",
  "updatedTime": "2025-05-09T05:01:09.863Z",
  "customerId": "cus_5774321009",
  "sourceId": "src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37",
  "currency": "USD",
  "email": "jsmith@digitalriver.com",
  "locale": "en_US",
  "browserIp": "111.111.111.111",
  "applicationId": "68f72e0c-cb7d-48e1-93c8-998668ad0ff4",
  "shipFrom": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "shipTo": {
    "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",
    "organization": "Digital River",
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "subtotal": 1094.5,
  "totalTax": 82.76,
  "importerOfRecordTax": true,
  "totalFees": 0,
  "totalDuty": 0,
  "totalDiscount": 0,
  "totalShipping": 5.76,
  "totalAmount": 1180.26,
  "discount": {
    "amountOff": 5.95
  },
  "chargeType": "merchant_initiated",
  "purchaseLocation": {
    "country": "US",
    "state": "MN",
    "postalCode": "55364"
  },
  "customerType": "individual",
  "sellingEntity": {
    "id": "DR_IRELAND-ENTITY",
    "name": "Digital River Ireland"
  },
  "items": [
    [
      {
        "skuId": "sku_5823594809",
        "amount": 18.58,
        "discount": {
          "percentOff": 10
        }
      },
      {
        "skuId": "sku_9234276173",
        "amount": 18.58,
        "quantity": 2
      }
    ]
  ],
  "shippingChoice": {
    "amount": 5.95,
    "taxAmount": 0.1,
    "description": "USPS: Priority (1 day delivery)",
    "serviceLevel": "SG"
  },
  "paymentSessionId": "ps_8cecaa32-f692-44cc-b103-4cf24dc93913",
  "liveMode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "upstreamId": "7765374748"
}
Building checkouts