Crear transferencia de liquidez de la Conta-PI

Prerrequisito: el rail debe estar listo antes de un envío: un certificado activo (ver rotateCertificate, activateCertificate), un reporte de disponibilidad READY (ver getReadiness) y una prueba de conectividad aprobada (ver createConnectivityTest). Acepta una transferencia de liquidez LPI de la Conta-PI a través de la API centrada en operaciones: la dirección aporte fondea la Conta PI de la IF desde su RB/CL (la plataforma DERIVA el código de red LPI0001), resgate retira fondos (LPI0003); la plataforma nunca compone el código de red. Persiste una proyección de transferencia de liquidez PENDING y devuelve el id de operación, el estado PENDING y el código de red derivado. Esto significa que el despacho fue aceptado, no una confirmación de liquidación de BACEN; la liquidación llega de forma asíncrona en la R-leg de entrada del STR y se lee mediante getLiquidityTransfer. Un aporte fuera de ventana se rechaza (RLPI0007). Lerian SPB EMITE el hecho de movimiento y proyecta el saldo de la Conta-PI de forma literal; nunca calcula una posición. Idempotente: reenviar la misma clave X-Idempotency con el mismo cuerpo devuelve la respuesta en caché.

POST /v1/str/operations/liquidity-transfers

Crear transferencia de liquidez de la Conta-PI

cURL

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/operations/liquidity-transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "<string>",
  "direction": "<string>",
  "accountType": "<string>",
  "contaPiISPB": "<string>"
}
'

202

{
  "operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "<string>",
  "wireCode": "<string>"
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Encabezados

Authorization · string

Bearer JWT token.

X-Idempotency · string

Idempotency key (canonical; legacy alias X-Idempotency-Key).

X-Idempotency-Key · string

Idempotency key (legacy alias).

X-TTL · string

Idempotency key TTL in seconds.

Cuerpo

application/json

amount · string · requerido

Movement amount as a decimal-reais string, forwarded verbatim into the LPI submit — Lerian SPB performs NO arithmetic on it.

Pattern: ^[0-9]+(\.[0-9]+)?$

Ejemplo:

"1500.25"

direction · string · requerido

Operator-facing movement direction: aporte funds the FI's Conta PI; resgate recalls funds from Conta PI.

Ejemplo:

"aporte"

accountType · string

Counterparty account type. RB_CL = Reservas Bancárias / Conta de Liquidação ((aporte,RB_CL)->LPI0001, (resgate,RB_CL)->LPI0003); CCME = Conta Correspondente a Moeda Eletrônica, own-account only ((aporte,CCME)->LPI0002, (resgate,CCME)->LPI0004). Empty defaults to RB_CL.

Ejemplo:

"RB_CL"

contaPiISPB · string

Optional Conta-PI owner ISPB (8 digits). Empty means the FI's OWN Conta PI (own-account path); a value differing from the issuer ISPB is the liquidante-funded path (RB_CL only). For CCME it must be empty or equal the issuer ISPB — CCME is own-account only.

Pattern: ^[0-9]{8}$

Ejemplo:

38166

Respuesta

202

application/json

Accepted

operationId · string<uuid> · requerido

Server-assigned operation UUID to poll on GET /v1/str/operations/liquidity-transfers/{operationId}.

Ejemplo:

"7c8b3a2e-9f1d-4a55-9b8e-1e1234567890"

status · string · requerido

Projection lifecycle status; PENDING on accept (awaiting the STR R-leg settlement confirmation).

Ejemplo:

"PENDING"

wireCode · string · requerido

LPI wire code derived server-side from (direction, accountType): (aporte,RB_CL)=LPI0001, (aporte,CCME)=LPI0002, (resgate,RB_CL)=LPI0003, (resgate,CCME)=LPI0004.

Ejemplo:

"LPI0001"