Masterpass Payment

Checkout Masterpass Payment

Integrate the Masterpass digital wallet into your checkout. The flow covers both the standard Masterpass integration and the Masterpass REST variant, including BIN lookup, installment selection, order number assignment, remote installment options, reward selection, and payment completion.

Authentication

These endpoints support both authenticated and anonymous sessions.

• Authenticated users: Session cookie (sessionid) tracks checkout progress.

• Anonymous users: Guest checkout is available when the CAN_GUEST_PURCHASE setting is enabled.

Request Format

Include the following header in all checkout requests:

• x-requested-with: XMLHttpRequest

Dynamic Settings

The following settings are managed at runtime through the admin interface and do not require a server restart.

THREE_D_SECURE_ENABLED

Master switch for 3D Secure verification. When disabled, 3D Secure is skipped regardless of other rules.

THREE_D_SECURE_RULES

Rule-based conditions that determine when 3D Secure is required. When enabled, an amount-based rule is available specifically for Masterpass transactions.

INSTALLMENT_FILTERS

Filters that restrict which installment options are presented. Applied during both standard and REST installment selection.

Static Settings

The following settings are configured in the server environment and require a restart to take effect.

DEFAULT_CARD_SLUG

Fallback card identifier used when a BIN number lookup returns no match. Defaults to other.