X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=FS%2FFS%2Fcust_pay_void.pm;h=86fbbe5abbe50dd3c8ab152318f9989e34a407c3;hb=f8b62efe57d6b2c7d1d5a6514fb78d3fcdbbb6cf;hp=6437163add1b640b815061f2bd1b2d53e25f6ecb;hpb=cccd0b7cd38a88c131e19981be38434f87abe194;p=freeside.git diff --git a/FS/FS/cust_pay_void.pm b/FS/FS/cust_pay_void.pm index 6437163ad..86fbbe5ab 100644 --- a/FS/FS/cust_pay_void.pm +++ b/FS/FS/cust_pay_void.pm @@ -1,15 +1,19 @@ package FS::cust_pay_void; use strict; -use vars qw( @ISA ); +use vars qw( @ISA @encrypted_fields ); use Business::CreditCard; use FS::UID qw(getotaker); -use FS::Record qw(qsearchs); # dbh qsearch ); +use FS::Record qw(qsearchs dbh fields); # qsearch ); +use FS::cust_pay; #use FS::cust_bill; #use FS::cust_bill_pay; #use FS::cust_pay_refund; #use FS::cust_main; +use FS::cust_pkg; -@ISA = qw( FS::Record ); +@ISA = qw( FS::Record FS::payinfo_Mixin ); + +@encrypted_fields = ('payinfo'); =head1 NAME @@ -37,24 +41,44 @@ are currently supported: =over 4 -=item paynum - primary key (assigned automatically for new payments) +=item paynum + +primary key (assigned automatically for new payments) + +=item custnum + +customer (see L) -=item custnum - customer (see L) +=item paid -=item paid - Amount of this payment +Amount of this payment -=item _date - specified as a UNIX timestamp; see L. Also see +=item _date + +specified as a UNIX timestamp; see L. Also see L and L for conversion functions. -=item payby - `CARD' (credit cards), `CHEK' (electronic check/ACH), +=item payby + +`CARD' (credit cards), `CHEK' (electronic check/ACH), `LECB' (phone bill billing), `BILL' (billing), `CASH' (cash), -`WEST' (Western Union) or `COMP' (free) +`WEST' (Western Union), `MCRD' (Manual credit card), or `COMP' (free) + +=item payinfo + +card number, check #, or comp issuer (4-8 lowercase alphanumerics; think username), respectively -=item payinfo - card number, check #, or comp issuer (4-8 lowercase alphanumerics; think username), respectively +=item paybatch -=item paybatch - text field for tracking card processing +text field for tracking card processing -=item closed - books closed flag, empty or `Y' +=item closed + +books closed flag, empty or `Y' + +=item pkgnum + +Desired pkgnum when using experimental package balances. =item void_date @@ -78,16 +102,53 @@ sub table { 'cust_pay_void'; } Adds this voided payment to the database. -=item delete +=item unvoid -Currently unimplemented. +"Un-void"s this payment: Deletes the voided payment from the database and adds +back a normal payment. =cut -sub delete { - return "Can't delete voided payments!"; +sub unvoid { + my $self = shift; + + local $SIG{HUP} = 'IGNORE'; + local $SIG{INT} = 'IGNORE'; + local $SIG{QUIT} = 'IGNORE'; + local $SIG{TERM} = 'IGNORE'; + local $SIG{TSTP} = 'IGNORE'; + local $SIG{PIPE} = 'IGNORE'; + + my $oldAutoCommit = $FS::UID::AutoCommit; + local $FS::UID::AutoCommit = 0; + my $dbh = dbh; + + my $cust_pay = new FS::cust_pay ( { + map { $_ => $self->get($_) } fields('cust_pay') + } ); + my $error = $cust_pay->insert; + if ( $error ) { + $dbh->rollback if $oldAutoCommit; + return $error; + } + + $error = $self->delete; + if ( $error ) { + $dbh->rollback if $oldAutoCommit; + return $error; + } + + $dbh->commit or die $dbh->errstr if $oldAutoCommit; + + ''; + } +=item delete + +Deletes this voided payment. You probably don't want to use this directly; see +the B method to add the original payment back. + =item replace OLD_RECORD Currently unimplemented. @@ -116,6 +177,7 @@ sub check { || $self->ut_number('_date') || $self->ut_textn('paybatch') || $self->ut_enum('closed', [ '', 'Y' ]) + || $self->ut_foreign_keyn('pkgnum', 'cust_pkg', 'pkgnum') || $self->ut_numbern('void_date') || $self->ut_textn('reason') ; @@ -129,7 +191,7 @@ sub check { $self->void_date(time) unless $self->void_date; - $self->payby =~ /^(CARD|CHEK|LECB|BILL|COMP|PREP|CASH|WEST)$/ + $self->payby =~ /^(CARD|CHEK|LECB|BILL|COMP|PREP|CASH|WEST|MCRD)$/ or return "Illegal payby"; $self->payby($1); @@ -169,19 +231,6 @@ sub cust_main { qsearchs( 'cust_main', { 'custnum' => $self->custnum } ); } -=item payinfo_masked - -Returns a "masked" payinfo field with all but the last four characters replaced -by 'x'es. Useful for displaying credit cards. - -=cut - -sub payinfo_masked { - my $self = shift; - my $payinfo = $self->payinfo; - 'x'x(length($payinfo)-4). substr($payinfo,(length($payinfo)-4)); -} - =back =head1 BUGS