Command a rediscount operation

curl --request POST \
  --url https://api.example.com/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://api.example.com/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://api.example.com/v1/str/operations/rediscounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/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. Idempotent — the X-Idempotency key lives with the rediscount: the same key and parsed request (member order and whitespace do not count; any other difference, such as number spelling, null for an absent field, or an unknown member, is another request) answer the stored rediscount with X-Idempotency-Replayed: true, also after X-TTL has dropped the cached response, and the same key with another request answers 422.

POST

str

operations

rediscounts

Command a rediscount operation

curl --request POST \
  --url https://api.example.com/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://api.example.com/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://api.example.com/v1/str/operations/rediscounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/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"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency

string

requerido

Idempotency key. Required on every mutation.

X-TTL

string

Seconds the cached response is kept; it may only shorten IDEMPOTENCY_DEFAULT_TTL_SEC. The key itself lives with the rediscount.

Cuerpo

application/json

kind

enum<string>

requerido

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.

Opciones disponibles:

contract,

payment,

conversion,

cancellation

Ejemplo:

"contract"

selicOperation

string

requerido

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.

Ejemplo:

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

Ejemplo:

"1500000.00"

cedentAccount

string

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

Ejemplo:

"123456789"

clearingHouseIspb

string

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

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

Ejemplo:

"12345678"

contractFlavour

enum<string>

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

Opciones disponibles:

intraday,

oneBusinessDay,

selicPurchase,

collateralRelease,

consolidation

Ejemplo:

"intraday"

maturityDate

string

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

Ejemplo:

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

Ejemplo:

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

Opciones disponibles:

cash,

sale

Ejemplo:

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

Ejemplo:

"T"

preferenceLevel

enum<string>

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

Opciones disponibles:

A,

N

Ejemplo:

"N"

recontractTitleQuantity

string

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

Ejemplo:

"1000"

recontractUnitPrice

string

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

Ejemplo:

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

Ejemplo:

"1051000.00"

returnTitleQuantity

string

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

Ejemplo:

"1000"

returnUnitPrice

string

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

Ejemplo:

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

Ejemplo:

"000999"

titleId

string

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

Ejemplo:

"100000"

titleQuantity

string

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

Ejemplo:

"1000"

unitPrice

string

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

Ejemplo:

"1050.12345678"

Respuesta

Accepted

amount

string

requerido

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.

Ejemplo:

"1500000.00"

correlationId

string

requerido

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

Ejemplo:

"req-7a3f9c2e"

string<uuid>

requerido

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

Ejemplo:

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

kind

string

requerido

Operator-facing command kind, echoed back.

Ejemplo:

"contract"

status

string

requerido

Lifecycle state. PENDING on a fresh accept; a frame the alçada parked waits for its signatures before the wire.

Ejemplo:

"PENDING"

wireCode

string

requerido

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

Ejemplo:

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

Ejemplo:

"12345678202606150000014"

Auditoría

Capacidades

Certificados

Depósitos compulsorios (RCO)

Mensajes

Aprobaciones de emisión

Eventos

Avisos GEN

Gobernanza

Inteligencia operativa

Operaciones

Readiness

Conciliación

Redescuento (RDC)

Informes

Consultas de reserva

Responsables

Programación

Consultas de programación

Configuración

Cargos del BACEN (SLB)

Consultas SME

Manejo de errores

Command a rediscount operation

Autorizaciones

Encabezados

Cuerpo

Respuesta