Multi-Processor Reconciliation Normalizer API

Normalize payouts, transactions, and settlements from Stripe, PayPal, Adyen, Square, or any custom processor into a single canonical ledger schema. Match, reconcile, and explain discrepancies — fully deterministic. No ML. No AI.

🔑 Authentication

This API is distributed exclusively through RapidAPI. Subscribe to a plan on the listing page, and RapidAPI automatically injects the required headers into every request:

Header	Description
`X-RapidAPI-Key`	Your subscription key (auto-injected)
`X-RapidAPI-Host`	`reconforge.p.rapidapi.com` (auto-injected)

All requests are verified server-side via X-RapidAPI-Proxy-Secret. Direct calls outside RapidAPI are rejected.

💰 Pricing & Plans

Plan	Price	API Calls / Month
FREE	$0	100
PRO	$25/mo	10,000
ULTRA	$75/mo	50,000
MEGA	$150/mo	200,000

Start free with 100 calls. Once you see the value, upgrading is a no-brainer.

📡 Endpoints

1. Health Check

GET /health

Verify the service is online. No authentication required.

curl -X GET "https://reconforge.p.rapidapi.com/health"

Response:

{
  "ok": true,
  "service": "reconforge",
  "version": "1.0.0",
  "timestamp": "2026-04-14T21:00:00.000Z"
}

2. Ingest Transactions

POST /ingest/transactions

Upload raw transaction records from any payment processor. Supports JSON and CSV formats. Records are normalized and stored for reconciliation.

curl -X POST "https://reconforge.p.rapidapi.com/ingest/transactions" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com" \
  -d '{
    "source": "stripe",
    "format": "json",
    "data": [
      {
        "id": "txn_abc123",
        "amount": 15000,
        "currency": "usd",
        "created": 1711929600,
        "type": "charge",
        "status": "available",
        "payout": "po_xyz",
        "fee": 465
      }
    ]
  }'

Response:

{
  "request_id": "uuid-v4",
  "ingest_id": "uuid-v4",
  "accepted_count": 1,
  "rejected_count": 0,
  "warnings": []
}

3. Ingest Payouts

POST /ingest/payouts

Upload payout or settlement records. Same request format as transactions.

curl -X POST "https://reconforge.p.rapidapi.com/ingest/payouts" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com" \
  -d '{
    "source": "stripe",
    "format": "json",
    "data": [
      {
        "id": "po_xyz",
        "amount": 14535,
        "currency": "usd",
        "created": 1711929600,
        "status": "paid",
        "type": "payout"
      }
    ]
  }'

4. Ingest Fees

POST /ingest/fees

Upload fee tables or fee line-items. Same request format as transactions.

curl -X POST "https://reconforge.p.rapidapi.com/ingest/fees" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com" \
  -d '{
    "source": "stripe",
    "format": "json",
    "data": [
      {
        "id": "fee_001",
        "amount": 465,
        "currency": "usd",
        "created": 1711929600,
        "type": "stripe_fee",
        "payout": "po_xyz"
      }
    ]
  }'

5. Custom Field Mappings

POST /ingest/mappings

Define a custom field mapping for non-standard processors. The mapping is stored and can be referenced by mapping_id in future ingest or normalize calls.

curl -X POST "https://reconforge.p.rapidapi.com/ingest/mappings" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com" \
  -d '{
    "mapping_name": "my_erp_system",
    "mapping": {
      "canonical_fields": {
        "transaction_id": "ref_number",
        "amount": "total_value",
        "currency": "curr_code",
        "created_at": "timestamp",
        "type": "txn_type",
        "status": "state",
        "payout_id": "batch_ref",
        "fee_amount": "processing_fee"
      },
      "transforms": [
        { "field": "amount", "op": "parse_number" },
        { "field": "created_at", "op": "parse_datetime" },
        { "field": "currency", "op": "uppercase" }
      ]
    }
  }'

Response:

{
  "request_id": "uuid-v4",
  "mapping_id": "uuid-v4",
  "mapping_name": "my_erp_system"
}

Available transform ops: parse_number, divide_100, parse_datetime, unix_to_iso, uppercase, lowercase

6. Stateless Normalize

POST /normalize

Normalize records on-the-fly without storing them. Pass raw processor data and get back canonical records instantly. Ideal for previewing data before ingesting.

curl -X POST "https://reconforge.p.rapidapi.com/normalize" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com" \
  -d '{
    "source": "paypal",
    "format": "json",
    "data": [
      {
        "transaction_id": "PP-12345",
        "gross_amount": "150.00",
        "currency_code": "usd",
        "transaction_initiation_date": "2026-04-01T10:00:00Z",
        "transaction_event_code": "T0006",
        "transaction_status": "S",
        "fee_amount": "4.65"
      }
    ]
  }'

Response:

{
  "request_id": "uuid-v4",
  "canonical_records": [
    {
      "transaction_id": "PP-12345",
      "amount": 150.00,
      "currency": "USD",
      "created_at": "2026-04-01T10:00:00.000Z",
      "type": "T0006",
      "status": "S",
      "fee_amount": 4.65
    }
  ],
  "warnings": [],
  "stats": { "total": 1, "normalized": 1, "rejected": 0 }
}

Supported sources: stripe, paypal, adyen, square, generic

7. Run Reconciliation

POST /reconcile/run

Match transactions against payouts using a deterministic engine. Configure tolerances for amount deltas, time windows, and FX variance. Returns matched pairs, unmatched items, and discrepancies with confidence scores.

curl -X POST "https://reconforge.p.rapidapi.com/reconcile/run" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com" \
  -d '{
    "transactions_ingest_id": "ingest-uuid-1",
    "payouts_ingest_id": "ingest-uuid-2",
    "fees_ingest_id": "ingest-uuid-3",
    "ruleset": "default",
    "tolerances": {
      "amount_delta": 0,
      "time_window_minutes": 1440,
      "fx_delta_pct": 0.25
    },
    "output": "full"
  }'

Response:

{
  "request_id": "uuid-v4",
  "reconcile_id": "uuid-v4",
  "summary": {
    "matched": 45,
    "unmatched_transactions": 3,
    "unmatched_payouts": 1,
    "discrepancies": 2
  },
  "matches": [ ... ],
  "discrepancies": [ ... ]
}

Rulesets: default, strict, lenient

8. Retrieve Reconcile Run

GET /reconcile/{reconcile_id}

Fetch the full results of a previous reconciliation run by its ID.

curl -X GET "https://reconforge.p.rapidapi.com/reconcile/{reconcile_id}" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com"

9. Reconciliation Report

POST /reconcile/report

Generate a structured report from a completed reconciliation run. Available in JSON, CSV structure, or both.

curl -X POST "https://reconforge.p.rapidapi.com/reconcile/report" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com" \
  -d '{
    "reconcile_id": "reconcile-uuid",
    "format": "both"
  }'

10. Discrepancy Explain

POST /discrepancy/explain

Get root cause analysis for a specific discrepancy. Returns ranked hypotheses with confidence scores and suggested corrective actions.

curl -X POST "https://reconforge.p.rapidapi.com/discrepancy/explain" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com" \
  -d '{
    "reconcile_id": "reconcile-uuid",
    "discrepancy_id": "discrepancy-uuid"
  }'

Response:

{
  "request_id": "uuid-v4",
  "root_cause_hypotheses": [
    {
      "cause": "Stripe processing fee deducted before payout",
      "confidence": 0.95,
      "fix": "Add fee_amount to payout expected total"
    }
  ],
  "suggested_actions": [
    "Re-reconcile with fees_ingest_id included"
  ]
}

11. Get Plan Limits

GET /limits

Check your current plan and remaining API call quota.

curl -X GET "https://reconforge.p.rapidapi.com/limits" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com"

Response:

{
  "request_id": "uuid-v4",
  "plan": "FREE",
  "api_calls_per_month": 100
}

12. Get Provider Templates

GET /templates

Retrieve built-in field mappings and transform rules for all supported payment processors. Use these as a starting point for custom mappings.

curl -X GET "https://reconforge.p.rapidapi.com/templates" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: reconforge.p.rapidapi.com"

Response:

{
  "request_id": "uuid-v4",
  "providers": [
    {
      "name": "stripe",
      "description": "Stripe balance transactions",
      "mapping": {
        "canonical_fields": {
          "transaction_id": "id",
          "amount": "amount",
          "currency": "currency",
          "created_at": "created",
          "type": "type",
          "status": "status",
          "payout_id": "payout",
          "fee_amount": "fee"
        },
        "transforms": [
          { "field": "amount", "op": "divide_100" },
          { "field": "fee_amount", "op": "divide_100" },
          { "field": "created_at", "op": "unix_to_iso" },
          { "field": "currency", "op": "uppercase" }
        ]
      }
    }
  ]
}

⚠️ Error Responses

All errors follow a consistent format:

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "source, format, and data are required",
    "request_id": "uuid-v4"
  }
}

HTTP Code	Error Code	Meaning
400	BAD_REQUEST	Missing or invalid fields in request body
401	UNAUTHORIZED	Missing RapidAPI subscription key
403	FORBIDDEN	Request did not originate from RapidAPI proxy
404	NOT_FOUND	Requested resource does not exist
405	METHOD_NOT_ALLOWED	Wrong HTTP method
429	RATE_LIMITED	Plan quota exceeded

🔄 Typical Workflow

Ingest transactions → POST /ingest/transactions → get ingest_id
Ingest payouts → POST /ingest/payouts → get ingest_id
Ingest fees (optional) → POST /ingest/fees → get ingest_id
Run reconciliation → POST /reconcile/run with all ingest IDs → get reconcile_id
Review results → GET /reconcile/{reconcile_id}
Explain discrepancies → POST /discrepancy/explain for each flagged item
Generate report → POST /reconcile/report

📬 Contact & Support

For questions, integration help, or enterprise inquiries:

📧 reconforge@fastmail.com