'supported_types' => [ qw( CC ECHECK ) ],
'token_support' => 0, #card storage/tokenization support
'test_transaction' => 0, #set true if ->test_transaction(1) works
+ 'partial_auth' => 0, #can gateway partial auth (new in 3.04)
'supported_actions' => [
'Normal Authorization',
'Authorization Only',
};
}
- # or a more complicated case:
+ # or a more complicated case with module_notes, different supported actions
+ # per type, and special void requirements:
sub _info {
{
'supported_types' => [ qw( CC ECHECK ) ],
'token_support' => 1,
'test_transaction' => 1,
+ 'partial_auth' => 1, #can gateway partial auth (new in 3.04)
'supported_actions' => { 'CC' => [
'Normal Authorization',
'Authorization Only',
'Post Authorization',
'Void',
'Credit',
+ 'Tokenize',
'Recurring Authorization',
'Modify Recurring Authorization',
'Cancel Recurring Authorization',
],
},
'CC_void_requires_card' => 1,
+ #? 'CC_reverse_auth_requires_txn_date' => 1,
'ECHECK_void_requires_account' => 1, #routing_code, account_number, name
};
}
Gateways will return one or two values from Authorization Only and
Normal Authorization transactions that must be submitted back with a
- Post Authorization, Void, or Credit transaction.
+ Post Authorization, Reverse Authorization, Void, or Credit transaction.
If the gateway returns one value, return this as "authorization"
is a unique tranaction id generated by the gateway.
+= txn_date (NEW IN 3.05) =
+
+ Some gateways return a transaction date from Authorization Only / Normal
+ Authorization transactions that must be submitted back for a follow-up
+ Post Authorization, Reverse Authorization, Void, or Credit transaction.
+
+ For the most compatibility with all gateways for follow-up transactions,
+ pass this as well as authorization and order number. Note this field is
+ a recent addition, so always access it like this:
+
+ my $txn_date = $bop_transaction_object->can('txn_date')
+ ? $bop_transaction_object->txn_date
+ : '';
+
+
= Moo (NEWLY DOCUMENTED IN 3.04) =
Feel free to write gateway modules which use Moo. Please do not require
- Declare this in your "sub _info" introspection subroutine:
'partial_auth' => 1,
- - Add "partial_auth_amount to your build_subs call in set_defaults, or add
+ - Add "partial_auth_amount" to your build_subs call in set_defaults, or add
one:
$self->build_subs('partial_auth_amount');
- Honor the transaction 'partial_auth' flag as follows:
+ If this transaction flag is unset, the application is not expecting to
handle a partial authorzation. So, either set the gateway flag disabling
- partial authorizations, or (if your gatweay does not have such a
+ partial authorizations, or (if your gateway does not have such a
setting), immediately void any partial authorization received and
return is_success 0.
+ If this transaction flag is set, the application can handle a partial
authorization. Make sure the flag to enable them is passed to the
- gateway, if necessary. When a partial authorization is received, the
- amount must be returned as "partial_auth_amount":
+ gateway, if necessary. When a partial authorization is received, return
+ is_success 1, and the amount as "partial_auth_amount":
$self->partial_auth_amount( $partial_amount );
For normal full authorizations, "partial_auth_amount" must not be set.