Create an adjustment
Use this endpoint to create a balancing journal entry (e.g., bank fee, FX difference) to resolve variance between matched transactions or on a single transaction.
Authorizations
Bearer token authentication (format: "Bearer {token}")
Headers
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.
Query Parameters
Context ID Context ID the adjustment belongs to
Body
Adjustment payload
Adjustment amount (decimal string)
1"10.50"
ISO 4217 currency code
3"USD"
Human-readable description
1"Bank wire fee adjustment"
Adjustment direction
DEBIT, CREDIT "DEBIT"
Reason for the adjustment
1"Variance due to bank processing fee"
Adjustment type
BANK_FEE, FX_DIFFERENCE, ROUNDING, WRITE_OFF, MISCELLANEOUS "BANK_FEE"
Match group the adjustment balances (UUID)
"550e8400-e29b-41d4-a716-446655440000"
Single transaction the adjustment balances (UUID)
"550e8400-e29b-41d4-a716-446655440000"
Response
Indicates that the resource was successfully created.
The balancing adjustment that was created

