ispaymentmessages Element

Syntax

<ispaymentmessages  payment-request = SalesforcePaymentRequest expression \\required
></ispaymentmessages>

Purpose

The <ispaymentmessages> tag injects <script> code tag injects <script> code that displays messages about the payment method. See dw.extensions.payments to configure the payment methods and to understand how they're rendered.

Rules of Use

This tag can appear multiple times on the same page with no limit to render payment messages for a product page or a cart page. Payment messages are only rendered when the site is configured to accept payment methods that support them. If a payment method doesn't support messages, they aren’t shown.

To use this element, you need access to the SalesforcePaymentRequest object.

This tag can't be used in a cached template because it's used to display the credit options for the payment method.

Example

In this example, <script> code is injected by <ispaymentmessages> to render messages associated with certain payment methods that are configured with Salesforce Payments on the site.

The ID of the component is “paymentrequest-<UUID>-messages” and the CSS class name where the component is to be rendered is “salesforce-payment-messages-element-<UUID>.” UUID is a randomly generated ID.

<isscript>
var UUIDUtils = require('dw/util/UUIDUtils');
var name = UUIDUtils.createUUID();

var messagesPaymentRequestId = 'paymentrequest-' + name + '-messages';
var messagesElementClass = 'salesforce-payment-messages-element-' + name;

var SalesforcePaymentRequest = require('dw/extensions/payments/SalesforcePaymentRequest');
var messagesPaymentRequest = new SalesforcePaymentRequest(messagesPaymentRequestId, '.' + messagesElementClass);
</isscript>