> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/unzer-hpp-for-phoca-cart/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/unzer-hpp-for-phoca-cart/getting-started.md).

# Getting started

A payment plugin integrating Unzer Hosted Payment Page (HPP) with the Phoca Cart e-commerce extension for Joomla.

Enhance your Phoca Cart online store with the **Unzer Hosted Payment Page (HPP) payment plugin**, allowing you to accept secure online payments through an extensive mix of payment methods supported by Unzer.

Enabling **Unzer** allows merchants to offer greater flexibility at checkout, catering to diverse customer preferences across Europe and globally. This leads to higher conversion rates, reduced cart abandonment, and improved customer satisfaction by supporting a wide variety of local and international payment methods, including credit/debit cards, PayPal, Klarna, SEPA Direct Debit, Sofort, and more.

The **Hosted Payment Page (HPP)** is a ready-made, secure checkout page hosted on Unzer's PCI DSS Level 1 certified infrastructure. When a customer selects Unzer and proceeds to payment in Phoca Cart, they are redirected to the Hosted Payment Page to finalize their transaction. Once the payment is complete, the customer is redirected back to your shop, and the order status is updated automatically via server-to-server webhook notifications.

For more information about the plugin, visit the [product page](https://norrnext.com/ecommerce/phoca-cart/unzer-hpp-for-phoca-cart).

### Key Features

* **Unzer HPP V2 Paypage Integration** — Secure redirection to Unzer's modern hosted payment interface.
* **Full Payment Methods Mix** — Accept Credit/Debit Cards, PayPal, Klarna, SEPA Direct Debit, and regional European payment methods configured in your Unzer account.
* **Complete Basket Synchronization** — Sends detailed order items including product titles, variants/attributes, quantities, unit prices, VAT rates, product images, shipping costs, payment fees, discounts, and automatic rounding adjustment.
* **Digital & Physical Goods** — Automatically distinguishes between physical products and digital downloads.
* **Customer & Address Preloading** — Automatically creates Unzer customer resources and sends billing and shipping addresses (required for secured payment methods such as Klarna, Invoice, and Direct Debit Secured).
* **Multiple Checkout Types** — Supports *Full*, *Payment Only*, and *No Shipping* modes to accommodate both tangible goods and digital products/services.
* **Automated Webhooks** — Webhook endpoints are automatically registered with Unzer via API upon first transaction, with signature and public key validation.
* **Customizable Checkout Design** — Full control over payment page styling directly in Phoca Cart: upload logos, favicons, background images, and configure colors, fonts, and corner radius to match your brand identity.
* **Modern Joomla Architecture** — Strict typing, PSR-12 standard, native Joomla 5.4+ / 6.x Dependency Injection container service architecture.

### System Requirements

| Minimum        | Recommended     |
| -------------- | --------------- |
| Joomla 5.4     | Joomla 6.1+     |
| Phoca Cart 6.0 | Phoca Cart 6.1+ |
| PHP 8.2        | PHP 8.3+        |

{% hint style="warning" %}
Your site must have a valid SSL certificate (TLS 1.2 or higher) enabled to ensure that customer data is securely transmitted and that Unzer server-to-server webhook notifications can be received over HTTPS.
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=NxRDh7jMtgI>" %}