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.

PaymentSession.setMessage(HostedFieldRole, message, scope)

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

HostedFieldRole String REQUIRED

The field role for the card field rendered in an iFrame and hosted on the CommWeb 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

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

scope String

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

None