Class PaymentSettings


  • public final class PaymentSettings
    extends java.lang.Object
    This class contains the Payment Settings public APIs.
    • Constructor Detail

      • PaymentSettings

        public PaymentSettings()
    • Method Detail

      • setDisableDeactivationOnPosDisconnect

        @Deprecated
        public static void setDisableDeactivationOnPosDisconnect​(boolean isdisableDeactivationOnPosDisconnect)
        Deprecated.
        This method is to enable the feature do not deactivate SDK when POS restart transaction
      • getDisableDeactivationOnPosDisconnect

        @Deprecated
        public static byte getDisableDeactivationOnPosDisconnect()
        Deprecated.
        Get the value of property set in the file
        Returns:
        property byte value
      • setPURERefundTransactionCompletionWithoutGenAC

        public static void setPURERefundTransactionCompletionWithoutGenAC​(boolean enabled)
        This method is to enable PURE refund transaction completion without GenerateAC command. SDK recognize the transaction as completed after read records if:
        • This configuration is enabled with 'true'.
        • The transaction is performed on PURE, and transaction type is REFUND '0x20'
        • All the required Read Record command has been completed, according to what is returned in GPO command AFL.
        Since:
        6.7.1
      • isPURERefundTransactionCompletionWithoutGenAC

        public static boolean isPURERefundTransactionCompletionWithoutGenAC()
        Get the configuration if PURE refund transaction can be completed without GenerateAC.
        Returns:
        property boolean value
        Since:
        6.7.1
      • setTransactionRetryLimit

        public static void setTransactionRetryLimit​(int maxRetryLimit)
        Allows setting maximum number of retries for a contactless payment transaction performed by a POS if the connection is interrupted. In other words the maxRetryLimit defines how many times the onDeactivated() callback from system indicating break up of NFC connection will be tolerated by the SDK (but signaled by ContactlessPaymentServiceListener.onTransactionInterrupted(int, String, int)) before calling onError with POS_COMM_DISCONNECTED. Default value is 0 and it means that SDK will signal POS_COMM_DISCONNECTED error right after the first occurrence.
        Parameters:
        maxRetryLimit - Value between 0 and 10. Default value is 0.
        Since:
        6.7.0
      • setTransactionRetryTimeout

        public static void setTransactionRetryTimeout​(long retryTimeout)
        Defines a timeout period for a transaction retry by POS. If the transaction retry does not progress (APDU resent by POS) within this interval then onError() callback will be hit.
        Parameters:
        retryTimeout - A value between 500 and 10000 in ms. Default value is 2000.
        Since:
        6.7.0
      • setApduSuspendTimeout

        public static void setApduSuspendTimeout​(long apduSuspendTimeout)
        Defines a timeout period for a APDU processing suspend. When application is integrated with AsyncHCEService, the SDK suspends APDU processing when SDK requests for authentication until authentication is performed, aborted or payment is deactivated. To avoid potential blocking of APDU processing, SDK has defined a timeout for the APDU processing suspension. APDU processing is resumed regardless of the authentication action at the end of the timeout. This could prevent infinite suspension of APDU processing in case application failed to display prompt to the end user for authentication. This timeout must be carefully chosen by the application. It is recommended to be as short as possible and at the same time sufficient for the end user to withdraw the mobile device from the POS after a tap.
        Parameters:
        apduSuspendTimeout - A value provided in milli-seconds. Default value is 5000 (5 Seconds) if not configured.
        Since:
        6.7.2