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"
  }
}

Autorizações

Authorization

string

header

obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency

string

obrigatório

Idempotency key. Required on every mutation.

X-TTL

string

Idempotency key TTL in seconds.

Corpo

application/json

kind

enum<string>

obrigatório

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.

Opções disponíveis:

contract,

payment,

conversion,

cancellation

Exemplo:

"contract"

selicOperation

string

obrigatório

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.

Exemplo:

"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.

Exemplo:

"1500000.00"

cedentAccount

string

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

Exemplo:

"123456789"

clearingHouseIspb

string

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

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

Exemplo:

"12345678"

contractFlavour

enum<string>

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

Opções disponíveis:

intraday,

oneBusinessDay,

selicPurchase,

collateralRelease,

consolidation

Exemplo:

"intraday"

maturityDate

string

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

Exemplo:

"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.

Exemplo:

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

Opções disponíveis:

cash,

sale

Exemplo:

"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.

Exemplo:

"T"

preferenceLevel

enum<string>

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

Opções disponíveis:

A,

N

Exemplo:

"N"

recontractTitleQuantity

string

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

Exemplo:

"1000"

recontractUnitPrice

string

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

Exemplo:

"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.

Exemplo:

"1051000.00"

returnTitleQuantity

string

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

Exemplo:

"1000"

returnUnitPrice

string

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

Exemplo:

"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.

Exemplo:

"000999"

titleId

string

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

Exemplo:

"100000"

titleQuantity

string

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

Exemplo:

"1000"

unitPrice

string

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

Exemplo:

"1050.12345678"

Resposta

Accepted

amount

string

obrigatório

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.

Exemplo:

"1500000.00"

correlationId

string

obrigatório

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

Exemplo:

"req-7a3f9c2e"

string<uuid>

obrigatório

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

Exemplo:

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

kind

string

obrigatório

Operator-facing command kind, echoed back.

Exemplo:

"contract"

status

string

obrigatório

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

Exemplo:

"PENDING"

wireCode

string

obrigatório

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

Exemplo:

"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}$

Exemplo:

"12345678202606150000014"

Auditoria

Capacidades

Certificados

Recolhimento compulsório (RCO)

Mensagens

Aprovações de emissão

Entregas de eventos

Eventos

Avisos GEN

Governança

Inteligência operacional

Operações

Readiness

Conciliação

Redesconto (RDC)

Relatórios

Consultas de reserva

Responsáveis

Agendamento

Consultas de agendamento

Configurações

Cobranças do BACEN (SLB)

Consultas SME

Webhooks

Tratamento de erros

Command a rediscount operation

Autorizações

Cabeçalhos

Corpo

Resposta