use constant CARD_TYPES => {
VI => 'Visa',
MC => 'MasterCard',
- AX => 'American Express',
+ AX => 'American Express', # FIXME: AM?
NN => 'Discover',
+ # JB?
};
$self->path('/process.cgi');
$self->build_subs(qw(
- receipt_number sales_order_number
- cardholder card_type
+ receipt_number order_number
+ card_type
total_amount
avs_response cvv2_response
));
}
+# OnlinePayment's get_fields now filters out undefs in 3.x. :(
+#
+sub get_fields {
+ my ($self, @fields) = @_;
+
+ my %content = $self->content;
+
+ my %new = map +($_ => $content{$_}), @fields;
+
+ return %new;
+}
+
# OnlinePayment's remap_fields is buggy, so we simply rewrite it
#
sub remap_fields {
$self->remap_fields(reverse %map);
my %data = $self->get_fields(keys %map);
- foreach (values %data) {
- $_ = '' unless defined;
- }
-
return %data;
}
# Convert a single product into a product string
#
sub prod_string {
- my ($self, $currency, $taxes, %data) = @_;
+ my ($self, $currency, %data) = @_;
croak "Missing amount in product" unless defined $data{amount};
my @flags = ($currency);
- $taxes = uc $data{taxes} if defined $data{taxes};
- foreach (split ' ' => $taxes) {
+ foreach (split ' ' => uc($data{taxes} || '')) {
croak "Unknown tax code $_" unless /^(GST|PST|HST)$/;
push @flags, $_;
}
croak 'Unsupported action'
unless $content{action} =~ /^Normal Authori[zs]ation$/i;
- $content{currency} ||= 'CAD';
- $content{currency} = uc $content{currency};
+ $content{currency} = uc($content{currency} || 'CAD');
croak "Unknown currency code ", $content{currency}
unless $content{currency} =~ /^(CAD|USD)$/;
- $content{taxes} ||= '';
- $content{taxes} = uc $content{taxes};
+ $content{taxes} = uc($content{taxes} || '');
my %data = $self->get_remap_fields(qw(
- xxxCardNumber card_number
+ xxxCard_Number card_number
xxxName name
xxxCompany company
$data{MerchantNumber} = $self->merchant_id;
- $data{xxxCardNumber} =~ tr/ //d;
+ $data{xxxCard_Number} =~ tr/ //d;
+ $data{xxxCard_Number} =~ s/^[0-36-9]/4/ if $self->test_transaction;
my ($y, $m) = $self->parse_expdate($content{exp_date});
$data{xxxCCYear} = sprintf '%.4u' => $y;
if (ref $content{description}) {
$data{Products} = join '|' => map $self->prod_string(
- $content{currency},
- $content{taxes},
- %$_),
- @{ $content{description} };
+ $content{currency},
+ taxes => $content{taxes},
+ %$_),
+ @{ $content{description} };
} else {
$self->required_fields(qw(amount));
$data{Products} = $self->prod_string(
$content{currency},
- $content{taxes},
- amount => $content{amount},
+ taxes => $content{taxes},
+ amount => $content{amount},
description => $content{description},
);
}
xml_out(\%data,
NoAttr => 1,
RootName => 'TranxRequest',
+ SuppressEmpty => undef,
XMLDecl => '<?xml version="1.0" encoding="utf-8" standalone="yes"?>',
);
}
$self->server_response($response);
- # (It's not quite clear whether there should be some decoding, or if
- # the result is already utf8.)
-
$response = xml_in($response,
ForceArray => [qw(product flag)],
GroupTags => { qw(Products product flags flag) },
$self->infuse($response, qw(
ReceiptNumber receipt_number
- SalesOrderNumber sales_order_number
- xxxName cardholder
+ SalesOrderNumber order_number
CardType card_type
Page result_code
ApprovalCode authorization
CVV2ResponseCode cvv2_response
));
+ # Completely undocumented field that sometimes override <Verbiage>
+ $self->error_message($response->{Error}) if $response->{Error};
+
$self->card_type(CARD_TYPES->{$self->card_type});
$self->{products_raw} = $response->{Products};
Business::OnlinePayment::InternetSecure is an implementation of
L<Business::OnlinePayment> that allows for processing online credit card
-payments through Internet Secure.
+payments through InternetSecure.
See L<Business::OnlinePayment> for more information about the generic
Business::OnlinePayment interface.
Object creation is done via L<Business::OnlinePayment>; see its manpage for
details. The I<merchant_id> processor option is required, and corresponds
-to the merchant ID assigned to you by Internet Secure.
+to the merchant ID assigned to you by InternetSecure.
=head1 METHODS
=item card_number (required)
-Credit card number. Any spaces will be removed.
+Credit card number. Spaces are allowed, and will be automatically removed.
=item exp_date (required)
-Credit card expiration date. Since L<Business::OnlinePayment> does not
-specify any syntax, this module is rather lax in what it will accept. It is
-recommended to use either I<YYYY-MM> or I<MM/YYYY>, to avoid any nasty
-surprises.
+Credit card expiration date. Since L<Business::OnlinePayment> does not specify
+any syntax, this module is rather lax regarding what it will accept. The
+recommended syntax is I<YYYY-MM>, but forms such as I<MM/YYYY> or I<MMYY> are
+allowed as well.
=item cvv2
Three- or four-digit verification code printed on the card. This can be left
blank or undefined, in which case no check will be performed. Whether or not a
-transaction will be declined in case of a mismatch depends on the merchant.
+transaction will be declined in case of a mismatch depends on the merchant
+account configuration.
This number may be called Card Verification Value (CVV2), Card Validation
-Code (CVC2) or Card Identification number (CID).
+Code (CVC2) or Card Identification number (CID), depending on the card issuer.
=item description
=item currency
Currency of all amounts for this order. This can currently be either
-C<CAN> (default) or C<USD>.
+C<CAD> (default) or C<USD>.
=item taxes
Taxes to be added automatically. These should not be included in B<amount>;
-they will be added by Internet Secure later on.
+they will be automatically added by InternetSecure later on.
-Available taxes are C<GST>, C<PST> and C<HST>; multiple taxes must be
-separated by spaces.
+Available taxes are C<GST>, C<PST> and C<HST>. Taxes can be combined by
+separating them with spaces, such as C<GST HST>.
=item name / company / address / city / state / zip / country / phone / email
-Facultative customer information. B<state> should be either a postal
-abbreviation or a two-letter code taken from ISO 3166-2, and B<country> should
-be a two-letter code taken from in ISO 3166-1.
+Customer information. B<Country> should be a two-letter code taken from ISO
+3166-1.
=back
=over 4
-=item receipt_number() / sales_order_number()
+=item receipt_number() / order_number()
Receipt number and sales order number of submitted order.
Total amount billed for this order, including taxes.
-=item cardholder()
-
-Cardholder's name. This is currently a mere copy of the B<name> field passed
-to B<submit()>.
-
=item card_type()
Type of the credit card used for the submitted order, being one of the
=item avs_response() / cvv2_response()
-Results of the AVS and CVV2 checks. See the Internet Secure documentation for
+Results of the AVS and CVV2 checks. See the InternetSecure documentation for
the list of possible values.
+=item products_raw()
+
+...
+
+
=back
=item quantity
-Ordered quantity of this product. This can be a decimal value.
+Ordered quantity of this product.
=item sku
be left undefined.
-=head2 Character encodings
-
-...
+=head2 Character encoding
+Since communication to/from InternetSecure is encoded with UTF-8, all Unicode
+characters are theoretically available when submitting information via
+B<submit()>. (Further restrictions may be imposed by InternetSecure itself.)
-=head2 products_raw
-
-...
+When using non-ASCII characters, all data provided to B<submit()> should either
+be in the current native encoding (typically latin-1, unless it was modified
+via the C<encoding> pragma), or be decoded via the C<Encode> module.
+Conversely, all data returned after calling B<submit()> will be automatically
+decoded.
=head1 EXPORT
=head1 AUTHOR
-Frederic Briere, E<lt>fbriere@fbriere.netE<gt>
+Frédéric Brière, E<lt>fbriere@fbriere.netE<gt>
=head1 COPYRIGHT AND LICENSE
-Copyright (C) 2004 by Frederic Briere
+Copyright (C) 2006 by Frédéric Brière
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.4 or,