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