Selectable Payment / Shipping / Handling Items 

title 

title

title
Type
string

Title of item, eg. “Master card” or “Ground mail” The title will be cloned, if markers like ###STATIC_COUNTRIES_CN_ISO_3### are used together with where.static_countries.

type 

type

type
Type
string
  • pick_store: pick it up from a store. The delivery address is filled from a selected store (see UIDstore)
  • nocopy: bill address will not be copied into the delivery address even if it has been left empty in the entry form.

mode 

mode

mode
Type
string

Possible payment options:

  • bank_transfer ... payment via account
  • credit_card
  • cash
  • PayPal
  • Saferpay
  • iPayment
  • Payone
  • ClickandBuy
  • vrepay
  • Authorize.net

image

image
Type
IMAGE cObject

Logo image for the item

price 

price

price
Type
double or array of integers see below for additional parameters

Price of item, including or excluding VAT, depends on TAXincluded. You use integers to specify the minimal number of items for which the price is valid. 6 items and more will cost 5.8 in this example.

Example:

use the subtitle for translations
30.price.type = count
30.price.1 = 4
30.price.6 = 5.8
Copied!

replaceTAXpercentage 

replaceTAXpercentage

replaceTAXpercentage
Type
double of integers

If set as double, the general TAXpercentage will be overridden by this value. You can alternatively use it as an array. You give the tax to replace on the left side, and the new tax value on the right side. This will replace all taxes of items of zero tax by a tax of 8% and it will replace all items of 14% with a tax of 2,5% instead. Use this to set different taxes for different countries.

Example:

replaceTAXpercentage depending on sum
30.replaceTAXpercentage {
    0 = 8
    14 = 2.5
}
Copied!

priceFactWeight 

priceFactWeight

priceFactWeight
Type
double

Will be added to price. The weight is multiplied with this factor to increase the shipping price.

priceFactCount 

priceFactCount

priceFactCount
Type
double

Will be added to price. The product's count is multiplied with this factor to increase the shipping price.

percentOfGoodstotal 

percentOfGoodstotal

percentOfGoodstotal
Type
double

Price of item, calculated from a percentage of the total amount before payment/ shipping

percentOfTotalShipping 

percentOfTotalShipping

percentOfTotalShipping
Type
double

If set the payment costs are calculated in the percentage of the total product tax price inclusive the shipping tax price.

creditcards 

creditcards

creditcards
Type
string

Comma separated list of allowed uids for the creditcards. See file localland_db.xml about the values. sys_products_cards.cc_type.I

  • 0: American Express
  • 1: Diners Club
  • 2: Mastercard
  • 3: Visa

creditcardSelect 

creditcardSelect

creditcardSelect
Type
array of form elements

If set, the month and year for the credit card are selectable from select boxes. Subvalues: mm (month) and yy (year)

Example:

replaceTAXpercentage depending on sum
creditcardSelect {
      mm {
        label = Month
        valueArray {
          10.label = 1
          10.value = 1
          20.label = 2
          20.value = 2
          30.label = 3
          30.value = 3
          40.label = 4
          40.value = 4
          50.label = 5
          50.value = 5
          60.label = 6
          60.value = 6
          70.label = 7
          70.value = 7
          80.label = 8
          80.value = 8
          90.label = 9
          90.value = 9
          100.label = 10
          100.value = 10
          110.label = 11
          110.value = 11
          120.label = 12
          120.value = 12
        }
      }

      yy {
        label = Year
        type = recs[creditcard][endtime_yy]=select
        valueArray {
          10.label = 2026
          10.value = 2027
          20.label = 2028
          20.value = 2029
          30.label = 2030
          30.value = 2031
          40.label = 2032
          40.value = 2033
      }
 }
Copied!

accounts 

accounts

accounts
Type
boolean

If set the payment with booking from the entered bank account will be allowed.

useAsterisk 

useAsterisk

useAsterisk
Type
int+
Default
1

If set then the account and credit data is replaced with asterisks after having been entered..

bulkilyAddition 

bulkilyAddition

bulkilyAddition
Type
int+
Default
1

Factor to multiply with a product which is bulkily

bulkilyFeeTax 

bulkilyFeeTax

bulkilyFeeTax
Type
int+

Tax fee in percent for shipping of bulkily

calculationScript 

calculationScript

calculationScript
Type
resource

PHP script which is included in a “blank” function and it should be written to manipulate amounts in the internal arrays. This script could be used to calculate a special fee regarding a payment/ shipping item. It is not recommended to use this feature. Write your own TYPO3 extension instead which is based on hooks. Properties of the calculation script is passed to the function as $confScript array. The resulting prices need to be written into the variables $priceShippingTax and $priceShippingNoTax.

handleScript 

handleScript

handleScript
Type
resource

PHP script which is included in a “blank” method called from products_basket() in user_products class when the order is finalized. This function must take care of displaying templates during the payment process with a payment gateway as well as finalizing the order afterwards. See payment_DIBS.php in jambagecom/addons-tt-products for an example. A HTML-template file follows. Properties of the handle script is passed to the function as $conf array. The content of the variable $content is returned as content.

handleLib 

handleLib

handleLib
Type
string / array

Name of the TYPO3 library to handle the Payment. Currently you can set only jambagecom/transactor here to use the Payment Transactor Library Extension.

array values: :typoscript:`extName`: name of the specific Payment Library (SPL) extension paymentMethod: method of the SPL (e.g. paymentlib_transcentral_cc_mastercard) :typoscript:`currency`: currency to use templateFile: template file for the display of the payment * gatewaymode: mode of the gateway (form / request)

Example:

transactor for Mastercard
40.title = Mastercard
40.handleLib = transactor
40.image.file = EXT:tt_products/res/icons/fe/mastercard.gif
40.handleLib {
    extName = transcentral
    paymentMethod = paymentlib_transcentral_cc_mastercard
    Currency = $
    templateFile = EXT:tt_products/template/paymentlib.tmpl
    gatewaymode = form
}
Copied!

handleURL 

handleURL

handleURL
Type
string

If set, this handleURL is called instead of the THANKS-url (by PIDthanks) in order to let eg. a handleScript process the information if payment by credit card or so.

handleTarget 

handleTarget

handleTarget
Type
string

Alternative target for the form.

excludePayment 

excludePayment

excludePayment
Type
string

This is a list of payment method keys (their numbers) which are not available given a certain delivery form. For instance if people pick up goods in the store, you don't want them to transfer money or pay online but just order the goods. So you can exclude those payment methods.

Example:

excludePayment for pickup in store
40.title = Pick up in store
40.excludePayment = 10,40
Copied!

excludeHandling 

excludeHandling

excludeHandling
Type
string

This is a list of handling method keys (their numbers) which are not available given a certain delivery form. For instance if people pick up goods in the store, you don't need a packaging for transport. So you can exclude those handling methods

Example:

excludePayment for pickup in store
40.title = Pick up in store
40.excludeHandling = 20,70
Copied!

replacePayment 

replacePayment

replacePayment
Type
list of integers

This is a list of payment settings which will be overridden if this shipping method has been selected.

Example:

excludePayment for pickup in store
40.title = China
40.replacePayment.10.title = Payment with China
40.replacePayment.10.price = 100
Copied!

show 

show

show
Type
boolean
Required

true

Default
1

If set, the item is shown in the list.

showLimit 

showLimit

showLimit
Type
double
Required

true

Default
0

If set, then this item will only get shown when there is at least this number of products in the basket.

  • 0: always show this item

type 

type

type
Type
string
Required

true

  • fe_users: the payment can be configured via the fe_users table

visibleForGroupID 

visibleForGroupID

visibleForGroupID
Type
string
Required

true

This payment method is only available, if a user is logged in and member of this front end user group

addRequiredInfoFields 

addRequiredInfoFields

addRequiredInfoFields
Type
string

Additional required fields in the INFO page, if this payment method is selected. Useful for credit card payment.

where_static_countries 

where_static_countries

where_static_countries
Type
string
Required

true

Set a SQL WHERE condition to follow for the selected country in the static_countries table of the sjbr/static-info-tables extension.

Example: .. code-block:: typoscript :caption: excludePayment for pickup in store

plugin.tt_products.shipping {
10.title = Parcel Germany 10.where.static_countries = cn_short_local = 'Deutschland' 10.price = 5.9 20.title = Parcel EU ###STATICCOUNTRIES_CN_SHORT_EN### 20.where.static_countries = cn_eu_member = 1 AND cn_short_local != 'Deutschland' 20.price = 8.9 30.title = Outside EU ###STATICCOUNTRIES_CN_SHORT_EN### 30.where.static_countries = cn_eu_member <> 1 30.price = 15

}