Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cobrix.co/llms.txt

Use this file to discover all available pages before exploring further.

Cuando creas un pago con callbackUrl, Cobrix envía un HTTP POST a esa URL al completarse.

​
Payload

{
  "eventType": "external_payment.completed",
  "resourceType": "external_payment",
  "companyId": "company-uuid",
  "payload": {
    "id": "payment-uuid",
    "status": "completed",
    "amountMinor": 15000,
    "currency": "VES",
    "invoiceId": "invoice-uuid",
    "paymentId": "internal-payment-uuid"
  }
}
CampoDescripción
eventTypeTipo de evento
resourceTypeRecurso afectado (external_payment)
companyIdUUID de la empresa dueña del pago
payloadDetalle del pago

​
Eventos

EventoDisparador
external_payment.completedEl pago se procesó con éxito

​
Comportamiento

  • Los webhooks son fire-and-forget — no bloquean la respuesta de la API.
  • Las entregas fallidas se registran pero no se reintentan automáticamente.
  • El contador de intentos queda en el registro del pago.
  • Si necesitas confiabilidad total, poll el endpoint Get Payment.

​
Recomendaciones

1

Responde 200 rápido

Responde 200 OK en menos de 5 segundos.
2

Procesa asíncrono

Encola el payload y procésalo fuera del handler HTTP.
3

Deduplica

Usa payload.id como clave para evitar doble-procesar el mismo evento.
4

Valida con GET

Para operaciones críticas, confirma siempre con GET /api/external/payments/{id}.