Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Form template using Comercia's lightbox payment.
  • Teaser template using Comercia's lightbox payment.
  • Teaser template using Comercia's basic payment.
  • Basic order management. (Content app coming soon!)
  • Easy configuration of Comercia's payment gateway.
  • Demo pages for selling tours using a purchase form.
  • Demo pages for selling tour guides.

Git

https://git.magnolia-cms.com/projects/SERVICES/repos/comercia-connector-module/browse

Installation

You can install the Comercia connector module by either: 

...

Warning
titleDependencies

Installing the pre-built jar requires to also get the realex dependencies. Maven is the easiest way to get them with dependency:copy-dependencies plugin. A bundle zip will be coming soon to avoid this additional step.


Configuration

The module is very easy to configure. You just need to go to the module's config:

...

  • account: Name of Comercia's account. "hpp" is the only currently supported.
  • formUrl: URL of Comercia's server. For example, use this for test server: "https://hpp.sandbox.addonpayments.com/pay", and this for production server: "https://hpp.addonpayments.com/pay".
  • merchantId: The client id you received in Comercia's addon payment registration.
  • responseUrl: The full URL of the module's servlet for order callbacks. The URL has the form: http(s)://[ip or domain]:[port]/[contextpath]/comercia/json-response. For example: http://mydomain.com/magnoliaPublic/comercia/json-response
  • secret: The shared secret you received in Comercia's addon payment registration.

Form component template

This component template can be used in guided sells which are composed of several form steps (using Magnolia's form module).

...

  • Checkout text: The checkout button label.
  • Target Page: The page to be shown after the payment is done.
  • Currency: The currency for the order.
  • Button id: HTML id of the checkout button.
  • Lightbox z-index: A custom z-index for the lightbox shown by Commercia.
  • Back button text: The back button label.

Teaser component template

This component template can be used in any page to sell a product with a fixed price. It extends the standard Magnolia's teaser component.

...

  • Target Page: The page to be shown after the payment is done.
  • Price: The proce of the product to be sold.
  • Currency: The currency for the order.

Download teaser component template

This component template can be used inside the target page of the previous components in case the order includes a download link after the purchase.

...

  • comercia-connector-module:components/comercia-download-teaser

Demo pages

The guided sell is shown through the following form pages:

...

  • /travel/comercia-download-thank-you

Support

You can review and report issues in the JIRA project.