# payment.approved

> El evento payment.approved (Pago en línea aprobado) de ByDomu: cuándo se emite, cómo suscribirse, sus campos y el payload que llega por webhook.


Pago en línea aprobado

Objeto · payment Al instante

## Cuándo se emite

La pasarela de la inmobiliaria (Wompi, Mercado Pago o Conekta) aprobó un cobro en línea. kind dice si era de arriendo, factura o separación.

Al instante, cuando pasa en ByDomu: desde la app, la API, Noa, una automatización o una integración. `actor.kind` dice quién fue: USER, NOA, SYSTEM, API, AUTOMATION o INTEGRATION.

## Suscríbete con

- `payment.approved` Solo este evento
- `payment.*` Todos los de Pago en línea
- `*` Todo el catálogo

## Campos que trae

rutas para filtrar y plantillas

`payment.id` Identificador del pago

`payment.amount` Monto

`payment.currency` Moneda

`payment.method` Medio de pago

`payment.kind` Qué se cobró

`payment.reference` Referencia

Hasta 5 intentos (0 s, 5 s, 30 s, 2 min y 10 min) ante error de red, 429 o 5xx. Responde 2xx en menos de 10 s.

Payload:

```
{
  "event": "payment.approved",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "payment.approved",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "SYSTEM",
    "userId": null
  },
  "data": {
    "payment": {
      "id": "clx1pay001",
      "amount": 3580000,
      "currency": "COP",
      "method": "PSE",
      "kind": "rent_payment",
      "reference": "domu_rent_payment_clx1rpy001_4f9a2c1b7e3d",
      "status": "APPROVED",
      "provider": "WOMPI",
      "url": "https://checkout.wompi.co/l/EXAMPLE",
      "payerEmail": "camilo.duarte@example.com",
      "paidAt": "2026-09-04T16:10:00.000Z",
      "rentPaymentId": "clx1rpy001",
      "invoiceId": null,
      "reservationId": null
    }
  }
}
```

Encabezados:

```
X-Domu-Event: payment.approved
X-Domu-Signature: t=1790610130,v1=9c1e…
User-Agent: Domu-Webhooks/2
```

Verificar firma:

```
import { createHmac, timingSafeEqual } from "node:crypto";

// header = X-Domu-Signature: t=<timestamp>,v1=<hmac>
function verifyWebhook(rawBody, header, secret, toleranceSec = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const timestamp = Number(parts.t);
  if (!timestamp || !parts.v1) return false;
  if (Math.abs(Date.now() / 1000 - timestamp) > toleranceSec) return false;
  const expected = createHmac("sha256", secret)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(parts.v1);
  return a.length === b.length && timingSafeEqual(a, b);
}
```

**Pídelo con tus datos de prueba** GET /v1/webhooks/sample/payment.approved

[Probar](https://developers.bydomu.com/referencia/get-webhook-sample?probar=1&type=payment.approved)