Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
V-3239 Added Adyen integration instructions (#13140)
karolina-bronowicka461f7d2a5755
diff --git a/docs/images/integrations/adyen/1.get_started.png b/docs/images/integrations/adyen/1.get_started.pngnew file mode 100644index 0000000000..0509d773fcBinary files /dev/null and b/docs/images/integrations/adyen/1.get_started.png differdiff --git a/docs/images/integrations/adyen/2.setup_form.png b/docs/images/integrations/adyen/2.setup_form.pngnew file mode 100644index 0000000000..4b7492cf8bBinary files /dev/null and b/docs/images/integrations/adyen/2.setup_form.png differdiff --git a/docs/images/integrations/adyen/3.adyen_enabled.png b/docs/images/integrations/adyen/3.adyen_enabled.pngnew file mode 100644index 0000000000..84c54e6095Binary files /dev/null and b/docs/images/integrations/adyen/3.adyen_enabled.png differdiff --git a/docs/images/integrations/adyen/4.additional_settings.png b/docs/images/integrations/adyen/4.additional_settings.pngnew file mode 100644index 0000000000..e0f6c2d275Binary files /dev/null and b/docs/images/integrations/adyen/4.additional_settings.png differdiff --git a/docs/images/integrations/logos/adyen.png b/docs/images/integrations/logos/adyen.pngnew file mode 100644index 0000000000..7245c86f93Binary files /dev/null and b/docs/images/integrations/logos/adyen.png differdiff --git a/docs/integrations/integrations.mdx b/docs/integrations/integrations.mdxindex 3fbccd039a..621cb6eec6 100644--- a/docs/integrations/integrations.mdx+++ b/docs/integrations/integrations.mdx@@ -10,6 +10,9 @@ description: "Learn how to connect your Spree Commerce store to third-party serv<Card title="Stripe" href="/integrations/payments/stripe" img="/images/integrations/logos/stripe.png">Stripe is a popular payment gateway that allows you to accept payments from your customers. Credit cards, wallets, buy-now-pay-later, installment payments and more.</Card>+ <Card title="Adyen" href="/integrations/payments/adyen" img="/images/integrations/logos/adyen.png">+ Adyen is a global payment platform that enables businesses to accept payments across multiple channels and markets. Credit cards, digital wallets, BNPL, local payment methods, and more across 150+ currencies.+ </Card><Card title="PayPal" href="/integrations/payments/paypal" img="/images/integrations/logos/paypal.png">PayPal is an online payment system that allows you to send and receive money around the world. You can link your credit card, debit card, or bank account. You can also set up a PayPal Balance account.</Card>diff --git a/docs/integrations/payments/adyen.mdx b/docs/integrations/payments/adyen.mdxnew file mode 100644index 0000000000..901cf8e192--- /dev/null+++ b/docs/integrations/payments/adyen.mdx@@ -0,0 +1,92 @@+---+title: "Connect Adyen payments to Spree Commerce"+sidebarTitle: Adyen+description: "Learn how to set up and manage Spree's native Adyen integration."+---++Adyen is a global payment platform that enables businesses to accept payments across multiple channels and markets. It supports a wide range of payment methods, provides advanced fraud protection, and offers seamless checkout experiences for customers worldwide.++<Warning>+ Adyen integration is currently in **private beta**. [Please contact us](https://spreecommerce.org/contact) to get access to the Adyen integration for your Spree store.+</Warning>++## Installation++Before you can enable Adyen, it must be installed. To do so, you need to run the following command:++```bash+bundle add spree_adyen --github spree/spree_adyen && bundle exec rails g spree_adyen:install+```++After that, you need to make sure to restart the server.++## Connect Adyen++Sign in to your Spree admin dashboard and navigate to **Settings → Payments**.++++Find Adyen under Available Payment Methods and click **Add**.++This will redirect you to the Adyen setup form.++++In order to retrieve your API keys:+1. Make sure to be logged into your Adyen Merchant Account+2. Navigate to **Developers → API credentials**+3. Configure a new **API credential**+4. Copy the generated **API Key** (you won't be able to see it later)+5. Click **Save changes**+6. Paste the **API Key** into its respective field in the Adyen setup form in Spree+7. Click **Create** to enable Adyen as a payment method on your store++++### Additional Settings++++You can optionally configure the following settings for your Adyen payment method:++- **Name**: Customize the display name shown for this payment method on the storefront.+- **Display**: Choose where Adyen should be available:+ - Storefront only+ - Admin panel only+ - Both (recommended)+- **Auto Capture**: Decide whether payments should be automatically captured at the time of authorization (recommended), or manually captured later.+- **Active Status**: Enable or disable the payment method. Inactive methods are hidden from checkout but not removed.++### Test Mode++If you want to test your checkout flow without processing real payments, Adyen's test mode is a safe and effective way to simulate transactions. To enable it, simply switch your Adyen Customer Area to **Test mode** and paste the corresponding **test API credentials** into the payment method settings in Spree.++## Features++Spree's native Adyen integration supports a comprehensive range of features and payment methods to help you offer a fast, secure, and flexible checkout experience:++- Support for 3D Secure and other security standards+- Support for off-session payments+- Support for Storefront API integration (see the API docs [here](/api-reference/storefront/adyen/create-an-adyen-payment-session))+- Accept payments in over 150 currencies+- Accept Credit Cards, Debit Cards, and Digital Wallets+- Accept Buy Now, Pay Later (BNPL) payments+- Accept Bank transfers and Direct Debit+- Accept Local payment methods (iDEAL, SOFORT, Bancontact, etc.)+- Accept Mobile payments (Apple Pay, Google Pay, Samsung Pay)+- Accept Cryptocurrency payments+- Advanced fraud protection and risk management+- Real-time payment status updates+- Comprehensive reporting and analytics++### Storefront Display++Spree's Adyen integration enhances the customer experience with dynamic, context-aware payment options across the storefront:++- Dynamic payment method selection based on customer location+- Real-time payment method availability+- Seamless checkout experience with Adyen's Drop-in component+- Support for one-click payments and saved payment methods+- Mobile-optimized payment flows++Feel free to [reach out](https://spreecommerce.org/contact) to learn more.