Pular para o conteúdo principal
POST
Create an adjustment

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

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>
obrigatório

Context ID Context ID the adjustment belongs to

Corpo

application/json

Adjustment payload

amount
string
obrigatório

Adjustment amount (decimal string)

Minimum string length: 1
Exemplo:

"10.50"

currency
string
obrigatório

ISO 4217 currency code

Required string length: 3
Exemplo:

"USD"

description
string
obrigatório

Human-readable description

Minimum string length: 1
Exemplo:

"Bank wire fee adjustment"

direction
enum<string>
obrigatório

Adjustment direction

Opções disponíveis:
DEBIT,
CREDIT
Exemplo:

"DEBIT"

reason
string
obrigatório

Reason for the adjustment

Minimum string length: 1
Exemplo:

"Variance due to bank processing fee"

type
enum<string>
obrigatório

Adjustment type

Opções disponíveis:
BANK_FEE,
FX_DIFFERENCE,
ROUNDING,
WRITE_OFF,
MISCELLANEOUS
Exemplo:

"BANK_FEE"

matchGroupId
string

Match group the adjustment balances (UUID)

Exemplo:

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

transactionId
string

Single transaction the adjustment balances (UUID)

Exemplo:

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

Resposta

Indicates that the resource was successfully created.

adjustment
object
obrigatório

The balancing adjustment that was created