Ceon Manual Card Payment Module v4

Hi,

This is the official support thread for Ceon Manual Card.

At the time of this posting the latest version is 4.0.1 but the latest version will always be available on the Ceon website and in the Zen Cart downloads area.


Module Features

This payment module has been written to be as comprehensive as possible (despite the limited nature of a payment module for manual card processing). The current feature list follows.

• Support for many Card Types
  
  • Each card type can be enabled or disabled at the click of a button inside the admin. Cards supported:
    
    • Visa
    • MasterCard
    • Maestro
    • Visa Debit
    • MasterCard Debit
    • American Express
    • Visa Electron (UKE)
    • Diners Club International
    • JCB
    • Laser
    • Discover
    
    
  • If you would like additional card types added please consult the FAQs.
  
  
• Can gather the following information:
  
  • Card Holder's Name
  • Card Type
  • Card Number
  • Expiry Date
  • CV2 Number
  • Start Date (Maestro/American Express)
  • Issue Number (Maestro)
  
  
• Option to Send Sensitive Card Data via E-mail
  
  • The CV2 number and middle digits of the card number can be sent in an e-mail to the store owner.
  • This means that the full details don't need to be stored on the server; not having the full card details in one central place is a much safer way to collect card details for manual/offline processing.
  • The rest of the details can be accessed at all times through the “Orders” section of the store's admin.
  
  
• Option to Store All Card Details [NEW for 4.0.0]
  
  • Instead of splitting up the card details, by sending the CV2 number and middle digits of the card number in an e-mail, the full card details can be stored and displayed at once, in their entirety, on the order's page.
  • Having the full card details in one central place is a less-safe way to collect card details for manual/offline processing but obviously more convenient for the store owner/admin staff.
  
  
• Surcharges/Discounts Support
  
  • In collaboration with another of our modules, the Ceon Payment Surcharges/Discounts Order Total module:
    
    • each Card Type can have an individual surcharge or discount rate specified which applies to all Order Values, or
    • each Card Type can even have a full range of surcharge/discount rates specified, so that differing Order Value ranges result in differing surcharge/discount rates being applied!
    
    
  • The rates for individual cards can even differ according to the country the billing address is in and/or the currency being used!
  • This all means that store owners can pass the cost of accepting certain card types onto their customers, or offer their customers discounts for using particular card types.
  • The Ceon Payment Surcharges/Discounts module can be downloaded for free from the Ceon website and is simple to use/integrate with stores!
  
  
• Visual Feedback of JavaScript Validation
  
  • In order to catch any problems with card details entered by the customer as quickly and easily as possible, this module will not only alert the customer to any incorrect information when they attempt to submit the form, it will actually highlight the form fields which require their attention.
  • This helps to minimise the number customers getting frustrated and leaving at the last hurdle!
  
  
• Icons for each Type of Credit/Debit Card Accepted
  
  • If this option is enabled in the admin, icons are displayed for each credit/debit card accepted (all are enabled in the screenshot to the right).
  • This looks very professional for the store!
  
  
• Cards Accepted Sidebox
  
  • A “Cards Accepted” sidebox also comes with the module, allowing the dynamic display of icons for each type of credit/debit card accepted by the store (all are enabled in the screenshot to the right).
  • This lets customers know what card types are accepted even before they've reached the checkout stage.
  
  
• Retains entered Card Details right throughout the checkout process
  
  • If the customer returns to the payment page (for example, to change their shipping address, or if they realise at the confirmation stage of the checkout procedure that they have entered some incorrect information), the card details they entered previously will be automatically restored!
  • This prevents any frustration with customers having to re-enter their details, something which unfortunately has to happen with most other payment modules.
  • In turn this feature helps to prevent customers leaving at the last hurdle!
  • An option is available to specify whether the details to be stored temporarily in the session should include the “sensitive” card details (Card Number and Card CV2 Number). If this option is enabled, these sensitive details are encrypted in the session using the Blowfish algorithm, to protect the confidentiality of the details as best as possible.
  
  
• Automatically selects itself as the current payment method when customer uses any field
  
  • Whenever the customer uses any of the Ceon Manual Card fields on the checkout payment page, the software automatically selects itself as the current payment method, saving customers time and frustration when they forget to select the payment method they are using.
  
  
• Button to Delete All Card Details [NEW for 4.0.0]
  
  • Once the card details have been used, the “Delete” functionality offered by this module can be used to remove them from the database.
  • Clearly this is good for data protection, as customers' details shouldn't be kept any longer than necessary (and not at all according to many merchant accounts' terms and conditions!).
  
  
• Quick and Easy Installation or Upgrading
  
  • Thanks to its automatic database creation functionality and automatic upgrade functionality, Ceon Manual Card is exceptionally easy to install or upgrade.
  
  
• Dynamic Start Date and Issue Number support
  
  • Certain cards (American Express) may need a Start Date to be supplied for authorisation to take place, while certain cards (Maestro) may need an Issue Number to be supplied.
  • Ceon Manual Card dynamically displays the necessary form gadgets to capture this information from the user, based on the card types enabled in the admin.
  
  
• Option to not even ask for a Start Date
  
  • Some stores don't need to collect the start date from their customers. For this reason there is an option to remove the start date fields altogether, so the customer is not asked for it.
  
  
• Support for cards without a CV2 Number
  
  • A small minority of cards have no CV2 number. If a customer has filled in all card details except for the CV2 number, they can be given the option to indicate that their card has no CV2 number.
  • This is totally automatic. The module can detect if a customer is trying to use a card without a CV2 number and will ask them to confirm if they have made a mistake, or to confirm that there is no CV2 number on their card. Otherwise they will be asked to correct their oversight.
  • This is necessary for Laser cards as many of them tend not to have CV2 numbers.
  
  
• Option to not even ask for a CV2 Number
  
  • Some stores don't need to collect the CV2 number from their customers. For this reason there is an option to remove the CV2 number field altogether, so the customer is not asked for the card's CV2 number.
  
  
• Ability to Disable Autocomplete
  
  • Some browsers store credit/debit card numbers and/or CV2 numbers entered in the form fields and then automatically insert them in the form fields when a user returns to a website.
  • This can be quite disconcerting to customers, so the option to have this browser feature disabled is offered (and set by default) by Ceon Manual Card.
  
  
• Start/Expiry Date Format Specification
  
  • The format of the text to be used for the Start/Expiry Date selection gadgets can be specified in the module's configuration.
  
  
• Debug Output Mode
  
  • Sometimes there can be problems with a store's settings. The debug mode allows you to see what information was to be sent, so you can check the settings. Most stores should never need this functionality though so it is disabled by default.
  
  

Download Now!

The latest version of the software can always be downloaded from its website.

The module has also been submitted to the Zren Cart downloads area.


Enjoy!

All the best...

Conor
ceon

I have just upgraded to Zen Cart 1.5.1 and Ceon Manual Card v4.0.1 and all is working fine.
In my previous version of Zen Cart (1.3.8a) I used what I think was the built in manual credit card processing module and was able to set a shopping cart total limit of £1000 for credit cards. So, whenever the cart total exceeded £1000 the CC payment option did not appear, just Paypal and Bank Deposit.

The code used in \includes\modules\payment\cc.php was:
/**
Limit CC payments up to £1000 excl VAT BOF
**/
if (IS_ADMIN_FLAG == true || $_SESSION['cart']->show_total() <= 1000) {
$this->enabled = true;
} else {
$this->enabled = false;
}
/**
Limit CC payments up to £1000 excl VAT EOF
**/

I have tried placing in ceon_manual_card.php but it breaks the entire checkout page.
Any assistance would be appreciated.
Thanks
Ian

Hi Ian,

Quote:

---

Originally Posted by Ruthless

I have tried placing in ceon_manual_card.php but it breaks the entire checkout page.
Any assistance would be appreciated.

---

That code looks fine so it must simply be that you have put the code in the wrong place, breaking the PHP parsing of the file, or you've accidentally included extra text that breaks the parsing of the PHP.

Start with a fresh copy of ceon_manual_card.php and try again, being careful to do things right.

If you're still having trouble you've have to pay someone to do this for you.

As this is custom work please don't post a reply here, I'd like to keep this thread to Ceon Manual Card support only.

All the best..

Conor
ceon

Hey Conor / Ceon, thanks so much for updating this! I was actually just about to install the previous version! Anyway, is there any way this can be changed to save the first 6 digits and email the last 6 digits? The reason I ask is because MaxMind / AVS need the first 6 to run the fraud detection.

If your going to manually run a card it is a really good idea to do an address verification and it would be really cool if it could be automated.

Again, Thanks for being AWESOME!

I regret to advise you that Conor passed away last night. Please see http://www.zen-cart.com/showthread.php?202939

Hello,

I installed the mod however i get the following message:

HTML Code:

---

The store's admin folder is not called “admin” but has been changed to “********”.

The value of DIR_FS_ADMIN in the configure.php file does not appear to match the admin's directory: “*********”.

---

But as per instructions here there is no need to alter the admin configure.php in v1.5.x when renaming your admin folder

You may find that you now have a new folder in your site called admin. That happens if you uploaded the mod's files from the files directory without changing the admin folder to the name of your new admin folder.

Conor created not only the cleanest code but great instructions as well. Try following the directions in the docs/index.html.

What do i do?

HTML Code:

---

Configuration Issues
Admin file missing!

At least one Ceon Manual Card admin file is missing:

/public_html/**************/includes/includes/extra_datafiles/ceon_manual_card_database_tables.php

The store's admin folder is not called “admin” but has been changed to “**************”.

The value of DIR_FS_ADMIN in the configure.php file does not appear to match the admin's directory: “*************”.

Please edit the admin configure.php file to check/fix the values for DIR_WS_ADMIN and DIR_FS_ADMIN.

---

Quote:

---

Originally Posted by ShopVille

What do i do?

HTML Code:

---

Configuration Issues
Admin file missing!

At least one Ceon Manual Card admin file is missing:

/public_html/**************/includes/includes/extra_datafiles/ceon_manual_card_database_tables.php

The store's admin folder is not called “admin” but has been changed to “**************”.

The value of DIR_FS_ADMIN in the configure.php file does not appear to match the admin's directory: “*************”.

Please edit the admin configure.php file to check/fix the values for DIR_WS_ADMIN and DIR_FS_ADMIN.

---

---

I fixed this by adding a directory named "includes" in the admin/includes directory,

However i'm trying to get the payment method restricted to certain categories, i successfully did it on other modules with the instructions here but ceon code looks entirely different

You keep digging the hole deeper. You need to regroup, start over, and read the directions.

After you unzip the file (on your computer), there should be three folders and two files inside a directory named ceon_manual_card_4.0.1_for_zc. If not, you have the wrong files.

The _docs folder contains the instructions that can be read by clicking on the _docs/index.html file. READ THEM.

The files folder contains files that are added to the base directory of Zen Cart AFTER you rename admin to the name you have given your admin. No other change is needed. If your Zen Cart is at yoursite.com/store, the folders in the files directory would be added to yoursite.com/store. If your Zen Cart is at yoursite.com, the folders in the files directory would be added to yoursite.com.

The optional (but recommended) template_files folder contains a stylesheet used to add images and style to the cart and the admin menu. The directory should look like:

• template_files
  
  • includes
    
    • templates
      
      • STORE-TEMPLATE
        
        • css
          
          • stylesheet_ceon_manual_card.css

STORE-TEMPLATE needs to be changed to the template you are using. If it is a custom template, rename STORE-TEMPLATE to the name of your template. If you are using the classic template (you shouldn't), rename STORE-TEMPLATE to template_default.

Lastly, the renamed folders in the template_files directory should be added to your site the same way as the folders from the files menu.


Remember that both the files directory and the template_files directory are representing the location of your Zen Cart files. Both files and template_files are the same as yoursite.com or yoursite.com/whatever.