Swish via Adyen
This feature is currently a Private Beta release. Contact Chargebee Support to enable Swish via Adyen for your live and test sites.
Swish is a popular mobile payment method in Sweden that allows customers to authorise payments directly through the Swish app. Chargebee supports Swish as a payment method via the Adyen payment gateway.
When customers select Swish at checkout, they are redirected to the Swish app to authorise the payment. Payment is completed instantly after customer approval and the final status is confirmed via Adyen webhooks.
Supported countries and currencies
Swish via Adyen supports the following countries and currencies:
| Country | Currency |
|---|---|
| Sweden | SEK |
Prerequisites
To accept Swish payments using Chargebee, you must:
- Have an active Adyen account with Swish enabled as a payment method in your Adyen Customer Area.
- Ensure SEK (Swedish Krona) currency is enabled for your Chargebee account.
- Ensure the Adyen payment gateway and webhooks are configured in your Chargebee account. Learn more
Integration options
You can integrate Swish via Adyen using the following methods:
| Integration method | Description |
|---|---|
| Chargebee Hosted Pages | Use Chargebee’s hosted checkout pages to accept Swish payments with minimal integration effort. |
| Chargebee JS | Embed Swish as a payment method within your custom checkout using Chargebee JS. |
| API (Payment Intent) | Integrate Swish using Chargebee APIs for a fully custom checkout and payment flow. |
Supported tokens
This integration supports the following set of tokens:
| Token | Description | Format and Sample |
|---|---|---|
| Chargebee Payment Intent ID | This is the Payment Intent ID returned after a successful authorization process using Chargebee JS. | Format: payment_intent[id] |
Configure Swish in Chargebee
Follow these steps to configure Swish via Adyen in your Chargebee site:
- Log in to the Chargebee app.
- Go to Settings > Configure Chargebee > Payment Gateways.
- Select the relevant Adyen instance from the list.
- On the Configure Adyen page, ensure Swish is enabled under the list of supported payment methods.
- Click Apply to save changes.
Note
Swish availability depends on your Adyen merchant configuration.
Configure smart routing for Swish
When you configure Swish through Adyen, smart routing for the SEK currency is automatically enabled. Check the Smart Routing settings, and if any other gateway is already designated for the SEK currency, adjust the Smart Routing settings manually to allocate Swish to it.
Follow these steps to modify Smart Routing settings:
- Log in to the Chargebee app.
- Go to Settings > Configure Chargebee > Payment Gateways.
- Click Manage Rules under Smart Routing.
- Go to the Swish section and click Add a Gateway for SEK. If you already have a payment gateway assigned to it, click Edit.
- From the Choose a payment gateway drop-down menu, select the relevant Adyen instance with Swish enabled.
- Click Save.
Enable Swish to pay for subscriptions
Swish is a one-time payment method and cannot be used for recurring payments. To use it for subscriptions, configure your Chargebee site to allow all one-time payment methods for subscriptions.
Note
While testing, ensure Allow customers to pay for subscriptions with payment methods that only support one-time payments and One-time Payments - Enable button are enabled under Settings > Configure Chargebee > Checkout & Self-Serve Portal.
Follow these steps to enable one-time payment methods for subscriptions:
- In the Chargebee app, go to Settings > Configure Chargebee > Checkout & Self-Serve Portal.
- Select the Configuration tab and enable Allow customers to pay for subscriptions with payment methods that only support one-time payments.
Checkout flow
Your customer performs the following steps during checkout using Swish via Adyen:
- Initiate checkout and proceed to the payment step.
- Select Swish as the payment method.
- You are redirected to the Swish app to authorise the payment.
- Confirm the payment within the Swish app.
- Once payment is authorised, you are redirected back to the merchant's website.
Testing
Sandbox testing
- Use the Adyen test environment with Swish enabled.
- Swish testing uses Adyen-provided test credentials and simulated mobile flows.
- Payment outcomes (success or failure) are controlled via Adyen test scenarios and API-triggered responses.
Note
Swish does not support amount-based outcome simulation. Test outcomes must be triggered via Adyen test configurations.
Production testing
Before going live:
- Ensure Swish is enabled in your Adyen account.
- Verify webhook configuration is complete (mandatory for payment status updates).
- Perform end-to-end testing using a real Swish-enabled bank account and a mobile device with the Swish app installed.
Reconciliation
For financial reconciliation between Chargebee and Adyen:
- Use the Chargebee transaction field id_at_gateway, which maps to the pspReference in Adyen.
Follow these steps to reconcile transactions:
- Retrieve the id_at_gateway value from the Chargebee transaction details.
- Locate the corresponding pspReference in Adyen reports.
- Match transactions using this reference.
Limitations and important points
- Swish cannot be added as a payment method via the customer portal or the Chargebee app. Customers must complete the Swish checkout flow.
- Swish does not support storing payment methods for recurring billing. Each transaction requires explicit customer authorization via the Swish app.
- Swish is not suitable for automatic subscription renewals. To collect payments for subscriptions using Swish, send email notifications with a Pay Now link when a new invoice is generated.
- Swish does not support chargebacks. Refunds must be issued manually if needed.
- Swish is exclusively available for SEK (Swedish Krona) transactions.
Was this article helpful?