NAME¶
Vend::Payment::Getitcard - Interchange Getitcard Support
SYNOPSIS¶
&charge=getitcard
or
[charge gateway=getitcard param1=value1 param2=value2]
PREREQUISITES¶
Digest::SHA
Net::SSLeay or LWP::UserAgent and Crypt::SSLeay
DESCRIPTION¶
This module adds support for purchases with prepaid cards issued by Getitcard
(
http://www.getitcard.com/).
The Vend::Payment::Getitcard module implements the
getitcard() routine
for use with Interchange. It is compatible on a call level with the other
Interchange payment modules.
To enable this module, place this directive in "interchange.cfg":
Require module Vend::Payment::Getitcard
This
must be in interchange.cfg or a file included from it.
Make sure CreditCardAuto is off (default in Interchange demos).
The mode can be named anything, but the "gateway" parameter must be
set to "getitcard". To make it the default payment gateway for all
credit card transactions in a specific catalog, you can set in
"catalog.cfg":
Variable MV_PAYMENT_MODE getitcard
It uses several of the standard settings from Interchange payment. Any time we
speak of a setting, it is obtained either first from the tag/call options,
then from an Interchange order Route named for the mode, then finally a
default global payment variable, For example, the "id" parameter
would be specified by:
[charge mode=getitcard id=YourGetitcardID]
or
Route getitcard id YourGetitcardID
or
Variable MV_PAYMENT_ID YourGetitcardID
Required settings are "id".
The active settings are:
- host
- Your Getitcard payment gateway host. Usually
secure.getitcard.com.
- secure
- MD5 checksum required for valid transactions.
- id
- Store number assigned to your merchant account.
- transaction
- The type of transaction to be run. Valid values are:
Interchange Getitcard
---------------- -----------------
auth authorize
sale authorize + commit (inside authorize step)
settle commit
void cancel
Default is "sale".
- order_id
- Getitcard unique transact (transaction number), you receive
as authorize result.
- order_number
- Interchange unique order_id, sent to Getitcard on all
transactions
Troubleshooting¶
If nothing works:
- •
- Make sure you "Require"d the module in
interchange.cfg:
Require module Vend::Payment::Getitcard
- •
- Check the error logs, both catalog and global.
- •
- Make sure you have all the necessary parameters (you can
consult getitcard docs).
- •
- Make sure you set your payment parameters properly.
- •
- Try an order, then put this code in a page:
<XMP>
[calc]
my $string = $Tag->uneval( { ref => $Session->{payment_result} });
$string =~ s/{/{\n/;
$string =~ s/,/,\n/g;
return $string;
[/calc]
</XMP>
That should show what happened.
EXAMPLES¶
This examples should work if you provide a valid card number, and set variables
MV_PAYMENT_ID, MV_PAYMENT_SECRET and MV_PAYMENT_CURRENCY.
Sale¶
[calc]$CGI->{mv_credit_card_number}='0123456789123456'[/calc]
[charge gateway=getitcard amount=12]
Authorize¶
[calc]$CGI->{mv_credit_card_number}='0123456789123456'[/calc]
[charge gateway=getitcard transaction=authorize amount=123]
Cancel¶
[charge gateway=getitcard transaction=cancel order_id=12345 order_number=123456]
Commit¶
[charge gateway=getitcard transaction=commit order_id=12345 order_number=123456]
AUTHORS¶
Stefan Hornburg (Racke) <racke@linuxia.de>
Jure Kodzoman (Yure) <jure@tenalt.com>