X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=CreditCard.pm;h=6a9a91891a2c9ed8ce3b64c3d11ddc699501f694;hb=4c810fa50a5a0d40c54a7ee0b48bfd23c4bde1b6;hp=b083411c8f56fcb0f53856f1b51bf6266fc175b4;hpb=752f80ce2c000b800544cc22c955d6b3d1e3fd91;p=Business-CreditCard.git diff --git a/CreditCard.pm b/CreditCard.pm index b083411..6a9a918 100644 --- a/CreditCard.pm +++ b/CreditCard.pm @@ -1,30 +1,13 @@ package Business::CreditCard; -# Business::CreditCard.pm -# -# Jon Orwant, -# -# 12 Jul 96 - created -# 17 Jan 97 - 0.21 released. -# short numbers and numbers with letters are no longer kosher. -# 1 Feb 2001 - 0.22 released, new maintainer, MakeMaker installation -# 3 May 2001 - 0.23 released, silly bug in test.pl -# 11 Jun 2001 - 0.24. added enRoute, JCB, BankCard, rewrote with regexes -# -# Copyright 1995,1996,1997 Jon Orwant. All rights reserved. -# This program is free software; you can redistribute it and/or -# modify it under the same terms as Perl itself. -# -# Version 0.24. Module list status is "Rdpf." - -require 5; - require Exporter; -use vars qw( @ISA $VERSION ); +use vars qw( @ISA $VERSION $Country ); @ISA = qw( Exporter ); -$VERSION = "0.23"; +$VERSION = "0.31"; + +$Country = 'US'; =head1 NAME @@ -50,8 +33,34 @@ The validate() subroutine returns 1 if the card number provided passes the checksum test, and 0 otherwise. The cardtype() subroutine returns a string containing the type of -card: "MasterCard", "VISA", and so on. My list is not complete; -I welcome additions. +card. The list of possible return values is more comprehensive than it used +to be, but additions are still most welcome. + +Possible return values are: + + VISA card + MasterCard + Discover card + American Express card + Diner's Club/Carte Blanche + enRoute + JCB + BankCard + Switch + Solo + China Union Pay + Laser + Unknown + +"Not a credit card" is returned on obviously invalid data values. + +As of 0.30, cardtype() will accept a partial card masked with "x", "X', ".", +"*" or "_". Only the first 2-6 digits and the lenth are significant; +whitespace and dashes are removed. To recognize just Visa, MasterCard and +Amex, you only need the first two digits; to recognize almost all cards +except some Switch cards, you need the first four digits, and to recognize +all cards including the remaining Switch cards, you need the first six +digits. The generate_last_digit() subroutine computes and returns the last digit of the card given the preceding digits. With a 16-digit card, @@ -59,17 +68,44 @@ you provide the first 15 digits; the subroutine returns the sixteenth. This module does I tell you whether the number is on an actual card, only whether it might conceivably be on a real card. To verify -whether a card is real, or whether it's been stolen, or what its -balance is, you need a Merchant ID, which gives you access to credit -card databases. The Perl Journal (http://tpj.com/tpj) has -a Merchant ID so that I can accept MasterCard and VISA payments; it -comes with the little pushbutton/slide-your-card-through device you've -seen in restaurants and stores. That device calculates the checksum -for you, so I don't actually use this module. +whether a card is real, or whether it's been stolen, or to actually process +charges, you need a Merchant account. See L. These subroutines will also work if you provide the arguments as numbers instead of strings, e.g. C. +=head1 CHANGES IN 0.30 + +Credit card issuers have recently been forming agreements to process cards on +other networks, in which one type of card is processed as another card type. + +By default, Business::CreditCard returns the type the card should be treated as +in the US and Canada. You can change this to return the type the card should +be treated as in a different country by setting +C<$Business::OnlinePayment::Country> to your two-letter country code. This +is probably what you want to determine if you accept the card, or which +merchant agreement it is processed through. + +You can also set C<$Business::OnlinePayment::Country> to a false value such +as the empty string to return the "base" card type. This is probably only +useful for informational purposes when used along with the default type. + +Here are the currently known agreements: + +=over 4 + +=item Diner's club cards (starting with 36) are now identified as "MasterCard" inside the US and Canada. + +=item China Union Pay cards are identified as Discover cards outside China. + +=back + +=head1 NOTE ON INTENDED PURPOSE + +This module is for verifying I B. It is B a +pedantic implementation of the ISO 7812 standard, a general-purpose LUHN +implementation, or intended for use with "creditcard-like account numbers". + =head1 AUTHOR Jon Orwant @@ -81,6 +117,29 @@ orwant@tpj.com Current maintainer is Ivan Kohler . Please don't bother Jon with emails about this module. +Lee Lawrence , Neale Banks and +Max Becker contributed support for additional card +types. Lee also contributed a working test.pl. + +=head1 COPYRIGHT AND LICENSE + +Copyright (C) 1995,1996,1997 Jon Orwant +Copyright (C) 2001-2006 Ivan Kohler +Copyright (C) 2007 Freeside Internet Services, Inc. + +This library is free software; you can redistribute it and/or modify +it under the same terms as Perl itself, either Perl version 5.8.8 or, +at your option, any later version of Perl 5 you may have available. + +=head1 SEE ALSO + +L is a wrapper around Business::CreditCard +providing an OO interface. Assistance integrating this into the base +Business::CreditCard distribution is welcome. + +L is a framework for processing online payments +including modules for various payment gateways. + =cut @EXPORT = qw(cardtype validate generate_last_digit); @@ -88,41 +147,54 @@ Please don't bother Jon with emails about this module. sub cardtype { my ($number) = @_; - return "Not a credit card" if $number =~ /[^\d\s]/; + $number =~ s/[\s\-]//go; + $number =~ s/[x\*\.\_]/x/gio; - $number =~ s/\D//g; + return "Not a credit card" if $number =~ /[^\dx]/io; + + #$number =~ s/\D//g; return "Not a credit card" unless length($number) >= 13 && 0+$number; - return "VISA card" if $number =~ /^4\d{12}\d{3}?$/; - return "MasterCard" if $number =~ /^5[1-5]\d{14}$/; - return "Discover card" if $number =~ /^6011\d{12}$/; - return "American Express card" if $number =~ /^3[47]\d{13}/; + return "Switch" + if $number =~ /^49(03(0[2-9]|3[5-9])|11(0[1-2]|7[4-9]|8[1-2])|36[0-9]{2})[\dx]{10}([\dx]{2,3})?$/o + || $number =~ /^564182[\dx]{10}([\dx]{2,3})?$/o + || $number =~ /^6(3(33[0-4][0-9])|759[0-9]{2})[\dx]{10}([\dx]{2,3})?$/o; + + return "VISA card" if $number =~ /^4[\dx]{12}([\dx]{3})?$/o; + + return "MasterCard" + if $number =~ /^5[1-5][\dx]{14}$/o + || ( $number =~ /^36[\dx]{12}/ && $Country =~ /^(US|CA)$/oi ); + + return "Discover card" + if $number =~ /^6011[\dx]{12}$/o + || $number =~ /^65[\dx]{14}$/o + || ( $number =~ /^622[\dx]{13}$/o && $Country !~ /^(CN)$/oi ); + + return "American Express card" if $number =~ /^3[47][\dx]{13}$/o; + return "Diner's Club/Carte Blanche" - if $number =~ /^3(0[0-5]|[68]\d)\d{11}$/; - return "enRoute" if $number =~ /^2(014|149)\d{11}$/; - return "JCB" if $number =~ /^3\d{15}$/ - || $number =~ /^(2131|1800)\d{11}$/; - return "BankCard" if $number =~ /^56(10\d\d|022[1-5])\d{10}$/; + if $number =~ /^3(0[0-5]|[68][\dx])[\dx]{11}$/o; + + return "enRoute" if $number =~ /^2(014|149)[\dx]{11}$/o; + + return "JCB" if $number =~ /^(3[\dx]{4}|2131|1800)[\dx]{11}$/o; + + return "BankCard" if $number =~ /^56(10[\dx][\dx]|022[1-5])[\dx]{10}$/o; + + return "Solo" + if $number =~ /^6(3(34[5-9][0-9])|767[0-9]{2})[\dx]{10}([\dx]{2,3})?$/o; + + return "China Union Pay" + if $number =~ /^622[\dx]{13}$/o; + + return "Laser" + if $number =~ /^6(304|7(06|09|71))[\dx]{12,15}$/o; + return "Unknown"; } -# from http://perl.about.com/compute/perl/library/nosearch/P073000.htm -# Card Type Prefix Length -# MasterCard 51-55 16 -# VISA 4 13, 16 -# American Express (AMEX) 34, 37 15 -# Diners Club/Carte Blanche 300-305, 36, 38 14 -# enRoute 2014, 2149 15 -# Discover 6011 16 -# JCB 3 16 -# JCB 2131, 1800 15 -# -# from Neale Banks -# According to a booklet I have from Westpac (an Aussie bank), a card number -# starting with 5610 or 56022[1-5] is a BankCard -# BankCards have exactly 16 digits. - sub generate_last_digit { my ($number) = @_; my ($i, $sum, $weight);