Saltar al contenido principal

Estado de pagos y transferencias

Los pagos y las transferencias tienen dos campos de estado, que la API devuelve juntos:

CampoQué responde
registration_status¿Se pidió el envío al banco? ¿El banco respondió?
status¿En qué punto está la orden?

Cuando los dos no coinciden, vale el status. Una orden puede tener status confirmed y registration_status requested o failed: el banco informó la liquidación antes de que Kobana registrara la aceptación. Mientras el status es pending, el registration_status indica si se pidió el envío y si el banco ya respondió.

registration_status​

ValorSignificado
pendingAún no enviada al banco.
requestedKobana pidió el envío al banco y espera la respuesta. En una remesa CNAB, la orden puede estar todavía en la cola de la próxima remesa, y la API no muestra cuándo el archivo llegó al banco.
confirmedEl banco aceptó la orden.
rejectedEl banco rechazó el registro.
failedEl envío no se completó. Ante un error temporal, Kobana lo intenta de nuevo, y la API no distingue ese reintento de una falla definitiva. No cree otra orden mientras el status no sea final: consulte la orden y, si sigue en failed, comuníquese con Soporte antes de crear otra.

status​

ValorSignificadoQuién actúa ahora¿Final?
pendingOrden creada. Consulte registration_status.Kobana o el bancoNo
awaiting_approvalA la espera de liberación.UstedNo
approvedLiberación aceptada, a la espera de ejecución.BancoNo
reprovedReprobada en la etapa de liberación.Cree otra ordenSí, solo se puede cancelar
scheduledEl banco la aceptó para la fecha programada.BancoNo
awaiting_scheduled_dateKobana la envía al banco en la fecha programada.KobanaNo
awaiting_fundsEl banco espera saldo en la cuenta.UstedNo
finishingEl banco está concluyendo la orden.BancoNo
confirmedEjecutada.NadieSí
rejectedEl banco la rechazó. El motivo está en rejected_error.Cree otra ordenSí
canceledCancelada.NadieSí
overdueSolo en transferencias. Pasó la fecha de vencimiento sin ejecutarse.Banco; usted, en la pantalla, si la transferencia aún no se envióNo

failed solo existe en registration_status, nunca en status.

confirmed y canceled son finales en el flujo normal. Un aviso posterior del banco aún puede cambiarlos: con una devolución o un reverso, confirmed puede pasar a rejected o canceled; con una liquidación o un rechazo informado en el archivo de retorno, canceled puede pasar a confirmed o rejected.

Principales transiciones​

No todos los bancos pasan por todos los estados: algunos van directamente de pending a confirmed.

Todas las transiciones​

Los diagramas siguientes muestran, por etapa, todos los cambios de estado del flujo regular. Cada flecha es un cambio posible, no un camino obligatorio. El banco puede informar un resultado fuera de secuencia, por lo que una orden puede llegar a un estado sin flecha correspondiente.

registration_status​

Cambios del campo registration_status, iguales en pagos y transferencias.

Inicio y liberación​

Ejecución​

Entradas en awaiting_funds y finishing.

Resultados​

Entradas en confirmed, rejected y canceled.

Estos diagramas son de pagos. En transferencias, existe el estado overdue, descrito a continuación.

overdue en transferencias​

Solo las transferencias vencen. Una transferencia en pending, awaiting_approval o awaiting_scheduled_date pasa a overdue cuando la fecha de vencimiento pasa sin ejecutarse. Desde allí, el banco aún puede informar otro estado.

La vuelta a pending solo ocurre con una transferencia aún no enviada al banco (registration_status pending), cuando usted guarda en la pantalla de la transferencia una nueva fecha de hoy en adelante. La API no puede cambiar esa fecha. Si el banco ya recibió la transferencia, solo el banco saca la orden de overdue.

Diferencias que suelen confundir​

  • rejected, reproved y failed. rejected es el rechazo del banco. reproved es la reprobación en la etapa de liberación. failed es un envío que no se completó.
  • awaiting_funds. No se convierte en overdue ni en failed. El resultado viene del banco.
  • overdue. Solo existe en transferencias y no es final: el banco aún puede ejecutarla o rechazarla. Consulte overdue en transferencias.
  • Cancelar en finishing, awaiting_funds u overdue. El estado no cambia. En pagos, la API rechaza la solicitud. En transferencias, la API acepta la solicitud, pero el estado sigue igual: si la transferencia ya fue al banco, la solicitud se le envía y la cancelación no se aplica.

Seguimiento de los cambios​

Cada cambio dispara payment.db.updated o transfer.db.updated. Consulte Eventos de webhook.

Consulte también Estado del pago y Seguimiento de transferencias, con las pantallas y las acciones disponibles en cada estado.