ISurchargeListener (ChipDNA Mobile API)

public interface ISurchargeListener

This interface is used to receive notification when a surcharge decision is required during a transaction. Before calling ChipDnaMobile.startTransaction(Parameters) register this listener using ChipDnaMobile.addSurchargeListener(ISurchargeListener).

Author:: Creditcall Ltd.

Method Summary

Modifier and Type

Method

Description

void

onSurcharge(Parameters parameters)

Invoked when a surcharge decision is required.

Method Details
- onSurcharge
  
  void onSurcharge(Parameters parameters)
  
  Invoked when a surcharge decision is required.
  
  Parameters:
  
  parameters - Parameters collection which can contain:
  ParameterKeys.ResponseRequired indicating whether the integrating application needs to respond. When the value is ParameterValues.TRUE a call to ChipDnaMobile.continueSurcharge(Parameters) is required for the transaction to continue.
  
  ParameterKeys.SurchargeMaximumAmount the maximum surcharge amount in minor units ("0" when a surcharge is not possible for the card).
  
  ParameterKeys.SurchargeMaximumPercentage the maximum surcharge as a percentage ("0" when a surcharge is not possible for the card).
  
  ParameterKeys.SurchargeCurrency the currency code for the surcharge maxima; present only when a surcharge is possible (omitted otherwise).
  
  ParameterKeys.OperatorPinRequired contains value ParameterValues.TRUE if the Operator PIN is required.