require 5.005;
-$VERSION = '3.04_01';
+$VERSION = '3.05';
$VERSION = eval $VERSION; # modperlstyle: convert the string into a number
# Remember subclasses we have "wrapped" submit() with _pre_submit()
failure_status
fraud_detect
is_success
+ partial_auth_amount
maximum_risk
path
port
response_page
avs_code
cvv2_response
+ txn_date
);
__PACKAGE__->build_subs(@methods);
=item Credit
+=item Tokenize
+
=item Recurring Authorization
=item Modify Recurring Authorization
=over 4
+=item partial_auth
+
+If you are prepared to handle partial authorizations
+(see L<partial_auth_amount()|/"partial_auth_amount()">
+ in L<TRANSACTION RESULT FIELDS|/"TRANSACTION RESULT FIELDS">),
+pass a true value in this field to enable them.
+
+If this flag is not set, a partial authorization will be immediately reversed
+or voided.
+
=item description
A description of the transaction (used by some processors to send
Account type. Can be (case-insensitive): B<Personal Checking>,
B<Personal Savings>, B<Business Checking> or B<Business Savings>.
+=item nacha_sec_code
+
+NACHA SEC Code for US ACH transactions. 'PPD' indicates customer signed a form
+giving authorization for the charge, 'CCD' same for a business checking/savings
+account, 'WEB' for online transactions where a box was checked authorizing the
+charge, and 'TEL' for authorization via recorded phone call (NACHA script
+required).
+
=item account_name
Account holder's name.
=back
+=head3 FOLLOW-UP TRANSACTION FIELDS
+
+These fields are used in follow-up transactions related to an original
+transaction (Post Authorization, Reverse Authorization, Void, Credit).
+
+=over 4
+
+=item authorization
+
+=item order_number
+
+=item txn_date
+
+=back
+
=head3 RECURRING BILLING FIELDS
=over 4
it was submitted but not approved, or undef if it has not been
submitted yet.
+=head2 partial_auth_amount()
+
+If this transaction was a partial authorization (i.e. successful, but less than
+the requested amount was processed), then the amount processed is returned in
+this field.
+
+(When is_success is true but this field is empty or 0, that indicates a normal
+full authorization for the entire requested amount.)
+
=head2 error_message()
If the transaction has been submitted but was not accepted, this
If supported by your gateway, a card_token can be used in a subsequent
transaction to refer to a card number.
+=head2 txn_date()
+
+Transaction date, as returned by the gateway. Required by some gateways
+for follow-up transactions. Store this if you would like to run inquiries or
+refunds on the transaction later.
+
=head2 fraud_score()
Retrieve or change the fraud score from any Business::FraudDetect plugin
=head2 silly_bool( $value )
-Returns 0 if the value starts with y, Y, t or T.
-Returns 1 if the value starts with n, N, f or F.
+Returns 1 if the value starts with y, Y, t or T.
+Returns 0 if the value starts with n, N, f or F.
Otherwise returns the value itself.
Use this for handling boolean content like tax_exempt.
Copyright (c) 1999-2004 Jason Kohles
Copyright (c) 2004 Ivan Kohler
-Copyright (c) 2007-2015 Freeside Internet Services, Inc.
+Copyright (c) 2007-2018 Freeside Internet Services, Inc.
All rights reserved.
=head1 MAILING LIST
Please direct current development questions, patches, etc. to the mailing list:
-http://420.am/cgi-bin/mailman/listinfo/bop-devel/
+http://mail.freeside.biz/cgi-bin/mailman/listinfo/bop-devel/
=head1 REPOSITORY
Or on the web:
- http://freeside.biz/gitweb/?p=Business-OnlinePayment.git
+ http://git.freeside.biz/gitweb/?p=Business-OnlinePayment.git
Or:
- http://freeside.biz/gitlist/Business-OnlinePayment.git
+ http://git.freeside.biz/cgit/Business-OnlinePayment.git
Many (but by no means all!) processor plugins are also available in the same
repository, see:
- http://freeside.biz/gitweb/
+ http://git.freeside.biz/gitweb/
Or:
- http://freeside.biz/gitlist/
+ http://git.freeside.biz/cgit/
=head1 DISCLAIMER