> ## 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.

# Introducción

> Bienvenido a la documentación para desarrolladores de Confio

Confio es una pasarela de pago para e-commerce que ofrece un sistema de custodia como alternativa segura al pago contra entrega. Funciona como intermediario reteniendo el pago hasta confirmar la entrega satisfactoria del producto, protegiendo así a compradores y vendedores en sus transacciones.

## ¿Qué es Confio?

Confio actúa como intermediario de confianza que garantiza:

* Seguridad para **compradores** al retener su dinero hasta recibir el producto
* Garantía para **vendedores** de que los fondos están asegurados tras una entrega exitosa

Este sistema elimina los riesgos del pago contra entrega y ofrece una opción confiable para productos de cualquier precio.

## Primeros Pasos

### Crear una Clave API

Para comenzar con la API de Confío, necesitarás obtener tu `CONFIO_ACCESS_TOKEN`.

**Cómo obtener tu token**:
Contacta a tu gerente de cuenta o asesor de Confío para solicitar tu token de acceso. El equipo de Confío coordinará la generación de tu token y la configuración de tu cuenta.

```bash .env theme={null}
CONFIO_ACCESS_TOKEN='tu_token_aqui'
```

> **Nota**: Actualmente no contamos con un portal de auto-gestión para desarrolladores. Todas las solicitudes de tokens y configuración de webhooks deben realizarse a través de tu gerente de cuenta de Confío.

### Realiza tu Primera Integración

Confio ofrece una API RESTful que puedes integrar utilizando cualquier cliente HTTP de tu elección. Aquí hay un ejemplo usando cURL:

### Ejemplos de API

#### Crear un Pago

```bash theme={null}
curl -X POST https://api.confiopagos.com/v1/stores/{store_id}/payments \
  -H "Authorization: Bearer CONFIO_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "correlationId": "order-12345",
    "amountCents": 5000000,
    "currencyCode": "COP",
    "mediaAssets": [
      "https://example.com/images/product1.jpg",
      "https://example.com/images/product2.jpg"
    ],
    "title": "Pago de prueba",
    "description": "Descripción detallada del producto o servicio (mínimo 24 caracteres)",
    "redirectUri": "https://tu-tienda.com/orden-confirmada",
    "buyer": {
      "firstName": "Juan Pérez",
      "phoneNumber": "+573215786325"
    }
  }'
```

<Note>
  Confío agregará automáticamente los siguientes query parameters a tu
  `redirectUri`: `status`, `payment_id` y `correlation_id`. Estos parámetros son
  meramente cosméticos para dar feedback al usuario y **no deben usarse para
  persistir información en tu sistema**.
</Note>

> **Nota sobre `redirectUri`**: Este parámetro opcional especifica la URL a la que Confío redireccionará al cliente después de completar el pago exitosamente. Si no se proporciona, el cliente permanecerá en la página de confirmación de Confío.

#### Obtener Estado del Pago

```bash theme={null}
curl -X GET https://api.confiopagos.com/v1/stores/{store_id}/payments/{payment_id} \
  -H "Authorization: Bearer CONFIO_ACCESS_TOKEN"
```

#### Actualizar Estado del Pago a Entregando

```bash theme={null}
curl -X PUT https://api.confiopagos.com/v1/stores/{store_id}/payments/{payment_id}/status \
  -H "Authorization: Bearer CONFIO_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "DELIVERING"
  }'
```

## Conceptos Clave

### Moneda Soportada

Actualmente, Confío solo soporta pagos en **pesos colombianos (COP)**. El campo `currencyCode` debe ser siempre `"COP"`.

### Monto Mínimo

El monto mínimo para crear un pago es de **\$10,000 COP** (1,000,000 centavos). Los montos deben especificarse en centavos.

Ejemplo:

* \$50,000 COP = 5,000,000 centavos
* \$100,000 COP = 10,000,000 centavos

### Estados de Pago

Entender los estados de pago de Confio es esencial para integrar con nuestra API:

* **AWAITING\_PAYMENT**: El pago ha sido creado pero el comprador aún no lo ha financiado
* **PAYMENT\_IN\_PROGRESS**: El comprador está en proceso de completar el pago
* **FUNDED**: El comprador ha completado el pago y los fondos se mantienen en custodia
* **DELIVERING**: El vendedor ha comenzado el proceso de entrega
* **UNDER\_REVIEW**: La entrega está completa y el comprador está revisando el producto
* **APPROVED**: El comprador ha aprobado la transacción y los fondos son liberados al vendedor
* **DISPUTED**: El comprador ha presentado una disputa sobre la transacción
* **REFUNDED**: La disputa se resolvió a favor del comprador
* **EXPIRED**: El pago no se completó dentro del plazo asignado
* **CANCELED**: El pago fue cancelado antes de ser completado
* **FAILED**: El intento de pago falló

## Siguientes Pasos

Ahora que entiendes los conceptos básicos de la API de Confio, puedes explorar los siguientes recursos:

<CardGroup cols={2}>
  <Card title="Crear un pago" href="/cookbooks/create-payment">
    Aprende a crear un pago paso por paso
  </Card>

  {" "}

  <Card title="Referencia de API" href="/api-reference">
    Documentación detallada de todos los endpoints de la API de Confio
  </Card>

  {" "}

  <Card title="Webhooks" href="/cookbooks/webhooks">
    Aprende a integrar webhooks para actualizaciones en tiempo real
  </Card>

  {" "}

  <Card title="Conviértete en partner" href="/cookbooks/partners">
    Aprende a integrar Confío con tu plataforma con el programa de partners
  </Card>
</CardGroup>