LogoLogo
System status
Commerce API references
Commerce API references
  • Commerce API references
  • Warnings and error codes
    • Errors
    • Error codes
      • HTTP response status codes
      • Error format for Shopper APIs
      • Error codes for Shopper APIs
        • 400 Bad Request
        • 401 Unauthorized
        • 403 Forbidden
        • 404 Not Found
        • 405 Method Not Allowed
        • 409 Conflict
        • 412 Precondition Failed
        • 413 Payload Too Large
        • 500 Internal Server Error
      • Error format for Admin APIs
        • Async error objects
        • Sync error objects
        • Deployment objects
        • Warning objects
      • Error codes for Admin APIs
        • Error patterns
        • Supported image types
        • Asynchronous response error codes
        • Deployment error codes
        • Synchronous response error codes
  • Commerce API reference guide
    • API structure
      • API keys
      • Supported OAuth and Commerce API formats
      • Mini cart widget
      • Custom attributes
      • Fields used as keys
      • Fields and expand query parameters
      • Caching responses
      • CORS support
      • JSONP support
      • Transport
      • Service profiles
      • Supported protocols and formats
      • Elements
      • Rate limiting
      • Locale and currency
      • Exchange rate
      • Product identifier
      • Product external reference identifier (ERID)
      • Customer external reference identifier ERID
      • Cancel request process
      • Failover and redundancy
      • Troubleshooting API calls
    • Shopper APIs reference
      • Carts
        • Offers
          • Offer types
          • POP offers
          • Applied offers
          • Eligible offers
      • Orders
      • Returns
      • Links
    • Admin APIs reference
      • Subscriptions
      • Sites
      • Products
      • Live changes
      • Authorized shipping and billing countries
      • Merchandising
      • Disclosures
    • Glossary
Powered by GitBook
On this page
  • Authorized browsing restrictions
  • Authorized shopping countries
  • Billing countries
  • Shipping countries
  • Locales
  • Allowed countries
  • Denied countries
  • Search
  • Comments
  • Automatic geo-location
  • How automatic geolocation works
  • Unrecognized country
  • Redirect settings
  • Add or remove destinations
  • Cross-site forgery prevention
  • Password strength
  • Secure session cookie
  • Shopper account security
  • Shopper brute force protection
  • Shopper current password check settings
  1. Commerce API reference guide
  2. Admin APIs reference

Authorized shipping and billing countries

Understand shipping and billing countries.

PreviousLive changesNextMerchandising

Last updated 4 months ago

You can . The following information describes the attributes under the Security tab on the Configure Site Settings page in .

Once you configure the authorized shipping and billing countries, you can programmatically get a list of the or .

Authorized browsing restrictions

Use the Authorized Browsing Locales setting to indicate which supported locales a shopper (in a specific country) can see when they visit your site.

Example: If your European site has four locales, you can specify whether a shopper from one of those locales can browse your store in the other three locales. (Note that your automatic geo-location settings can determine the locales a shopper can visit.) Authorized browsing locales limit a shopper's ability to see your store in one of the other locales supported in your store.

You can set up authorized browsing locales to limit the locales (and therefore the products and pricing) a shopper can see based on the shopper's location. This ensures that a shopper can only purchase products from their designated locale.

Authorized shopping countries

You can define the list of authorized shopping countries for your site. The list of authorized countries defines which shoppers can purchase products from your store based on the billing or shipping address they enter during checkout. Use this feature when you want to:

  • Deny shoppers living in a specific location from purchasing products from your store.

  • Deny shoppers who want to ship products to a certain location (even if they do not reside at that location) from shipping products to that location from your store.

Billing countries

You can use the Allow Billing From attribute to choose the option you want to use to define purchase restrictions based on the shopper's billing address. Your options are as follows:

  • Any Country—This option allows shoppers with a billing address from any country to purchase from your store. There are no shopping restrictions based on the billing address.

  • Any Country Except Specifically Denied Countries—Allows you to specify the countries that shoppers cannot select when they enter their billing information. This option prevents shoppers who provide billing information tied to an unauthorized country from purchasing products from your store.

  • Only Specifically Allowed Countries—You can specify the countries shoppers can select when they enter their billing information. This ensures only shoppers in a specific country or who provide billing information tied to a specific country can purchase products from your store.

Shipping countries

You can use the Allow Shipping To attribute to choose the option you want to use to define purchase restrictions based on the shopper's shipping address.

  • Any Country—Allows shoppers with a Shipping address from any country to purchase from your store. This option has no shopping restrictions based on the shipping address.

  • Any Authorized Billing Country—Allows shoppers who enter a shipping address in any authorized billing country to place an order in your store.

  • Any Country Except Specifically Denied Countries—This option allows you to specify the countries shoppers cannot select when entering their shipping information. It prevents shoppers who provide shipping information tied to an unauthorized country from purchasing products from your store.

  • Only Specifically Allowed Countries—You can specify the countries that shoppers can select when entering their shipping information. This ensures only shoppers in a specific country or who provide shipping information tied to a specific country, can purchase products from your store.

Locales

Supported locales (all other locales besides the default locale) will inherit the settings from the default locale by default. If you want to configure a supported locale differently from the default, click that locale tab, select the Customize for This Locale option, and then add the countries you want to allow or deny for that locale.

Allowed countries

Lists the countries a shopper can use when entering their billing or shipping countries.

Denied countries

Lists the countries a shopper cannot use when entering their billing or shipping information. Some countries appear in the Denied Countries list by default. You cannot do business with these countries based on export control restrictions.

If a shopper from an unauthorized country tries to purchase a product, they will trigger the following error:

{ 
   "errors":{ 
      "error":[ 
         { 
             "relation":"https://developers.digitalriver.com/shoppers/CartsResource", 
             "code":"restricted-bill-to-country", 
             "description":"Billing Address country is restricted for request" 
         } 
       ] 
    } 
} 

Search

To search for countries you want to deny or allow by locale, click the Search button, select the countries you want to allow or deny and click Apply. The Selected countries appear in the list.

Comments

Explain why you defined the restrictions in the Comments field. Provide enough detail to ensure someone else can determine why you denied or allowed billing or shipping to a specific country for a specific locale.

Automatic geo-location

How automatic geolocation works

When you enable Automatic Geo-Location and a shopper visits your store (either by entering a URL in the address bar or clicking a link), the system redirects them to the site that corresponds with the redirect settings you defined.

You define geolocation redirect rules primarily at the site level. The system compiles and stores the redirect rules at the company level.

The geolocation system compares each incoming shopper's origin country and browser language to the compiled list of redirect rules for all sites within the company hierarchy. The system identifies the correct redirect rule based on the shopper's country and language and directs the shopper to the related site and locale.

There are two types of site-level redirect rules:

  1. The first rule type redirects all incoming shoppers whose origin country the system cannot identify or match the second rule type. You can only specify one redirect rule of this type.

  2. The second rule type redirects shoppers coming from a specific country/locale. You can specify many redirect rules of this type.

You can also set redirect rules at the company level. Use these rules when redirecting shoppers who try to access a site not hosted by Digital River.

If Digital River hosts all of the EMEA sites for a specific company but none of the APAC sites, you can create a company-level rule that redirects all incoming APAC shoppers to the appropriate non-Digital River site.

Unrecognized country

The system redirects the shopper according to your specified settings if the country code is not recognized or configured in the Country/Language list. Use the Unrecognized Country attribute to choose one of the following options:

  • Stay on this site—Shoppers visiting your store from an unrecognized country will stay on the site they are trying to view.

    Example: If a shopper from an unrecognized country tries to access your store's en_GB locale and you do not have a rule set up to redirect shoppers in unrecognized countries specifically, they will see your store's en_GB locale.

  • Go to specific site—The system redirects shoppers visiting your store from an unrecognized country to a specific site and locale you select from the Site and Locale lists that appear when you select this option. If you select Go to specific site, the following attributes appear:

    • Site—Choose the site you want to redirect shoppers to from this list. This field appears when you select the Go to specific site option.

    • Locale—Choose the locale you want to use from this list. This field appears when you select the Go to specific site option.

Redirect settings

Choose whether you want to redirect shoppers visiting your store from an unrecognized country to a specific site or locale based on their location and browser language setting.

  • Always Redirect—Automatically redirect shoppers in a specific country with a specific locale setting in their browser to a specified site and locale when they visit your store.

  • Do Not Redirect—Allows shoppers to go directly to your store based on their browser's IP location and locale setting.

Add or remove destinations

To add or remove destinations, click the Add or Remove button, select the country, browser language, and destination, and then click Save.

Cross-site forgery prevention

When enabled, this feature protects shoppers against attacks that force them to unwittingly perform actions against their permission. To enable or disable Cross-Site Request Forger Prevention, choose one of the following options:

  • ON—Enables protection against attacks that force shoppers to act unwittingly without their permission. When you select ON, the Enable Cross-Site Request Forgery (CSRF) for Anonymous Users toggle appears.

  • OFF—Disables protection against attacks that force shoppers to act unwittingly against their permissionforget.

To enable or disable CSRF for Anonymous Users, choose one of the following options:

  • ON—Enables protection against attacks that force anonymous shoppers to perform actions against their permission unwittingly.

  • OFF—Disables protection against attacks that force anonymous shoppers to perform actions against their permission unwittingly.

Password strength

When SSO is enabled, the password strength feature is disabled. When SSO is disabled, you can define the user's password strength.

  • Minimum Password Length—Define the minimum number of characters that a shopper must use for a password. The minimum number of characters is 8, and the maximum number of characters is 32.

  • Enhanced Password Strength—Enhanced password strength requires a secure shopper's password. In addition to meeting the minimum password length, the password will need to include three of the following characteristics:

    • Upper case letter

    • lower case letter

    • Numbers

    • Special characters: ! @ # $ % ^ * ~ : ; & > < [ ] { } | - _ + = ?

    Choose one of the following options:

    • ON—Enables the Enhanced Password Strength feature.

      Note: If you enable the Enhanced Password Strength feature, existing shoppers with weak passwords must change their password when they sign in.

    • OFF—Disables the Enhanced Password Strength feature.

Secure session cookie

The secure session feature allows you to use a secure-session cookie to prevent someone from hijacking a Global Commerce session. Choose one of the following Secure Session Cookie options:

  • Enabled—Enables the Secure Session Cookie feature. The Lenient Mode appears when you select the Enabled option for Secure Session Cookie.

  • Disabled—Disables the Secure Session Cookie feature.

Suppose the secure cookie sent by the client does not match the information originally sent to the client. In that case, the system will log out of the session automatically (including the innocent client) when you disable Lenient Mode. Choose one of the following Lenient Mode options:

  • Enabled—Enables the Lenient Mode feature.

  • Disabled—Disables the Lenient Mode feature.

Shopper account security

The shopper account security feature allows you to define how shoppers can regain access to their accounts if they forget their passwords. Some settings may require assistance from your Store Operations Manager.

  • Forgot password email—Choose how you want to respond when a shopper requests a new password because they forgot their password:

    • Send Shopper Their Password—The system sends the shopper an email with a new password.

    • Send Shopper a Link to Reset Their Password—The system sends an email with a link to the shopper that they can use to create a new password.

  • Expire link to reset password—Enter the hours before the link expires. The value must be greater than zero (0). This field appears when you select the Send Shopper a Link to Reset Their Password option.

Shopper brute force protection

Whether the following fields are enabled depends ho how you configured your authentication settings. When these fields are enabled, you can define your policy for protecting shopper accounts from an automated hacking attack.

  • Account Protection—Choose one of the following options:

    • Require the user to enter a CAPTCHA after multiple failed logins

    • Lock shopper account after multiple failed logins

  • Number of Attempts—Enter the number of failed login attempts that trigger account protection. The number must be greater than 0 and less than 16.

Shopper current password check settings

When this feature is enabled, shoppers must enter their current password when they change it. Choose one of the following options:

  • ON—The shopper must enter their current password when changing it.

  • OFF—The shopper does not need to enter their current password when changing it.

You can use the resource to get the list of allowed billing countries and use that information to display allowed billing countries in the Country drop-down list when a shopper provides their billing details.

You can use the resource to get the list of authorized shipping countries.

The automatic geo-location setting allows you to send shoppers to a specific site and locale based on their language and geographic location. The feature also allows you to restrict shoppers from certain locations from viewing or shopping in your store. See for more information.

How Automatic Geo-Location works
Global Commerce
configure the authorized shipping and billing countries
authorized billing countries
shipping countries
GET /v1/sites/{siteId}/authorized-billing-countries
GET /v1/sites/{siteId}/authorized-shipping-countries