Stripe for Phoca Cart

1. Getting Started

This plugin provides integration of Stripe the processing and payment service to Phoca Cart - e-commerce extension for Joomla. Using Stripe your business can accept all major debit and credit cards from customers in every country in 135+ currencies. More details can be found at product page.

System Requirements:

• Joomla 3.7+
• Phoca Cart 3.1+
• Valid SSL certificate

SSL certificate is highly recommended to use to ensure card details of your customers are safe.

2. Stripe Dashboard settings

Sign in to Stripe dashboard and proceed to Developers > API keys.

You need API keys for live and test environment. These keys should be added to Phoca cart payment method settings.

Webhooks

Now it is time to set up Webhooks. Proceed to Stripe Dashboarc > Developers > Webhooks, then click on Add Endpoint button.

There the following params:

• Webhook version: set the latest version.
• Filter event: set Send all event types.

The Webhook has been created. Now click on it and you will get its settings:

Find Click to reveal button and copy the Webhook Secret for further usage in Phoca Cart payment method.

3. Plugin installation

Stripe for Phoca Cart can be installed as a typical Joomla extension. Make sure you have downloaded the latest version of the plugin. Proceed to Administrator panel > Extensions > Manage > Install and select the package downloaded from NorrNext site.Then go to plugins and enable Stripe for Phoca Cart plugin.

4. Adding new payment method in Phoca Cart

There are several tabs with settings. Let's look on each tab.

4.1. General Options tab

• Title - Payment method title
• Cost - Set Shipping cost. E.g. 2€ for packing
• Tax Rate - select tax rate (to be created at Taxes section)
• Calculation Type - set calculation type (Percentage or Fixed)
• Default - set this payment method as default (Yes / No)
• Payment Method - Select Stripe for Phoca Cart value
• Image - set up image for this payment method (2CO logo)
• Ordering - set item ordering
• Access - The access level group that is allowed to view this item
• Customer Group - set Customer Groups this payment type is available to

The following tabs are standard to each payment method:

4.2. Amount Rule tab

• Lowest Amount - Set lowest amount
• Highest Amount - Set highest amount
• Amount Rule Active - Yes / No

4.3. Country rule tab

• Countries - here you can select multiple countries for which this payment method will work
• Country Rule Active - set Yes if country rule will be active. If you don't want to limit this payment method by countires, set it to No

4.4. Regions rule tab

• Regions - set region or regions
• Region Rule Active - Set if region rule will be active

4.5. Shipping rule tab

• Shipping - Set shipping method(s)
• Shipping Rule Active - Set if shipping rule will be active

The following tab is related to the selected Stripe method, so you must fill it correctly.

4.6. Payment Method Options tab

• Sandbox Mode - If Sandbox Mode is enabled, no real money are transfered. Sandbox is used to test the payments.

Order Statuses

• Payment Completed - Select the order status that will be applied based on successfull payment transaction result. By default it is Completed
• Payment Failed - Select the order status that will be applied based on failed payment or error during transaction processing. By default it is Cancelled.
• Payment Cancelled - Select the order status that will be applied based on cancelled payment or error during transaction processing. By default it is Cancelled.

API Keys

• Publishable Key - Set your Publishable Key. You can find it in Stripe Dashboard > Developers > API keys.
• Secret Key - Set your Secret Key. You can find it in Stripe Dashboard > Developers > API keys.
• Webhook Secret - Set your Webhook Signing Secret. You can find it in Stripe Dashboard > Developers > Webhooks.
• Webhook URL - a URL to paste in Stripe dashboard. Example:

https://mydomain.com/index.php?option=com_phocacart&view=response&task=response.paymentwebhook&type=stripe&tmpl=component&pid=5

Where is mydomain.com - set up your domain and make sure you have a valid SSL certificate. You need to copy this URL and paste it in Stripe dashboard > Webhooks.

Note: API keys are required fields to save the configuration. Fill them if even you are going to use sandbox mode.

API Test Keys

• Publishable Key - Set your test Publishable Key. You can find it in Stripe Dashboard.
• Secret Key - Set your test Secret Key. You can find it in Stripe Dashboard.
• Webhook Secret - Set your Webhook Signing Secret. You can find it in Stripe Dashboard > Developers > Webhooks.

4.7. Publishing Options tab

• Published - set the status of the payment method: published or unpublished

5. Configuring the plugin

5.1. Download Key tab

The plugin has the only option:

This feature allow to get an update of the plugin via back-end in few clicks. Set your download key to enable the update using Joomla! Update System. You can find the key in your Stripe for Phoca Cart subscription on the NorrNext website.

If you set the key for the first time or have changed it, please click on the Update Key button to save it for Joomla! Update System.

Read official tutorial: How to enable one-click update for NorrNext commercial extensions

Make sure the plugin is enabled!

6. F.A.Q.

Does your plugin support 3D Secure?

Yes, 3D Secure is implemented automatically if it is provided by the bank which has issued the debit/credit card.

The payment is successful in Phoca Cart, but it has pending status in Stripe dashboard.

You missed Webhooks settings. Please, get Webhook URL and add it to Stripe settings.

How can I test payments?

Enable Sandbox mode, add test API keys and use Test card numbers and tokens or Testing 3D Secure payments.

Stripe accept payments in iDEAL and other payment methods. How I can add them?

You can activate required payment methods from Stripe Dashboard.