Preflight

Preflight API Reference

Investigate payment failures and automate operational workflows for SWIFT and SEPA payments.

Preflight ingests payment outcomes (ACK/NACK, pacs.002, pacs.004, internal status events) and automatically:

  • creates investigation cases
  • generates evidence timelines
  • classifies failure reasons
  • provides corridor intelligence

Designed for payment platforms, orchestration layers, and ISO 20022 pipelines.

Ingest payment outcome

curl -X POST https://api.preflightpayments.com/api/outcomes/ingest \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "payment_id": "demo_001",
  "sender_country": "GB",
  "recipient_country": "DE",
  "payment_currency": "EUR",
  "rail": "SEPA",
  "amount": "1000",
  "status": "REJECTED",
  "raw_reason": "Invalid IBAN",
  "timestamp": "2026-03-06T10:00:00Z"
}'

Result

  • Investigation case created
  • Evidence timeline generated
  • Failure reason classified

You can inspect the result via: GET /api/payments/{id}/trace

Interactive execution

Public API reference available below.

To run requests:

  • Open the docs (link below or iframe), click Authorize (top right)
  • Enter your demo API key (no "Bearer" prefix)
  • Use Try it out on any endpoint; requests run against the live sandbox API

No key needed: /health, /docs. Key required: all /api/* endpoints (preflight, cases, telemetry, trace, etc.). Without a key you get 401 API key required.

Need a key? Request access

Core capabilities

Outcome ingestion

Send payment execution outcomes from your middleware.

Examples: SWIFT ACK/NACK · SEPA pacs.002 · SEPA pacs.004 returns · internal status events

Trace & investigation

Retrieve a complete operational trace for any payment.

Includes: outcome timeline · evidence records · case lifecycle · phase classification

Operational intelligence

Analyze returns across corridors and identify avoidable failures.

Example insights: top return reasons · corridor return patterns · avoidable failure rate

Interactive API docs

Open the live Preflight API docs in a new tab.

The sandbox API may take a few seconds to wake on first load.

Open API Docs

Use your demo API key in the Authorize dialog, then try endpoints directly from the browser. The OpenAPI spec reflects the live demo environment.

Example workflow

  1. 1

    Payment submitted

    Status: PENDING

  2. 2

    Network reject arrives

    Status: REJECTED

    Preflight automatically:

    • opens investigation case
    • links outcome to payment trace
    • attaches evidence
  3. 3

    Operations investigate

    Use: GET /api/payments/{id}/trace

  4. 4

    Analyze returns across corridors

    GET /api/intelligence/returns

Sandbox environment

The API reference uses a deterministic demo dataset.

  • Safe to experiment
  • No real payment data
  • Environment resets periodically

Perfect for exploring workflows.

Integration model

Preflight integrates beside your execution stack.

Typical event sources:

  • payment middleware
  • SWIFT gateways
  • ISO 20022 pipelines
  • orchestration layers

Preflight does not execute payments. It observes payment execution events and builds an operational investigation layer.

Request demo access

Get a demo API key and access to the full case management UI.

Request Access

Prefer direct contact? [email protected]