FireHorse Pay/developersDashboard
API reference

Read provider callback history

Inspect received provider callbacks linked to an owned transaction. The response contains safe summaries, processing state and duplicate counts.

GET/api/v1/transactions/{idOrUuid}/callbacks

Illustrative examples · merchant-scoped · API key and HMAC required

Request#

FieldUseDescription
idOrUuidpathOwned transaction ID or UUID.
Node.js
// Node.js 18+ · server only. No browser API key.
import { createHash, createHmac, randomUUID } from 'node:crypto';

const key = process.env.FIREHORSE_API_KEY;
if (!key) throw new Error('Set FIREHORSE_API_KEY on the server');
const path = '/api/v1/transactions/100123/callbacks';
const method = 'GET';
const body = '';
const timestamp = String(Math.floor(Date.now() / 1000));
const nonce = randomUUID();
const hash = createHash('sha256').update(body, 'utf8').digest('hex');
const canonical = [method, path.split('?')[0], timestamp, nonce, hash].join('\n');
const signature = createHmac('sha256', key).update(canonical).digest('hex');
const response = await fetch('https://firehorsepay.powerwebhub.com/transaction' + path, {
  method, redirect: 'error',
  headers: {
    'X-API-KEY': key, 'X-TIMESTAMP': timestamp,
    'X-NONCE': nonce, 'X-SIGNATURE': signature,
    'Content-Type': 'application/json'
  }
});
const result = await response.json();
if (!response.ok) {
  // Reconcile uncertain results and 409; do not blindly create another order.
  throw new Error('Firehorse HTTP ' + response.status);
}
// Store result securely. A 201/CREATED is not a confirmed payment.

Example response#

HTTP 200 · illustrative response
[
  {
    "receivedAt": "2026-11-22T12:00:00Z",
    "providerCode": "example_sandbox",
    "status": "DONE",
    "processedAt": "2026-11-22T12:00:01Z",
    "payloadSummary": {
      "status": "success",
      "amount": "10.00",
      "currency": "EUR"
    },
    "duplicateCount": 0,
    "lastDuplicateAt": null
  }
]

Integration notes#

Provider callbacks are inbound to Firehorse. They are distinct from outbound merchant webhooks.

Callback summary amounts are provider-reported raw values; use the transaction amount breakdown for authoritative credited amounts.

Headers and signature material are not part of this response. An empty history does not prove that a payment failed.

Search documentation