Skip to main content

Documentation

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.

Rapyd Account Connection Limit

You can only connect one store per Rapyd Account.

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

Andorra, Armenia, Austria, Australia, Belgium, Bosnia and Herzegovina, Brazil, Bulgaria, Canada, 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)

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

How to Activate Ecwid
  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
  1. In the Ecwid control panel, go to Payment.

    648090badde23.png
  2. Scroll down to the Payment Alternatives section, and select Rapyd Payments from the Choose Payment Processor dropdown menu.

    648090bccb713.png
  3. Click on the Add Payment Method button that appears on the pop-up window.

    648090be4345b.png

    Note

    Apple Pay

    European customers with an Apple account may use Apple Pay for purchases when using Safari. See supported countries here.

    The Rapyd Payments account details page appears.

    648090bfd4812.png

Note

The Client Portal must be in sandbox mode during this testing phase. See 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

  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
  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

    Note

    This billing address setting should also be enabled during production mode.

  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
  3. Enter your email address and click the Checkout button.

    648090c99e2b9.png
  4. Select the Rapyd Payments method, enter a billing address, and click on the Go to Payment button.

    648090cb2e1a9.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
  7. Click the Finish button on the Payment Successful screen that appears.

    648090ce7e4c7.png

    A confirmation message appears.

    648090d006b4b.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

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

Note

The Client Portal must be in production mode. See 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

    The Rapyd Payments account details page appears:

    648090c1bd441.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.

  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
  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.

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
  2. Click on the link icon and enter the URL of the landing page in the Fallback URL field.

    648090aa75383.png
  3. Click Save.

Note

For more information on customizing your checkout page, see Hosted Checkout Page Integration.