Transfer funds between client accounts

curl --request POST \
  --url https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/client-account-transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "CNPJ_CPFCliCredtd": "<string>",
  "CNPJ_CPFCliDebtd": "<string>",
  "DtMovto": "<string>",
  "FinlddCli": "<string>",
  "ISPBIFCredtd": "<string>",
  "NomCliCredtd": "<string>",
  "NomCliDebtd": "<string>",
  "TpCtCredtd": "<string>",
  "TpCtDebtd": "<string>",
  "TpPessoaCredtd": "<string>",
  "TpPessoaDebtd": "<string>",
  "VlrLanc": "<string>",
  "AgCredtd": "<string>",
  "AgDebtd": "<string>",
  "CodDocFis": "<string>",
  "CodIdentdTransf": "<string>",
  "CtCredtd": "<string>",
  "CtDebtd": "<string>",
  "CtPgtoCredtd": "<string>",
  "CtPgtoDebtd": "<string>",
  "DtAgendt": "<string>",
  "Hist": "<string>",
  "NivelPrefPAG": "<string>",
  "VlrCBS": "<string>",
  "VlrIBS": "<string>"
}
'

package main

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

func main() {

	url := "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/client-account-transfers"

	payload := strings.NewReader("{\n  \"CNPJ_CPFCliCredtd\": \"<string>\",\n  \"CNPJ_CPFCliDebtd\": \"<string>\",\n  \"DtMovto\": \"<string>\",\n  \"FinlddCli\": \"<string>\",\n  \"ISPBIFCredtd\": \"<string>\",\n  \"NomCliCredtd\": \"<string>\",\n  \"NomCliDebtd\": \"<string>\",\n  \"TpCtCredtd\": \"<string>\",\n  \"TpCtDebtd\": \"<string>\",\n  \"TpPessoaCredtd\": \"<string>\",\n  \"TpPessoaDebtd\": \"<string>\",\n  \"VlrLanc\": \"<string>\",\n  \"AgCredtd\": \"<string>\",\n  \"AgDebtd\": \"<string>\",\n  \"CodDocFis\": \"<string>\",\n  \"CodIdentdTransf\": \"<string>\",\n  \"CtCredtd\": \"<string>\",\n  \"CtDebtd\": \"<string>\",\n  \"CtPgtoCredtd\": \"<string>\",\n  \"CtPgtoDebtd\": \"<string>\",\n  \"DtAgendt\": \"<string>\",\n  \"Hist\": \"<string>\",\n  \"NivelPrefPAG\": \"<string>\",\n  \"VlrCBS\": \"<string>\",\n  \"VlrIBS\": \"<string>\"\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({
    CNPJ_CPFCliCredtd: '<string>',
    CNPJ_CPFCliDebtd: '<string>',
    DtMovto: '<string>',
    FinlddCli: '<string>',
    ISPBIFCredtd: '<string>',
    NomCliCredtd: '<string>',
    NomCliDebtd: '<string>',
    TpCtCredtd: '<string>',
    TpCtDebtd: '<string>',
    TpPessoaCredtd: '<string>',
    TpPessoaDebtd: '<string>',
    VlrLanc: '<string>',
    AgCredtd: '<string>',
    AgDebtd: '<string>',
    CodDocFis: '<string>',
    CodIdentdTransf: '<string>',
    CtCredtd: '<string>',
    CtDebtd: '<string>',
    CtPgtoCredtd: '<string>',
    CtPgtoDebtd: '<string>',
    DtAgendt: '<string>',
    Hist: '<string>',
    NivelPrefPAG: '<string>',
    VlrCBS: '<string>',
    VlrIBS: '<string>'
  })
};

fetch('https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/client-account-transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/client-account-transfers"

payload = {
    "CNPJ_CPFCliCredtd": "<string>",
    "CNPJ_CPFCliDebtd": "<string>",
    "DtMovto": "<string>",
    "FinlddCli": "<string>",
    "ISPBIFCredtd": "<string>",
    "NomCliCredtd": "<string>",
    "NomCliDebtd": "<string>",
    "TpCtCredtd": "<string>",
    "TpCtDebtd": "<string>",
    "TpPessoaCredtd": "<string>",
    "TpPessoaDebtd": "<string>",
    "VlrLanc": "<string>",
    "AgCredtd": "<string>",
    "AgDebtd": "<string>",
    "CodDocFis": "<string>",
    "CodIdentdTransf": "<string>",
    "CtCredtd": "<string>",
    "CtDebtd": "<string>",
    "CtPgtoCredtd": "<string>",
    "CtPgtoDebtd": "<string>",
    "DtAgendt": "<string>",
    "Hist": "<string>",
    "NivelPrefPAG": "<string>",
    "VlrCBS": "<string>",
    "VlrIBS": "<string>"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "attempts": 123,
  "codMsg": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "numCtrlIF": "<string>",
  "nuop": "<string>",
  "request": {
    "CNPJ_CPFCliCredtd": "<string>",
    "CNPJ_CPFCliDebtd": "<string>",
    "DtMovto": "<string>",
    "FinlddCli": "<string>",
    "ISPBIFCredtd": "<string>",
    "NomCliCredtd": "<string>",
    "NomCliDebtd": "<string>",
    "TpCtCredtd": "<string>",
    "TpCtDebtd": "<string>",
    "TpPessoaCredtd": "<string>",
    "TpPessoaDebtd": "<string>",
    "VlrLanc": "<string>",
    "AgCredtd": "<string>",
    "AgDebtd": "<string>",
    "CodDocFis": "<string>",
    "CodIdentdTransf": "<string>",
    "CtCredtd": "<string>",
    "CtDebtd": "<string>",
    "CtPgtoCredtd": "<string>",
    "CtPgtoDebtd": "<string>",
    "DtAgendt": "<string>",
    "Hist": "<string>",
    "NivelPrefPAG": "<string>",
    "VlrCBS": "<string>",
    "VlrIBS": "<string>"
  },
  "status": "SUBMITTED",
  "submittedAt": "2023-11-07T05:31:56Z",
  "answer": {
    "codMsg": "<string>",
    "movementDate": "2023-12-25",
    "numCtrlPAG": "<string>",
    "sitLancPAG": "<string>",
    "situationAt": "2023-11-07T05:31:56Z"
  },
  "answerAbsent": true,
  "answeredAt": "2023-11-07T05:31:56Z",
  "dispatchedAt": "2023-11-07T05:31:56Z",
  "lastError": "<string>"
}

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

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

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

Transfer funds between client accounts

Issues a PAG0108 “IF requisita Transferência de recursos entre contas de clientes” to the Câmara PAG (Catálogo de Serviços do SFN v5.13, Vol II). Requests a transfer of funds between natural or legal persons holding accounts at different financial institutions. The instruction is minted, built, signed, encrypted and durably recorded BEFORE anything reaches the queue, so this returns 202 with the control number the câmara will echo; the answer (PAG0108R1) arrives asynchronously and is read back with getPAG0108. Every amount is a decimal STRING carried to the wire exactly as written. A deployment with no send leg configured answers 503 with SILOC-0023; one whose dispatcher is not running answers 503 with SILOC-0024.

POST

api

siloc

outbound

client-account-transfers

Transfer funds between client accounts

curl --request POST \
  --url https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/client-account-transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "CNPJ_CPFCliCredtd": "<string>",
  "CNPJ_CPFCliDebtd": "<string>",
  "DtMovto": "<string>",
  "FinlddCli": "<string>",
  "ISPBIFCredtd": "<string>",
  "NomCliCredtd": "<string>",
  "NomCliDebtd": "<string>",
  "TpCtCredtd": "<string>",
  "TpCtDebtd": "<string>",
  "TpPessoaCredtd": "<string>",
  "TpPessoaDebtd": "<string>",
  "VlrLanc": "<string>",
  "AgCredtd": "<string>",
  "AgDebtd": "<string>",
  "CodDocFis": "<string>",
  "CodIdentdTransf": "<string>",
  "CtCredtd": "<string>",
  "CtDebtd": "<string>",
  "CtPgtoCredtd": "<string>",
  "CtPgtoDebtd": "<string>",
  "DtAgendt": "<string>",
  "Hist": "<string>",
  "NivelPrefPAG": "<string>",
  "VlrCBS": "<string>",
  "VlrIBS": "<string>"
}
'

package main

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

func main() {

	url := "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/client-account-transfers"

	payload := strings.NewReader("{\n  \"CNPJ_CPFCliCredtd\": \"<string>\",\n  \"CNPJ_CPFCliDebtd\": \"<string>\",\n  \"DtMovto\": \"<string>\",\n  \"FinlddCli\": \"<string>\",\n  \"ISPBIFCredtd\": \"<string>\",\n  \"NomCliCredtd\": \"<string>\",\n  \"NomCliDebtd\": \"<string>\",\n  \"TpCtCredtd\": \"<string>\",\n  \"TpCtDebtd\": \"<string>\",\n  \"TpPessoaCredtd\": \"<string>\",\n  \"TpPessoaDebtd\": \"<string>\",\n  \"VlrLanc\": \"<string>\",\n  \"AgCredtd\": \"<string>\",\n  \"AgDebtd\": \"<string>\",\n  \"CodDocFis\": \"<string>\",\n  \"CodIdentdTransf\": \"<string>\",\n  \"CtCredtd\": \"<string>\",\n  \"CtDebtd\": \"<string>\",\n  \"CtPgtoCredtd\": \"<string>\",\n  \"CtPgtoDebtd\": \"<string>\",\n  \"DtAgendt\": \"<string>\",\n  \"Hist\": \"<string>\",\n  \"NivelPrefPAG\": \"<string>\",\n  \"VlrCBS\": \"<string>\",\n  \"VlrIBS\": \"<string>\"\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({
    CNPJ_CPFCliCredtd: '<string>',
    CNPJ_CPFCliDebtd: '<string>',
    DtMovto: '<string>',
    FinlddCli: '<string>',
    ISPBIFCredtd: '<string>',
    NomCliCredtd: '<string>',
    NomCliDebtd: '<string>',
    TpCtCredtd: '<string>',
    TpCtDebtd: '<string>',
    TpPessoaCredtd: '<string>',
    TpPessoaDebtd: '<string>',
    VlrLanc: '<string>',
    AgCredtd: '<string>',
    AgDebtd: '<string>',
    CodDocFis: '<string>',
    CodIdentdTransf: '<string>',
    CtCredtd: '<string>',
    CtDebtd: '<string>',
    CtPgtoCredtd: '<string>',
    CtPgtoDebtd: '<string>',
    DtAgendt: '<string>',
    Hist: '<string>',
    NivelPrefPAG: '<string>',
    VlrCBS: '<string>',
    VlrIBS: '<string>'
  })
};

fetch('https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/client-account-transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/client-account-transfers"

payload = {
    "CNPJ_CPFCliCredtd": "<string>",
    "CNPJ_CPFCliDebtd": "<string>",
    "DtMovto": "<string>",
    "FinlddCli": "<string>",
    "ISPBIFCredtd": "<string>",
    "NomCliCredtd": "<string>",
    "NomCliDebtd": "<string>",
    "TpCtCredtd": "<string>",
    "TpCtDebtd": "<string>",
    "TpPessoaCredtd": "<string>",
    "TpPessoaDebtd": "<string>",
    "VlrLanc": "<string>",
    "AgCredtd": "<string>",
    "AgDebtd": "<string>",
    "CodDocFis": "<string>",
    "CodIdentdTransf": "<string>",
    "CtCredtd": "<string>",
    "CtDebtd": "<string>",
    "CtPgtoCredtd": "<string>",
    "CtPgtoDebtd": "<string>",
    "DtAgendt": "<string>",
    "Hist": "<string>",
    "NivelPrefPAG": "<string>",
    "VlrCBS": "<string>",
    "VlrIBS": "<string>"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "attempts": 123,
  "codMsg": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "numCtrlIF": "<string>",
  "nuop": "<string>",
  "request": {
    "CNPJ_CPFCliCredtd": "<string>",
    "CNPJ_CPFCliDebtd": "<string>",
    "DtMovto": "<string>",
    "FinlddCli": "<string>",
    "ISPBIFCredtd": "<string>",
    "NomCliCredtd": "<string>",
    "NomCliDebtd": "<string>",
    "TpCtCredtd": "<string>",
    "TpCtDebtd": "<string>",
    "TpPessoaCredtd": "<string>",
    "TpPessoaDebtd": "<string>",
    "VlrLanc": "<string>",
    "AgCredtd": "<string>",
    "AgDebtd": "<string>",
    "CodDocFis": "<string>",
    "CodIdentdTransf": "<string>",
    "CtCredtd": "<string>",
    "CtDebtd": "<string>",
    "CtPgtoCredtd": "<string>",
    "CtPgtoDebtd": "<string>",
    "DtAgendt": "<string>",
    "Hist": "<string>",
    "NivelPrefPAG": "<string>",
    "VlrCBS": "<string>",
    "VlrIBS": "<string>"
  },
  "status": "SUBMITTED",
  "submittedAt": "2023-11-07T05:31:56Z",
  "answer": {
    "codMsg": "<string>",
    "movementDate": "2023-12-25",
    "numCtrlPAG": "<string>",
    "sitLancPAG": "<string>",
    "situationAt": "2023-11-07T05:31:56Z"
  },
  "answerAbsent": true,
  "answeredAt": "2023-11-07T05:31:56Z",
  "dispatchedAt": "2023-11-07T05:31:56Z",
  "lastError": "<string>"
}

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

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

{
  "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 for this state-changing request (required, max 255 characters).

Maximum string length: 255

Cuerpo

application/json

CNPJ_CPFCliCredtd

string

requerido

CNPJ ou CPF Cliente Creditado (CNPJ_CPF, [1..1]).

CNPJ_CPFCliDebtd

string

requerido

CNPJ ou CPF Cliente Debitado (CNPJ_CPF, [1..1]).

DtMovto

string

requerido

Data Movimento (xs:date, [1..1]).

FinlddCli

string

requerido

Finalidade Cliente (FinlddCli, [1..1]).

ISPBIFCredtd

string

requerido

ISPB IF Creditada (ISPB, [1..1]).

NomCliCredtd

string

requerido

Nome Cliente Creditado (Nome, [1..1]).

NomCliDebtd

string

requerido

Nome Cliente Debitado (Nome, [1..1]).

TpCtCredtd

string

requerido

Tipo Conta Creditada (TpCt, [1..1]).

TpCtDebtd

string

requerido

Tipo Conta Debitada (TpCt, [1..1]).

TpPessoaCredtd

string

requerido

Tipo Pessoa Creditada (TpPessoa, [1..1]).

TpPessoaDebtd

string

requerido

Tipo Pessoa Debitada (TpPessoa, [1..1]).

VlrLanc

string

requerido

Valor Lançamento (Valor, [1..1]).

AgCredtd

string

Agência Creditada (Agencia, [0..1]).

AgDebtd

string

Agência Debitada (Agencia, [0..1]).

CodDocFis

string

Código Documento Fiscal (CodDocFis, [0..1]). Required when the Grupo_PAG0108_Split group is supplied; omit the whole group otherwise.

CodIdentdTransf

string

Código Identificador Transferência (CodIdentdTransf, [0..1]).

CtCredtd

string

Conta Creditada (CtBancaria, [0..1]). Exactly one of CtCredtd or CtPgtoCredtd is required.

CtDebtd

string

Conta Debitada (CtBancaria, [0..1]). Exactly one of CtDebtd or CtPgtoDebtd is required.

CtPgtoCredtd

string

Conta Pagamento Creditada (CtPgto, [0..1]). Exactly one of CtCredtd or CtPgtoCredtd is required.

CtPgtoDebtd

string

Conta Pagamento Debitada (CtPgto, [0..1]). Exactly one of CtDebtd or CtPgtoDebtd is required.

DtAgendt

string

Data Agendamento (xs:date, [0..1]).

Hist

string

Histórico (Historico, [0..1]).

NivelPrefPAG

string

Nível Preferência PAG (PrefPAG, [0..1]).

VlrCBS

string

Valor CBS (VlrNNegtv, [0..1]). Required when the Grupo_PAG0108_Split group is supplied; omit the whole group otherwise.

VlrIBS

string

Valor IBS (VlrNNegtv, [0..1]). Required when the Grupo_PAG0108_Split group is supplied; omit the whole group otherwise.

Respuesta

Accepted

attempts

integer<int64>

requerido

Queue-put attempts made so far.

codMsg

string

requerido

The SFN instruction code this row carries, e.g. PAG0107.

string<uuid>

requerido

Outbound message id.

numCtrlIF

string

requerido

The control number this institution issued (NumCtrlIF). The câmara echoes it on the answer, which is what correlates the two.

nuop

string

requerido

The BCMSG operation number of the frame.

request

object

requerido

The request exactly as it was submitted, projected verbatim.

Show child attributes

status

enum<string>

requerido

Lifecycle state. REFUSED means the câmara received the instruction and returned its E twin; FAILED means this rail could not deliver it. Both are terminal and they are different facts.

Opciones disponibles:

SUBMITTED,

DISPATCHED,

ANSWERED,

REFUSED,

FAILED

submittedAt

string<date-time>

requerido

When the instruction was recorded.

answer

object

What the câmara answered; omitted until it has answered.

Show child attributes

answerAbsent

boolean

True only on an ANSWERED message whose answer body this rail does not hold. The câmara did answer; what it wrote is not here, and the missing answer block is that absence, never an empty answer. Omitted otherwise.

answeredAt

string<date-time>

When the câmara's answer was applied; omitted until it is.

dispatchedAt

string<date-time>

When the frame reached the send queue; omitted until it has.

lastError

string

Why the last queue put failed, or — on REFUSED — the CodErro values the câmara marked, verbatim. Omitted when neither applies.

Integración

Conectividad

Homologación

Participantes

Ciclos y liquidación

Transferencias

Garantías

Ruta de tarjetas

Asientos y extractos

Avisos y notificaciones

Alertas y auditoría

Programación

Manejo de errores

Transfer funds between client accounts

Autorizaciones

Encabezados

Cuerpo

Respuesta