1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
package FS::payinfo_transaction_Mixin;
use strict;
use vars qw( @ISA );
use FS::payby;
use FS::payinfo_Mixin;
use FS::Record qw(qsearchs);
use FS::cust_main;
use FS::payment_gateway;
@ISA = qw( FS::payinfo_Mixin );
=head1 NAME
FS::payinfo_transaction_Mixin - Mixin class for records in tables that represent transactions.
=head1 SYNOPSIS
package FS::some_table;
use vars qw(@ISA);
@ISA = qw( FS::payinfo_transaction_Mixin FS::Record );
=head1 DESCRIPTION
This is a mixin class for records that represent transactions: that contain
payinfo and realtime result fields (gatewaynum, processor, authorization,
order_number). Currently FS::cust_pay, FS::cust_refund, and FS::cust_pay_void.
=head1 METHODS
=over 4
=item cust_main
Returns the parent customer object (see L<FS::cust_main>).
=cut
sub cust_main {
my $self = shift;
qsearchs( 'cust_main', { 'custnum' => $self->custnum } );
}
=item payby_name
Returns a name for the payby field.
=cut
sub payby_name {
my $self = shift;
if ( $self->payby eq 'BILL' ) { #kludge
'Check';
} else {
FS::payby->shortname( $self->payby );
}
}
# We keep _parse_paybatch just because the upgrade needs it.
sub _parse_paybatch {
my $self = shift;
$self->paybatch =~ /^((\d+)\-)?(\w+):\s*([\w\-\/ ]*)(:([\w\-]+))?$/
or return {};
#"Can't parse paybatch for paynum $options{'paynum'}: ".
# $cust_pay->paybatch;
my( $gatewaynum, $processor, $auth, $order_number ) = ( $2, $3, $4, $6 );
if ( $gatewaynum ) { #gateway for the payment to be refunded
my $payment_gateway =
qsearchs('payment_gateway', { 'gatewaynum' => $gatewaynum } );
$processor = $payment_gateway->gateway_module if $payment_gateway;
}
{
'gatewaynum' => $gatewaynum,
'processor' => $processor,
'authorization' => $auth,
'order_number' => $order_number,
};
}
# because we can't actually name the field 'authorization' (reserved word)
sub authorization {
my $self = shift;
$self->auth(@_);
}
=item payinfo_check
Checks the validity of the realtime payment fields (gatewaynum, processor,
auth, and order_number) as well as payby and payinfo
=cut
sub payinfo_check {
my $self = shift;
# All of these can be null, so in principle this could go in payinfo_Mixin.
$self->SUPER::payinfo_check()
|| $self->ut_numbern('gatewaynum')
# not ut_foreign_keyn, it causes upgrades to fail
|| $self->ut_alphan('processor')
|| $self->ut_textn('auth')
|| $self->ut_textn('order_number')
|| '';
}
=back
=head1 SEE ALSO
L<FS::payinfo_Mixin>
=cut
1;
|