setMessage()

Sets the content of the hidden label inside the iFrame. Content of the label will be used by assistive technology applications and devices.

This function supports the Multiple Hosted Session functionality.

Usage

PaymentSession.setMessage(<HostedFieldRole>, message, [scope])

Example

PaymentSession.setMessage('card.number', 'Invalid card number, please check your card number');

Arguments

<HostedFieldRole> String COMPULSORY

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

message String OPTIONAL

The message to be sent to hosted field and used as a hidden label.

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