This extension lets FOSSBilling accept one-time Yoco Checkout payments in South African Rand (ZAR). It also supports optional USD invoice conversion into ZAR before checkout.
Features
One-time Yoco Checkout payments
ZAR invoice support
Optional USD-to-ZAR invoice conversion
Yoco webhook verification for payment confirmation
Test and live API key fields
Installation
Download the latest release ZIP.
Extract the archive into your FOSSBilling root so the paths merge into:
library/Payment/Adapter/Yoco.php
data/assets/gateways/yoco.png
Clear the FOSSBilling cache.
In the FOSSBilling admin panel, go to System > Payment gateways.
Install or enable the Yoco payment gateway.
Add your Yoco live or test keys.
Configure your Yoco webhook and add the webhook secret in the gateway settings.
Currency notes
Yoco checkout is processed in ZAR. ZAR invoices are charged directly. USD invoices can be converted to ZAR using the configured gateway conversion rate or the FOSSBilling currency rates.
Webhook notes
The gateway verifies Yoco webhook signatures when a webhook secret is configured. Payment confirmation is handled through the payment.succeeded event.