Create a fee schedule
Use this endpoint to create a new fee schedule. Fee schedules define the fee structure applied to transactions during reconciliation.
Autorizaciones
Bearer token authentication (format: "Bearer {token}")
Encabezados
A unique identifier for tracing the request across services.
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.
Cuerpo
Fee schedule creation payload
How items combine. PARALLEL applies every item to the same gross base; CASCADING applies each item to the net remaining after prior items.
PARALLEL, CASCADING "PARALLEL"
ISO 4217 currency code the schedule's amounts are denominated in.
"USD"
Fee items that make up the schedule; at least one is required.
1 - 100 elementsHuman-readable name of the fee schedule.
1 - 100"Card Processing - Visa"
Rounding strategy. HALF_UP rounds halves away from zero; BANKERS rounds halves to the nearest even digit; FLOOR rounds down; CEIL rounds up; TRUNCATE drops extra digits.
HALF_UP, BANKERS, FLOOR, CEIL, TRUNCATE "HALF_UP"
Number of decimal places fee amounts are rounded to.
2
Respuesta
Successfully created fee schedule.
How items combine. PARALLEL applies every item to the same gross base; CASCADING applies each item to the net remaining after prior items.
PARALLEL, CASCADING "PARALLEL"
Creation timestamp in RFC 3339 format.
"2025-01-15T10:30:00Z"
ISO 4217 currency code the schedule's amounts are denominated in.
"USD"
Unique identifier of the fee schedule.
"550e8400-e29b-41d4-a716-446655440000"
Fee items that make up the schedule.
100Human-readable name of the fee schedule.
"Card Processing - Visa"
Rounding strategy. HALF_UP rounds halves away from zero; BANKERS rounds halves to the nearest even digit; FLOOR rounds down; CEIL rounds up; TRUNCATE drops extra digits.
HALF_UP, BANKERS, FLOOR, CEIL, TRUNCATE "HALF_UP"
Number of decimal places fee amounts are rounded to.
2
Identifier of the tenant that owns the schedule.
"550e8400-e29b-41d4-a716-446655440000"
Last update timestamp in RFC 3339 format.
"2025-01-15T10:30:00Z"
Number of distinct contexts whose fee rules reference this schedule. Computed at read time from the fee rules that reference this schedule (never persisted).
2