For developers — Integration is an afternoon

Ingest

One POST. Any JSON payload.

Send the events your systems already emit. Set an Idempotency-Key and retries are free: the same key is accepted, deduplicated and never double-processed. Events that match no flow are still ingested, validated and stored.

INGEST AN EVENT bash

curl -X POST https://api.flyhalf.io/v1/events \
  -H "Authorization: Bearer fh_live_…" \
  -H "Idempotency-Key: evt_9f31" \
  -d '{
    "type": "order.completed",
    "participant": "cus_84h2",
    "payload": { "total": 349.00 }
  }'

→ 202 accepted · signed receipt in 41ms

VERIFY A WEBHOOK SIGNATURE php

$expected = hash_hmac('sha256',
    $timestamp.'.'.$body,
    $signingSecret);

if (! hash_equals($expected, $signatureHeader)) {
    abort(401); // not from Flyhalf — drop it
}

Webhooks out

Signed, timestamped, replayable.

Every outbound webhook carries an HMAC signature over a timestamped payload — verify with a constant-time compare and reject anything stale. Failed deliveries retry on a backoff schedule, then dead-letter with one-click replay from the dashboard.

Delivery log with status, latency and response body
Retries: 1m → 5m → 30m → 2h → 12h, then dead-letter
Webhook events for rewards, badges, rank changes, redemptions

The boring guarantees

What you'd build anyway — already built.

Idempotency everywhere

Events dedupe on your key; flow side-effects derive their own. At-least-once delivery, exactly-once effects.

Sandbox as a dimension

fh_test_ keys write sandbox data through the whole stack. Messages render and log as simulated — never sent.

Versioned API

Everything under /v1. Breaking changes get a new version, not a surprise deploy.

Append-only ledger

Points are never edited in place. Reversals reference the original entry, so audits reconcile to the cent.

WooCommerce, one install

Drop in the WordPress plugin and Woo orders, refunds, registrations and reviews arrive as signed Flyhalf events — HMAC-signed, idempotency-keyed, queued off the checkout request. No code to write.

Ship the integration before the stand-up.

Book a demo Start free