Recebendo Transferências TED na sua Conta BaaS
Esta funcionalidade da Celcoin permite que os clientes recebam transferências via TED de outras instituições financeiras em suas contas BaaS.
Nome e Número da Celcoin
Nome: Celcoin Instituição de Pagamento
Número: 509
Como Identificar uma Transferência via TED
Para identificar uma transferência via TED na sua conta BaaS, siga os seguintes passos:
- Prepare seu sistema para receber o Webhook de TED
spb-transfer-in
(transferências recebidas); - Ao receber o Webhook, analise o status da transação para obter informações sobre a transferência.
Modelos de Webhook de TED-in
O webhook spb-transfer-in
possui variações de estrutura conforme o tipo de transação TED, conforme exemplificado abaixo. Esses modelos variam nos campos enviados, especialmente no objeto debitParty
.
Campos comuns a todos os modelos
amount
id
numCtrlSTR
clientfinality
creditParty
currentBalance
oldBalance
(em alguns casos)typeCode
(identificador do modelo)
Modelos por Tipo
STR0008R2
{
"reason": "Emissão TED - Referência XYZ",
"numCtrlSTR": "STR20250416034200684",
"amount": 1280541.16,
"debitParty": {
"bank": "11223344",
"taxId": "44444444000177",
"accountType": "CC",
"name": "Instituição Exemplar S/A",
"personType": "J",
"branch": "1",
"account": "1122"
},
"currentBalance": 3700073.45,
"oldBalance": 2419532.29,
"id": "cccccccc-dddd-eeee-aaaa-bbbbbbbbbbbb",
"clientfinality": "10",
"creditParty": {
"bank": "87654321",
"taxId": "55555555000133",
"accountType": "CC",
"name": "Empresa ABCD Ltda",
"personType": "J",
"branch": "1",
"account": "445566"
},
"typeCode": "STR0008R2"
}
STR0007R2
{
"reason": "Transferencia entre contas",
"numCtrlSTR": "STR20250416034163430",
"amount": 2122.6,
"debitParty": {
"bank": "22334455",
"taxId": "22222222000181",
"name": "Financeira ABC",
"personType": "J"
},
"currentBalance": 2122.6,
"oldBalance": 0,
"id": "dddddddd-eeee-aaaa-bbbb-cccccccccccc",
"clientfinality": "40",
"creditParty": {
"bank": "87654321",
"taxId": "66666666001",
"accountType": "CC",
"name": "Maria Souza",
"personType": "F",
"branch": "1",
"account": "1123581321"
},
"typeMessage": "IF requisita Transferência de IF para conta de cliente",
"typeCode": "STR0007R2"
}
STR0051R2
{
"reason": "11223344556677889900 - Tribunal ABC - Parte A vs Parte B",
"numCtrlSTR": "STR20250415034156211",
"amount": 9772.93,
"debitParty": {
"bank": "00000000",
"taxId": "00000000000191",
"name": "Banco Exemplo S/A",
"personType": "J",
"branch": "1234"
},
"currentBalance": 14120.78,
"oldBalance": 4347.85,
"id": "eeeeeeee-aaaa-bbbb-cccc-dddddddddddd",
"clientfinality": "10",
"creditParty": {
"bank": "87654321",
"taxId": "77777777001",
"accountType": "CC",
"name": "Carlos Pereira",
"personType": "F",
"branch": "1",
"account": "9876543"
},
"typeCode": "STR0051R2"
}
Considerações Finais
Todos os exemplos são variações do evento spb-transfer-in
.
O campo typeCode
no payload informa o modelo da transação.
É necessário que o sistema do integrador trate dinamicamente a presença ou ausência dos campos opcionais, conforme o tipo de transação.
Recomendamos validar quais campos são críticos para o seu processo interno de negócio.
Confira aqui -> https://developers.celcoin.com.br/docs/webhooks-baas
Updated 8 days ago