← Volver al inicio
API de cobros · Para desarrolladores

API y webhooks

Crea cobros y consulta sus estados desde tu sistema.

Esta información es pública. La documentación de cuenta requiere iniciar sesión.

API y webhooks de WarazPay

API v1

La documentación incluye la autenticación, los campos de cada solicitud y ejemplos de uso.

  • POST /api/v1/payments — Crear un cobro.
  • GET /api/v1/payments — Consultar cobros.
  • GET /api/v1/payments/{id} — Consultar una operación.
  • POST /api/v1/payments/{id}/cancel — Cancelar un cobro cuando su estado lo permita.

Ver documentación. Necesitas ingresar a tu cuenta.

Autenticación

Las solicitudes usan una llave de acceso y una firma HMAC. Guarda las credenciales en tu servidor, nunca en el código del navegador.

Usa la misma clave de idempotencia cuando reintentes la creación de un cobro. Así evitas duplicarlo si se interrumpe la conexión.

Webhooks

Configura la URL que recibirá las notificaciones. Comprueba la firma y el identificador del evento antes de actualizar el pedido. Tu sistema debe reconocer los eventos repetidos.

Pruebas

Verifica la creación del cobro, el vencimiento, la cancelación y la recepción de notificaciones. Los pagos de sandbox son simulados; no representan dinero recibido.