Vend::Payment::Getitcard(3pm)
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:
- o Make sure you "Require"d the module in interchange.cfg:
Require module Vend::Payment::Getitcard - o Check the error logs, both catalog and global.
- o Make sure you have all the necessary parameters (you can consult
- getitcard docs).
- o Make sure you set your payment parameters properly.
- o 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>