# BigCommerce App BigCommerce allows merchants to concentrate on building innovative web applications without worrying about how to bill their customers. Available versions: * [BigCommerce Prebuilt Checkout solution](https://docs.digitalriver.com/bigcommerce-prebuilt-checkout-solution/) Support only: * [BigCommerce app 1.0](https://docs.digitalriver.com/bigcommerce/1.0-4/) {% embed url="" %} # BigCommerce App 1.0 BigCommerce allows merchants to concentrate on building innovative web applications without worrying about how to bill their customers. ## System Requirements * **API Fleet and version**: Digital River API version 2021-02-23 * **Commerce Platform Version**: BigCommerce 6.2.0\
# Introduction BigCommerce is a recurring billing system designed for software as a service (SaaS) companies. BigCommerce allows merchants to concentrate on building innovative web applications without worrying about how to bill their customers. The Digital River app on BigCommerce's Marketplace enables a client or brand using BigCommerce's store to activate a powerful global enabler solution that can perform the complex and risky back-end requirements of global expansion so they can instead focus on new markets and grow international sales. The Digital River app plugs directly into BigCommerce's platform, enabling flawless, hyper-localized customer experiences from checkout to fulfillment. You can also use it to quickly expand into new countries while we manage local regulatory compliance, taxes, payments, payment card industry (PCI) compliance, fraud, chargebacks, customer support, and more. # Supported countries Learn about supported countries. The BigCommerce app supports Digital River payment integration, tax calculation, and tax management: Your store must be based in one of the following countries: AD, AE, AF, AL, AR, AS, AT, AU, AZ, BA, BD, BE, BG, BH, BN, BO, BR, BV, BY, CA, CC, CH, CK, CL, CN, CO, CR, CX, CY, CZ, DE, DK, DO, DZ, EC, EE, EG, ES, ET, FI, FM, FO, FR, GB, GF, GL, GR, GS, GT, GU, HK, HM, HN, HR, HU, ID, IE, IL, IN, IO, IQ, IS, IT, JO, JP, KE, KH, KI, KR, KW, KZ, LA, LB, LI, LK, LS, LT, LU, LV, LY, MA, MC, MH, MK, MM, MO, MP, MR, MT, MX, MY, NF, NG, NI, NL, NO, NP, NU, NZ, OM, PA, PE, PH, PK, PL, PM, PN, PR, PT, PY, QA, RE, RO, RS, SA, SE, SG, SI, SJ, SK, SL, SM, SV, TA, TC, TH, TK, TL, TM, TN, TR, TT, TV, TW, UA, UM, US, UY, UZ, VA, VE, VN, YE, ZA. We conducted testing for the following country, currency, and locale combinations: | Country | Currency | Locale | | ------------------ | -------- | ------ | | Great Britain (GB) | GBP | en\_GB | | United States (US) | USD | en\_US | ## Supported markets For information on supported markets and currencies for [Drop-in](https://docs.digitalriver.com/digital-river-api/payments/payment-integrations-1/drop-in), go to: * **Payment Method Guide:** [digitalriver.com/payment-method-guide](https://www.digitalriver.com/payment-method-guide/) * **Country Guide:** [digitalriver.com/country-guide/](https://www.digitalriver.com/country-guide/) # General workflow Learn about the general workflow for the BigCommerce app. Digital River integrates with the BigCommerce app with a seamless front-end purchasing experience. It includes product details, merchandising, checkout, and payment information, while Digital River handles back-end functions, including behind-the-scenes tax compliance, payment processing, and risk mitigation.
The Digital River app provides a host of benefits: * Seamless connectivity with Digital River's Global Seller Services solution * Easy to install and configure * No micromanagement of the front-end shopper experience * Alleviates the burden of tax and fraud risk * Unites best-in-class front-end and back-end solutions # Features Learn about the features for the Digital River app. The Digital River app provides the following features: * Transaction processing * Order cancellation * Post-order management * Digital product sales * Physical product sales * Mixed cart (physical and digital) sales * Digital River Drop-in * One-time billing/discrete purchase–guest shopper * One-time billing/discrete purchase–authenticated shopper * Integrated user management * Integrated external fulfillment support * External return integration * Order cancellation integration * Refund orchestration * Tax-exclusive and inclusive pricing and display * Translations support * Automated one-way catalog sync * Cross-border shipping * Integration error monitor and notifications # Requirements Learn about the requirements for the BigCommerce app. You must meet the following requirements before you can integrate the app. * You must use an optimized one-page checkout. * You must install the Digital River Payments, Fraud, Tax & Compliance Management app (Digital River app). * You must not have any other tax provider app installed. * You must not have any other payment provider connected. * You must have a phone number for shipping and billing information on checkout. * You must use the [Adding Products (v3](https://support.bigcommerce.com/s/article/Adding-Products-v3?language=en_US)) interface. * You must use the [Product Options (v3)](https://support.bigcommerce.com/s/article/Product-Options-v3?language=en_US) interface. ### Product setup requirements You must fill out the following fields for each product: * [SKU](https://docs.digitalriver.com/digital-river-api/product-management/skus#skus) * [Country of origin](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus#country-of-origin) * [Export Control Classification Number](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus#eccn) (ECCN)–You can add the ECCN through a Custom Field. The field name must be ECCN. * [Tax Code](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus#tax-code) * [`skuGroupId`](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus#sku-group-identifier)–The `skuGroupId` uniquely identifies a [SKU group](https://www.digitalriver.com/docs/digital-river-api-reference/#tag/SKUs) configured for your Digital River account. A SKU group allows you to define the global markets, trading patterns, and their functionality. For more information, see [Grouping SKUs](https://docs.digitalriver.com/digital-river-api/product-management/setting-up-sku-groups). To configure your SKU groups, contact your Digital River Account Manager. {% hint style="info" %} When updating the `skuGroupId`, it is important to update or change the Basic Product details simultaneously. This ensures that the product details are properly synchronized with Digital River when the webhook is triggered. {% endhint %} # Considerations Learn about the considerations for the BigCommerce app. When integrating with Digital River, several important factors can impact the overall functionality and performance of your BigCommerce platform. This section outlines key considerations that you should review to ensure a smooth and successful integration process. * To connect with Digital River, you must turn off any previous payment integrations. * Before integration, review the **Shipping Setup** to understand any shipping limitations within the BigCommerce platform. # Limitations Learn about the limitations for the BigCommerce app. While integrating Digital River with BigCommerce offers numerous benefits, it's important to be aware of some limitations. This integration does not currently support certain features and functionalities, and you must take special care, particularly regarding payment and tax integrations. Below is a detailed list of the specific limitations you may encounter: * Suppose you already have a transacting store with a non-Digital River payment integration. In that case, you must turn off any non-Digital River payment and tax integrations before connecting with Digital River. * This integration does not currently support the following features. * For SKU groups, there is only one `hsCode` per product * [Gift wrapping](https://support.bigcommerce.com/s/article/Gift-Wrapping?language=en_US) * [Creating tax-exempt customers](https://support.bigcommerce.com/s/article/How-do-I-have-customers-with-a-tax-exempt-status?language=en_US) * [Gift certificates](https://support.bigcommerce.com/s/article/Gift-Certificates?language=en_US) * [Buy one get one free (BOGOF)](https://support.bigcommerce.com/s/article/Possible-Discounts-Offer?language=en_US#promotions) * [Stored payment methods](https://support.bigcommerce.com/s/article/Enabling-Stored-Payment-Methods?language=en_US) * Stored credit * When the BigCommerce control panel triggers a refund and fails, the order status will continue to display as refunded to the customer. The order timeline will reflect the failure correctly, and you must use the Digital River [Dashboard ](https://dashboard.digitalriver.com/login)to [process the refund](https://docs.digitalriver.com/digital-river-api/administration/dashboard/order-management/orders/creating-a-refund). * At this point, you must [refund the order](https://docs.digitalriver.com/digital-river-api/administration/dashboard/order-management/orders/creating-a-refund) from the [Digital River Dashboard](https://dashboard.digitalriver.com/login). See [Processing Refunds](https://support.bigcommerce.com/s/article/Processing-Refunds?language=en_US) for more information. # Install the Digital River app Learn how to install the Digital River app. Installing the Digital River app on your BigCommerce store is essential for effectively managing and streamlining your eCommerce operations. This app integrates powerful payment processing and transaction features, ensuring seamless and secure financial operations. Follow these steps to install and configure the Digital River app on your BigCommerce platform, starting with setting up a test account and obtaining API keys from the Digital River Dashboard. To install the Digital River app: 1. Use the [Quick start guide](https://docs.digitalriver.com/digital-river-api/quick-start-guide) to set up a test account and then sign in to the Digital River [Dashboard](https://dashboard.digitalriver.com/login) to access your test account, set the API version, and get your [API keys](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/api-keys). From the Dashboard: 1. [Set the API version to 2021-02-23](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/api-keys/updating-your-api-version#updating-your-api-version-on-all-keys). 2. [Obtain both the Public and Confidential Keys](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/api-keys/getting-your-api-keys).
![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FJzOzdy8HqF6Qw5cfvEZK%2FKeysandversioning.png?alt=media\&token=b17a3b4a-45ce-4e6d-a8bf-7d80ad58b066) ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FXcwCMHzn0Y7VTyM7JDeP%2FPublicandconfidentialkeys.png?alt=media\&token=509288be-81e3-4bf0-8a43-0ef55c799540) 2. Sign in to [BigCommerce](https://login.bigcommerce.com/). 1. Go to . 2. Install the **Digital River** app from the BigCommerce Marketplace. Note that the site owner must install the app. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FPPHHtGEvUhIOTl4xeyiZ%2FInstallapp.png?alt=media\&token=d16a882a-764f-41d9-8a11-f7d9857432bf) ## Registering your API keys To register your API keys: 1. In the BigCommerce platform, click **Apps** and then **Digital River** to open the Digital River Payments, Fraud, Tax & Compliance Management app. 2. Enter your test confidential key in the **Digital River Test Confidential API Key** field. These keys are available on the [Digital River Dashboard](https://dashboard.digitalriver.com/apikeys). The Digital River Production Confidential API Key field can remain empty until you provision the live site.\ **Note**: You are not required to provide the production confidential API key. The **Digital River Production Confidential API Key** field can remain empty until you are ready to go live. 3. Choose one of the following options: * Select the **Use Digital River Fulfillment** checkbox if you will use Digital River managed fulfillment. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FVrxZmmRrTydlVSsjhH6d%2FDigitalRiverapplicationtestkey.PNG?alt=media\&token=0c0335f6-8dda-4352-a244-8c5b9fe40592)
**Important**: Do not select the **Use Production Key** checkbox until testing is complete and you are ready to launch your site. * **Required**. Select the **Use Digital River Multi-Origin Shipping Option** checkbox and enter the shipping location combination in the **Provide Destination-Origin shipping location combination** field. \ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FAgzz23r18ebDOZBMot9Z%2FUse-Digital-River-Multi-Origin-Shipping-Option.png?alt=media\&token=e7bf7b3b-1374-4925-9940-5071f40df979)\ The shipping location combination contains the shipping address, a pair of two-letter [Alpha-2 country codes](https://www.iban.com/country-codes) that represent the ship-to country and ship-from country delimited by a right chevron (`>`) such as `FR>FR`. Where France (FR) is the ship-to country and France (FR) is the ship-from country. When entering the shipping location, use the following format: `line1|line2|city|state|postal code|country code`.\ You can use a comma (`,`) to delimit multiple shipping location combinations and a double pipe (`||`)such as if there is no value. For example: \ \ `US>134-135 main street||Minnesota|MN|55343|US,CA>CA,FR>FR,DEFAULT>CN`\ **Note**: * You must provide the full ship-from address for tax purposes when shipping from Canada or the United States. * If a ship-to country code is NOT found in the list provided and if the `DEFAULT` key is available, then apply the value from the `DEFAULT` key. In the example above, it would be `CN`. * If there is NO `DEFAULT` key in the string, then BigCommerce will apply a tax estimate origin address country\_code/locale country\_code. * If the **Provide Destination-Origin shipping location combination** field is empty, then BigCommerce will apply the tax estimate origin address country\_code/locale country\_code. 4. Click **Submit**. When you successfully register your API keys, you will see the following message:
# Configure the BigCommerce settings Learn how to set up the store for the BigCommerce app. # Step 1: Configure the store profile Learn how to configure your store profile. It's essential to configure your store profile correctly. Follow these steps to input necessary details such as contact information, default country, and language settings, ensuring all configurations align to avoid discrepancies during checkout and order submission. Here's how to configure your store profile: Work with your Digital River project manager to configure your store. Digital River will assist in confirming that it meets the [requirements](/bigcommerce/1.0-4/introduction/requirements#features). To configure your store profile: 1. Click **Settings** in the app menu on the left and then click **Store Profile**. 2. Enter your store contact information. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FijIERcYyIeZRSjNehu2z%2FContactinformation.PNG?alt=media\&token=332ca604-137a-41ea-9dc1-ae3597925140) 3. Select your **Default country** from the drop-down menu. **Note**: You must select the same country for both Default country and [Shipping Origin](/bigcommerce/1.0-4/configure-the-bigcommerce-settings/step-5-configure-shipping). If you do not set this correctly, the totals displayed to the shopper during checkout and order submission will be different. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FGExjeDqyIKzRbOIcCPaN%2FDefaultcountry.PNG?alt=media\&token=cfa407c4-af90-4cf3-a84c-75c320f394d4) 4. Select **Set specific language manually** under Default language, then select the language from the following dropdown menu. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2Fac4YLZoZ2etlwrdYJljz%2FDefaultlanguage.PNG?alt=media\&token=a88ca1ce-1579-4c73-9357-17143ad2099c) 5. Click **Save**. # Step 2: Configure payments Learn how to configure payments for your store. To ensure a seamless payment experience on your BigCommerce storefront, follow the steps below to configure Digital River payments. This guide will walk you through the essential settings for integrating Digital River, including currency configuration, API key setup, and warehouse location entry. Properly configuring these settings will enable you to handle multiple currencies and streamline your eCommerce operations. {% hint style="warning" %} For the [Drop-in payments](https://docs.digitalriver.com/digital-river-api/payments/payment-integrations-1/drop-in) to work, you must configure the currency on the BigCommerce storefront and enable the payment method on the **Digital River Settings** tab. You must complete this task for each supported currency listed in the **Show payment methods** drop-down list. {% endhint %} To configure payments: 1. Click **Settings** in the app menu on the left and then click **Payments**. 2. From the **Checkout Payment Settings** tab, select the supported currency from the drop-down list under **Show payment methods**. \ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F42gO0SGVDICtvl3hDwkR%2FShow-payment-methods.png?alt=media\&token=192678a6-6401-4dde-8551-1a6892194988) 3. Disable all non-Digital River payment methods, if applicable. 4. Scroll down to **Online Payment Methods** and expand the pane. 5. Locate **Digital River** and click **Set up**. The Digital River Settings tab appears. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FIdl1qkLv3ubsbb4nWbHk%2FDigital-River-Set-Up.png?alt=media\&token=520a581c-133e-421d-b0f5-cdd6c2c5f749) 6. From the **Digital River Settings** tab. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FoNDnN7zcTREmljLLAhXm%2FDigitalriversettings.PNG?alt=media\&token=c2c7ff1c-57c0-4186-91e3-f49f8c6bed3a) 7. Enter your Digital River API keys obtained from the [Digital River Dashboard](https://dashboard.digitalriver.com/login). ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FI1xE8XPdr8Kxa55Ws3Cp%2FAPIkeys.PNG?alt=media\&token=40dff670-6108-4de7-8aad-3cb57aeef94e) * **Production Confidential Key**–Provide your Digital River production confidential key. * **Production Public Key**–Your Digital River production public key.u by Digital River * **Test Confidential Key**–Your Digital River test confidential key (or “evaluation confidential key”). * **Test Public Key**–Your Digital River test public key (or “evaluation public key”). **Note**: The same values that you entered for the fields above must also be copied into your Digital River Payments, Fraud, Tax & Compliance Management app. 8. Select **Yes** from the **Test Mode** dropdown menu. **Test Mode** determines whether your store is in test mode. When you are ready to take payments, change this value to **No** (recommended). 9. Required. Set up your warehouse location. You can use the **Multi-Origin Shipping** setting to support multiple warehouse locations in multiple countries, enter the location combinations in the Multi-Origin Shipping field. When entering the shipping location, use the following format: `line1|line2|city|state|postal code|country code`.\ You can use a comma (`,`) to delimit multiple shipping location combinations and a double pipe (`||`)such as if there is no value. For example: \ \ `US>134-135 main street||Minnesota|MN|55343|US,CA>CA,FR>FR,DEFAULT>CN` ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F587W7rVdQNdLG18o2AXb%2FMulti-Origin-Shipping.png?alt=media\&token=d655419e-6faa-4ce7-b9fe-3843957b1ffd) 10. Click **Save**. Repeat steps 2-10 using the same API keys for each new or updated currency and warehouse location. {% hint style="info" %} Each time you click **Save**, BigCommerce automatically [creates a new webhook endpoint](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/webhooks/creating-a-webhook) within your Digital River account You are responsible for [deleting any duplicate or old webhook endpoints](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/webhooks/deleting-a-webhook) within Digital River to avoid sending duplicate event data to BigCommerce. {% endhint %} {% hint style="info" %} You must copy the same values that you entered in the fields above into your Digital River app. {% endhint %} {% hint style="info" %} You must enable and configure the following features within your Digital River account. They are not configurable within BigCommerce. * 3D-Secure * CVV required * [Payment methods](https://docs.digitalriver.com/digital-river-api/administration/dashboard/settings/payment-methods) * Stored credit cards {% endhint %} # Step 3: Configure currencies Learn how to configure currencies for your store. Configuring currencies in BigCommerce allows your store to support multiple currencies, enhancing the shopping experience for international customers. By setting up different currencies, you can provide localized pricing and improve checkout conversions. Follow the steps below to configure currencies for your store. {% hint style="info" %} You must [configure payments](/bigcommerce/1.0-4/configure-the-bigcommerce-settings/step-2-configure-payments) before you configure currencies. {% endhint %} To configure currencies within the BigCommerce: 1. Click **Settings** in the app menu on the left and then click **Currencies**. 2. Click the **Add new currency** button. The Add Currency dialog box appears. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FyOQBXUPA4WJiIrFq8CUx%2FAddcurrency.PNG?alt=media\&token=6afd79ae-68ed-4d73-8699-cae0ce7db9d9)
3. Select a currency code from the drop-down menu and click **Next**. 4. Enter the display name for the currency under **Currency display configurations**. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FjbtpDnfd4ARA17AVcvD2%2FCurrencydisplay.PNG?alt=media\&token=c0e06850-d9aa-48e5-b86c-e3fde9d5cf7d)
5. Optional. Use Shift+Click to associate the countries with this currency. If the field is blank, the currency is available in all countries. 6. Select an option for **Transacting currency**. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F5V6MIKYRw5KTXYb6E2oU%2FTransactions.PNG?alt=media\&token=04f3aee9-afd0-4448-9164-c4a6d8258dd6) 7. Enter the static conversion rate. The static conversion rate remains unchanged until you enter a different conversion rate. Using this method avoids constantly fluctuating prices in non-default currencies. 8. Complete the fields under the **Currency display** to customize how the currency will appear to customers. 9. Click **Save**. 10. To allow shoppers to transact in this currency, click the toggle in the **Visible?** column. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2FU9lVMPyjg8V4TR0XCQyI%2FVisible-toggle.png?alt=media\&token=6ab18050-c6f0-41e1-b25d-f04a1a2316fa) ## Multi-currency Digital River on BigCommerce can be configured for multiple currencies at a time. A single Digital River merchant account accepts all Digital River-supported transaction currencies. For more information, visit [Multicurrency](https://support.bigcommerce.com/s/article/Managing-Currencies?language=en_US#mc). # Step 4: Configure tax Learn how to configure tax for your store. Configuring tax settings is crucial to ensure accurate tax calculation and compliance with regional tax laws. This guide will walk you through setting up tax services, defining tax labels, and configuring display settings. By following these instructions, you can streamline your tax management and provide clarity to your customers during checkout. ## Configure tax settings To configure tax settings: 1. Click **Settings** in the menu on the left and then click **Tax**. 2. Click **Enable** to enable Digital River as a tax service. A green ENABLED text box will appear next to Digital River. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FpBEVnCrpI00YGOENHSq0%2FDigitalriverenabled.PNG?alt=media\&token=e8c15158-ca48-411d-aafc-87e1b8b1d165) 3. Click **Edit** under **Tax Settings**. 4. Type the label in the **Tax Label** field to describe this tax option. 5. Under **Prices Entered With Tax**, and choose **No, I will enter prices exclusive of tax**. **Note**: You must set the **Prices Entered with Tax** drop-down to **No, I will enter prices exclusive of tax.** ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FHHmlyhESpUd787bqIP9U%2FPricesenteredwithtax.PNG?alt=media\&token=3d70f477-366a-46bc-8e44-b64dd2ddf41c) 6. Under **Fallback Tax**, and choose **Use my manual Tax settings**. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FhtgF7MqcDoW6w2xb8eSE%2FFallbacktax.PNG?alt=media\&token=c6b798d2-5c21-4d5e-bdc5-1b0f66ecfddf) 7. Select the specified option from each of the following drop-down menus: * **Calculate Tax Based on**: Destination Address * **Shipping Tax Class**: Shipping * **Gift Wrapping Tax Class**: Gift Wrapping
![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FJsI0K7z1xwimB2EfxILz%2FCalculatetaxbasedon.PNG?alt=media\&token=bad00572-2f0c-4f4c-afc3-76d81d96c825) 8. Under **Configure Tax Display Settings**, select the specified option from each of the following drop-down menus: * **Show Prices Within Control Panel**: Excluding Tax * **Show Prices on Invoices**: Excluding Tax * **Show Tax Charges in Cart and Checkout**: Broken down by tax rate * **Show Tax Charges on Orders and Invoices**: Broken down by tax rate ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F6nzQi1GAPVnDYHhnUru7%2FConfiguretaxdisplay.PNG?alt=media\&token=f2d6e450-835c-48a4-8b0e-843a005e85b4) 9. Optional. Under **Configure Default Tax Address**, select a country from the drop-down menu. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FQREhoznamt4P0XJ8khMU%2FConfigure-Default-Tax-Address.png?alt=media\&token=2e6f2ee0-bebd-4612-b51b-b8086792ad28) 10. Optional. Select a state from the drop-down menu, if applicable. 11. Optional. Enter a postal code, if applicable. 12. Click **Save**. ## Configure the tax rates and zones To configure the tax rates and zones: 1. From the Tax page, scroll down to **Set up your own tax rules** and click **Edit** for **Manual Tax**. 2. Click the **Tax Rates & Zones** tab. 3. Click **Add Tax Zone**. 4. In the **Tax Zone Name** field, type the name you want to use for this tax zone. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F0sh1nhvOgRG137LNfxtY%2FTax-Zone-Name.png?alt=media\&token=e9a02fb5-019a-408e-8ed5-51989b01d009) 5. Choose one of the following options for **Tax Zone Type**: * **This tax zone is based on one or more countries** * **This tax zone is based on one or more states** * **This tax zone is based on one or more postal codes** 6. Select the appropriate country or countries from the **Country** list. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2Fph0yPnCoLZnzsBsK4aGO%2FCountries-list.png?alt=media\&token=214685c6-5222-4811-a378-8b26ee8d79e0) 7. Choose the **All customers in my store option** for **Tax Zone Applies to**. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FAwBdmNKJOfUDboymz1Dz%2FTax-Zone-Applies-to.png?alt=media\&token=41836e3b-01ef-4121-a7fa-ecb4c290ad7c) 8. Select the **Enable this tax zone** check box. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FYdldCqL9iazTOJCUgx3p%2FEnable-this-tax-zone.png?alt=media\&token=4b9bc081-9ba1-47c4-b33a-21db7de24882) 9. Click **Save**. # Step 5: Configure shipping Learn how to configure shipping for your store. Configuring shipping settings in your application is essential to ensure accurate and timely delivery of products to your customers. This section provides step-by-step instructions on setting up your shipping address and adding various country zones to streamline your shipping process. By correctly configuring these settings, you can manage shipping origins, set up shipping zones, and enable static and real-time shipping quotes for a seamless checkout experience. ## Configuring the shipping address To configure the shipping address: 1. Click **Settings** in the app menu on the left and then click **Shipping**. The Shipping Manager page appears. 2. Under **Shipping Origin**, click **Edit**. The **Configure Shipping Address** dialog appears. **Note**: You must select the same country for both [Default country](/bigcommerce/1.0-4/configure-the-bigcommerce-settings/step-1-configure-the-store-profile) and Shipping Origin (ship-from address). If you do not set it correctly, the totals displayed to the shopper during checkout and order submission will be different. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F2bqX4yWBMEKd3VdRXR89%2FConfigure-shipping-address.png?alt=media\&token=07f04e7f-f903-4030-a18a-784e244d8687)
3. Complete the fields and click **Submit**. The required fields are **Address**, **City Postcode**, and **Country**. ## Adding a country zone 1. Under **Checkout Shipping Options** on the **Shipping Manager** page, select **Add a country zone** from the **Add shipping zone** drop-down. To **Add a country zone**: 1. Select a country from the **Country** drop-down and click **Submit**. This will add a single country as a valid shipping destination. For more complex zones like multiple countries, states, or postcodes, set up a [custom zone](/bigcommerce/1.0-4/configure-the-bigcommerce-settings/step-5-configure-shipping#adding-a-custom-zone). ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FmGp6mcqkrAG9IfTxCpjb%2FAdd-Country-Zone.png?alt=media\&token=c0989cde-d59a-4e77-8ea5-29596a8e5fc0) 2. To configure shipping quotes for a country, click **Configure** next to the country you added. 3. Choose one of the following options: * To enable static shipping quotes, toggle one of the options to enable under **Static shipping quotes**, complete the fields, and click **Submit**. Repeat this step for each additional option.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2F5JzIRNgxDrV3tZ4mbX6Y%2FStatic-shipping-quotes.png?alt=media\&token=70ffcd89-e958-4fda-a8e3-2868e4649fe5) * To configure real-time shipping quotes, click **Connect** next to the real-time shipping option you want to use under **Real-time shipping quotes**, complete the fields under each tab, and click **Submit**. Repeat this step for each additional option.\ .![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2FsrfTIHzr9x6pfe7dfqzU%2FReal-time-shipping-quotes.png?alt=media\&token=ea78d05f-46e5-4767-abf1-f48b17e1c195) 4. Click **Done**. ## Adding a custom zone To add a custom zone: 1. Under **Checkout Shipping Options** on the **Shipping Manager** page, select **Add a custom zone** from the **Add shipping zone** drop-down. The Add custom zone dialog will then appear. 2. Complete the fields under the **Zone** and **Handling fee** tabs and click **Submit**. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2Fj6tHCZ3ILjS6SqE4xFrj%2FAdd-custom-zone-zone.png?alt=media\&token=b7ead376-5e7a-4cd7-b379-4530e8ceb315) ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FmxkJyHyOUrbM5kOvnBbt%2FAdd-custom-zone-handling-fee.png?alt=media\&token=386985d1-3cbd-4f82-acd8-6ca87c057566) 3. Click **Configure** next to the zone you added. 4. Choose one of the following options: * To enable static shipping quotes, toggle one of the options to enable under **Static shipping quotes**, complete the fields, and click **Submit**. Repeat this step for each additional option.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2F5JzIRNgxDrV3tZ4mbX6Y%2FStatic-shipping-quotes.png?alt=media\&token=70ffcd89-e958-4fda-a8e3-2868e4649fe5) * To configure real-time shipping quotes, click **Connect** next to the real-time shipping option you want to use under **Real-time shipping quotes**, complete the fields under each tab, and click **Submit**. Repeat this step for each additional option.\ .![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2FsrfTIHzr9x6pfe7dfqzU%2FReal-time-shipping-quotes.png?alt=media\&token=ea78d05f-46e5-4767-abf1-f48b17e1c195) 5. Click **Done**. # Step 6: Create a script for Digital River compliance terms Learn how to create a script for the Digital River compliance terms. To ensure compliance with Digital River's terms and conditions, you may need to integrate specific scripts into your store's checkout process. This guide will walk you through creating and adding a script for Digital River compliance terms using the Script Manager. Follow the instructions below to complete the integration seamlessly. The Script Manager is a visual organization of the scripts installed on your store. You can manage any scripts installed via our API or added directly from the Script Manager from this page. To create a script for the Digital River compliance terms: 1. Click **Storefront** in the app menu on the left and then click **Script Manager**. The Script Manager page appears. 2. Click **Create a Script**. \ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F7H39J2Iw71m16ZcdnQpn%2FCreate-a-script.png?alt=media\&token=02895434-5391-44b4-8b45-887a540e3add) 3. Enter `DigitalRiver Compliance Terms` in the **Name of script** and **Description** fields.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2FJI39x7mSzJ2ReGnt06fk%2FName-of-script.png?alt=media\&token=631793b3-8442-4a33-a40c-4a53dbdd6adc) 4. Select the **Footer** option for **Location on page**.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F7I6TfRg3k2lYBFLE458C%2FLocation-on-page.png?alt=media\&token=20f86be1-2303-445d-b097-1f537ec1f791) 5. Select the **Checkout** option for **Select pages where script will be added**. \ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FdYRKtAuTaHt1LjJ8gnX5%2FCheckout.png?alt=media\&token=f6102274-bb45-4e5f-804e-0b82a2634ad6) 6. Select the **Essential** option for the **Script category**.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FLHwxoQ296jhW5Iffz7oW%2FScript-category.png?alt=media\&token=83531184-b88f-4c18-8e05-8b73e8ad90ac)
7. Select the **Script** option for the **Script type**.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FXNEttakHftiKtYJWQ5bR%2FScript-type.png?alt=media\&token=85eaeeff-f9c0-4757-ba6a-850e07f1e5ed) 8. Copy the script your Digital River Project Manager provided and paste it into the **Script contents** field. 9. Change the key highlighted in yellow to your API public key in the script. \ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2FJtq8UzuYVLqSi4m1bjOV%2FScript-contents.png?alt=media\&token=00079394-471e-48c9-bd4c-7e8589c65386) 10. Click **Save**. # Step 7: Edit the required phone number field Learn how to set the phone number field to required. Users must provide their phone numbers during account signup to ensure seamless integration with Digital River. Making the phone number field mandatory allows you to avoid potential issues and ensure the drop-in feature operates correctly. Follow these steps to edit the required phone number field: {% hint style="info" %} Digital River requires the phone number field. If no phone number is available, Drop-in will not display as expected. {% endhint %} 1. Click **Settings** in the app menu on the left and then click **Account Signup Form**. 2. Click the **Address Fields** tab.\
3. Click **Edit** in the options menu.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2F3nvSOWjnJLCZ7mtHh7iI%2FAddress-Fields-More-options.png?alt=media\&token=c492c88e-a429-465f-91ae-c2d43b2150a1)
4. Select the **Yes this field is required** checkbox and click **Save**. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FQLqYQGyvXQpp6bv9YBm4%2FEdit-the-text-field.png?alt=media\&token=e652c91a-df77-43b0-aa08-8121e489aff0) # Step 8: Configure a product Learn how to configure a product for your store. To configure a product in BigCommerce for Digital River integration, follow the steps outlined in this guide. It includes setting up basic product information, identifiers, pricing details, custom fields, and customs information. Proper configuration ensures seamless product management and compliance with Digital River requirements. ## Adding a product You can configure the product as you normally would in BigCommerce with some exceptions. This task walks you through the product requirements for Digital River. To add a product: 1. Click **Products** in the menu on the left and then click **View**. The View Products page appears.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FLmxWEzUHOEDbAlWgIMEF%2FView-Products.png?alt=media\&token=c61ed4ce-2ed6-4ae4-b6c5-b6b090039b47) 2. Click **Add** to create a new product. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FUBnmVC0956NdhkKiEJzv%2FAdd.png?alt=media\&token=c3bab7a2-b77c-4456-8682-da0b85efa6d4) 3. Under **Basic Information**, enter the **Product Name**, **Default Price**, and **Weight** values. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FkKqCCSqhywbLlf33qw5W%2FBasic-Information.png?alt=media\&token=c4af15d5-c22e-479b-808a-8e10a24a542b) 4. Under **Product Identifiers**, enter the values for **SKU** and the **Manufacturer Part Number (MPN)**. If you are using Digital River's Managed Fulfillment, your fulfillment partner can provide the manufacturer's part number. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2Fr6JlzIdtj9rCKooQ6KWw%2FProduct-Identifiers.png?alt=media\&token=49d8cc1a-9ace-4134-9728-86ad3fb361a8) 5. Under **Pricing**, enter the product's default price (including tax), select **Default Tax Class** from the **Tax Class** drop-down, and provide a code in the **Tax Provider Tax Code** field. See [Tax code](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus#tax-code) in [Managing SKUs](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus) for more information. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2Fw8TYZsqWDPJ0E52uyV5i%2FPricing.png?alt=media\&token=bd33461a-89f5-483b-85ea-15ab0a36417a) 6. Under **Custom Fields**, click **Add Custom Fields**. 7. An ECCN field is required. To create an [Export Control Classification Number (ECCN)](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus#eccn) field, enter `ECCN` in the **Custom Field Name** field and enter an [ECCN value](https://www.bis.doc.gov/index.php/licensing/commerce-control-list-classification/export-control-classification-number-eccn) in the **Custom Field Value** field. **Note**: In BigCommerce, you must enter the number without the decimal points.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2Fg8Keq524OweUB3iY4S8S%2FCustom%20Fields.png?alt=media\&token=73b25d5a-3d9c-464e-9c82-662639597061) 8. A **skuGroupId** field is required if you are using the Digital River app for landed cost. To create a [**SKU Group ID**](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus#sku-group-identifier) field, enter `skuGroupID` the **Custom Name** field and the skuGroupId value in the **Custom Field Value** field. The `skuGroupId` uniquely identifies the [SKU group](https://www.digitalriver.com/docs/digital-river-api-reference/#tag/SKUs) associated with the SKU. See [Grouping SKUs](https://docs.digitalriver.com/digital-river-api/product-management/setting-up-sku-groups) for more information.

When updating the skuGroupId, you must also update or change the Basic Product details. When the webhook triggers, this ensures the product details are synchronized with Digital River.

9. In the left navigation, click **Customs Information** under **Fulfillment**. 10. Select the **Manage customs information** checkbox. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2Fv9U9yTUc7uZghs4mHrpQ%2FCustoms%20Information.png?alt=media\&token=2b360656-73ef-47ce-815b-11bb127e0323) 11. Select a country from the **Country of origin** drop-down. 12. Optional. Type a brief description of the product in the **Commodity description** field. 13. Click **Save**. ## Editing an existing product To edit an existing product: 1. Click **Products** in the menu on the left and then click **View**. The View Products page appears. 2. Choose one of the following options to edit a product: * Click the link under the **Product Name** column for the product you want to edit. * Click **More options** under the **Actions** column for the product you want to update and then click **Edit** to update a product. 3. Update the appropriate fields. 4. Click **Save**. # Step 9: Configure transactional emails Learn how to configure transactional emails in the BigCommerce App. Configuring transactional emails allows you to automate and customize customer communication regarding their orders. These emails include notifications for order creation, status updates, and order submissions. Following the steps outlined below, you can efficiently set up and tailor these emails to enhance customer experience and streamline your order management process. The following task shows you how to create transactional email for: * **Order Status Update**: Sent when the status of an order is changed. * **Order Email**: Sent when an order is created. * **Order Notification**: Sent when a shopper submits an order. To create transactional emails: 1. Click **Marketing** in the menu on the left and then click **Transactional Emails**. The Transactional emails page appears. \ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FUeaKvZ0f7du5lSz86oDj%2FTransactional-emails.png?alt=media\&token=496f8bac-9698-4ca8-a969-f9b54a618de0) 2. Choose one of the following transactional email options: * To create an order status update email, click **Order Status Update**. The Order Status Update page appears. * To create an order email, click **Order Email**. The Order Email page appears. * To create an order notification email, click **Order Notification**. The Order Notification page appears. 3. Select **Global (storefront defaults)** from the dropdown.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FsQdq2ofnT3cRHAuJat3Z%2FGlobal-storefront-defaults.png?alt=media\&token=9ffe1a91-25fa-480e-b67c-3ee23f25ea86) 4. Under the **Phrases** tab, add the text by locale or entity provided by your Digital River Project Manager. To add a new phrase, click **Add new** and enter a phrase name and value. 5. To apply style changes to the email, click **Code** and update the **Subject** or **Content** fields. 6. To see how the email will look when sent to a customer, click **Preview**. 7. To send a test email, click **Send a test email** and check your inbox. You will receive an email as follows: * Order Status Update:\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FBTsXNGtejfcdLKOgtU8F%2FOrder-Status-Update-email.png?alt=media\&token=7b1c2e14-32d2-4250-a296-9014deb6f377) * Order Email:\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FivEGPAiCCM79aRssQcvf%2FOrder-email.png?alt=media\&token=e8fcc9b2-ac3a-4b38-a48a-6d141f69611b) * Order Notification:\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FApA34bravGJtD7PSQOa0%2FOrder-Notification-email.png?alt=media\&token=6ec0e211-3af7-4e1d-97f8-01e311802c72)
8. Click **Save**. 9. Repeat steps 2 through 8 for each additional transactional email option. # Step 10: Complete certification Learn how to complete certification for the BigCommerce App. Work with your Digital River Project Manager to complete [certification](https://docs.digitalriver.com/digital-river-api/general-resources/standards-and-certifications). # Step 11: Start accepting payment Learn how to start accepting payments in the Big Commerce App. Once certification is complete, you can begin accepting payment through Digital River. # Shopper experience Understand the shopper experience. The shopper experience using Digital River's Drop-In on BigCommerce is designed to be seamless and user-friendly. When a shopper proceeds to checkout, they will encounter a straightforward payment interface that integrates seamlessly with the BigCommerce store, ensuring a smooth and efficient purchasing process. This guide will walk you through the steps a shopper experiences when using [Drop-In payments](https://docs.digitalriver.com/digital-river-api/payments/payment-integrations-1/drop-in) during checkout.
# Payment methods Learn more about the payment methods supported by BigCommerce using Drop-in payments. # Cards Learn about supported Credit Cards for BigCommerce. Credit cards offer a convenient and secure method for consumers to purchase goods or services on credit. This payment method supports renowned card brands and is globally available, ensuring a fast and seamless shopping experience across different regions. The table below provides comprehensive details about the Credit Card payment method, including supported card brands, types, popular countries, and currencies. Additionally, it outlines the shopper experience and specific features such as voiding and manual capture options.
DetailsDescription
Payment method

The Credit Cards payment method is a fast and secure shopping experience where the consumer can purchase goods or services on credit.

Supported card brands:

  • American Express
  • Diners Club
  • Discover
  • JCB
  • Maestro
  • MasterCard
  • Visa
TypeCredit/debit
Popular countriesGlobally available
Supported currencies

See supported currencies for:

Shopper experienceThe cards appear within the Drop-in component under the Payment section of the Checkout page. You must configure the currency and billing country settings on BigCommerce storefront and also enable the payment methods from the Digital River Dashboard for Drop-in to work.
Void✔ Support for physical orders only. Digital orders cannot be voided because they will be fulfilled immediately. Therefore, only a refund can be requested.
Manual Capture✘
# Google Pay Learn about supported Google Pay for BigCommerce. Google Pay is a versatile digital wallet designed to streamline payment processes. It allows merchants to request any credit or debit card stored in their customers' Google accounts. This feature enhances the shopper experience and provides merchants with a secure, efficient method to handle transactions globally. Integrating Google Pay into BigCommerce stores supported by Digital River ensures merchants can leverage a trusted payment solution to boost their eCommerce capabilities. The following table provides detailed information about the Google Pay payment method, including merchant requirements, supported regions and currencies, shopper experience, and additional transaction capabilities. It will help merchants integrate and optimize Google Pay within their Digital River-supported BigCommerce stores. | Details | Subscription | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Type | The Google Pay payment method is a digital wallet that allows a merchant to request any credit or debit card stored in their customer’s Google account. For more information, see [Google Pay](https://docs.digitalriver.com/digital-river-api/payments/payment-integrations-1/digitalriver.js/payment-methods/google-pay). | | Merchant requirements |

Google Pay must be enabled within your:

| | Supported countries | Globally available in [69 countries/territories](https://www.digitalriver.com/payment-method/google-pay/). | | Supported currencies | AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, JPY, NOK, NZD, PLN, SEK, SGD, USD | | Shopper experience | | | Merchant experience | After the shopper checks out using Google Pay, the order details page in BigCommece displays the payment method as “Google Pay (via Digital River)”. | | Authorize-Only | ✔ | | Void | ✔ | | Auto-capture upon fulfillment | ✔ When the Order Status moves to "Shipped," Digital River listens to the BigCommerce webhook and attempts to capture the payment within Digital River Then, Digital River sends BigCommerce a capture notification. When BigCommerce receives the capture notification, BigCommerce updates the payment status on the order. | | Manual Capture | ✘ | | Authorize & Capture | ✘ Digital River requires that the capture happen after the order is shipped. | | Full Refund | ✔ Digital River requires that the capture happen after the order is shipped. | | Partial Refund | ✔ | | Embedded checkout support? | ✔ | | Multi-currency | ✔ | | Webhooks handled | ✔ See [Webhooks ](/bigcommerce/1.0-4/webhooks)for a list of supported webhooks | # Webhooks Learn what webhooks are enabled with Digital River configuration. Webhooks are vital to integrating Digital River with your BigCommerce store. They automatically notify your system about certain events, enabling seamless updates and data synchronization. Once you complete your registration with Digital River and configure the Digital River app, several webhooks are automatically enabled to ensure your store stays updated with real-time information about orders and payment statuses. Below is a list of these essential webhooks and their respective descriptions. {% hint style="info" %} Each time you click **Save** on the [Payment Methods page](/bigcommerce/1.0-4/configure-the-bigcommerce-settings/step-2-configure-payments) in BigCommerce, BigCommerce automatically [creates a new webhook endpoint](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/webhooks/creating-a-webhook) within your Digital River account. You are responsible for [deleting duplicate or old webhook endpoints](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/webhooks/deleting-a-webhook) within Digital River to avoid sending duplicate event data to BigCommerce. {% endhint %} | Webhook | Description | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `order.accepted` | When BigCommerce receives this webhook from Digital River, the payment status on the order in BigCommerce moves to authorized, and the order status moves to awaiting payment. | | `order.blocked` | When BigCommerce receives this webhook, BigCommerce will move the payment status to declined, orders status to declined, and fraud status to rejected. | | `order.charge.cancel.complete` | When BigCommerce receives this webhook, BigCommerce will move payment status to void, and order status to cancelled. | | `order.charge.capture.complete` | When BigCommerce receives this webhook, BigCommerce moves the payment status to captured. Note that BigCommerce will not update the order status. The orders status retains the status selected by the merchant. | | `order.charge.capture.failed` | BigCommerce surfaces a message to the merchant in the order timeline and order in the store log. No change to payment status or order status. | | `order.charge.cancelled` | BigCommerce updates payment status to void, and order status to cancelled. | | `order.charge.refund.complete` | Informational only. Indicates the refund on the order is complete. | | `order.charge.refund.failed` | Informational only. Indicates the refund on the order failed. BigCommerce will set the payment and order status when the client performs the refund action on the UI or API | | `order.chargeback` | BigCommerce will not change any payment status or order status. It will just display a message in the order tmeline. | | `order.complete` | Informational only. Indicates the order is complete. | # Status mappings Learn how notifications trigger status updates. Status mappings provide a comprehensive view of how orders transition through various stages from inception to completion. Understanding these mappings is crucial for interpreting the status updates received from Digital River and their corresponding statuses in BigCommerce. This section details the specific status changes for different types of orders, ensuring clarity and accuracy in tracking an order’s lifecycle. ## Order with a physical product only An order that contains only a physical product typically follows a standard workflow involving multiple statuses for payment and fulfillment. The table below illustrates the different statuses an order can have from the initial notification received from Digital River through to the completed order status in BigCommerce and Digital River systems.
Notification received from Digital RiverBigCommerce payment statusBigCommerce order statusDigital River order status
nonePendingPendingpending_payment
nonePendingAwaiting Paymentpending_payment
order.acceptedAuthorizedAwaiting Paymentaccepted
noneAuthorizedShippedfulfilled
order.charge.capture.completePendingShippedcomplete
## Order with a digital product only An order containing only a digital product involves a more streamlined workflow compared to physical products, primarily focusing on payment authorization and fulfillment. The table below outlines the various statuses such an order can transition through, from the initial notification received from Digital River to the final completed order status in both BigCommerce and Digital River systems. | Notification received from Digital River | BigCommerce payment status | BigCommerce order status | Digital River order status | | ---------------------------------------- | -------------------------- | ------------------------ | -------------------------- | | none | Pending | Pending | pending\_payment | | none | Pending | Awaiting Payment | pending\_payment | | order.accepted | Authorized | Awaiting Payment | accepted | | order.charge.capture.complete | Captured | Awaiting Fulfillment | fulfilled | | none | Captured | Completed | complete | ## Order with mixed products Orders containing physical and digital products present a more complex workflow than orders with only physical or digital items. The table below describes the various statuses such an order can transition through, detailing how notifications from Digital River synchronize with BigCommerce's payment and order status systems. This ensures that both physical shipments and digital deliveries are accurately tracked and fulfilled. | Notification received from Digital River | BigCommerce payment status | BigCommerce order status | Digital River order status | | ---------------------------------------- | -------------------------- | ------------------------ | -------------------------- | | none | Pending | Pending | pending\_payment | | none | Pending | Awaiting Payment | pending\_payment | | order.accepted | Authorized | Awaiting Payment | accepted | | none | Authorized | Shipped | accepted | | order.charge.capture.complete | Captured | Shipped | fulfilled | | none | Captured | Completed | complete | # Fraud prevention Learn how Digital River prevents fraud. Digital River’s in-house fraud engine is Transaction Defender. Based on its evaluation, Digital River accepts or declines a transaction. No manual setup is required. See [Ecommerce Fraud Protection](https://www.digitalriver.com/global-seller-services/fraud/) for details. {% hint style="info" %} If the **Order Status** in BigCommerce is set to **Manual Verification Required**, the merchant does not need to take action; Digital River manually reviews the transaction. {% endhint %} # 3D-Secure Learn what security measures protect the BigCommerce app. The European Union's Strong Customer Authentication (SCA) requirements became effective on September 14, 2019. These new requirements, part of the [second Payment Services Directive](https://ec.europa.eu/info/law/payment-services-psd-2-directive-eu-2015-2366_en) (PSD2) regulations, mandate that you conduct two-factor authentication on certain online transactions. This integration supports 3D-Secure 2.0. Digital River account enables 3D-Secure by default and cannot be disabled. Digital River's Drop-in component brokers the 3D-Secure challenge the shopper experiences at checkout. See [PSD2 and SCA](https://docs.digitalriver.com/digital-river-api/payments/psd2-and-sca) for more information. # Multicurrency Learn how Digital River supports multiple currencies on BigCommerce. You can configure Digital River on BigCommerce for use with multiple currencies simultaneously. A single Digital River merchant account accepts all Digital River–supported transaction currencies. The merchant must have the desired currencies enabled within their Digital River account. For general information, visit [Multicurrency](https://support.bigcommerce.com/s/article/Managing-Currencies?language=en_US#mc).\ For more information, visit [Digital River’s Country Guide](https://www.digitalriver.com/country-guide/). # Look and feel Learn how to customize Drop-in. Using the [Cornerstone theme](https://support.bigcommerce.com/s/article/Cornerstone-Theme-Manual?language=en_US), you can style the look and feel of the elements within the [Drop-in](https://docs.digitalriver.com/digital-river-api/payments/payment-integrations-1/drop-in) component using [Page Builder](https://support.bigcommerce.com/s/article/Page-Builder?language=en_US). You can change the following body text and link attributes: * Body text font family * Link font family * Link color * Link hover color Form Checklist * Form Background * Form header text color * Form border color ## Styling the Pay button To style the Pay button within the Digital River drop-in component: 1. Click **Store Setup** in the app menu on the left and then click **Themes**. 2. Under **Current Theme**, click **Advanced**, and select **Make a Copy** from the drop-down list.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FoFqZoENsg5YssfGo8lAX%2FThemes.png?alt=media\&token=be2f1959-d084-4ecd-8ba9-3504aa296f9d) 3. Enter a name for the theme in the **Theme Name** field and click **Save a Copy**. \ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FLuqa7miXCmKVbsaSvykH%2FMake-a-Copy.png?alt=media\&token=2c50f72e-da9f-4adf-a3a4-43f767bdbbd3)
4. Under **Themes**, click more options on your created theme and select **Edit Theme Files**.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FJRNxBjP9xRbXmkdjgWxI%2FMore-options-Themes.png?alt=media\&token=14d4a672-5906-4610-ab11-c9b9d5bbd3e5) 5. Click the **Do not show me again** checkbox and click **Edit theme files**. ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FmN4cNDPnqHHgvnWo6h9Q%2FEdit-your-theme-files.png?alt=media\&token=421469ec-7da8-4bf7-a64e-40f22a878f6d) 6. From your browser's **Stencil File Editor** tab, click **assets**, click **scss**, and then click **optimized-checkout.scss**.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FfUmZrVjqA0irkizHTGdI%2Foptimized-checkout-css.png?alt=media\&token=ab32937b-0eb5-4c28-af3c-257c84b59a4a) 7. Copy the following text and paste it at the bottom of the optimized-checkout.scss file.\ \ `.DR-pay-button{`\ `background-color: BLACK !important;`\ `}`\ `.DR-button-text{`\ `color: RED !important;`\ `}`\ **Important**: You must add the `!important` rule to the CSS line. 8. Click **Save File**. The results will look like this:
# Test the app Learn how to test the BigCommerce app. After you complete all the steps and start the server, the BigCommerce app should seamlessly call Digital River APIs on the checkout pages. The following steps show the stages where you can test the installed BigCommerce app. 1. When you successfully install the BigCommerce App, **Digital River** will appear in the left navigation under **Apps**. \ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FtKhUWEXST7NaKLQ7Z6pN%2FDigital-River-App.png?alt=media\&token=28dbcd0b-a530-417f-8d30-972829f355f1) 2. When you [successfully register the keys](/bigcommerce/1.0-4/install-the-digital-river-app#registering-your-api-keys), you will see the "Successfully Registered" message. \
3. When you successfully [configure the API keys for the currency selection](/bigcommerce/1.0-4/configure-the-bigcommerce-settings/step-2-configure-payments): 1. On refresh, Big Commerce will show the updated settings under **Notifications** on the Digital **River Settings** tab.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FgyPSATUqeylpnLctiBIE%2FNotifications.png?alt=media\&token=4a55c97d-3a5e-4be9-9628-fc305edb207f) 2. The [Webhooks ](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/webhooks)page on the [Digital River Dashboard ](https://dashboard.digitalriver.com/)will confirm the endpoint (notification URL), username, and password.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FOvgzUkkqQ4yMCH1H02zn%2FWebhooks.png?alt=media\&token=f2dd9082-cfb5-4676-ba31-3eba7732c665) 3. BigCommerce will run a [create SKU request](https://www.digitalriver.com/docs/digital-river-api-reference/#operation/createSkus) to confirm the provided API keys are valid. You can verify the creation of this SKU from the SKUs page on the [Dashboard](https://dashboard.digitalriver.com/), where the **SKU ID** is **9898989899**, and the **Name** is **Test Product**.\ ![](https://385943888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYQsO02eKz9DuHs39Wm-694727794%2Fuploads%2FXpptHPWw3pH6DN30wZx2%2FSKUs.png?alt=media\&token=e6b1b38f-bc6c-4f45-9027-12bed196deef) # Common questions Find answers to common questions. ## Pricing and Fees ### What fees are associated with the gateway? [Contact the Digital River Sales team](https://www.digitalriver.com/request-demo/) for information. ## Account Eligibility ### What currencies and countries does the payment gateway support? The store must be based in one of the following countries: CA, GL, PM, TC, US, AD, AT, BE, DK, FO, FI, FR, DE, GB, GR, IE, IS, IT, LI, LU, MC, NL, NO, PT, SM, ES, SJ, SE, CH, VA, AL, BY, BG, HR, CZ, EE, HU, KZ, LV, LT, MK, PL, RO, RU, RS, SK, SI, TM, TR, UA, UZ, AF, AZ, DZ, BH, BA, CY, ET, EG, IL, IQ, JO, KE, KW, LB, LS, LY, MR, MT, MA, NG, OM, PK, QA, RE, SA, SL, ZA, TA, TN, AE, YE, AR, BO, BR, CO, CL, CR, DO, EC, GF, GT, HN, MX, NI, PA, PY, PE, PR, SV, TT, UY, VE, AU, AS, BV, IO, NZ, JP, CN, CX, CC, CK, GU, HM, HK, KI, MO, MH, FM, NU, NF, MP, NP, PN, GS, LK, IN, BD, KR, TW, TK, TV, UM, SG, BN, ID, TL, PH, MY, MY, KH, LA, MM, TH, VN The selected payment method determines the supported currencies. ### What items are restricted for merchants to sell? For a list of allowed goods, see [Tax codes](https://docs.digitalriver.com/digital-river-api/product-management/creating-and-updating-skus#tax-code). ## Transactions ### After I create an account, what is the waiting period before I can process transactions? Assuming the following statements are true, you can start accepting payment on your store through Digital River immediately: * You are on a BigCommerce paid plan. * The [Digital River Payments, Fraud, Tax & Compliance Management app is installed](/bigcommerce/1.0-4/install-the-digital-river-app) on your store. * You [created a Digital River account](https://docs.digitalriver.com/digital-river-api/administration/dashboard/quick-start-guide#step-1-creating-a-free-test-account). * Digital River has [passed your certification](https://docs.digitalriver.com/digital-river-api/developer-resources/standards-and-certifications). You will work with a Digital River Project Manager to set a timeline for the launch, including scheduling Checkout Certification. ### How long until the funds are transferred to my bank? You can find the fund transfer details in your Digital River contract. Contact Digital River for more information. ### Will I or my customers receive an additional email or invoice from the payment gateway? BigCommerce sends the [invoice email](https://support.bigcommerce.com/s/article/Invoices?language=en_US#default). Digital River does not send the invoice email. ## Orders ### How do I troubleshoot an order? See [Troubleshooting Orders](https://support.bigcommerce.com/s/article/Troubleshooting-Orders?language=en_US). ## Refunds ### How soon after a transaction can I perform a refund? See [Issuing Refunds](https://docs.digitalriver.com/digital-river-api/order-management/returns-and-refunds-1/refunds/issuing-refunds). ### Is there any time after which I cannot perform a refund? See [Issuing Refunds](https://docs.digitalriver.com/digital-river-api/order-management/returns-and-refunds-1/refunds/issuing-refunds). ### What are the limitations around refunds? Once you [apply an order level-refund](https://support.bigcommerce.com/s/article/Processing-Refunds?language=en_US#refund-order), you may then only refund the remaining order amount afterward. If you **Refund individual items** at this point, you will receive an error. If you want to issue a refund for fees, or importer of record (IOR) tax and duties for cross-border orders, you must initiate this refund from within Digital River. ### Does the integration support [multiple shipments](https://support.bigcommerce.com/s/article/Shipments) to the same location? Yes. ### Does the integration support [multiple shipments](https://support.bigcommerce.com/s/article/Shipments) to different locations? No. Digital River only supports multiple shipments when shipping all items on the order to the same location. Digital River only supports one tax calculation per order. As a result, Digital River does not support shipping multiple items from a single order to different locations. That’s because each location applies taxes differently. ### Does the Digital River payment integration automatically check if I have the correct app installed? Once you download the Digital River app from the marketplace, Big Commerce will display all the relevant storefront settings. If you do not configure the app settings and ONLY configure the payment settings, no additional validation will flag the store admin that something was not set up for the app to work. ## Additional Features ### Are there any fraud filtering options available? No. Fraud filtering is done automatically by Digital River. See [Fraud prevention and security](/bigcommerce/1.0-4/3d-secure). ### Does it allow authorize-only or recurring/subscription payments? Authorize-only is supported. Subscriptions are not supported. ## Troubleshooting and payment disputes ### Why did my client receive an error when trying to pay? See Digital River’s [Error handling](https://docs.digitalriver.com/digital-river-api/getting-started-1/standards-and-certifications/integration-checklists/error-handling). ### How are payment disputes handled? Digital River will handle chargebacks. The merchant will need to handle other payment disputes (e.g., damaged product on delivery). During the implementation process with your Digital River project manager, you will be set up with access to the Solutions Center and introduced to your Digital River direct contacts. ### How do I contact the payment gateway’s support? To find contact information, click [Support](/bigcommerce/1.0-4/support). ### Can I use my VAT ID to get a tax exemption? No. The integration does not support VAT ID. # Support Have a problem? We can help! If you encounter errors, issues, or defects in implementing the Digital River app for BigCommerce, contact the system integrator or partner who installed it. If you have a defect with the app's functionality, go to to send an email, start a chat, or call 888-699-8911 opt 1. Include the following information: * System Integrator or Partner's contact information * A description of the issue (with a transaction ID if it is available) * Detailed reproduction steps For all other questions or inquiries, contact your Digital River representative.