setFocus()

Instructs the specified hosted field in the iFrame to gain focus.

This function supports the Multiple Hosted Session functionality.

Usage

PaymentSession.setFocus(<HostedFieldRole>, [scope])

Example

PaymentSession.setFocus('card.number');

Arguments

<HostedFieldRole> String COMPULSORY

The field role for the card field rendered in an iFrame and hosted on the CommWeb payment gateway. Valid field roles: 'card.number', 'card.expiryMonth', 'card.expiryYear', 'card.securityCode', 'giftCard.number', 'giftCard.pin', 'ach.bankAccountNumber', 'ach.bankAccountNumberConfirmation', 'ach.bankAccountHolder', 'ach.routingNumber','directDebitCanada.bankAccountNumberConfirmation', 'directDebitCanada.bankAccountHolder', 'directDebitCanada.bankAccountNumber', 'directDebitCanada.financialInstitutionNumber', 'directDebitCanada.transitNumber'

scope String OPTIONAL

The optional named instance of a card payment data set within a session. See Multiple Hosted Sessions for more information.

Return Value

None