Skip to main content
invoice.canceled

Qué significa

La API pública anuló el documento y detuvo los cobros pendientes compatibles. Ocurre cuando DELETE /api/v1/invoices/{invoiceId} se procesa sin reason o con reason: "DELETE_FROM_PROVIDER". El endpoint responde HTTP 204 sin cuerpo. El webhook se entrega de forma asíncrona y contiene la última proyección del cobro: invoice.status queda en DELETE_FROM_PROVIDER y invoice.payment.status queda en canceled.
El siguiente ejemplo fue validado en sandbox y sus identificadores, datos de cliente, teléfono y token fueron sanitizados para su publicación.

Payload completo

Correlación e idempotencia

Usa event.type + invoice.id como clave de deduplicación. Repetir el mismo DELETE sobre un documento ya anulado devuelve HTTP 204 y no crea un segundo evento de ciclo de vida. Aun así, la entrega es al menos una vez: Cobrix puede reenviar el mismo evento si no recibe la confirmación esperada.

Respuesta

Verifica x-cobrix-signature, guarda el evento y devuelve HTTP 200 exacto. Un 202 o 204 provoca reintento en este protocolo.