DebitSurcharge Property

Extra amount the merchant charges the customer for using a debit card.

Syntax

 ptechcanadiandebit.getDebitSurcharge([callback])
 ptechcanadiandebit.setDebitSurcharge( debitSurcharge, [callback])

Default Value

""

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getDebitSurcharge([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setDebitSurcharge([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

Surcharging in Canada is optional at the point of sale terminal device. The amount of the surcharge is defined at the Point of Sale (POS) and must be accepted by the cardholder prior to the transaction being processed. If the DebitSurcharge property contains a value, the surcharge amount will be logged to the transaction record on the Host. The Surcharge Amount must be included as part of the transaction amount. Regulations require that this fee amount print on the receipt and be clearly labeled as "TERMINAL FEE" or "FRAIS D'OPER." For example:

In this case, the receipt would read:

SALE          $10.00 
CASH BACK     $ 5.00 
TERMINAL FEE  $  .50 
TOTAL CHARGED $15.50 

Data Type

String