Command a rediscount operation

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/operations/rediscounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "kind": "contract",
  "selicOperation": "000123",
  "amount": "1500000.00",
  "cedentAccount": "123456789",
  "clearingHouseIspb": "12345678",
  "contractFlavour": "intraday",
  "maturityDate": "2027-01-01",
  "originalHandle": "RDC20260615000000001",
  "paymentForm": "cash",
  "paymentType": "T",
  "preferenceLevel": "N",
  "recontractTitleQuantity": "1000",
  "recontractUnitPrice": "1052.00000000",
  "returnAmount": "1051000.00",
  "returnTitleQuantity": "1000",
  "returnUnitPrice": "1051.00000000",
  "selicTradeKey": "000999",
  "titleId": "100000",
  "titleQuantity": "1000",
  "unitPrice": "1050.12345678"
}
'

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/operations/rediscounts"

	payload := strings.NewReader("{\n  \"kind\": \"contract\",\n  \"selicOperation\": \"000123\",\n  \"amount\": \"1500000.00\",\n  \"cedentAccount\": \"123456789\",\n  \"clearingHouseIspb\": \"12345678\",\n  \"contractFlavour\": \"intraday\",\n  \"maturityDate\": \"2027-01-01\",\n  \"originalHandle\": \"RDC20260615000000001\",\n  \"paymentForm\": \"cash\",\n  \"paymentType\": \"T\",\n  \"preferenceLevel\": \"N\",\n  \"recontractTitleQuantity\": \"1000\",\n  \"recontractUnitPrice\": \"1052.00000000\",\n  \"returnAmount\": \"1051000.00\",\n  \"returnTitleQuantity\": \"1000\",\n  \"returnUnitPrice\": \"1051.00000000\",\n  \"selicTradeKey\": \"000999\",\n  \"titleId\": \"100000\",\n  \"titleQuantity\": \"1000\",\n  \"unitPrice\": \"1050.12345678\"\n}")

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

	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-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    kind: 'contract',
    selicOperation: '000123',
    amount: '1500000.00',
    cedentAccount: '123456789',
    clearingHouseIspb: '12345678',
    contractFlavour: 'intraday',
    maturityDate: '2027-01-01',
    originalHandle: 'RDC20260615000000001',
    paymentForm: 'cash',
    paymentType: 'T',
    preferenceLevel: 'N',
    recontractTitleQuantity: '1000',
    recontractUnitPrice: '1052.00000000',
    returnAmount: '1051000.00',
    returnTitleQuantity: '1000',
    returnUnitPrice: '1051.00000000',
    selicTradeKey: '000999',
    titleId: '100000',
    titleQuantity: '1000',
    unitPrice: '1050.12345678'
  })
};

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

import requests

url = "https://spb.sandbox.lerian.net/v1/str/operations/rediscounts"

payload = {
    "kind": "contract",
    "selicOperation": "000123",
    "amount": "1500000.00",
    "cedentAccount": "123456789",
    "clearingHouseIspb": "12345678",
    "contractFlavour": "intraday",
    "maturityDate": "2027-01-01",
    "originalHandle": "RDC20260615000000001",
    "paymentForm": "cash",
    "paymentType": "T",
    "preferenceLevel": "N",
    "recontractTitleQuantity": "1000",
    "recontractUnitPrice": "1052.00000000",
    "returnAmount": "1051000.00",
    "returnTitleQuantity": "1000",
    "returnUnitPrice": "1051.00000000",
    "selicTradeKey": "000999",
    "titleId": "100000",
    "titleQuantity": "1000",
    "unitPrice": "1050.12345678"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "amount": "1500000.00",
  "correlationId": "req-7a3f9c2e",
  "id": "9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
  "kind": "contract",
  "status": "PENDING",
  "wireCode": "RDC0002",
  "nuOp": "12345678202606150000014"
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Command a rediscount operation

Commands a redesconto do Banco Central — collateralised BCB lending against Selic-registered federal securities — and returns the operation id plus a PENDING state. One door serves the four operator-facing kinds and the server derives the RDC wire code: a contract borrows (RDC0002 intraday, RDC0003 one business day, RDC0004 tied to a Selic purchase, RDC0009 tied to a clearing-house collateral release, RDC0013 a consolidation), a payment gives it back (RDC0007 in cash, RDC0008 funded by selling the pledged securities), a conversion liquidates an open operation and opens a repriced replacement (RDC0005), and a cancellation withdraws a request still pending at Selic (RDC0014). The outcome arrives asynchronously on the response leg — and an ACCEPTED answer is NOT a settlement: Selic may hold the request for want of securities, in which case the operation is registered, no money has moved, and no settlement fact is emitted. Lerian SPB records what BACEN answers; it holds no position and performs no balance arithmetic.

POST

str

operations

rediscounts

Command a rediscount operation

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/operations/rediscounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "kind": "contract",
  "selicOperation": "000123",
  "amount": "1500000.00",
  "cedentAccount": "123456789",
  "clearingHouseIspb": "12345678",
  "contractFlavour": "intraday",
  "maturityDate": "2027-01-01",
  "originalHandle": "RDC20260615000000001",
  "paymentForm": "cash",
  "paymentType": "T",
  "preferenceLevel": "N",
  "recontractTitleQuantity": "1000",
  "recontractUnitPrice": "1052.00000000",
  "returnAmount": "1051000.00",
  "returnTitleQuantity": "1000",
  "returnUnitPrice": "1051.00000000",
  "selicTradeKey": "000999",
  "titleId": "100000",
  "titleQuantity": "1000",
  "unitPrice": "1050.12345678"
}
'

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/operations/rediscounts"

	payload := strings.NewReader("{\n  \"kind\": \"contract\",\n  \"selicOperation\": \"000123\",\n  \"amount\": \"1500000.00\",\n  \"cedentAccount\": \"123456789\",\n  \"clearingHouseIspb\": \"12345678\",\n  \"contractFlavour\": \"intraday\",\n  \"maturityDate\": \"2027-01-01\",\n  \"originalHandle\": \"RDC20260615000000001\",\n  \"paymentForm\": \"cash\",\n  \"paymentType\": \"T\",\n  \"preferenceLevel\": \"N\",\n  \"recontractTitleQuantity\": \"1000\",\n  \"recontractUnitPrice\": \"1052.00000000\",\n  \"returnAmount\": \"1051000.00\",\n  \"returnTitleQuantity\": \"1000\",\n  \"returnUnitPrice\": \"1051.00000000\",\n  \"selicTradeKey\": \"000999\",\n  \"titleId\": \"100000\",\n  \"titleQuantity\": \"1000\",\n  \"unitPrice\": \"1050.12345678\"\n}")

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

	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-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    kind: 'contract',
    selicOperation: '000123',
    amount: '1500000.00',
    cedentAccount: '123456789',
    clearingHouseIspb: '12345678',
    contractFlavour: 'intraday',
    maturityDate: '2027-01-01',
    originalHandle: 'RDC20260615000000001',
    paymentForm: 'cash',
    paymentType: 'T',
    preferenceLevel: 'N',
    recontractTitleQuantity: '1000',
    recontractUnitPrice: '1052.00000000',
    returnAmount: '1051000.00',
    returnTitleQuantity: '1000',
    returnUnitPrice: '1051.00000000',
    selicTradeKey: '000999',
    titleId: '100000',
    titleQuantity: '1000',
    unitPrice: '1050.12345678'
  })
};

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

import requests

url = "https://spb.sandbox.lerian.net/v1/str/operations/rediscounts"

payload = {
    "kind": "contract",
    "selicOperation": "000123",
    "amount": "1500000.00",
    "cedentAccount": "123456789",
    "clearingHouseIspb": "12345678",
    "contractFlavour": "intraday",
    "maturityDate": "2027-01-01",
    "originalHandle": "RDC20260615000000001",
    "paymentForm": "cash",
    "paymentType": "T",
    "preferenceLevel": "N",
    "recontractTitleQuantity": "1000",
    "recontractUnitPrice": "1052.00000000",
    "returnAmount": "1051000.00",
    "returnTitleQuantity": "1000",
    "returnUnitPrice": "1051.00000000",
    "selicTradeKey": "000999",
    "titleId": "100000",
    "titleQuantity": "1000",
    "unitPrice": "1050.12345678"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "amount": "1500000.00",
  "correlationId": "req-7a3f9c2e",
  "id": "9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
  "kind": "contract",
  "status": "PENDING",
  "wireCode": "RDC0002",
  "nuOp": "12345678202606150000014"
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency

string

required

Idempotency key. Required on every mutation.

X-TTL

string

Idempotency key TTL in seconds.

Body

application/json

kind

enum<string>

required

Operator-facing command kind. The server derives the RDC wire code from this plus contractFlavour/paymentForm: contract -> RDC0002/0003/0004/0009/0013, payment -> RDC0007/0008, conversion -> RDC0005, cancellation -> RDC0014.

Available options:

contract,

payment,

conversion,

cancellation

Example:

"contract"

selicOperation

string

required

Selic operation number (NumOpSEL) of THIS frame — mandatory on all nine commands. On a payment it is that payment leg's own number, not the contract's: an intermediate partial takes a new number from the institution's daily range while the last one takes back the number the rediscount was granted under.

Example:

"000123"

amount

string

Financed amount (VlrFinanc) in decimal reais, forwarded verbatim — never parsed or multiplied out of quantity x unit price. On a conversion this is the amount of the NEW operation; the original's return amount is returnAmount. A cancellation carries NO amount and supplying one is refused: the RDC0014 layout declares none.

Example:

"1500000.00"

cedentAccount

string

Selic account of the securities cedent (CtCed). Contracts only.

Example:

"123456789"

clearingHouseIspb

string

ISPB of the clearing house whose collateral release backs the operation (ISPBLDL). contractFlavour=collateralRelease only.

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

Example:

"12345678"

contractFlavour

enum<string>

Which contract entry point (kind=contract only): intraday -> RDC0002, oneBusinessDay -> RDC0003, selicPurchase -> RDC0004, collateralRelease -> RDC0009, consolidation -> RDC0013.

Available options:

intraday,

oneBusinessDay,

selicPurchase,

collateralRelease,

consolidation

Example:

"intraday"

maturityDate

string

Maturity of the pledged security (DtVenc). Contracts only.

Example:

"2027-01-01"

originalHandle

string

BACEN handle (NumCtrlRDCOr) of the operation this command acts on — the NumCtrlRDC its contract response returned. Required by a payment, a conversion and a cancellation; refused on a contract, which opens an operation rather than acting on one.

Example:

"RDC20260615000000001"

paymentForm

enum<string>

How the payment is funded (kind=payment only): cash -> RDC0007 (own reserves), sale -> RDC0008 (proceeds of selling the pledged securities, which is why only this form carries selicTradeKey).

Available options:

cash,

sale

Example:

"cash"

paymentType

string

Payment form (TpPgto), a closed BACEN domain distinguishing a partial payment from a total one. Payments only. Partial payment is first-class and repeatable: the response reports the remaining balance and the operation stays open until it reaches zero.

Example:

"T"

preferenceLevel

enum<string>

Optional settlement priority (NivelPref): A = alta, N = normal. Payments and conversions.

Available options:

A,

N

Example:

"N"

recontractTitleQuantity

string

Quantity of the NEW operation a conversion opens. Conversions only.

Example:

"1000"

recontractUnitPrice

string

Unit price of the NEW operation a conversion opens (Grupo_RDC0005_ConvrRecontr). Conversions only.

Example:

"1052.00000000"

returnAmount

string

Amount of the ORIGINAL operation's return leg on a conversion. Kept separate from amount so neither half of a conversion can borrow the other's numbers. Conversions only.

Example:

"1051000.00"

returnTitleQuantity

string

Quantity of the ORIGINAL operation's return leg on a conversion (Grupo_RDC0005_VoltaOpOr). Conversions only.

Example:

"1000"

returnUnitPrice

string

Unit price the securities return at (PURet) — same eight-decimal price facet as unitPrice. Payments and conversions.

Example:

"1051.00000000"

selicTradeKey

string

Selic trade key (ChASEL) binding the rediscount to what backs it. Required by contractFlavour=selicPurchase (the purchase), contractFlavour=collateralRelease (the câmara release) and paymentForm=sale (the sale funding the payment); refused everywhere else.

Example:

"000999"

titleId

string

Selic identifier of the security being pledged (IdentdTitSEL). Contracts only.

Example:

"100000"

titleQuantity

string

Number of securities pledged (contracts) or returned (payments) — QtdTit.

Example:

"1000"

unitPrice

string

Unit price of the pledged security (PU) — a PRICE with eight decimal places, not a money amount. Contracts only.

Example:

"1050.12345678"

Response

Accepted

amount

string

required

Commanded amount, verbatim. A cancellation reports "0": the RDC0014 layout carries no amount, so this is a structural zero meaning the command moves no value — never a claim about the operation being cancelled.

Example:

"1500000.00"

correlationId

string

required

Request-scoped correlation identifier echoing X-Request-ID.

Example:

"req-7a3f9c2e"

string<uuid>

required

Rediscount operation UUID. Poll GET /v1/str/operations/rediscounts/{operationId} with it.

Example:

"9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"

kind

string

required

Operator-facing command kind, echoed back.

Example:

"contract"

status

string

required

Lifecycle state. Always PENDING here: the frame is on the wire and BACEN has said nothing yet.

Example:

"PENDING"

wireCode

string

required

RDC message code the server derived and put on the wire.

Example:

"RDC0002"

nuOp

string

SFN operation number stamped on the transmitted frame. It is the handle the response leg correlates on.

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

Example:

"12345678202606150000014"

Audit

Capabilities

Certificates

Compulsory deposits (RCO)

Messages

Emission approvals

Event deliveries

Events

GEN notices

Governance

Operational intelligence

Operations

Readiness

Reconciliation

Rediscounts (RDC)

Reports

Reserve queries

Responsibles

Schedule

Schedule queries

Settings

BACEN charges (SLB)

SME queries

Webhooks

Error handling

Command a rediscount operation

Authorizations

Headers

Body

Response