Create Conta-PI liquidity transfer
Prerequisite: the rail must be ready before a submit — an active certificate (see rotateCertificate, activateCertificate), a READY readiness report (see getReadiness), and a passing connectivity test (see createConnectivityTest). Accepts an LPI Conta-PI liquidity transfer through the operation-centric API: direction aporte funds the FI’s Conta PI from its RB/CL (the platform DERIVES wire code LPI0001), resgate recalls funds (LPI0003) — the platform never composes the wire code. Persists a PENDING liquidity-transfer projection and returns the operation id, the PENDING status, and the derived wire code. This means dispatch was accepted, not BACEN settlement confirmation; the settlement arrives asynchronously on the inbound STR R-leg and is read via getLiquidityTransfer. An out-of-window aporte is rejected (RLPI0007). Lerian SPB EMITS the movement fact and projects the Conta-PI balance verbatim; it never computes a position. Idempotent — replaying the same X-Idempotency key with the same body returns the cached response.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Bearer JWT token.
Idempotency key (canonical; legacy alias X-Idempotency-Key).
Idempotency key (legacy alias).
Idempotency key TTL in seconds.
Body
Movement amount as a decimal-reais string, forwarded verbatim into the LPI submit — Lerian SPB performs NO arithmetic on it.
^[0-9]+(\.[0-9]+)?$"1500.25"
Operator-facing movement direction: aporte funds the FI's Conta PI; resgate recalls funds from Conta PI.
"aporte"
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.
"RB_CL"
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.
^[0-9]{8}$38166
Response
Accepted
Server-assigned operation UUID to poll on GET /v1/str/operations/liquidity-transfers/{operationId}.
"7c8b3a2e-9f1d-4a55-9b8e-1e1234567890"
Projection lifecycle status; PENDING on accept (awaiting the STR R-leg settlement confirmation).
"PENDING"
LPI wire code derived server-side from (direction, accountType): (aporte,RB_CL)=LPI0001, (aporte,CCME)=LPI0002, (resgate,RB_CL)=LPI0003, (resgate,CCME)=LPI0004.
"LPI0001"

