This Ubercart Integration article includes the following:
Introduction to Ubercart
Integration between Click & Pledge's Payment System with Ubercart
General Settings
Receipt Settings
Recurring Settings
Enable Payment Gateway
Checkout Page
Tax in Ubercart
Introduction to Ubercart
Details about Ubercart may be found at the company's site: http://www.ubercart.org/
The following are instructions show you how to integrate Click & Pledge Payment gateway in Ubercart for Drupal. Install Ubercart module with all supporting modules (unless you install all supporting modules your Ubercart project will not work).
Integration between Click & Pledge's Payment System with Ubercart
Download the Click & Pledge integration module: https://www.drupal.org/project/clickandpledge_ubercart
Make sure to dump all the files from our module <uc_clickandpledge >.
Use the following folder structure:
Place the uc_clickandpledge folder under
1. <Your host root> modules\ubercart\payment
2. Click on ‘Extend’ tab and search with Click&Pledge in the search bar.
3. Once the Click & Pledge module is installed, you will be redirected to the Login screen.
4. We can login to new user directly with CONNECT platform through OAuth Connection. Enter the CONNECT User Name associated with your Click & Pledge account and click on Get the Code. Please check your email inbox for the Login Verification Code email.
5. Copy the Code and click Log in
General Settings
Status: Select the status as Enable to see the C&P payment gateway in the site.
C&P Account ID: Based on the Account ID selected, the settings which are set in the CONNECT platform will be appear here. Click Refresh Accounts if any changes made in the CONNECT so that those changes will reflect here.
CONNECT Campaign URL Alias: Transactions will post to this selected Campaign. It can be added to the form so that the transacted amount will be added to the selected campaign. By entering the CONNECT Campaign URL Alias in the Form, the receipt assigned to the CONNECT Campaign will replace the generic receipt. The receipt which is assigned to this campaign will be sent to the recipient. For additional information on Receipts, review the KnowledgeBase article on CONNECT: Receipts .
To know the CONNECT Campaign URL Alias, login to CONNECT platform (https://login.connect.clickandpledge.com) > Launcher > Fundraising > Campaigns > Select the desired campaign > Campaign Details > Campaign Settings > Basic Information > Campaign Alias.
Transaction Mode: Transaction Mode may be set either to Test or Production. Production mode is nothing but live payment form wherein the given amount will be deducted from the selected payment type. Test mode is used to test the transactions. No amount will be deducted from the payment.
Payment Methods: The CONNECT Payment settings will be replicated here. To view the accepted credit cards, please login to CONNECT and click Launcher > Settings > Accepted Cards.
Note: Due to limitations with the Drupal Ubercart payment API, only Credit Card payment is currently support
Receipt Settings
Send Receipt to Patron: Enable/Disable the checkbox so that the receipt will/will not be sent to the recipient.
Receipt Header: Enter the Receipt Header up to the limit of 1500 characters. The following HTML tags are allowed: <P></P><BR /><OL></OL><LI></LI><UL></UL>.
Terms & Conditions: Enter the Terms & Conditions up to the limit of 1500 characters. The following HTML tags are allowed: <P></P><BR /><OL></OL><LI></LI><UL></UL>.
Recurring Settings
Label: Enter the name of the recurring settings which will appear in the external page.
Settings: The name entered here will be displayed in the external page. Enable or disable the one-time only & recurring options as per the need.
NOTE: Recurring options will be available only when the check-box for recurring is enabled.
Default Payment Option: If both one-time only & recurring options are active then this option will be available. Select one as the default payment options.
Recurring Type Label: The name entered here will be displayed in the external page. Enable the check-boxes for installments & subscription.
Default Recurring Type: Select the default recurring type. This option will be available only when both installments and subscription is enabled.
Periodicity Label: The name entered here will be displayed in the external page. Select the desired periodicities so that they will appear in the external page.
Number of Payments Label: Enter the name of the field so that it will appear in the external page.
- Indefinite + Open Field Only: If this option is selected, the default value will be 999 which can be changed accordingly in the external page.
- Indefinite only: If this option is selected then 998 times for installments and 999 times for subscription, the recurring option will be continued.
- Open Field only: If this option is selected, “Default number of payments” and “Maximum number of installments” can be given. The entries given here can be changed in the external page.
- Fixed Number – No Change allowed: If this option is selected, the number entered in this field remains constant.
After making all the changes click on the “Save Configuration” button.
Enable Payment Gateway
To enable Click & Pledge Payment Gateway, go to Store > Configuration > Payment Methods > Add Payment Method – Type: Select Click & Pledge Credit Card and click ‘Add Payment Method’.
1
Checkout Page
In Front End, you can see the Click & Pledge payment.
Click & Pledge with One Time Contribution:
Click & Pledge payment with Recurring Contributions:
Tax in Ubercart
In Drupal 8.0, Ubercart tax is hidden. By default, Ubercart is not displaying product taxes in the frontend (Both at Cart & Checkout). Ubercart is providing tax settings in dashboard, but they can't be applied on products during checkout process.
To apply taxes at the time of checkout process, we customized the Ubercart UC_TAX Module files. If you want to enable taxes at checkout, you need to modify or replace the following files.
Go to https://www.drupal.org/project/ubercart/issues/3044408 and read the instructions.
Please find the patch #3 and download ubercart-tax-files-to-be-change.zip file or directly download the files from the below link: https://www.drupal.org/files/issues/2019-05-24/ubercart-tax-files-to-be-change.zip
We have saved the files with .txt. Once extracted, please rename them with .php extension and place the files in following locations
1. root-folder\modules\ubercart\uc_cart\src\Form\CartForm.php
2. root-folder\modules\ubercart\uc_tax\src\Plugin\Ubercart\TaxRate\PercentageTaxRate.php
3. root-folder\modules\ubercart\uc_tax\src\TaxRatePluginBase.php
4. root-folder\modules\ubercart\uc_tax\src\TaxRatePluginInterface.php
5. root-folder\modules\ubercart\uc_tax\uc_tax.module