Accept card and open banking payments through Felloh’s secure hosted checkout using Payment Links.

Felloh Payment Links for WooCommerce lets you take card and open banking payments securely through Felloh’s hosted payment pages.

When a customer checks out, this gateway automatically:

1. Creates a Booking in Felloh using the WooCommerce order reference and customer details.
2. Creates a Payment Link associated with that booking.
3. Redirects the customer to the Felloh hosted checkout page (https://pay.felloh.com/{linkId}).
4. Receives webhook updates from Felloh to mark WooCommerce orders as paid, failed, cancelled, or refunded.

This plugin keeps all card and bank data off your site — Felloh hosts the payment form — while maintaining full order tracking inside WooCommerce.

• Secure hosted checkout via Felloh Payment Links
• Supports Card and Open Banking payments
• Automatically creates a Felloh Booking for every WooCommerce order
• Signed Webhook verification (HMAC-SHA256)
• Works in both sandbox and live modes
• No PCI scope — no card data passes through your server

== Requirements ==

• WordPress 6.0+
• WooCommerce 8.0+
• PHP 7.4+
• A Felloh merchant account with:
  • Organisation ID
  • Public & Private keys
  • Webhook Signing Secret

1. Download or clone this repository into wp-content/plugins/felloh-woocommerce/.
2. Activate the plugin from Plugins → Installed Plugins in WordPress.
3. Go to WooCommerce → Settings → Payments.
4. Enable Felloh – Payment Link and click Manage.
5. Enter your:
   • Organisation ID
   • Public Key
   • Private Key
   • Webhook Signing Secret
6. (Optional) Enable or disable Card and Open Banking options.
7. Save changes.

== Webhook Configuration ==

1. In your Felloh dashboard, create a new webhook pointing to:

https://yourdomain.com/wp-json/felloh/v1/webhook

2. Enable Transaction Status events (and Refund events if desired).
3. Copy the Signing Secret and paste it into the plugin’s settings.
4. Test by placing an order and confirming status updates in WooCommerce.

1. Customer checks out using the “Pay with Card or Bank” option.
2. Plugin authenticates with Felloh’s API using your public/private keys.
3. A Booking is created with:

• booking_reference = Woo order number
• customer_name, email, gross_amount

4. A Payment Link is created with the booking_id and redirect URLs.
5. Customer is sent to the Felloh hosted payment page.
6. Felloh notifies WooCommerce via a signed webhook when the payment status changes.
7. Order status automatically updates in WooCommerce.

• Enable Sandbox Mode in plugin settings.
• Use your Felloh sandbox keys.
• Place a low-value test order and complete payment in Felloh’s sandbox checkout.
• Check WooCommerce → Orders to confirm status changes after the webhook fires.

• Uses JWT authentication with Felloh’s /token endpoint.
• Verifies webhook signatures with HMAC-SHA256 using your secret.
• No card or banking details are stored or transmitted by your site.

No. All sensitive information is collected on Felloh’s secure, hosted payment page.

WooCommerce will log the error in WooCommerce → Status → Logs. You can manually update the order if needed.

Yes — edit the “Title” and “Description” fields in the plugin’s settings.

Yes. The plugin redirects customers to an external Felloh checkout URL after the order is created, which works with both legacy and block checkouts.

The plugin uses the following Felloh endpoints:

• POST /token — Authenticate and obtain a JWT
• PUT /agent/bookings — Create a booking
• PUT /agent/payment-links — Create a payment link
• Webhooks — Transaction status events with HMAC signatures

All requests use application/json with minor units for amounts (e.g. pence).

= 1.0.0 =

• Initial release.
• Create Booking + Payment Link flow.
• Secure webhook verification and order updates.
• WooCommerce gateway settings and sandbox support.

1.0.0 — Initial release. Ensure you configure your webhook URL and signing secret before going live.

• Felloh Developer Docs: https://developers.felloh.com/
• Payment Links Guide: https://developers.felloh.com/guides/payment-link
• Booking API Reference: https://developers.felloh.com/resources/booking
• Webhook Guide: https://developers.felloh.com/guides/webhooks