> ## Documentation Index
> Fetch the complete documentation index at: https://developers.confiopagos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualiza el estado del pago con eventos logísticos

> Aprende a actualizar el estado de pagos cuando ocurren eventos logísticos

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.

```mermaid theme={null}
sequenceDiagram
    participant Sistema Logístico
    participant Tu Plataforma
    participant Confio

    Note over Confio: Estado: Funded

    Sistema Logístico->>Tu Plataforma: Notifica envío del producto
    Tu Plataforma->>Confio: Actualiza estado a DELIVERING
    Confio->>Tu Plataforma: Confirma actualización
    Note over Confio: Estado: Delivering

    Sistema Logístico->>Tu Plataforma: Notifica entrega del producto
    Tu Plataforma->>Confio: Actualiza estado a UNDER_REVIEW
    Confio->>Tu Plataforma: Confirma actualización
    Note over Confio: Estado: UnderReview
```

## Requisitos previos

Para implementar esta integración, necesitarás:

1. Un token de acceso válido a la API de Confío
   <Note>
     Debes contactarnos para generar el token. Una vez generado, te recomendamos
     almacenarlo en un lugar seguro y no compartirlo
   </Note>
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

```bash theme={null}
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

```bash theme={null}
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

* [Documentación de referencia de la API de Confío](/api-reference)
* [Guía de partners](/cookbooks/partners)
* [Contacto de soporte](mailto:soporte@confiopagos.com)