The Rapyd Works With Developer Hub

Welcome to the Rapyd Works With developer hub. You'll find comprehensive guides and documentation to help you start working with Rapyd Works With as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

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.

See List of Supported Countries (You must be domiciled here in order to accept payments)

Andorra, Armenia, Argentina, Australia, Bosnia and Herzegovina, Bulgaria, Bolivia (Plurinational State of), Brazil, Belarus, Chile, China, Colombia, Costa Rica, Cyprus, Czech Republic, Denmark, Dominican Republic, Ecuador, Estonia, Faroe Islands, France, Georgia, Gibraltar, Greece, Guatemala, Croatia, Hungary, Indonesia, Isle of Man, India, Iceland, Korea (Republic of), Kuwait, Liechtenstein, Luxembourg, Latvia, Monaco, Moldova (Republic of), Montenegro, Macedonia (the former Yugoslav Republic of), Malta, Mexico, Malaysia, Norway, New Zealand, Panama, Peru, Philippines, Poland, Paraguay, Romania, Serbia, Russia, Saudi Arabia, Sweden, Singapore, Slovenia, Slovakia, San Marino, El Salvador, Thailand, Turkey, Ukraine, Uruguay, United States, Holy See, Vietnam, Republic of Kosovo, South Africa

Step 1: Get Started with Rapyd Payments

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.

Step 2: Activate the App from the Rapyd Client Portal

A. Sign in to Client Portal and navigate to Plugins.

B. In the Ecwid window, click the Active toggle button.

Step 3: Add the App from the Ecwid Control Panel

A. In the Ecwid control panel, go to Payment.

B. Scroll down to the Payment Alternatives section, and select Rapyd Payments from the Choose Payment Processor dropdown menu.

C. Click on the Add Payment Method button that appears on the pop-up window.

The Rapyd Payments account details page appears.

Step 4: Configure the Sandbox Mode

📘

Note

The Client Portal must be in sandbox mode during this testing phase. See Select Environment.

A. In the Rapyd Payments account details page, click the Enable test mode toggle button.
B. 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.
C. 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.
D. Click on the Enable this payment method at checkout toggle button.

E. Click the Save button.
F. Go to the Cart & Checkout tab in Settings > General, and enable the Ask for a billing address during checkout setting.

📘

Note

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

Step 5: Testing the App

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

C. Enter your email address and click the Checkout button.

D. Select the Rapyd Payments method, enter a billing address, and click on the Go to Payment button.

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

F. Click on the Place Your Order button.

G. Click the Finish button on the Payment Successful screen that appears.

A confirmation message appears.

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

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

Step 6: Configure the Production Mode

📘

Note

The Client Portal must be in production mode. See Select Environment.

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

The Rapyd Payments account details page appears:

C. Click the Enable test mode toggle button to disable it.
D. 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.
E. 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.

F. Click the Save button.
G. 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 7: 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:
A. Sign in to the Client Portal and navigate to Settings > Branding.

B. Click on the link icon and enter the URL of the landing page in the Fallback URL field.

C. Click Save.

📘

Note

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

Updated about a month ago

Rapyd Payments App for Ecwid


Start accepting payments from your Ecwid store.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.