Introducción a Webhooks

Los webhooks de Global66 permiten a tu empresa recibir notificaciones automáticas cuando ocurren eventos relevantes en tus transacciones. No necesitas consultar periódicamente — Global66 se encarga de avisarte.

¿Cómo funciona?

Global66 te notifica

Cuando cambia el estado de una remesa o se reciben fondos, Global66 envía un EVENTO automático a tu endpoint con los datos del evento.

Tú validas y respondes

Tu servidor verifica que el header x-api-key coincida con tu clave y responde 200 OK. Así de simple.

Flujo de integración

1. Exponer un endpoint público

   Tu servidor necesita una URL pública que acepte peticiones con el método HTTP que configuraste y body JSON.

2. Registrar el webhook en Global66

   Proporciona tu endpoint_url y los eventos que quieres recibir: REMITTANCE_STATUS_CHANGE y/o MONEY_RECEIVED.

3. Obtener tu API Key

   Global66 te entrega una x-api-key única que debes guardar de forma segura.

4. Validar y responder 200

   Al recibir cada evento, compara el header x-api-key con tu clave y responde HTTP 200 OK de inmediato.

Eventos disponibles

remittanceUpdate Cambio de estado de una remesa — REMITTANCE_STATUS_CHANGE

paymentReceived Recepción de dinero por transferencia bancaria — MONEY_RECEIVED

---

Siguiente: Autenticación →