Los webhooks son eventos que gigstack envía a tu servidor en cuanto ocurre algo en tu cuenta. Con ellos mantienes tus herramientas sincronizadas sin consultar la API constantemente. Si aún no conoces la API, revisa primero Conociendo el API de gigstack.
Eventos disponibles
Pagos:
- payment.created, payment.updated, payment.succeeded, payment.canceled, payment.deleted, payment.upcomingduedate
Facturas:
- invoice.created, invoice.canceled, invoice.failed (cuando falla la creación automática de la factura)
Recibos de autofactura:
- receipt.created, receipt.updated, receipt.canceled, receipt.deleted
Clientes:
- client.created, client.updated, client.deleted
Estructura del evento
Cada evento que llega a tu servidor tiene esta forma:
{
"data": ClientObject | PaymentObject | ReceiptObject | InvoiceObject,
"team": "SXztwsWPvX7Fcv", // ID de la cuenta donde se creó el recurso
"webhook": "wh_6ZCY9e4", // ID del webhook
"event": "receipt.created", // tipo de evento
"livemode": true // true en producción, false en sandbox
}
Crear un webhook
-
Ve a Configuración, abre la pestaña API y haz clic en Nuevo Webhook.
-
Escribe la URL de tu servidor.
-
Agrega una descripción para identificarlo.
-
Selecciona los eventos que quieres escuchar.
-
Si lo necesitas, agrega headers de autenticación.
-
Haz clic en Crear Webhook.
Administrar tus webhooks
En Configuración, pestaña API, sección de webhooks creados, puedes desactivarlos temporalmente, editar su configuración o eliminarlos.
Es todo. Con los webhooks, tus herramientas siempre tienen la información al día. Si tienes dudas, escríbenos por el chat de soporte.