Iniciar prueba de conectividad (ECO)

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/connectivity-tests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipientIspb": "<string>",
  "message": "<string>"
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/connectivity-tests"

payload = {
    "recipientIspb": "<string>",
    "message": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({recipientIspb: '<string>', message: '<string>'})
};

fetch('https://spb.sandbox.lerian.net/v1/str/connectivity-tests', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://spb.sandbox.lerian.net/v1/str/connectivity-tests",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'recipientIspb' => '<string>',
    'message' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/connectivity-tests"

	payload := strings.NewReader("{\n  \"recipientIspb\": \"<string>\",\n  \"message\": \"<string>\"\n}")

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

	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))

}

HttpResponse<String> response = Unirest.post("https://spb.sandbox.lerian.net/v1/str/connectivity-tests")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"recipientIspb\": \"<string>\",\n  \"message\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/connectivity-tests")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"recipientIspb\": \"<string>\",\n  \"message\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "controlNumber": "<string>",
  "messageType": "<string>",
  "nuOp": "<string>",
  "status": "<string>",
  "submittedAt": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Iniciar prueba de conectividad (ECO)

Prerrequisito: un certificado activo (ver rotateCertificate, activateCertificate) y un reporte de disponibilidad READY (ver getReadiness) antes de la prueba de conectividad; una prueba de conectividad aprobada es a su vez el prerrequisito de una operación de envío (ver createBankTransferOperation). Construye una solicitud de eco GEN0001 dirigida al participante indicado, la persiste como SUBMITTED antes del despacho por el rail y deja que el relay de salida la despache a la RSFN. La contraparte responde con GEN0001R1 devolviendo el mensaje; la respuesta se correlaciona por NUOp y confirma la prueba. Idempotente: reenviar la misma clave X-Idempotency con el mismo cuerpo devuelve la respuesta en caché.

POST

str

connectivity-tests

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/connectivity-tests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipientIspb": "<string>",
  "message": "<string>"
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/connectivity-tests"

payload = {
    "recipientIspb": "<string>",
    "message": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({recipientIspb: '<string>', message: '<string>'})
};

fetch('https://spb.sandbox.lerian.net/v1/str/connectivity-tests', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://spb.sandbox.lerian.net/v1/str/connectivity-tests",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'recipientIspb' => '<string>',
    'message' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/connectivity-tests"

	payload := strings.NewReader("{\n  \"recipientIspb\": \"<string>\",\n  \"message\": \"<string>\"\n}")

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

	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))

}

HttpResponse<String> response = Unirest.post("https://spb.sandbox.lerian.net/v1/str/connectivity-tests")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"recipientIspb\": \"<string>\",\n  \"message\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/connectivity-tests")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"recipientIspb\": \"<string>\",\n  \"message\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "controlNumber": "<string>",
  "messageType": "<string>",
  "nuOp": "<string>",
  "status": "<string>",
  "submittedAt": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency

string

Idempotency key (primary).

X-Idempotency-Key

string

Idempotency key (legacy alias for X-Idempotency).

X-TTL

string

Idempotency key TTL in seconds (overrides the configured default).

Cuerpo

application/json

recipientIspb

string

requerido

ISPB of the counterparty participant the echo is addressed to (8 numeric digits).

Ejemplo:

38166

message

string

Optional free-text MsgECO payload echoed back by the counterparty (max 256 chars).

Ejemplo:

"connectivity check"

Respuesta

Created

controlNumber

string

requerido

IF control number assigned to the GEN0001 submission.

Ejemplo:

"20260610000001"

messageType

string

requerido

STR message code of the submission (always GEN0001 for connectivity tests).

Ejemplo:

"GEN0001"

nuOp

string

requerido

BACEN protocol identifier (NUOp) assigned to the GEN0001 connectivity-test submission.

Ejemplo:

"12345678202606100000001"

status

string

requerido

Submission status; SUBMITTED until the counterparty's GEN0001R1 echo correlates by NUOp and flips it to CONFIRMED.

Ejemplo:

"SUBMITTED"

submittedAt

string

requerido

RFC3339 UTC timestamp when the submission was persisted before send.

Ejemplo:

"2026-06-10T12:00:00Z"

⌘I

Pix — Lerian SPI (mensajería nativa)

Pix — JD (interfaz, directo)

Pix — BTG (interfaz, indirecto)

TED — Lerian SPB (mensajería nativa)

TED — JD (interfaz)

Boletos — BTG (interfaz)

Lerian SILOC (mensajería nativa)

Lerian SLC (mensajería nativa)

Lerian STA (mensajería nativa)

Lerian SISBAJUD (mensajería nativa)

Lerian Consignado (mensajería nativa)

Iniciar prueba de conectividad (ECO)

Autorizaciones

Encabezados

Cuerpo

Respuesta