Set Conta-PI auto-transfer configuration

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). Declares the STR’s automatic-transfer policy per account class (the platform emits wire code LPI0005): for EACH class (RB/CL and CCME) set exactly ONE of — a value of ‘0’/‘0.00’ disables auto-transfer for that class. ‘Last message wins’: a new config fully replaces the prior one. Persists the last-sent config frame and returns the derived wire code, the submit status, and the NUOp. This means dispatch was accepted, not BACEN confirmation; the STR acknowledges asynchronously (LPI0005R1) and later reports each automatic transfer it performs (LPI0006). Lerian SPB forwards the config values verbatim; it performs NO arithmetic. Idempotent — replaying the same X-Idempotency key with the same body returns the cached response.

POST /v1/str/operations/auto-transfer-config

Set Conta-PI auto-transfer configuration

cURL

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/operations/auto-transfer-config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ccmePercent": "<string>",
  "ccmeValue": "<string>",
  "rbClPercent": "<string>",
  "rbClValue": "<string>"
}
'

202

{
  "status": "<string>",
  "wireCode": "<string>",
  "nuOp": "<string>"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Headers

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.

Body

application/json

ccmePercent · string

CCME class: percentage of the CCME balance to auto-transfer. Set exactly one of ccmePercent or ccmeValue. '0' disables auto-transfer for this class.

Example:

"25"

ccmeValue · string

CCME class: fixed decimal-reais amount to auto-transfer. Set exactly one of ccmePercent or ccmeValue. '0.00' disables auto-transfer for this class.

Example:

"300.00"

rbClPercent · string

RB/CL class: percentage of the reserve/settlement balance to auto-transfer. Set exactly one of rbClPercent or rbClValue. '0' disables auto-transfer for this class.

Example:

"50"

rbClValue · string

RB/CL class: fixed decimal-reais amount to auto-transfer. Set exactly one of rbClPercent or rbClValue. '0.00' disables auto-transfer for this class.

Example:

"1500.25"

Response

202

application/json

Accepted

status · string · required

Submit status: dispatch was accepted (the STR ACK arrives asynchronously as LPI0005R1).

Example:

"SUBMITTED"

wireCode · string · required

LPI wire code of the auto-transfer config-set (always LPI0005).

Example:

"LPI0005"

nuOp · string

SFN operation number stamped on the transmitted LPI0005 frame; the LPI0005R1 ACK correlates back to it.

Example:

"12345678202606190000005"