---
name: "Vend::Payment::Getitcard"
section: "3pm"
platform: "linux"
package: "interchange"
version: "5.7.7-2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/Vend::Payment::Getitcard"
---

# Vend::Payment::Getitcard(3pm)

Interchange Getitcard Support

## 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\>