Skip to main content
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.
.env
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

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"
    }
  }'
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.
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

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

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:

Crear un pago

Aprende a crear un pago paso por paso

Referencia de API

Documentación detallada de todos los endpoints de la API de Confio

Webhooks

Aprende a integrar webhooks para actualizaciones en tiempo real

Conviértete en partner

Aprende a integrar Confío con tu plataforma con el programa de partners