Para consultar el catálogo exhaustivo derivado del esquema, consulta todos los ejemplos.
Qué es
Gestiona las actualizaciones del estado de pago de WhatsApp.Antes de comenzar
- Crea un endpoint HTTPS público en tu aplicación.
- Configura un endpoint de webhook de YCloud para los tipos de eventos que necesites.
- Almacena el secreto de firma del endpoint de forma segura.
- Haz que el procesamiento de eventos sea idempotente.
Cómo funciona
YCloud envía una solicitud HTTPPOST cuando ocurre el evento. Verifica la firma, registra el evento de forma duradera, devuelve una respuesta 2xx y procesa las tareas lentas de forma asíncrona.
Solicitud
Los escenarios a continuación muestran las solicitudes enviadas a tu URL de webhook. Trata el eventoid como el identificador de entrega y utiliza type para enrutar la carga útil.
Respuesta
Devuelve un estado2xx después de aceptar el evento.
Para la configuración del endpoint, la validación de firmas y el comportamiento de reintentos, consulta Configurar webhooks.
Transacción de pago actualizada
Recibes actualizaciones a través de webhooks cuando cambia el estado de la transacción iniciada por el usuario. Ocurre cuando el estado del pago cambia acaptured (cuando el pago se completa con éxito) o a pending (cuando el usuario lo intentó pero aún no se recibe la señal de transacción exitosa).
Solicitud
Respuesta
Confirma la recepción tras aceptar el evento de forma duradera.Explicación
- Para enviar mensajes con detalles del pedido para recibir pagos, consulta Mensaje de plantilla de detalles del pedido y Mensaje interactivo de detalles del pedido.
- Una vez que el cliente intente realizar el pago, recibirás actualizaciones del pago. Para notificar al cliente el estado del pedido, consulta Mensaje de plantilla de estado del pedido y Mensaje interactivo de estado del pedido.