Documento público pagado

invoice.paid

Qué significa

El documento quedó completamente pagado y su saldo pendiente llegó a cero. Cobrix produce exactamente un invoice.paid tanto cuando el pago termina en Cobrix como cuando el proveedor confirma un pago mediante PAID_FROM_PROVIDER. Cuando el pago se originó en Cobrix, invoice.status puede ser PAID y luego avanzar a CONCILIATED. Cuando fue confirmado por el proveedor, permanece como PAID_FROM_PROVIDER para conservar el origen de la operación.

Payload completo

{
  "invoice": {
    "id": "1c981ecd-9a91-407c-944c-b3e7953e6185",
    "name": "Plan mensual de internet",
    "amount": 20,
    "provider": "erp_acme",
    "provider_id": "1001",
    "reference": "DOC-EXT-1001",
    "status": "PAID_FROM_PROVIDER",
    "remarks": null,
    "metadata": {},
    "due_date": "2026-08-15T00:00:00.000000Z",
    "created_at": "2026-07-14T16:00:00.000000Z",
    "updated_at": "2026-07-14T16:10:00.000000Z",
    "payment_id": "e849e271-34fb-4d16-a07e-fecbf97b2b4e",
    "is_test": true,
    "payment": {
      "id": "e849e271-34fb-4d16-a07e-fecbf97b2b4e",
      "source": "Plan mensual de internet",
      "currency": "USD",
      "amount": 20,
      "amount_label": "$ 20",
      "title": "Plan mensual de internet",
      "description": "Plan mensual de internet",
      "phone": "+584120000000",
      "expiration_at": null,
      "due_date": "2026-08-15T00:00:00.000000Z",
      "document_link": null,
      "external_id": "1001",
      "allows": {
        "accounts": true,
        "cards": true,
        "card_extra": false,
        "realtime": false
      },
      "status": "APPROVED",
      "is_test": true,
      "created_at": "2026-07-14T16:00:00.000000Z",
      "paid_at": "2026-07-14T16:10:00.000000Z",
      "payment_link": "https://pay.cobrix.co/c/e849e271",
      "redirect_url": null,
      "provider_id": "provider-payment-5001",
      "metadata": null,
      "customer": null,
      "method": null,
      "splits": [],
      "company": null,
      "commission": null
    }
  },
  "event": {
    "type": "invoice.paid",
    "timestamp": 1784045400,
    "environment": "test",
    "company_id": "7d355d52-ac74-49f5-b31c-ce29b4680752"
  }
}

Procesamiento seguro

Deduplica por X-Cobrix-Event-Id: el valor se conserva durante todos los reintentos y reenvíos del mismo evento. Como defensa adicional, guarda también event.type e invoice.id. Antes de aplicar una acción irreversible, confirma:

invoice.status es PAID, CONCILIATED o PAID_FROM_PROVIDER.
payment.status es APPROVED.
payment.paid_at contiene la fecha real del pago aplicado.
Para PAID_FROM_PROVIDER, payment.provider_id coincide con el identificador público enviado al confirmar el pago.

Cobrix crea el evento después de persistir el pago, su aplicación financiera y el saldo cero. La respuesta de la operación pública no espera a que tu receptor acepte el webhook.

​Qué significa

​Payload completo

​Procesamiento seguro

Qué significa

Payload completo

Procesamiento seguro