---
title: "Payment Fee Schedule Authoring Engine · RBE·08"
method: POST
path: "/v1/tools/fee_schedule_engine"
---

# Payment Fee Schedule Authoring Engine · RBE·08

`POST /v1/tools/fee_schedule_engine`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/fee_schedule_engine`
- Auth: none declared

Browser-based tool for PSPs, neobanks, and BaaS providers to author, simulate, and export tiered payment fee schedules. Covers rail, corridor, amount band, merchant type, customer tier, and volume. Generates PSD2 Art. 45 / Reg E disclosure summary and versioned Policy Mandate JSON. Zero PII. Client-side. Works offline.

**Tool URL:** https://ainumbers.co/tools/rbe-08-fee-schedule-engine.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `schedule_name` string, required: Human-readable name for the fee schedule
  - `version` string: Semver version string, e.g. 1.0
  - `effective_date` string, date
  - `expiry_date` string, date
  - `issuer` string: PSP or brand name — not PII
  - `currency` 'GBP' | 'EUR' | 'USD' | 'MULTI', required
  - `jurisdictions` string[]
  - `regulatory_frameworks` string[]
  - `cliff_detection_threshold_pct` number
  - `durbin_scope` boolean
  - `l2_l3_indicators` boolean
  - `rules` object[], required
    - `rail` string, required
    - `corridor` 'Domestic' | 'Intra-EU' | 'Cross-border', required
    - `amount_min` number
    - `amount_max` number
    - `merchant_type` string
    - `customer_tier` string
    - `fixed_fee` number
    - `percentage_fee` number
    - `fx_margin` number
    - `network_surcharge` number
    - `minimum_fee` number
    - `maximum_fee` number
  - `simulate_transaction` object
    - `rail` string
    - `corridor` string
    - `amount` number
    - `merchant_type` string
    - `customer_tier` string

## Response `200`

Successful tool execution result

- object
  - `rules` unknown[]
    - unknown
  - `cliff_flags` unknown[]
    - unknown
  - `coverage_gaps` unknown[]
    - unknown
  - `simulation_result` object
  - `psd2_disclosure` string
  - `ap2_mandate` object

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)