Skip to main content
POST
Reconcile an operation against the counterpart's settlement status

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

operationId
string
requerido

Operation id (UUID).

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

Cuerpo

application/json
participantIspb
string

ISPB (8 characters) the SLC0908 consulta is run on behalf of. A resource selector for the counterpart node, not an identity claim.

Ejemplo:

"12345678"

reason
string

Audit justification (mandatory; enforced by the domain). At most 1024 characters. This verb takes no evidence — the counterpart's answer is the evidence.

Maximum string length: 1024
Ejemplo:

"operation stuck at FORWARDED after the ASLC023 window closed"

Respuesta

OK

action
enum<string>
requerido

Outcome class: IN_SYNC (the two ledgers already agreed, nothing written) or SYNCHRONIZED (the local record was advanced).

Opciones disponibles:
IN_SYNC,
SYNCHRONIZED
Ejemplo:

"SYNCHRONIZED"

counterpartStatus
string
requerido

The counterpart's RAW SLC0908 settlement status, echoed verbatim rather than re-rendered through this service's vocabulary.

Ejemplo:

"CONFIRMED"

localState
string
requerido

Local state after the reconcile.

Ejemplo:

"CONFIRMED"

operationId
string
requerido

Operation id (UUID) that was reconciled.

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

previousState
string
requerido

Local state before the reconcile. Equal to localState on an IN_SYNC run.

Ejemplo:

"FORWARDED"

reconciledBy
string
requerido

Authenticated subject who requested the reconcile, taken from the validated request identity and never from the payload.

Ejemplo:

"ops@acquirer.com"

controlNumber
string

Counterpart control number correlating the operation, when the answer carried one.

Ejemplo:

"CTRL-0042"

trigger
string

Transition trigger (always NUCLEA_RECONCILED). Absent on an IN_SYNC run, where no transition was persisted.

Ejemplo:

"NUCLEA_RECONCILED"