Saltar al contenido principal
POST
Create an adjustment

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 consulta

contextId
string<uuid>
requerido

Context ID Context ID the adjustment belongs to

Cuerpo

application/json

Adjustment payload

amount
string
requerido

Adjustment amount (decimal string)

Minimum string length: 1
Ejemplo:

"10.50"

currency
string
requerido

ISO 4217 currency code

Required string length: 3
Ejemplo:

"USD"

description
string
requerido

Human-readable description

Minimum string length: 1
Ejemplo:

"Bank wire fee adjustment"

direction
enum<string>
requerido

Adjustment direction

Opciones disponibles:
DEBIT,
CREDIT
Ejemplo:

"DEBIT"

reason
string
requerido

Reason for the adjustment

Minimum string length: 1
Ejemplo:

"Variance due to bank processing fee"

type
enum<string>
requerido

Adjustment type

Opciones disponibles:
BANK_FEE,
FX_DIFFERENCE,
ROUNDING,
WRITE_OFF,
MISCELLANEOUS
Ejemplo:

"BANK_FEE"

matchGroupId
string

Match group the adjustment balances (UUID)

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

transactionId
string

Single transaction the adjustment balances (UUID)

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

Respuesta

Indicates that the resource was successfully created.

adjustment
object
requerido

The balancing adjustment that was created