📖 Documentation

FireBuddy Docs

Everything you need to add a Fire Open Banking payment widget to your website — from first sign-up to live checkout in under 10 minutes.

Quickstart

Getting FireBuddy live on your site takes three steps:

  1. Sign up and pay your subscription at firebuddy.io/signup. Your account activates instantly after your Fire payment is confirmed.
  2. Create a product in your dashboard — give it a name, price, and description. You'll get a unique Product ID.
  3. Paste 2 lines of code onto any webpage. The widget appears automatically, handles the Fire payment, and sends your customer a receipt.
✅ Most customers go from sign-up to a live payment widget in under 10 minutes — no developer needed.

How it works

When a customer clicks "Pay" in your widget, FireBuddy initiates a Fire Open Banking payment request. The customer is shown their bank's interface to authorise the transfer. Once authorised, the money goes directly to your Fire account and FireBuddy records the transaction.

No card details are stored. No payment processor sits in the middle. Just a direct bank-to-bank transfer, initiated via Fire's regulated Open Banking infrastructure.

Requirements

ℹī¸ Don't have a Fire account yet? Sign up at fire.com — it's free to open and takes a few minutes for Irish businesses.

Basic Embed

Add the following two lines to any HTML page, inside the <body> tag, wherever you want the payment widget to appear:

HTML 
<!-- Load the FireBuddy widget script once per page -->
<script src="https://firebuddy.io/widget.js"></script>

<!-- Place this div wherever the widget should render -->
<div
  id="firebuddy"
  data-api-key="YOUR_API_KEY"
  data-product-id="YOUR_PRODUCT_ID"
></div>

Replace YOUR_API_KEY with the API key from your dashboard, and YOUR_PRODUCT_ID with the ID of the product you want to sell.

⚠ī¸ Keep your API key private. Don't share it publicly or commit it to a public GitHub repo. If compromised, you can regenerate it from the dashboard.

Attributes

The FireBuddy <div> accepts the following data attributes:

Attribute Required Description
data-api-key Required Your FireBuddy API key, found in your dashboard.
data-product-id Required The UUID of the product to display. Each product has a unique ID.
data-theme Optional Widget colour theme. Accepts light (default) or dark.
data-button-text Optional Override the default "Pay with Fire" button label.
data-redirect-url Optional URL to redirect the customer to after successful payment.

Full example with optional attributes

HTML 
<div
  id="firebuddy"
  data-api-key="fb_live_abc123xyz"
  data-product-id="uuid-of-your-product"
  data-theme="dark"
  data-button-text="Book my session"
  data-redirect-url="https://yoursite.ie/thank-you"
></div>

Platform-specific instructions

WordPress

Use the Custom HTML block in the Gutenberg editor, or paste directly into a page template via Appearance → Theme Editor. The widget works in any WordPress theme.

Webflow

Add an Embed element to your page and paste the two lines of code. Make sure "Custom Code" is enabled in your Webflow project settings.

Squarespace

Use a Code Block in any section of your page. Squarespace must be on the Business plan or higher to use custom code.

Shopify

Add a Custom HTML section to any page or product template via the theme editor. Ideal for a standalone product or deposit page — not intended to replace the full cart checkout.

Plain HTML

Paste anywhere inside your <body> tag. No build step or framework required.

Creating Products

Each product represents something you're selling — a service, session, product, or booking slot. You can have as many products as you like under one subscription.

  1. Go to Products & Widgets in your dashboard
  2. Click New Product and fill in the name, description, price, and icon
  3. Click Embed next to any product to get the ready-to-paste code snippet
ℹī¸ Each product has a unique UUID. To show two different products on the same page, use two separate <div id="firebuddy"> elements with different data-product-id values and unique wrapper IDs.

API Keys

Your API key is tied to your subscription and identifies your account when the widget loads. You have one active key at a time.

Subscription & Renewal

FireBuddy uses Fire Open Banking for subscription payments, which means renewals are not automatic. Here's what happens at the end of each billing cycle:

⚠ī¸ Make sure your email address is correct in your account so you receive renewal reminders. Widgets will stop working if your key is deactivated, which could interrupt payments on your live site.

FAQ

Does FireBuddy work outside Ireland?

FireBuddy uses Fire Open Banking, which is available in Ireland and the UK. Your customers must have a bank that supports Open Banking (most major Irish and UK banks do).

Are there transaction fees?

No. FireBuddy charges a flat monthly or annual subscription. There are no per-transaction fees on top of that. Fire may apply their own account fees — check your Fire agreement for details.

Can I have multiple widgets on one page?

Yes. Give each widget div a unique id attribute and a different data-product-id. The widget script handles multiple instances on the same page.

What happens if a customer's payment fails?

Open Banking payments are authorised at the bank level — the customer sees a failure message in their banking app. The widget displays an error state and the customer can try again.

Can I customise the widget's appearance?

Basic theming is available via data-theme="dark". More advanced styling options (custom colours, fonts) are on the roadmap for a future release.

I lost my API key — what do I do?

Your key is always visible in the dashboard Overview tab. If you think it's been compromised, contact hello@firebuddy.io to rotate it.

Need help?

Email us at hello@firebuddy.io — we typically reply within one business day.