Payment Providers

Vidori supports Stripe, Adyen, and PayPal as payment providers for membership payments. Your subscribers are charged directly through your own merchant account — Vidori never touches the funds.

You only need to configure one provider. Once connected, you can link pricing to your membership tiers.

---

Choosing a Provider

Feature	Stripe	Adyen	PayPal
Best for	Startups, small-to-mid businesses	Enterprise, global merchants	Global reach, buyer trust
Pricing management	Products & prices managed in Stripe	Prices set directly in Vidori	Prices set directly in Vidori
Checkout	Stripe Checkout (hosted)	Adyen Drop-in component	PayPal Buttons (inline)
Test environment	Test mode via sk_test_ keys	Separate test/live environments	Sandbox / Live environments

Tip

If you’re unsure which provider to use, Stripe is the quickest to get started with. You can create a free account at stripe.com.

---

Stripe Setup

1. Create a Stripe account

   Sign up at stripe.com if you don’t have an account. Complete the onboarding to activate your account.

2. Get your API keys

   Go to Stripe Dashboard → Developers → API keys.

   • Publishable key — starts with pk_test_ or pk_live_. Click to copy.
   • Secret key — starts with sk_test_ or sk_live_. Click Reveal test key (or Reveal live key) to copy.

3. Enter credentials in Vidori

   In the admin panel, go to Memberships → Payments. Select Stripe and enter the Secret Key and Publishable Key. Click Save Stripe Configuration.

4. Create a webhook

   After saving, Vidori displays a Webhook URL. Copy it, then:

   • Go to Stripe Dashboard → Developers → Webhooks.
   • Click Add endpoint.
   • Paste the Webhook URL.
   • Under Select events to listen to, add:
     • checkout.session.completed
     • customer.subscription.deleted
   • Click Add endpoint to save.

5. Copy the webhook secret

   On the endpoint details page, click Reveal under Signing secret. Copy the whsec_... value and paste it into the Webhook Secret field in Vidori. Save again.

6. Test the connection

   Click Test Connection in the admin panel to verify your credentials are valid.

Caution

Use test mode keys (sk_test_, pk_test_) while setting up. Switch to live keys only when you’re ready to accept real payments.

Linking Stripe Prices to Tiers

After connecting Stripe:

1. Create subscription products with recurring prices in your Stripe Dashboard.
2. In the admin panel, go to Memberships → Tiers.
3. Click the pricing action on a tier and select a Stripe price to link.

---

Adyen Setup

1. Get your Adyen credentials

   Log in to the Adyen Customer Area and gather:

   • Merchant Account — found under Account → Merchant accounts.
   • API Key — go to Developers → API credentials, select your credential, and generate a server-side API key.
   • Client Key — in the same API credential page, find the client key (used for the Drop-in component).
   • HMAC Key — go to Developers → Webhooks, create a Standard webhook, and copy the HMAC key.

2. Enter credentials in Vidori

   In the admin panel, go to Memberships → Payments. Select Adyen and fill in all fields. Choose Test or Live environment.

   If using the Live environment, you also need to enter your Live Endpoint Prefix (found in the Adyen Customer Area, e.g. 1797a841fbb37ca7-YourCompany).

3. Configure the webhook

   After saving, Vidori displays a Webhook URL. In the Adyen Customer Area:

   • Go to Developers → Webhooks.
   • Add a Standard webhook.
   • Set the URL to the Webhook URL from Vidori.
   • Enable the AUTHORISATION and CANCELLATION events.
   • Save and note the HMAC key if you haven’t already.

4. Test the connection

   Click Test Connection in the admin panel to verify your credentials.

Setting Adyen Prices on Tiers

Unlike Stripe, Adyen prices are configured directly in Vidori:

1. Go to Memberships → Tiers.
2. Click the pricing action on a tier.
3. Enter the amount, currency, and billing interval.

---

PayPal Setup

1. Create a PayPal Business account

   Sign up at paypal.com/business if you don’t have a business account.

2. Create an app in the Developer Dashboard

   Go to the PayPal Developer Dashboard → Apps & Credentials.

   • Click Create App.
   • Name your app (e.g., “Vidori Memberships”).
   • Select Merchant as the app type.
   • After creation, you’ll see your Client ID and Client Secret.

3. Enter credentials in Vidori

   In the admin panel, go to Memberships → Payments. Select PayPal and enter the Client ID and Client Secret. Choose Sandbox or Live environment. Click Save PayPal Configuration.

4. Create a webhook

   After saving, Vidori displays a Webhook URL. Copy it, then:

   • Go to PayPal Developer Dashboard → Webhooks.
   • Click Add Webhook.
   • Paste the Webhook URL from Vidori.
   • Subscribe to these events:
     • PAYMENT.CAPTURE.COMPLETED
     • CHECKOUT.ORDER.APPROVED
     • PAYMENT.CAPTURE.REFUNDED
   • Click Save.

5. Copy the Webhook ID

   After creating the webhook, copy its Webhook ID (shown in the webhook list) and paste it into the Webhook ID field in Vidori. Save again.

6. Test the connection

   Click Test Connection in the admin panel to verify your credentials are valid.

Caution

Use Sandbox credentials while setting up. Switch to Live only when you’re ready to accept real payments.

Setting PayPal Prices on Tiers

Like Adyen, PayPal prices are configured directly in Vidori:

1. Go to Memberships → Tiers.
2. Click the pricing action on a tier.
3. Enter the amount, currency, and billing interval.

---

Switching Providers

You can switch between Stripe, Adyen, and PayPal at any time, but note:

• Existing subscriptions will be cancelled at the end of their current billing period.
• Subscribers will need to re-subscribe using the new provider.
• Tier pricing configuration will need to be reconfigured for the new provider.

Caution

Switching providers in production affects all active subscribers. Plan the transition carefully and communicate changes to your users in advance.

Disconnecting a Provider

To disconnect your current provider, click Disconnect on the Payments page. This does not cancel active subscriptions immediately — they will expire at the end of their billing period.

---

Troubleshooting

Issue	Solution
Connection test fails	Double-check your API keys. Ensure you’re using the correct mode (test vs live).
Webhooks not arriving	Verify the Webhook URL is correctly entered in Stripe/Adyen/PayPal. Check that the required events are enabled.
Payments not processing	Confirm your Stripe/Adyen/PayPal account has completed onboarding and is activated for live payments.
Subscription not created	Ensure a price is linked to the tier (Stripe) or a price is set on the tier (Adyen/PayPal).