Pular para o conteúdo principal
POST
Ignore a transaction

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 caminho

contextId
string<uuid>
obrigatório

The unique identifier of the reconciliation context. Context ID

transactionId
string<uuid>
obrigatório

The unique identifier of the transaction. Transaction ID

Corpo

application/json

Ignore transaction request

reason
string
obrigatório

Reason for ignoring the transaction

Minimum string length: 1
Exemplo:

"Duplicate entry - already processed manually"

Resposta

Indicates that the request was successful and the response contains the expected data.

amount
string
obrigatório

Transaction amount as a decimal string in the transaction currency (precision preserved verbatim; never a float)

Exemplo:

"1000.50"

contextId
string<uuid>
obrigatório

Reconciliation context this transaction belongs to

Exemplo:

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

createdAt
string<date-time>
obrigatório

Creation timestamp (RFC 3339)

Exemplo:

"2025-01-15T10:30:00Z"

currency
string
obrigatório

ISO 4217 currency code of the amount

Exemplo:

"USD"

date
string<date-time>
obrigatório

Transaction value date (RFC 3339)

Exemplo:

"2025-01-15T00:00:00Z"

dedupeKey
string
obrigatório

Read-only: the duplicate-key value this row was imported under, derived from the source's duplicate key declaration at import time. A source can change that declaration later, so this is the only place that says which identity THIS row carries. Prefixed v1 when the key spells out the fields it was derived from, v1h when those fields were hashed because the spelled-out key was too long to index.

Exemplo:

"v1|external_id=9:TXN-12345"

externalId
string
obrigatório

External identifier carried from the source system

Exemplo:

"TXN-12345"

extractionStatus
enum<string>
obrigatório

Field-extraction status: PENDING (queued), COMPLETE (fields parsed), FAILED (extraction error)

Opções disponíveis:
PENDING,
COMPLETE,
FAILED
Exemplo:

"COMPLETE"

id
string<uuid>
obrigatório

Unique identifier for the transaction

Exemplo:

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

jobId
string<uuid>
obrigatório

Ingestion job that produced this transaction

Exemplo:

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

sourceId
string<uuid>
obrigatório

Source this transaction belongs to

Exemplo:

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

status
enum<string>
obrigatório

Matching status: UNMATCHED (no match found), MATCHED (reconciled), IGNORED (excluded from reconciliation by an operator), PENDING_REVIEW (imported under the blank-external-id review policy and awaiting an operator decision)

Opções disponíveis:
UNMATCHED,
MATCHED,
IGNORED,
PENDING_REVIEW
Exemplo:

"UNMATCHED"

description
string

Free-text description carried from the source

Exemplo:

"Wire transfer from ABC Corp"

metadata
object

Normalized source metadata: unmapped source columns the engine projects into composite match keys and FX-conversion inputs (e.g. counterparty, bank_transaction_code, fx_rate). Arbitrary key/value, tenant-scoped to the caller's own data.