Foro

Estimado equipo de Soporte Técnico de Clip,

Les escribo para solicitar su orientación técnica respecto a la integración de la API de Checkout v2 que me encuentro realizando en mi sitio web en un entorno de pruebas (Sandbox).

Actualmente, mi backend genera de forma correcta la solicitud de pago mediante una petición POST al endpoint https://api.payclip.com/v2/checkout, obteniendo el objeto JSON con el estatus CHECKOUT_CREATED y la URL de redirección (payment_request_url). El flujo de pago en su interfaz se completa sin inconvenientes.

Mi consulta está enfocada estrictamente en el retorno del usuario a mi página de éxito (redirection_url -> success). Necesito capturar y procesar de forma segura el resultado de la transacción en mi backend para tomar decisiones de negocio automatizadas (como actualizar el estado del pedido en mi base de datos y liberar el producto).

Para lograrlo de forma óptima, requiero que me apoyen aclarando los siguientes puntos:

Parámetros en la URL de retorno: Al configurarse la propiedad success, ¿qué parámetros exactos añade la pasarela de Clip por defecto a la URL de redirección cuando el usuario vuelve a mi sitio web? Además de mi referencia personalizada (external_reference), ¿envían el identificador de la transacción bajo la llave payment_request_id, id o alguna otra variante?

Endpoint para Webhook o Consulta GET: Para validar el estatus real del pago desde mi backend (evitando que el usuario manipule las variables de la URL), ¿el método correcto es realizar una petición GET al endpoint https://api.payclip.com/v2/checkout/{payment_request_id}? De ser así, ¿cuáles son los strings o estados exactos que puede devolver el campo status cuando el pago ha sido liquidado con éxito (por ejemplo: PAID, SUCCESSFUL)?

Agradezco de antemano su apoyo para proporcionarme la estructura exacta o la documentación correspondiente para asegurar la lógica de mi backend en este paso del flujo.