Vend::Payment::Getitcard(3) 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) <[email protected]>

Jure Kodzoman (Yure) <[email protected]>

LAST SEARCHED