Saltar al contenido principal
POST
Simulate fee calculation

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication (format: "Bearer {token}")

Encabezados

X-Request-Id
string

A unique identifier for tracing the request across services.

X-Idempotency
string

Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409, and an idempotency storage failure returns 500. These refusals are problem documents.

Parámetros de ruta

scheduleId
string<uuid>
requerido

The unique identifier of the fee schedule. Schedule ID

Cuerpo

application/json

Fee simulation payload

currency
string
requerido

ISO 4217 currency code of the gross amount.

Ejemplo:

"USD"

grossAmount
string
requerido

Gross amount to simulate fees against, as a decimal string in the given currency.

Ejemplo:

"100.00"

Respuesta

Fee simulation result.

currency
string
requerido

ISO 4217 currency code of the simulated amounts.

Ejemplo:

"USD"

grossAmount
string
requerido

Gross amount that fees were simulated against, as a decimal string.

Ejemplo:

"100.00"

items
object[] | null
requerido

Per-item breakdown of the simulated fees.

Maximum array length: 100
netAmount
string
requerido

Amount remaining after all fees, as a decimal string.

Ejemplo:

"97.70"

totalFee
string
requerido

Sum of all item fees, as a decimal string.

Ejemplo:

"2.30"