Status de pagamentos e transferências
Pagamentos e transferências têm dois campos de situação, retornados juntos pela API:
| Campo | O que responde |
|---|---|
registration_status | O envio ao banco foi pedido? O banco respondeu? |
status | Em 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
| Valor | Significado |
|---|---|
pending | Ainda não enviada ao banco. |
requested | A 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. |
confirmed | O banco aceitou a ordem. |
rejected | O banco recusou o registro. |
failed | O 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
| Valor | Significado | Quem age agora | Final? |
|---|---|---|---|
pending | Ordem criada. Veja registration_status. | Kobana ou banco | Não |
awaiting_approval | Aguardando liberação. | Você | Não |
approved | Liberação aceita, aguardando efetivação. | Banco | Não |
reproved | Reprovada na etapa de liberação. | Crie outra ordem | Sim, só pode ser cancelada |
scheduled | O banco aceitou para a data agendada. | Banco | Não |
awaiting_scheduled_date | A Kobana envia ao banco na data agendada. | Kobana | Não |
awaiting_funds | O banco aguarda saldo na conta. | Você | Não |
finishing | O banco está concluindo a ordem. | Banco | Não |
confirmed | Efetivada. | Ninguém | Sim |
rejected | O banco recusou. O motivo está em rejected_error. | Crie outra ordem | Sim |
canceled | Cancelada. | Ninguém | Sim |
overdue | Só em transferências. Passou a data de expiração sem efetivação. | Banco; você, pela tela, se a transferência ainda não foi enviada | Nã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,reprovedefailed.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 viraoverduenemfailed. O desfecho vem do banco.overdue. Só existe em transferências e não é final: o banco ainda pode efetivar ou recusar. Vejaoverdueem transferências.- Cancelar em
finishing,awaiting_fundsouoverdue. 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.