Pular para o conteúdo principal

Status de pagamentos e transferências

Pagamentos e transferências têm dois campos de situação, retornados juntos pela API:

CampoO que responde
registration_statusO envio ao banco foi pedido? O banco respondeu?
statusEm que ponto a ordem está?

Quando os dois discordam, vale o status. Uma ordem pode estar com status confirmed e registration_status requested ou failed: o banco avisou a liquidação antes de a Kobana registrar o aceite. Enquanto o status é pending, o registration_status indica se o envio foi pedido e se o banco já respondeu.

registration_status​

ValorSignificado
pendingAinda não enviada ao banco.
requestedA Kobana pediu o envio ao banco e aguarda a resposta. Em remessa CNAB, a ordem pode ainda estar na fila da próxima remessa, e a API não mostra quando o arquivo chegou ao banco.
confirmedO banco aceitou a ordem.
rejectedO banco recusou o registro.
failedO envio não foi concluído. Em erro temporário, a Kobana tenta de novo, e a API não diferencia essa nova tentativa de uma falha definitiva. Não crie outra ordem enquanto o status não for final: consulte a ordem e, se ela continuar failed, fale com o Suporte antes de criar outra.

status​

ValorSignificadoQuem age agoraFinal?
pendingOrdem criada. Veja registration_status.Kobana ou bancoNão
awaiting_approvalAguardando liberação.VocêNão
approvedLiberação aceita, aguardando efetivação.BancoNão
reprovedReprovada na etapa de liberação.Crie outra ordemSim, só pode ser cancelada
scheduledO banco aceitou para a data agendada.BancoNão
awaiting_scheduled_dateA Kobana envia ao banco na data agendada.KobanaNão
awaiting_fundsO banco aguarda saldo na conta.VocêNão
finishingO banco está concluindo a ordem.BancoNão
confirmedEfetivada.NinguémSim
rejectedO banco recusou. O motivo está em rejected_error.Crie outra ordemSim
canceledCancelada.NinguémSim
overdueSó em transferências. Passou a data de expiração sem efetivação.Banco; você, pela tela, se a transferência ainda não foi enviadaNão

failed só existe em registration_status, nunca em status.

confirmed e canceled são finais no fluxo normal. Um aviso posterior do banco ainda pode mudá-los: com devolução ou estorno, confirmed pode virar rejected ou canceled; com liquidação ou recusa informada no arquivo de retorno, canceled pode virar confirmed ou rejected.

Principais transições​

Nem todo banco passa por todos os status: alguns vão direto de pending a confirmed.

Todas as transições​

Os diagramas abaixo mostram, por etapa, todas as mudanças de status do fluxo regular. Cada seta é uma mudança possível, não um caminho obrigatório. O banco pode informar um desfecho fora de sequência, e por isso uma ordem pode chegar a um status sem seta correspondente.

registration_status​

Mudanças do campo registration_status, iguais em pagamentos e transferências.

Início e liberação​

Execução​

Entradas em awaiting_funds e finishing.

Desfechos​

Entradas em confirmed, rejected e canceled.

Estes diagramas são de pagamentos. Em transferências, existe o status overdue, descrito a seguir.

overdue em transferências​

Só transferências vencem. Uma transferência em pending, awaiting_approval ou awaiting_scheduled_date passa a overdue quando a data de expiração passa sem efetivação. Dali, o banco ainda pode informar outro status.

A volta a pending só acontece com transferência ainda não enviada ao banco (registration_status pending), quando você salva na tela da transferência uma nova data de hoje em diante. A API não tem como mudar essa data. Se o banco já recebeu a transferência, só o banco tira a ordem de overdue.

Diferenças que costumam confundir​

  • rejected, reproved e failed. rejected é a recusa do banco. reproved é a reprovação na etapa de liberação. failed é o envio que não terminou.
  • awaiting_funds. Não vira overdue nem failed. O desfecho vem do banco.
  • overdue. Só existe em transferências e não é final: o banco ainda pode efetivar ou recusar. Veja overdue em transferências.
  • Cancelar em finishing, awaiting_funds ou overdue. O status não muda. Em pagamentos, a API recusa o pedido. Em transferências, a API aceita o pedido, mas o status continua o mesmo: se a transferência já foi ao banco, o pedido segue para ele e o cancelamento não é aplicado.

Acompanhar as mudanças​

Toda mudança dispara payment.db.updated ou transfer.db.updated. Veja Eventos de webhook.

Veja também Status do pagamento e Acompanhamento de transferências, com as telas e as ações disponíveis em cada situação.