---
title: "Rapyd Payments App for Ecwid"
source_url: https://docs.rapyd.net/en/rapyd-payments-app-for-ecwid.html
lang: en
---

# Rapyd Payments App for Ecwid

Start accepting payments from your Ecwid store.

With Rapyd, you can quickly accept more payment methods from more countries. Payment methods like ewallets, bank transfers, cards and cash.

Rapyd offers this Ecwid add-on in over 50 countries.

> **Note:**
>
> You can only connect one store per Rapyd Account.

You must be domiciled in one of the following countries in order to accept payments.

## Supported Countries

Andorra, Armenia, Austria, Australia, Belgium, Bosnia and Herzegovina, Brazil, Bulgaria, Chile, Colombia, Croatia, Cyprus, Czech Republic, Denmark, Dominican Republic, El Salvador, Estonia, Finland, France, Georgia, Germany, Gibraltar, Greece, Greenland, Hong Kong, Hungary, Iceland, India, Indonesia, Ireland, Israel, Italy, Japan, Latvia, Liechtenstein, Lithuania, Luxembourg, Macedonia, Malaysia, Malta, Mexico, Moldova, Monaco, Montenegro, Netherlands, New Zealand, Norway, Peru, Philippines, Poland, Portugal, Romania, San Marino, Singapore, Slovakia, Slovenia, South Africa, South Korea, Spain, Sweden, Switzerland, Taiwan, Thailand, Turkey, UK, USA, Vatican, Vietnam, Virgin Islands (USA)

## Prerequisites

Rapyd Client Portal account

With a Rapyd Client Portal account, you can:

- Activate and set up your plugin.
- Access sandbox mode and test payments.
- View supported payment methods.
- View payment reports.
- Invite team members.
- Complete KYB steps to fully activate your account.

[Sign up](https://support.rapyd.net)

## How to Activate Ecwid

### Step 1: Activate the App from the Rapyd Client Portal

1. Sign in to Client Portal and navigate to **Plugins**. Click **Ecwid**.
2. On the **Ecwid** page, click the **Active** toggle button.

   > **Note:**
   >
   > You can search supported countries in the search bar.

   ![648090ae0f1a2.gif](image/img-78fd6fb954d2a8afb2f009f05b92b377.gif)

### Step 2: Add the App from the Ecwid Control Panel

1. In the Ecwid control panel, go to **Payment**.

   ![648090badde23.png](image/img-65d6e5fb7ae7859166a52d40002506c4.png)
2. Scroll down to the **Payment Alternatives** section, and select **Rapyd Payments** from the **Choose Payment Processor** dropdown menu.

   ![648090bccb713.png](image/img-db37b962e80eda9e3ec72fdb846874d3.png)
3. Click on the **Add Payment Method** button that appears on the pop-up window.

   ![648090be4345b.png](image/img-02fe4ef899b5704a7fa985740bbc4c94.png)

   > **Note:**
   >
   > **Apple Pay**
   >
   > European customers with an Apple account may use Apple Pay for purchases when using Safari. [See supported countries here](https://support.apple.com/en-us/HT207957).

   The **Rapyd Payments** account details page appears.

   ![648090bfd4812.png](image/img-c5580ff55ea615caa9a5e5c6c1e2eeae.png)

### Step 3: Configure the Sandbox Mode

> **Note:**
>
> The Client Portal must be in sandbox mode during this testing phase. See [Developers](https://docs.rapyd.net/en/developers.md "Developers").

1. In the **Rapyd Payments** account details page, click the **Enable test mode** toggle button.
2. Enter your Rapyd **Access Key** and **Secret Key** for the sandbox environment in the **Test Access key** and **Test Secret key** fields. Note that you should use the unique production keys for the Ecwid plugin. See also [Viewing Plugin Keys](https://docs.rapyd.net/en/plugins-and-add-ons.md "Plugins and Add-Ons")
3. In the **Appearance options** section, enter a name for the payment method as it will appear in your site’s checkout screen. It is recommended that you provide a name that indicates a test mode.
4. Click on the **Enable this payment method at checkout** toggle button.

   ![648090c1bd441.png](image/img-659400d702c460351ec8b780c8c1bd30.png)
5. Click the **Save** button.
6. Go to the **Cart & Checkout** tab in **Settings > General**, and enable the **Ask for a billing address during checkout** setting.

   ![648090c3d6aee.png](image/img-4ef5fc94de292a6432641b6e849bdd05.png)

   > **Note:**
   >
   > This billing address setting should also be enabled during production mode.

### Step 4: Testing the App

1. Go to your Ecwid ecommerce site as a customer and add an item to the cart.
2. Click on the **Go to Checkout** button.

   ![648090c5dee66.png](image/img-6ad275c3e0cb3c2a810a074de43a4e98.png)
3. Enter your email address and click the **Checkout** button.

   ![648090c99e2b9.png](image/img-f51741add6a1bcc1a866e46e7415ce5b.png)
4. Select the **Rapyd Payments** method, enter a billing address, and click on the **Go to Payment** button.

   ![648090cb2e1a9.png](image/img-c4f983853012e03fb887e2fb409bd791.png)
5. For testing purposes, select any type of payment and fill in the additional fields. For example, enter the following test values for a Mastercard card payment:

   - Card: Mastercard
   - Card number: 4111 1111 1111 1111
   - Expiration Date: 12/23
   - CVV Code: 123
   - Cardholder Name: John Doe
6. Click on the **Place Your Order** button.

   ![648090ccad376.png](image/img-8f0ba386b8de1d71622b2b355848eeef.png)
7. Click the **Finish** button on the **Payment Successful** screen that appears.

   ![648090ce7e4c7.png](image/img-fcbf560d01f061ee5f75e06ab276c2c9.png)

   A confirmation message appears.

   ![648090d006b4b.png](image/img-b09f94e14ea64703f5f3b51618cbe870.png)
8. Go to the **My Sales > Orders** section of the Ecwid Admin panel and verify that the payment you have made is displayed with the correct status.

   ![648090d1635d3.png](image/img-a6c4a21b5d3d2ac43c76e2fb3d898a95.png)

   After you have finished testing the app, you can switch to production mode.

### Step 5: Configure the Production Mode

> **Note:**
>
> The Client Portal must be in production mode. See [Home Page](https://docs.rapyd.net/en/home-page.md "Home Page").

1. In the Ecwid control panel, go to **Payment**.
2. Click on the **Actions** button of the **Rapyd Payments** window and select **Edit**.

   ![648090d2d64a9.png](image/img-72b4b204943b5826b9134cfd2a6da7a0.png)

   The **Rapyd Payments** account details page appears:

   ![648090c1bd441.png](image/img-659400d702c460351ec8b780c8c1bd30.png)
3. Click the **Enable test mode** toggle button to disable it.
4. Enter your Rapyd **Access Key** and **Secret Key** for the production environment in the **Access key** and **Secret key** fields. Note that you should use the unique production keys for the Ecwid plugin. See also [Viewing Plugin Keys](https://docs.rapyd.net/en/plugins-and-add-ons.md "Plugins and Add-Ons").
5. In the **Appearance options** section, enter a name for the payment method as it will appear in your site’s checkout screen. It is recommended that you provide a name that indicates a payment method that your customers can use.

   ![648090d684ea8.png](image/img-c2cf9f5fae7566ad22a523cae5887a38.png)
6. Click the **Save** button.
7. To fully activate your account for production mode, you’ll need to complete the KYB form for compliance review in the Rapyd Client Portal.

### Step 6: Set Up a Landing Page URL

After the checkout process completes, the customer can be forwarded to a landing page. This may be the main URL of the ecommerce site or any other landing page that you may want to define. To set the landing page URL:

1. Sign in to the Client Portal and navigate to **Settings > Branding**.

   ![648090a7f0443.png](image/img-68d32513dd5863ec96d84365ab6b57dc.png)
2. Click on the link icon and enter the URL of the landing page in the **Fallback URL** field.

   ![648090aa75383.png](image/img-6e81561de11a73dbadab73d9b88e6c3d.png)
3. Click **Save**.

> **Note:**
>
> For more information on customizing your checkout page, see [Hosted Checkout Page Integration](https://docs.rapyd.net/en/hosted-checkout-page-integration.md "Hosted Checkout Page Integration").