Skip to main content
Esta guía explica cómo actualizar el estado de los pagos en Confío cuando ocurren eventos logísticos como el envío y la entrega de productos. Estas actualizaciones son necesarias para el funcionamiento del sistema de custodia de Confío, donde los fondos se retienen hasta la aprobación del comprador.

​
Descripción general del proceso

Esta guía se enfoca en la parte logística del flujo de pagos de Confío, específicamente en las transiciones de estado relacionadas con el envío y entrega del producto:
  1. Partiendo de un pago en estado Funded (donde los fondos ya están en custodia)
  2. Cuando el producto es enviado, el pago debe actualizarse a estado Delivering
  3. Cuando el producto es entregado, el pago debe actualizarse a estado UnderReview
Estas transiciones de estado son críticas dentro del flujo completo de Confío y deben ser comunicadas mediante la API cuando ocurren los eventos logísticos correspondientes. Sin estas actualizaciones, los fondos permanecerán bloqueados y no podrán avanzar a las siguientes etapas del proceso.

​
Requisitos previos

Para implementar esta integración, necesitarás:
  1. Un token de acceso válido a la API de Confío
    Debes contactarnos para generar el token. Una vez generado, te recomendamos almacenarlo en un lugar seguro y no compartirlo
  2. Los identificadores de tienda y pago correspondientes
  3. Un sistema para detectar eventos logísticos (envío y entrega) y actualizar el estado en Confío

​
Actualización del estado al enviar un producto

Cuando un producto es enviado al comprador, actualiza el estado del pago a DELIVERING. Sin esta actualización, el pago permanecerá en estado Funded y no podrá avanzar en el ciclo de vida de la transacción.

​
Especificación del endpoint

curl -X PUT "https://api.confiopagos.com/v1/stores/{store}/payments/{payment}/status" \
  -H "Authorization: Bearer CONFIO_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "DELIVERING"
  }'

​
Actualización del estado para revisión tras la entrega

Cuando un producto ha sido entregado al comprador, actualiza el estado del pago a UNDER_REVIEW. Esta actualización inicia el período de revisión para el comprador. Sin esta actualización, los fondos permanecerán en custodia indefinidamente y no podrán ser liberados al vendedor.

​
Especificación del endpoint

curl -X PUT "https://api.confiopagos.com/v1/stores/{store}/payments/{payment}/status" \
  -H "Authorization: Bearer CONFIO_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "UNDER_REVIEW"
  }'

​
Mejores prácticas

  1. Actualiza los estados oportunamente: Realiza las actualizaciones cuando ocurre el evento logístico para mantener el flujo de fondos.
  2. Implementa reintentos: Configura un sistema de reintentos para garantizar que las actualizaciones se completen.
  3. Mantén registros: Guarda un registro de las actualizaciones para facilitar la resolución de problemas.
  4. Valida antes de actualizar: Verifica que el estado actual del pago sea coherente con la actualización que intentas realizar.

​
Recursos adicionales