Skip to main content
Beta. This module is feature-complete and code-reviewed but has not yet been verified against a live PrestaShop install. Test it thoroughly in your own staging environment before going live.
The Therius module for PrestaShop adds a Therius Payments option to checkout, mounting the Checkout Widget for card and alternative payment methods. Repository: therius-pay/therius-plugin-prestashop

​
Requirements

  • PrestaShop with admin access to install modules
  • A Therius account with API keys and a checkout configuration

​
Install

  1. Copy the therius-plugin-prestashop folder into your PrestaShop modules/ directory, named therius.
  2. In the PrestaShop admin, go to Modules → Module Manager, find Therius Payments, and click Install.

​
Configure

​
Webhooks

Configuring this is not optional. This checkout charges the card before the PrestaShop order exists — the order is normally created by the shopper’s browser posting back after payment. If that post never lands (closed tab, dropped connection), the payment.captured / payment.authorized webhook is the only way the store learns the charge happened and builds the missing order.
  1. In the Therius Dashboard, go to Developers → Webhooks and add an endpoint pointing at:
    Create one endpoint in Sandbox mode and one in Production mode if you use both.
  2. Subscribe to: payment.authorized, payment.captured, payment.refused, payment.refunded, payment.refund_failed, payment.cancelled, payment.chargeback, payment.capture_failed.
  3. Copy each environment’s signing secret into the matching Test Webhook Secret / Live Webhook Secret field.

​
Refunds

Issue a refund by creating a partial refund / credit slip on the order in the PrestaShop admin. The module sends the refund to Therius with an idempotency key so a retried request does not double-refund.

​
Known limitations

  • payment.chargeback is acknowledged but not mapped to an order-state change — PrestaShop has no built-in “on hold” state this module uses elsewhere. The event returns 200 and is otherwise ignored.
  • A webhook-recovered order can be priced from the cart’s current total, not the amount actually charged, if the cart’s contents change in the gap between the charge and the webhook delivery. This is rare but worth checking if a recovered order’s total does not match its payment amount.