Realizar uma Transferência via TED

Essa funcionalidade permite que os clientes da Celcoin consigam efetuar transferências TED para instituições financeira


📘

Restrições de horário

Dias da semana: A funcionalidade de TED estará disponível exclusivamente de segunda a sexta-feira.
Horário de início: A partir das 06:30 (horário local).
Horário de término: Até as 17:00 (horário local).


Passos para Integrar

  1. Realizar autenticação na API - [API Reference]
  2. Realizar uma transferência TED - [API Reference]
  3. Receber o Webhook com Status do TED

Caso seja necessário você pode consultar o status do TED manualmente.

Descrição dos campos

CampoDescriçãoTipo Campo
amountValor da transação.
clientCodeIdentificador único da transação gerado pelo cliente.
accountNúmero da conta de origem (Quem irá pagar).
bankIdentificador do Banco de destino (ISPB - Identificador de Sistema de Pagamentos Brasileiro).
accountNúmero da Conta de destino (Quem irá receber).
branchNúmero da agência de destino.
taxIdNúmero do documento (CPF ou CNPJ) da conta de destino.
nameNome da conta de destino
accountTypeTipo de Conta.CC - Conta Corrente
CI - Conta Investimento
PG - Conta de Pagamento
PP - Conta Poupança
personTypeTipo de Pessoa.F - Fisica
J - juridica
clientFinalityFinalidade1 - Pagamento de Impostos, Tributos e Taxas
3 - Pagamentos de Dividendos
4 - Pagamento de Salários
5 - Pagamento de Fornecedores
7 - Pagamento de Aluguéis e Taxas de Condomínio
9 - Pagamento de Mensalidade Escolar
10 - Crédito em Conta
100 - Depósito Judicial
110 - Transferência entre contas de mesma titularidade
99999 - Outros
descriptionCampo opcional.
Caso o campo clientFinality estiver como 99999, este campo vai se tornar obrigatório.

📘

Importante

Para realizar o envio de uma TED com sucesso no ambiente de sandbox, é necessário preencher o campo 'bank' com qualquer ISPB válido (exceto 13935893, que corresponde à Celcoin) e o campo 'account' com '000001', ambos no objeto 'creditParty'.

⚠️

Atenção

O dígito verificador deve ser enviado junto ao número da conta. Em caso de agência com dígito verificador, este deve ser removido.

JSON de exemplo

{
   "amount":0.01,
   "clientCode":"ad575298-8e81-4f90-a0b0-f3a04d8a48c6",
   "debitParty":{
      "account":"30023646056255"
   },
   "creditParty":{
      "bank":"30306294",
      "account":"000001",
      "branch":"20",
      "taxId":"09958359006",
      "name":"Joao Silva Santos",
      "accountType":"CC",
      "personType":"J"
   },
   "clientFinality":"110",
   "description":""
}

cURL da chamada

curl --location 'https://sandbox.openfinance.celcoin.dev/baas-wallet-transactions-webservice/v1/spb/transfer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Token}}' \
--data '{
    "amount": 0.01,
    "clientCode": "ad575298-8e81-4f90-a0b0-f3a04d8a48c6",
    "debitParty": {
        "account": "30023646056255"
    },
    "creditParty": {
        "bank": "30306294",
        "account": "000001",
        "branch": "20",
        "taxId": "09958359006",
        "name": "Joao Silva Santos",
        "accountType": "CC",
        "personType": "J"
    },
     "clientFinality": "110"
}'

Exemplo de retorno

👍

Sucesso 200

{
  "status": "PROCESSING",
  "version": "1.0.0",
  "body": {
    "id": "34fee7bc-4d40-4605-9af8-398ed7d0d6b5",
    "amount": 0,
    "clientCode": "1458854",
    "debitParty": {
      "account": "444444",
      "branch": "1",
      "taxId": "11122233344",
      "name": "Celcoin",
      "accountType": "CACC",
      "personType": "F",
      "bank": "30306294"
    },
    "creditParty": {
      "bank": "30306294",
      "account": "10545584",
      "branch": "1",
      "taxId": "11122233344",
      "name": "Celcoin",
      "accountType": "CC",
      "personType": "F"
    }
  }
}

Error 400

{
  "version": "1.0.0",
  "status": "ERROR",
  "error": {
    "errorCode": "CIE999",
    "message": "Ocorreu um erro interno durante a chamada da api."
  }
}

Tabela de errorCode

CodeMessage
CBE001ClientCode é obrigatório.
CBE093ClientCode possui tamanho maximo de 200 caracteres.
CBE094amount é obrigatório.
CBE095amount invalido.Favor verificar a formatação do campo e deve ser maior que 0.
CBE100Existe um lançamento idêntico pendente.Favor aguarde para realizar esta operação para evitar duplicidade.
CBE101Já existe um lançamento com o mesmo clientCode. Favor realizar uma nova operação.
CBE102Lançamento de debito não permitido.Valor ultrapassa o limite maximo permitido por operação.
CBE107debitParty é obrigatório.
CBE108debitparty.account é obrigatório.
CBE109debitparty.account invalido.
CBE110debitparty.account possui tamanho maximo de 20 caracteres.
CBE115creditParty é obrigatório.
CBE116creditparty.account é obrigatório.
CBE117creditparty.account invalido.
CBE118creditparty.account possui tamanho maximo de 20 caracteres.
CBE119creditParty.branch é obrigatório.
CBE120creditParty.branch invalido.
CBE121creditParty.taxId é obrigatório.
CBE122creditParty.taxId invalido.
CBE123Transação não permitida.Conta com saldo insuficiente.
CBE124Lançamento não permitido.debit.account esta encerrada.
CBE126creditParty.bank é obrigatório e deve existir na lista de participantes Pix.
CBE127creditParty.name é obrigatório e possui tamanho maximo de 120 caracteres.
CBE128creditParty.accountType não foi informado ou é invalido.
CBE159Lançamento não permitido.Sua conta esta bloqueada.
CBE269creditParty.personType não foi informado ou é invalido.
CBE270clientFinality não foi informado ou é invalido.
CBE271Campo description obrigatorio quando o campo clientFinality estiver preenchido com 99999 (Outros).
CBE272É necessário informar pelo menos um dos campos: id ou clientCode.
CBE274Não é permitido enviar TED para a mesma conta sendo do mesmo Participante.
CBE275Não é permitido TED para outra titularidade.