Webhooks

Los webhooks te permiten recibir notificaciones en tiempo real sobre eventos importantes en tu cuenta de Linka.

Configurar webhooks

1. Entra al dashboard de Linka.
2. Ve a Settings > Webhooks.
3. Agrega la URL de tu endpoint.
4. Selecciona los eventos que quieres recibir.

Eventos webhook

Eventos de pago

• payment.created - Se creo un nuevo pago.
• payment.completed - El pago fue completado.
• payment.failed - El pago fallo.

Eventos de compra

• purchase.created - Se creo una nueva compra.
• purchase.completed - La compra fue completada.
• purchase.failed - La compra fallo.

Payload del webhook

Todos los webhooks usan una estructura similar:

{
  "event": "payment.completed",
  "data": {
    "id": "pay_123",
    "amount": "100.00",
    "currency": "USDC",
    "status": "completed"
  },
  "timestamp": "2024-01-01T00:00:00Z"
}

Verificar webhooks

Cada webhook incluye un header de firma que puedes usar para validar la solicitud:

X-Linka-Signature: sha256=...

Seguridad

• Verifica siempre la firma del webhook.
• Usa HTTPS para tus endpoints.
• Implementa idempotencia para manejar eventos duplicados.