Overview

The Praxis Payment Page is the fastest and most secure way to integrate payments, offering a seamless checkout experience to your customers via IFrame or full-page redirect. It is a fully hosted solution that takes care of PCI compliance, 3DS authentication, allowing merchants to focus on growing their business.

Key Features:

Seamless Integration – Reduce development effort while benefiting from a flexible payment flow inside an IFrame or redirect page.
Multi-Payment Support – Accept cards, alternative payment methods (APMs), and local payment solutions through a single integration.
Localized User Experience – Automatically adapts to customers' preferred language, currency, and previously used payment methods.
Built-in Security & Compliance – Fully PCI-DSS compliant with secure handling of sensitive payment data.
Customizable UI – Modify the look and feel of the payment page, including branding and layout, to match your business needs.

For merchants who want a ready-to-use payment solution without the complexity of handling security and compliance, the Praxis Payment Page is the perfect choice.

Integrating Cashier

You can either redirect customers to the Cashier page or embed it in an iframe on your website. Cashier automatically handles authentication, payment method presentation, and PCI compliance, so you don’t have to process card details directly.

Below are the steps to integrate Cashier into your website:

1. Create a Cashier Payment Session

Initiate a Cashier Payment request to generate a redirect_url that the customer can use to access the Cashier UI.

You can then:

Redirect the customer to the redirect_url.
Embed it in an iframe on your payment page using the redirect_url as the src.

Important: This must be done from a browser so required headers like Origin and Referer are included for request validation.

Optional: Include a validation_url when creating the session. This will trigger a validation webhook after the customer submits their payment details (before the transaction is processed).

2. Validate Payment Details

The customer interacts with the Cashier UI to select a payment method and submit their payment details.

If a validation_url was provided in step 1, Cashier immediately sends a validation webhook to your server. This allows your system to approve or reject the submission based on business logic before the transaction is processed.

Validation rules:

Triggered only if validation_url was provided in the session request.
"status": 0 → validation successful; payment proceeds.
Any other status → validation failed; the "description" field is shown to the customer as the reason.
Timeout or malformed responses (missing fields, incorrect types, non-JSON, or invalid JSON object) → validation failure with a generic error message.

3. Complete the Transaction and Receive Notification

After validation is successful, the payment is processed by Cashier.

After payment is processed:

Cashier sends a transaction outcome notification to your server. Use this to update order status or trigger business logic.
The customer is redirected to your return_url, where you can display a confirmation page or show the payment outcome.

Recommended Cashier Iframe Dimensions for Desktop

If you plan to embed the Cashier iframe on your website instead of opening it in a new window or full page, use the following recommended dimensions to ensure a seamless display without scrolling.

Width is fixed, while height may vary depending on additional fields.
The values below are based on a Deposit by Card setup with a predefined set of static fields.

Cashier Theme	Width	Height
Dark	922	643
Mosaic	710	727
Panoramic	800	725
Table	620	920
Tiles	620	810
PowerSlide	600	800

Hosted Payment Page (Cashier)

Overview

Integrating Cashier

Recommended Cashier Iframe Dimensions for Desktop

Demo