Confirm a proposed match group

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/matching/groups/{matchGroupId}/confirm \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/matching/groups/{matchGroupId}/confirm"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://matcher.sandbox.lerian.net/v1/matching/groups/{matchGroupId}/confirm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://matcher.sandbox.lerian.net/v1/matching/groups/{matchGroupId}/confirm"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

{
  "confidence": 85,
  "contextId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2025-01-15T10:30:00Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "items": [
    {
      "allocatedAmount": "1000.00",
      "allocatedCurrency": "USD",
      "allowPartial": false,
      "createdAt": "2025-01-15T10:30:00Z",
      "expectedAmount": "1000.00",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "matchGroupId": "550e8400-e29b-41d4-a716-446655440000",
      "transactionId": "550e8400-e29b-41d4-a716-446655440000",
      "updatedAt": "2025-01-15T10:30:00Z",
      "side": "LEFT",
      "sourceId": "550e8400-e29b-41d4-a716-446655440000",
      "sourceName": "Bank statement"
    }
  ],
  "runId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PROPOSED",
  "updatedAt": "2025-01-15T10:30:00Z",
  "confirmedAt": "2025-01-15T10:35:00Z",
  "reasonCodes": [
    "FX_RATE_VARIANCE"
  ],
  "rejectedReason": "amounts do not match within tolerance",
  "ruleId": "550e8400-e29b-41d4-a716-446655440000"
}

POST

matching

groups

{matchGroupId}

confirm

Confirm a proposed match group

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/matching/groups/{matchGroupId}/confirm \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/matching/groups/{matchGroupId}/confirm"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://matcher.sandbox.lerian.net/v1/matching/groups/{matchGroupId}/confirm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://matcher.sandbox.lerian.net/v1/matching/groups/{matchGroupId}/confirm"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

{
  "confidence": 85,
  "contextId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2025-01-15T10:30:00Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "items": [
    {
      "allocatedAmount": "1000.00",
      "allocatedCurrency": "USD",
      "allowPartial": false,
      "createdAt": "2025-01-15T10:30:00Z",
      "expectedAmount": "1000.00",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "matchGroupId": "550e8400-e29b-41d4-a716-446655440000",
      "transactionId": "550e8400-e29b-41d4-a716-446655440000",
      "updatedAt": "2025-01-15T10:30:00Z",
      "side": "LEFT",
      "sourceId": "550e8400-e29b-41d4-a716-446655440000",
      "sourceName": "Bank statement"
    }
  ],
  "runId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PROPOSED",
  "updatedAt": "2025-01-15T10:30:00Z",
  "confirmedAt": "2025-01-15T10:35:00Z",
  "reasonCodes": [
    "FX_RATE_VARIANCE"
  ],
  "rejectedReason": "amounts do not match within tolerance",
  "ruleId": "550e8400-e29b-41d4-a716-446655440000"
}

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.

Parâmetros de caminho

matchGroupId

string<uuid>

obrigatório

Match Group ID

Parâmetros de consulta

contextId

string<uuid>

obrigatório

Context ID Context ID the group belongs to

Resposta

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

confidence

integer<int64>

obrigatório

Match confidence score from 0 (lowest) to 100 (exact); manual matches are 100

Intervalo obrigatório: 0 <= x <= 100

Exemplo:

85

contextId

string

obrigatório

Reconciliation context ID this group belongs to

Exemplo:

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

createdAt

string

obrigatório

Creation timestamp (RFC 3339)

Exemplo:

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

string

obrigatório

Unique identifier for the group

Exemplo:

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

items

object[] | null

obrigatório

Transaction allocations that make up this match group

Maximum array length: 500

Show child attributes

runId

string

obrigatório

Identifier of the match run that created this group

Exemplo:

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

status

enum<string>

obrigatório

Current status of the group: PROPOSED (awaiting review), CONFIRMED (accepted), REJECTED (a proposed group discarded before confirmation), or REVOKED (a confirmed group whose confirmation was later undone by an unmatch; the original confirmation timestamp is kept for audit)

Opções disponíveis:

PROPOSED,

CONFIRMED,

REJECTED,

REVOKED

Exemplo:

"PROPOSED"

updatedAt

string

obrigatório

Last update timestamp (RFC 3339)

Exemplo:

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

confirmedAt

string

When the group was confirmed (RFC 3339); present only once confirmed

Exemplo:

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

reasonCodes

string[] | null

Rationale reason codes attached to this group's member transactions (e.g. FX_RATE_VARIANCE, FEE_VARIANCE, AGED_BREAK, OVER_SETTLED), resolved by joining member exceptions. Absent for a clean match with no recorded rationale

Maximum array length: 32

Exemplo:

["FX_RATE_VARIANCE"]

rejectedReason

string

Reason the group was rejected; present only when the status is REJECTED

Exemplo:

"amounts do not match within tolerance"

ruleId

string

Identifier of the rule used for matching; null for manual matches

Exemplo:

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

Primeiros passos

API de Contextos de Configuração

API de Regras de Correspondência

API de Fontes de Dados

API de Mapeamento de Campos

API de Tabelas de Tarifas

API de Configuração de Regras de Tarifas

API de Agendamentos

Fluxo de exceções

Ações em massa

Comentários

Credenciais de callback

API de Disputas

API de Jobs de Exportação

API de Governança

Jobs de ingestão

Layouts e formatos

Revisões de extração

Extração de documentos

Execuções de correspondência

Correspondência manual e ajustes

Candidatos e itens em aberto

Sugestões de regras

Painel e métricas

Relatórios

Exportações

Status da descoberta

Conexões de descoberta

Extrações

Conexões de agregadores

Webhooks de agregadores

Tratamento de erros

Eventos

Confirm a proposed match group

Autorizações

Cabeçalhos

Parâmetros de caminho

Parâmetros de consulta

Resposta