VibeFox Yoco for PrestaShop

Overview

VibeFox Yoco Pay Gateway adds card and Instant EFT payments in South African rand (ZAR) to PrestaShop through the Yoco Checkout API. At the payment step the customer chooses Yoco, is sent to the Yoco-hosted payment page, pays there and comes back to your shop. Card data never touches your site, and abandoned payments leave no unpaid orders.

It suits South African shops that sell in ZAR and have a Yoco account with online payments. The module takes one-time payments only. It has no saved cards, subscriptions, on-site card form or separate authorize and capture, and it works only in ZAR, with a minimum order total of R2.00.

Key features

Yoco hosted checkout: a Yoco checkout is created for the cart total in cents. A repeated request after a double click or a timeout gets the same checkout, not a second one.

Paid only when Yoco confirms: the module asks Yoco for the checkout status when the customer returns and when a signed webhook arrives. The order is created only when Yoco reports the checkout as completed.

Webhooks set up for you: when you save a secret key, the module registers its webhook URL with Yoco for that mode and stores the signing secret. Webhooks without a valid signature are rejected.

Amount and currency check: a payment with a different amount or currency puts the order in Yoco payment on hold with a note. A payment for a cancelled or refunded order does not reopen it.

No double processing: a webhook and the customer's return arriving at the same moment are handled one after the other. One cart, one order, one recorded payment.

Refunds from the order page: full and partial refunds in the Yoco payment block of the order, in the amount Yoco charged and with the key of the mode the payment was made in. Refunds made in the Yoco portal are recorded automatically.

Test and live modes: separate secret keys and webhook secrets for each mode. A key with the wrong prefix is not saved.

Yoco block on the order page: the payment, all payment attempts of the cart, the refund history and the module's notes. Log with keys and e-mail addresses masked.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. Shop currency South African rand (ZAR). A Yoco account with online payments and its secret keys. A VibeFox license key from vibefox.net (one key per domain).