Payment Methods
A payment method is how a customer pays for the order. Concerto Commerce supports both online and offline transactions. For the online methods, Concerto Commerce integrates with third-party payment gateways so that customer's credit card information is automatically sent through the gateway (as either an authorization or authorization and charge) upon completion of an order. You can have multiple payment methods active at the same time. A customer can select how they want to pay at the checkout.
To define payment methods, go to Configuration → Payment methods.
To activate a payment method, click Edit beside the required method, select the Is active checkbox and click Update. The Is active option changes from false to true.
Different payment methods support different options. There are 4 payment options that a payment method might or might not support:
- Supports capture indicates whether this method allows processing money transfer after the amount was charged.
- Refund indicates this method allows making a money refund after the amount was charged and captured.
- Partial refund indicates whether this method allows making a partial money refund after the amount was charged and captured.
- Void indicates whether this method allows making a money refund before the amount was charged (when the payment status is pending).
- Recurring support indicates whether this method allows recurring payments.
Click Configure beside a payment method to set it up.
Check/money order
Check/money orders are often used by government agencies or large businesses. Rather than paying directly through your site, shoppers will request that you send them a Purchase order (PO), and they will send the payment back. Most of the order processing is handled outside of the software.
To configure this payment method, go to Configuration → Payment methods. Find the Check/money order (Payments.CheckMoneyOrder) payment method list:
Activate the method, edit its name, and display order
You can edit the payment method name, which will be displayed for customers in the public store, or its display order. To do this, click the Edit button in the plugin row on the payment method list page. You will be able to enter Friendly name and Display order. In this row, you can also activate the plugin or make it inactive using the Is active field. Click the Update button. Your changes will be saved.
Configure the payment method
On the Configuration → Payment methods page, find the Check/money order (Payments.CheckMoneyOrder) payment method and click the Configure button. The Configure - Check/money order window will be displayed as follows:
Set up the payment method as follows:
- In the Description field, enter the info that will be shown to customers during checkout.
- Define the Additional fee for using this method.
- In the Additional fee. Use percentage field, define whether to apply an additional percentage fee to the order total. If not enabled, a fixed value is used.
- The Shippable product is required field indicates whether shippable products are required in order to display this payment method during checkout.
Click Save.
Limit to stores and customer roles
You can limit any payment method to store and customer role. This means that the method will be available to certain stores or customer roles only. You can do this from the plugin list page.
- Go to Configuration → Local plugins. Find the plugin you want to limit. In our case, it's Check/money order. To find it faster, use the Search panel at the top of the page and search by Plugin name or Group using the Payment methods option.
- Click the Edit button, and the Edit plugin details window will be displayed as follows:
- You can set up the following limits:
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option just leave this field empty.
IMPORTANT
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore ACL rules (sitewide). Read more about the access control list here.
- Use the Limited to stores option to limit this plugin to a certain store. If you have multiple stores, choose one or several from the list. If you don't use this option, just leave this field empty.
IMPORTANT
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore "limit per store" rules (sitewide). Read more about multi-store functionality here.
Click Save.
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option just leave this field empty.
Credit card (manual processing)
This is a special payment plugin that allows all orders to be successfully entered on the website, but it does NOT really charge a customer or make calls to any live payment gateway. It is recommended to use this payment method if you want to perform one of the following:
- Process all orders offline
- Process them manually via another back-office system
- Test the site end-to-end before going live
To configure this payment method, go to Configuration → Payment methods. Then find the Credit card (Payments.Manual) payment method in the payment method list:
Activate the method, edit its name, and display order
You can edit the payment method name, which will be displayed for customers in the public store, or its display order. To do this, click the Edit button in the plugin row on the payment method list page. You will be able to enter Friendly name and Display order. In this row, you can also activate the plugin or make it inactive using the Is active field. Click the Update button. Your changes will be saved.
Configure the payment method
On the Configuration → Payment methods page, find the Credit card (Payments.Manual) payment method and click the Configure button. The Configure - Credit card window will be displayed as follows:
Set up the payment method as follows:
- In the After checkout mark payment as field, specify the transaction mode.
- Define the Additional fee for using this method.
- In the Additional fee. Use percentage field, define whether to apply an additional percentage fee to the order total. If not enabled, a fixed value is used.
Click Save.
Limit to stores and customer roles
You can limit any payment method to store and customer role. This means that the method will be available to certain stores or customer roles only. You can do this from the plugin list page.
- Go to Configuration → Local plugins. Find the plugin you want to limit. In our case, it's Credit card. To find it faster, use the Search panel at the top of the page and search by Plugin name or Group using the Payment methods option.
- Click the Edit button, and the Edit plugin details window will be displayed as follows:
- You can set up the following limits:
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option, just leave this field empty.
IMPORTANT
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore ACL rules (sitewide). Read more about the access control list here.
- Use the Limited to stores option to limit this plugin to a certain store. If you have multiple stores, choose one or several from the list. If you don't use this option, just leave this field empty.
IMPORTANT
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore "limit per store" rules (sitewide). Read more about multi-store functionality here.
Click Save.
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option, just leave this field empty.
PayPal Standard
PayPal Standard is the easiest way to securely accept credit card and PayPal payments online.
To configure the PayPal Standard plugin, go to Configuration → Payment methods. Then find the PayPal Standard payment method in the payment method list:
Activate the method, edit its name, and display order
You can edit the payment method name, which will be displayed for customers in the public store, or its display order. To do this, click the Edit button in the plugin row on the payment method list page. You will be able to enter Friendly name and Display order. In this row, you can also activate the plugin or make it inactive using the Is active field. Click the Update button. Your changes will be saved.
Configure the payment method
To use the PayPal Standard plugin as a payment method, please follow these steps:
- Register a Business account on www.paypal.com. Follow the link https://www.paypal.com/bizsignup/. Then fill in the information about yourself and your business:
NOTE
If you already have an account, you will be redirected to the authorization.
- In the top navigation bar, click the Settings icon
- Select Website payments in the left panel and click Update in the Website preferences line.
- In the Auto return for website payments section, set the switch to On. As the Return URL, enter the URL of your site, which will receive ID transactions sent by PayPal after customer payment. In our case, it's
http://localhost:15536/Plugins/PaymentPayPalStandard/PDTHandlerbut don't forget to replace localhost with your site URL.
- In the Payment data transfer section, set the switch to On and copy Identity Token.
- To configure the plugin in the admin panel of Concerto Commerce, go to Configuration → Payment methods. In the PayPal Standard line, click Configure.
- In the Business Email field, enter the email specified when registering a Business account on paypal.com.
- In the PDT Identity Token field, enter the copied Identity Token from clause #5.
- Click Save.
For the IPN (Instant Payment Notification) activation:
- Select Notifications in the left panel and click the Update in the Instant payment notifications line.
- Familiarize yourself with the information regarding IPN and click Choose IPN Settings.
- Select Receive IPN messages (Enabled). As Notification URL, enter the URL of your IPN handler.
- Click Save. You should get a message that you have successfully activated IPN.
NOTE
Instant Payment Notification (IPN) is a PayPal message service that sends a notification when a transaction is affected. Once IPN is integrated, sellers can automate their back office so that they don't have to wait for payments to come in to trigger the order fulfillment.
Limit to stores and customer roles
You can limit any payment method to store and customer role. This means that the method will be available to certain stores or customer roles only. You can do this from the plugin list page.
- Go to Configuration → Local plugins. Find the plugin you want to limit. In our case, it's PayPal Standard. To find it faster, use the Search panel at the top of the page and search by Plugin name or Group using the Payment methods option.
- Click the Edit button, and the Edit plugin details window will be displayed as follows:
- You can set up the following limits:
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option just leave this field empty.
IMPORTANT
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore ACL rules (sitewide). Read more about the access control list here.
- Use the Limited to stores option to limit this plugin to a certain store. If you have multiple stores, choose one or several from the list. If you don't use this option, just leave this field empty.
IMPORTANT
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore "limit per store" rules (sitewide). Read more about multi-store functionality here.
- Click Save.
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option just leave this field empty.
Known Issues
Error: Things don't appear to be working at the moment (PayPal)
If you see the error "Things don't appear to be working at the moment. Please try again later"
The error is caused by a setting within your PayPal Account.
Step 1: On the left sidebar, under "Products & Services," click "Website Payments"
Step 2: Click "Update" next to the "Website Preferences" section
Step 3: Scroll down to the "Encrypted Website Payments" section, select "Off" on the right, and then save your changes.
After saving the change, you can go back to your site and try the button/forms again, and they should work.
PayPal Commerce
PayPal Commerce gives your buyers a simplified and secure checkout experience. PayPal intelligently presents the most relevant payment types to your shoppers automatically, making it easier for them to complete their purchases using such methods as Pay with Venmo, PayPal Credit, credit card payments, iDEAL, Bancontact, Sofort, and other payment types.
Configure the payment method
To configure the PayPal Commerce plugin, go to Configuration → Payment methods. Then find the PayPal Commerce payment method in the payment method list:
Follow these steps to configure PayPal Commerce:
1. Activate the payment method
To do this, click the Edit button in the plugin row on the payment method list page. Activate the plugin by selecting the Is active checkbox. Click the Update button. Your changes will be saved.
2. Create a PayPal account
If you already have a PayPal account, just proceed to the next section. If you don't then register a Business account. You have two options to do this: you can register an account on the PayPal website or you can do this from the plugin configuration page. Let's briefly consider both options:
Register an account on the PayPal website
- Register a Business account on PayPal. Just click the Sign up button there:
- Then fill in the information about yourself and your business:
NOTE
If you already have an account, you will be redirected to the authorization.
Register an account from the plugin configuration page
- Open the PayPal Commerce configuration page in the admin area. You will see the following form:
- Enter your email address and let PayPal check everything out by clicking the Save button.
- If everything is OK, you will see the following green notification and a newly added Sign up for PayPal button:
- Click this button and you will see the following pop-up window allowing you to fill in some data and register an account:
You should pass through a few steps to fill in all the required data. The last one will ask you to confirm your email to activate your account.
3. Set up the Paypal Developer Dashboard
- Log into the Developer Dashboard with your PayPal account credentials.
- In My Apps & Credentials, use the toggle to switch between live and sandbox testing apps.
- Navigate to the REST API apps section and click Create App.
- Type a name for your app and click Create App. The app details page will open and display your credentials.
- Copy and save the Client ID and Secret for your app.
- Review your app details and save your app if you made any changes.
4. Configure the payment method in Concerto Commerce
- Find the PayPal Commerce payment method on the Configuration → Payment methods page and click Configure. The Configure - PayPal Commerce page will be displayed as follows:
- Define the following settings on the Configure - PayPal Commerce page:
- Specify API credentials manually - determine if you need to manually set credentials. Select this option if you already have an application created or if you want to use sandbox mode. Otherwise, the plugin will be set up automatically and you will be able to start accepting PayPal payments in your store after completing your PayPal registration.
- Use sandbox if you want to test the payment method first.
- Enter the Client ID you saved in the previous steps.
- Enter the Secret you saved in the previous steps.
- Choose the Payment type to either capture payment immediately or authorize payment for an order after order creation.
- Specify API credentials manually - determine if you need to manually set credentials. Select this option if you already have an application created or if you want to use sandbox mode. Otherwise, the plugin will be set up automatically and you will be able to start accepting PayPal payments in your store after completing your PayPal registration.
- Then proceed to the PayPal Prominently panel:
On this panel, define the display settings:
- Select the Display buttons on shopping cart checkbox to display PayPal buttons on the shopping cart page instead of the default checkout button.
- Select the Display buttons on product details to display PayPal buttons on product details pages; clicking them matches the behavior of the default 'Add to cart' button.
- Select the Display Pay Later messages box to take advantage of the pay later messaging feature on your website. The message is displayed on the product and checkout pages, showing how much the customer is paying in four installments.
- Tick the Display logo in header links checkbox to display a PayPal logo in the header links. These logos and banners are a great way to let your buyers know that you choose PayPal to securely process their payments.
- If the previous checkbox is selected, the Logo source code field is displayed. In this field, enter the source code of the logo. Find more logos and banners on PayPal Logo Center. You can also modify the code to fit correctly into your theme and site style.
- Tick the Display logo in footer checkbox to display a PayPal logo in the footer. These logos and banners are a great way to let your buyers know that you choose PayPal to securely process their payments.
- If the previous checkbox is selected, the Logo source code field is displayed. In this field, enter the source code of the logo. Find more logos and banners on PayPal Logo Center. You can also modify the code to fit correctly into your theme and site style.
Click Save to save the plugin settings.
Limit to stores and customer roles
You can limit any payment method to store and customer role. This means that the method will be available to certain stores or customer roles only. You can do this from the plugin list page.
- Go to Configuration → Local plugins. Find the plugin you want to limit. In our case, it's PayPal Commerce. To find it faster, use the Search panel in the top of the page and search by Plugin name or Group using the Payment methods option.
- Click the Edit button, and the Edit plugin details window will be displayed as follows:
- You can set up the following limits:
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option just leave this field empty.
IMPORTANT
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore ACL rules (sitewide). Read more about the access control list here.
- Use the Limited to stores option to limit this plugin to a certain store. If you have multiple stores, choose one or several from the list. If you don't use this option, just leave this field empty.
IMPORTANT
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore "limit per store" rules (sitewide). Read more about multi-store functionality here.
Click Save.
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option just leave this field empty.
PayPal Smart Payment Buttons
IMPORTANT
This plugin is currently deprecated and, starting from version 4.40.4, has been replaced by the PayPal Commerce plugin.
This plugin is currently deprecated and, starting from version 4.40.4, has been replaced by the PayPal Commerce plugin.
PayPal Checkout with Smart Payment Buttons gives your buyers a simplified and secure checkout experience. PayPal intelligently presents the most relevant payment types to your shoppers automatically, making it easier for them to complete their purchases using such methods as Pay with Venmo, PayPal Credit, credit card payments, iDEAL, Bancontact, Sofort, and other payment types.
Video tutorial
Watch this video tutorial to learn how to configure PayPal Smart Payment Buttons.
Configure the payment method
To configure the PayPal Smart Payment Buttons plugin, go to Configuration → Payment methods. Then find the PayPal Smart Payment Buttons payment method in the payment method list:
Follow these steps to configure PayPal Smart Payment Buttons:
1. Activate the payment method
To do this, click the Edit button in the plugin row on the payment method list page. Activate the plugin by selecting the Is active checkbox. Click the Update button. Your changes will be saved.
2. Create a PayPal account
If you already have a PayPal account, just proceed to the next section.
Register a Business account on PayPal. Then fill in the information about yourself and your business:
NOTE
If you already have an account, you will be redirected to the authorization.
If you already have an account, you will be redirected to the authorization.
3. Set up the PayPal Developer Dashboard
- Log into the Developer Dashboard with your PayPal account credentials.
- In My Apps & Credentials, use the toggle to switch between live and sandbox testing apps.
- Navigate to the REST API apps section and click Create App.
- Type a name for your app and click Create App. The app details page will open and display your credentials.
- Copy and save the Client ID and Secret for your app.
- Review your app details and save your app if you made any changes.
4. Configure the payment method in Concerto Commerce
- Find the PayPal Smart Payment Buttons payment method on the Configuration → Payment methods page and click Configure. The Configure - PayPal Smart Payment Buttons page will be displayed as follows:
- Define the following settings on the Configure - PayPal Smart Payment Buttons page:
- Use sandbox if you want to test the payment method first.
- Enter the Client ID you saved in the previous steps.
- Enter the Secret you saved in the previous steps.
- Choose the Payment type to either capture payment immediately or authorize payment for an order after order creation.
- Then proceed to the PayPal Prominently panel:
On this panel, define the display settings:
- Select the Display buttons on shopping cart checkbox to display PayPal buttons on the shopping cart page instead of the default checkout button.
- Select the Display buttons on product details to display PayPal buttons on product details pages; clicking on them matches the behavior of the default 'Add to cart' button.
- Select the Display logo in header links checkbox to display a PayPal logo in the header links. These logos and banners are a great way to let your buyers know that you choose PayPal to securely process their payments.
- If the previous checkbox is selected, the Logo source code field is displayed. In this field, enter the source code of the logo. Find more logos and banners on PayPal Logo Center. You can also modify the code to fit correctly into your theme and site style.
- Select the Display logo in footer checkbox to display a PayPal logo in the footer. These logos and banners are a great way to let your buyers know that you choose PayPal to securely process their payments.
- If the previous checkbox is selected, the Logo source code field is displayed. In this field, enter the source code of the logo. Find more logos and banners on PayPal Logo Center. You can also modify the code to fit correctly into your theme and site style.
- Use sandbox if you want to test the payment method first.
- Enter the Client ID you saved in the previous steps.
- Enter the Secret you saved in the previous steps.
- Choose the Payment type to either capture payment immediately or authorize payment for an order after order creation.
On this panel, define the display settings:
- Select the Display buttons on shopping cart checkbox to display PayPal buttons on the shopping cart page instead of the default checkout button.
- Select the Display buttons on product details to display PayPal buttons on product details pages; clicking on them matches the behavior of the default 'Add to cart' button.
- Select the Display logo in header links checkbox to display a PayPal logo in the header links. These logos and banners are a great way to let your buyers know that you choose PayPal to securely process their payments.
- If the previous checkbox is selected, the Logo source code field is displayed. In this field, enter the source code of the logo. Find more logos and banners on PayPal Logo Center. You can also modify the code to fit correctly into your theme and site style.
- Select the Display logo in footer checkbox to display a PayPal logo in the footer. These logos and banners are a great way to let your buyers know that you choose PayPal to securely process their payments.
- If the previous checkbox is selected, the Logo source code field is displayed. In this field, enter the source code of the logo. Find more logos and banners on PayPal Logo Center. You can also modify the code to fit correctly into your theme and site style.
Click Save to save the plugin settings.
Limit to stores and customer roles
You can limit any payment method to store and customer role. This means that the method will be available to certain stores or customer roles only. You can do this from the plugin list page.
- Go to Configuration → Local plugins. Find the plugin you want to limit. In our case, it's PayPal Smart Payment Buttons. To find it faster, use the Search panel at the top of the page and search by Plugin name or Group using the Payment methods option.
- Click the Edit button, and the Edit plugin details window will be displayed as follows:
- You can set up the following limits:
- In the Limited to customer roles field, choose one or several customer roles, that is, administrators, vendors, guests, who will be able to use this plugin. If you don't need this option just leave this field empty.
IMPORTANT
-
-
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore ACL rules (sitewide). Read more about the access control list here.
- Use the Limited to stores option to limit this plugin to a certain store. If you have multiple stores, choose one or several from the list. If you don't use this option, just leave this field empty.
-
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore ACL rules (sitewide). Read more about the access control list here.
- Use the Limited to stores option to limit this plugin to a certain store. If you have multiple stores, choose one or several from the list. If you don't use this option, just leave this field empty.
IMPORTANT
-
-
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore "limit per store" rules (sitewide). Read more about multi-store functionality here.
Click Save.
-
In order to use this functionality, you have to disable the following setting: Catalog settings → Ignore "limit per store" rules (sitewide). Read more about multi-store functionality here.
Click Save.