Retry Transfer Reconciliation - Lerian

Retry Transfer Reconciliation

curl --request POST \
  --url https://ted.sandbox.lerian.net/v1/transfers/{transferId}/reconciliation/retry \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --header 'X-Organization-Id: <x-organization-id>' \
  --data '
{
  "reason": "JD cabine confirms the settlement; requeueing for a fresh query"
}
'

package main

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

func main() {

	url := "https://ted.sandbox.lerian.net/v1/transfers/{transferId}/reconciliation/retry"

	payload := strings.NewReader("{\n  \"reason\": \"JD cabine confirms the settlement; requeueing for a fresh query\"\n}")

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

	req.Header.Add("X-Organization-Id", "<x-organization-id>")
	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-Organization-Id': '<x-organization-id>',
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({reason: 'JD cabine confirms the settlement; requeueing for a fresh query'})
};

fetch('https://ted.sandbox.lerian.net/v1/transfers/{transferId}/reconciliation/retry', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://ted.sandbox.lerian.net/v1/transfers/{transferId}/reconciliation/retry"

payload = { "reason": "JD cabine confirms the settlement; requeueing for a fresh query" }
headers = {
    "X-Organization-Id": "<x-organization-id>",
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "transferId": "770e8400-e29b-41d4-a716-446655440003",
  "reconciliationStatus": "AWAITING",
  "requeuedAt": "2026-08-28T15:04:05Z"
}

POST

/

v1

/

transfers

/

{transferId}

/

reconciliation

/

retry

Retry Transfer Reconciliation

curl --request POST \
  --url https://ted.sandbox.lerian.net/v1/transfers/{transferId}/reconciliation/retry \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --header 'X-Organization-Id: <x-organization-id>' \
  --data '
{
  "reason": "JD cabine confirms the settlement; requeueing for a fresh query"
}
'

package main

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

func main() {

	url := "https://ted.sandbox.lerian.net/v1/transfers/{transferId}/reconciliation/retry"

	payload := strings.NewReader("{\n  \"reason\": \"JD cabine confirms the settlement; requeueing for a fresh query\"\n}")

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

	req.Header.Add("X-Organization-Id", "<x-organization-id>")
	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-Organization-Id': '<x-organization-id>',
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({reason: 'JD cabine confirms the settlement; requeueing for a fresh query'})
};

fetch('https://ted.sandbox.lerian.net/v1/transfers/{transferId}/reconciliation/retry', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://ted.sandbox.lerian.net/v1/transfers/{transferId}/reconciliation/retry"

payload = { "reason": "JD cabine confirms the settlement; requeueing for a fresh query" }
headers = {
    "X-Organization-Id": "<x-organization-id>",
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "transferId": "770e8400-e29b-41d4-a716-446655440003",
  "reconciliationStatus": "AWAITING",
  "requeuedAt": "2026-08-28T15:04:05Z"
}

Autorizações

Authorization

string

header

obrigatório

JWT Bearer token authentication. The tenantId is derived from the bearer token or authenticated request context and is not supplied through X-Organization-Id.

Cabeçalhos

X-Organization-Id

string<uuid>

obrigatório

Midaz organization scope for the request, used for downstream CRM, Fees, and Midaz calls. Required on org-scoped transfer routes in every deployment mode; a missing or non-UUID value returns 400. This is not the tenant identifier — tenantId is derived from the bearer JWT or authenticated context, never from this header. Background workers (TED IN poller, reconciliation) have no request header and, in single-tenant mode, fall back to the deployment's ORGANIZATION_ID env.

X-Idempotency

string

obrigatório

Required idempotency key for safe retries. Use a UUID v4 or unique business identifier. If the same key is sent again and the original request was already processed, the cached response is returned.

See Retries and idempotency for details.

Maximum string length: 255

Parâmetros de caminho

transferId

string<uuid>

obrigatório

The unique identifier of the transfer.

Corpo

application/json

Operator justification for the requeue.

reason

string

obrigatório

Maximum string length: 500

Exemplo:

"JD cabine confirms the settlement; requeueing for a fresh query"

Resposta

Indicates that the transfer returned to the reconciliation queue.

transferId

string<uuid>

Exemplo:

"770e8400-e29b-41d4-a716-446655440003"

reconciliationStatus

string

Exemplo:

"AWAITING"

requeuedAt

string<date-time>

Exemplo:

"2026-08-28T15:04:05Z"