Capturing the Terms of Sale (TOS) acceptance

Learn how to add a TOS acceptance.

Terms of Sale (TOS) outlines the agreed-upon conditions between the buyer and seller regarding purchasing goods or services. This document covers payment terms, delivery conditions, return policies, warranties, and liabilities. Accepting the TOS is often a mandatory step for the customer before finalizing a purchase, ensuring that both parties know their rights and obligations.

Creating the TOS

To create the TOS, ensure that crucial sections such as payment terms, delivery conditions, return policies, warranties, and liabilities are included. Ensure that the TOS is clear, comprehensive, and easy to understand for customers. Accepting the TOS must be mandatory before the customer can finalize a purchase, ensuring clear agreement on the terms between both parties.

You can use a DigitalRiver object provided by DigitalRiver.js to create the TOS required by Digital River and disclose the TOS through Drop-in payments.

Setting the TOS acceptance parameter

To set the TOS acceptance parameter, include the termsOfSalesAcceptance field when creating or updating a cart. This ensures that the customer explicitly accepts the Terms of Sale before proceeding. The parameter accepts a boolean value: true for acceptance and false for non-acceptance.

The following cURL example shows how to set the termsOfSalesAcceptance when creating a cart:

cURL

curl --location --request POST 'https://api.digitalriver.com/v1/shoppers/me/carts/active' \
--header 'Content-Type:  application/json' \
--header 'authorization: Basic {Your_API_Key}\
--data-raw '{
  "cart": {
    "ipAddress": "10.24.2.28"
    "termsOfSalesAcceptance": "true"
  }
}'

201 Created response

A 201 Created response returns a Cart object:

{
    "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active",
    "paymentMethods": {},
    "applyPaymentMethod": {},
    "submitCart": {},
    "webCheckout": {},
    "id": "47278010023",
    "lineItems": {},
    "totalItemsInCart": "1",
    "businessEntityCode": "DR_INC-ENTITY",
    "termsOfSalesAcceptance":"true"
    "billingAddress": {},
    "shippingAddress": {},
    "payment": {},
    "shippingOptions": {},
    "pricing": {}
}

This termsOfSalesAcceptance parameter is mandatory for the cart submission process to confirm that the customer has accepted the TOS. The enumerated values are true or false.

You capture when a customer accepts the TOS. The following requests allow a customer to accept the TOS from the cart:

• Submit cart: POST /v1/shoppers/me/carts/active/submit-cart
• Update or create cart: POST /v1/shoppers/me/carts/active

How a customer accepts the TOS

How a user accepts the TOS depends on which option you selected when configuring Terms of Sale Acceptance on the Checkout tab under Configure Site Settings in Global Commerce.

The customer passively accepts terms through order submission

If you choose Shopper passively accepts terms through order submission, the customer accepts the TOS when they submit the order. Digital River requires this setting when we are the Reseller of Record.

The customer actively accepts the TOS

If you chose Shopper actively accepts terms before completing the purchase, the customer must click the checkbox to accept the TOS. Sites based in the EU require this setting.

No acceptance required

Choose No Acceptance Required if your site does not require the customer to accept the TOS.