API reference
Inspect the transaction trace
Read the owned transaction timeline for routing, initiation, provider interaction and webhook delivery diagnostics.
Illustrative examples · merchant-scoped · API key and HMAC required
Request#
| Field | Use | Description |
|---|---|---|
idOrUuid | path | Numeric owned 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/trace';
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
{
"transactionId": 100123,
"merchantReference": "order-example-001",
"providerCode": "example_sandbox",
"currentStatus": "CREATED",
"traceId": "example-trace",
"events": []
}Integration notes#
The shape of individual events depends on the recorded source. The empty events array here is an illustrative example.
A missing event means no matching evidence was recorded; it does not certify a successful stage.
