Estado de pagos y transferencias
Los pagos y las transferencias tienen dos campos de estado, que la API devuelve juntos:
| Campo | Qué 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
| Valor | Significado |
|---|---|
pending | Aún no enviada al banco. |
requested | Kobana 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. |
confirmed | El banco aceptó la orden. |
rejected | El banco rechazó el registro. |
failed | El 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
| Valor | Significado | Quién actúa ahora | ¿Final? |
|---|---|---|---|
pending | Orden creada. Consulte registration_status. | Kobana o el banco | No |
awaiting_approval | A la espera de liberación. | Usted | No |
approved | Liberación aceptada, a la espera de ejecución. | Banco | No |
reproved | Reprobada en la etapa de liberación. | Cree otra orden | Sí, solo se puede cancelar |
scheduled | El banco la aceptó para la fecha programada. | Banco | No |
awaiting_scheduled_date | Kobana la envía al banco en la fecha programada. | Kobana | No |
awaiting_funds | El banco espera saldo en la cuenta. | Usted | No |
finishing | El banco está concluyendo la orden. | Banco | No |
confirmed | Ejecutada. | Nadie | Sí |
rejected | El banco la rechazó. El motivo está en rejected_error. | Cree otra orden | Sí |
canceled | Cancelada. | Nadie | Sí |
overdue | Solo 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,reprovedyfailed.rejectedes el rechazo del banco.reprovedes la reprobación en la etapa de liberación.failedes un envío que no se completó.awaiting_funds. No se convierte enoverdueni enfailed. El resultado viene del banco.overdue. Solo existe en transferencias y no es final: el banco aún puede ejecutarla o rechazarla. Consulteoverdueen transferencias.- Cancelar en
finishing,awaiting_fundsuoverdue. 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.