Reembolsos en Cobre

Reembolsos aún está en desarrollo activo: parte de la funcionalidad descrita en este documento puede no estar disponible todavía para su cuenta. Contacte a su KAM (Key Account Manager) para conocer el estado actual del despliegue.

Emita reembolsos totales y parciales en rieles de payin de Colombia a través de una sola API

Los reembolsos permiten a los clientes de Cobre devolver fondos a un pagador respecto de un payin original, sin construir lógica de reversión personalizada por método de pago. En lugar de manejar la lógica de reembolso de forma distinta para cada riel, los clientes llaman a un único endpoint referenciando la transacción original, y Cobre resuelve automáticamente el riel y la ruta de payout correctos.

1. Qué habilita Cobre con Reembolsos

Emitir reembolsos totales o parciales sobre un money movement o transaction de payin completado mediante una sola llamada a la API.

Referenciar la transacción original por money_movement_id o transaction_id — sin necesidad de reconstruir manualmente los datos del pago o del pagador.

Disponible hoy para Colombia, cubriendo direct_debit_nequi (tokenización Nequi) y r2p_breb. Próximamente: soporte para r2p_pse, r2p_bancolombia y créditos por llave estática BreB, junto con cobertura en México (spei_credit, r2p_spei).

Emitir múltiples reembolsos parciales sobre el mismo payin original, hasta su monto original.

2. Reembolsos en el modelo de Cobre

Un reembolso se modela como un money movement de payout vinculado a un payin original. Cuando un cliente solicita un reembolso, Cobre debita el Cobre Balance que recibió originalmente el payin y crea un nuevo payout hacia el pagador, reutilizando la información de contraparte ya asociada a ese payin.

Los reembolsos solo aplican a money movements de tipo payin — las transacciones de transfer-in no son elegibles. Como el reembolso toma fondos del mismo balance que recibió el dinero, el cliente debe tener saldo suficiente allí para que el reembolso se procese; Cobre no toma fondos de reembolso de ningún otro balance.

3. Capacidades clave

3.1 Reembolsos totales y parciales

Los clientes pueden devolver el monto completo de un payin o una porción de él. Los reembolsos parciales pueden emitirse más de una vez sobre el mismo payin original, siempre que el monto reembolsado combinado nunca exceda lo recibido originalmente.

3.2 Referencia flexible de la transacción

Un reembolso puede solicitarse usando el money_movement_id del payin original o su transaction_id, de modo que los clientes puedan disparar el reembolso desde el identificador que ya rastrean internamente.

3.3 Resolución del riel a cargo de Cobre

Los clientes no eligen ni configuran el riel de reembolso. Cobre resuelve la ruta de payout correcta con base en el riel del payin original y la contraparte ya registrada para él.

3.4 Resumen de reembolso — totales acumulados por payin

Además de cada intento individual de reembolso, Cobre mantiene un resumen de reembolso — un acumulador de totales por payin original. Una sola consulta devuelve el monto original, el monto ya reembolsado, el monto actualmente reservado por intentos en curso, el monto aún reembolsable y la lista de intentos individuales, sin que el cliente deba obtener y sumar cada intento por su cuenta.

3.5 Captura de datos del pagador para reembolsos PSE y Bancolombia (v2)

Para rieles en los que Cobre no recibe la cuenta bancaria ni los datos de identificación del pagador como parte del payin original (r2p_pse, r2p_bancolombia), el intento de reembolso se crea con estado waiting_for_information y Cobre devuelve un data_capture_url — un enlace que el pagador sigue para enviar de forma segura los datos faltantes de cuenta bancaria e identificación. El reembolso continúa automáticamente una vez que el pagador completa este paso, antes del plazo data_capture_url_expires_at.

4. Conceptos y terminología

Payin: el money movement original que acreditó un Cobre Balance y es elegible para un reembolso.

Refund (reembolso): un money movement de payout creado por Cobre, que referencia un payin original y devuelve fondos al pagador original.

Refund attempt (rfe_): una solicitud individual de reembolso sobre un payin, con su propio ciclo de vida de estado.

Refund summary (rf_): el acumulador de totales a lo largo de todos los intentos de reembolso sobre un mismo payin original.

money_movement_id: identificador interno de Cobre para un money movement; una de las dos formas aceptadas para referenciar el payin original al solicitar un reembolso.

transaction_id: el identificador de transacción asociado al payin original; la otra referencia aceptada para una solicitud de reembolso.

Cobre Balance: el balance virtual debitado para fondear el reembolso; debe ser el mismo balance que recibió el payin original.

data_capture_url: enlace devuelto cuando un intento de reembolso está en waiting_for_information, usado por el pagador para enviar la cuenta bancaria y los datos de identificación requeridos para completar un reembolso PSE o Bancolombia.

Counterparty: el registro de cuenta del pagador que Cobre reutiliza para enrutar el reembolso.

5. Confiabilidad y dependencias

La finalización de un reembolso depende de los mismos factores que cualquier payout en el riel resuelto: validez de la cuenta destino y el comportamiento de procesamiento del riel subyacente. No se puede solicitar un reembolso sobre un payin que ya fue reembolsado por completo, y los reembolsos parciales combinados no pueden exceder el monto del payin original.

6. Casos de uso de negocio típicos

Disputas o solicitudes de reembolso del cliente — devolver fondos a un pagador que disputa o solicita la reversión de un pago ya recibido.

Corrección de pago duplicado — previsto como caso de uso futuro: devolver fondos de un payin que duplica otro pago ya completado.

Los reembolsos encajan en estos casos porque permiten al cliente resolver un problema orientado al pagador sin salir de la plataforma Cobre ni volver a capturar manualmente los datos de payout ya conocidos de la transacción original.

7. Transacciones, reportes y conciliación

Como el reembolso se emite como un money movement de payout, genera su propio registro de transacción, distinto — pero vinculado — a la transacción del payin original. Los clientes pueden rastrear el estado de un reembolso de la misma forma que cualquier otro money movement, y conciliario contra el débito que produce en el Cobre Balance de origen.

8. Gobernanza, controles y auditabilidad

Los reembolsos los inicia el cliente a través de la API: no hay un flujo de reembolso de autoservicio orientado al pagador. Como un reembolso solo puede tomar fondos del balance que recibió el payin original, la capacidad de reembolso queda acotada de forma natural por los fondos disponibles en ese balance. Una vez ejecutado el payout del reembolso, revertirlo no es una capacidad integrada: deshacerlo requiere un proceso manual separado fuera del flujo de reembolso.

9. Resumen — Qué entrega Cobre con Reembolsos

✔ Una sola API para devolver fondos a un pagador, sin reconstruir lógica de payout por riel.

✔ Soporte de reembolsos totales y parciales, referenciados por money_movement_id o transaction_id.

✔ Resolución automática del riel y de la contraparte con base en el payin original.

✔ Disciplina de balance integrada: los reembolsos solo toman fondos del balance que recibió el dinero original.

✔ Un resumen de reembolso que reporta totales acumulados por payin, sin sumar manualmente los intentos individuales.

✔ Captura segura de datos del pagador para reembolsos PSE y Bancolombia, de modo que el reembolso pueda continuar incluso cuando Cobre aún no tiene los datos bancarios del pagador.

Los reembolsos dan a los clientes de Cobre una forma directa de resolver disputas y solicitudes de corrección del pagador en rieles de payin de Colombia hoy, con cobertura más amplia en Colombia y México planificada a medida que la capacidad se expanda.

Reembolsos en Cobre

Emita reembolsos totales y parciales en rieles de payin de Colombia a través de una sola API#

1. Qué habilita Cobre con Reembolsos#

2. Reembolsos en el modelo de Cobre#

3. Capacidades clave#

3.1 Reembolsos totales y parciales#

3.2 Referencia flexible de la transacción#

3.3 Resolución del riel a cargo de Cobre#

3.4 Resumen de reembolso — totales acumulados por payin#

3.5 Captura de datos del pagador para reembolsos PSE y Bancolombia (v2)#

4. Conceptos y terminología#

5. Confiabilidad y dependencias#

6. Casos de uso de negocio típicos#

7. Transacciones, reportes y conciliación#

8. Gobernanza, controles y auditabilidad#

9. Resumen — Qué entrega Cobre con Reembolsos#

Emita reembolsos totales y parciales en rieles de payin de Colombia a través de una sola API

1. Qué habilita Cobre con Reembolsos

2. Reembolsos en el modelo de Cobre

3. Capacidades clave

3.1 Reembolsos totales y parciales

3.2 Referencia flexible de la transacción

3.3 Resolución del riel a cargo de Cobre

3.4 Resumen de reembolso — totales acumulados por payin

3.5 Captura de datos del pagador para reembolsos PSE y Bancolombia (v2)

4. Conceptos y terminología

5. Confiabilidad y dependencias

6. Casos de uso de negocio típicos

7. Transacciones, reportes y conciliación

8. Gobernanza, controles y auditabilidad

9. Resumen — Qué entrega Cobre con Reembolsos