Saltar al contenido principal
Localpayment te permite procesar reembolsos de Métodos de Pago Alternativos (APM) tanto mediante la integración con la API como a través de la interfaz del Business Portal. Esta guía cubre el flujo completo de reembolso para las transacciones de APM mediante el flujo de reembolsos que requieren datos.

Antes de comenzar

Asegúrate de tener:

Credenciales de API

Credenciales API válidas y token de acceso para la autenticación.

Configuración de la cuenta

Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

Lista blanca de IP

Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

Endpoint del webhook

Configura una URL de webhook para recibir notificaciones de pago.

Requisitos adicionales para el reembolso:

  • Debes tener saldo suficiente en tu cuenta de Localpayment para cubrir el importe del reembolso.
  • Rol de usuario con permisos de reembolso (consulta la documentación sobre roles de usuario).
  • La transacción original debe estar en estado Completed.
  • El externalId de la transacción de pago original.
  • Completa la información del beneficiario para los reembolsos que requieren datos.

Guía de implementación

Localpayment ofrece dos métodos para procesar reembolsos de APM: integración mediante API para el procesamiento automatizado y el Business Portal para operaciones manuales.

Procesamiento de reembolsos mediante API

Procesa reembolsos mediante programación a través de la API REST para flujos de trabajo automatizados e integración con tus sistemas.

Procesamiento de reembolsos del Business Portal

Gestiona manualmente los reembolsos a través del Business Portal de Localpayment, que cuenta con una interfaz fácil de usar.Nota: Todos los reembolsos del Business Portal requieren aprobación.

Reembolsos que requieren datos para APM

Los reembolsos de APM se procesan como reembolsos que requieren datos, lo que significa que necesitas tanto el externalId de la transacción original como la información completa del beneficiario. A diferencia de los reembolsos directos, este flujo requiere datos adicionales del pagador y del banco, ya que los pagos con QR implican información específica del beneficiario que debe ser verificada.
Importante:Solo se permiten reembolsos completos para las transacciones de APM. No se admiten reembolsos parciales.

Requisitos específicos de cada país

Los reembolsos de APM tienen requisitos y limitaciones específicos según el país y el método de pago. A continuación, se detallan las principales consideraciones específicas de cada país:
  • Flujo de reembolsos: Reembolsos que requieren datos con información completa del beneficiario.
  • Tipos de documentos: Tipos de documentos argentinos admitidos (CUIL, DNI, etc.).
  • Procesamiento: Los reembolsos se procesan a través de las redes bancarias locales argentinas.

Paso 1: Procesar el reembolso a través de la API.

Para reembolsar un pago de APM a través de la API, envía una solicitud PATCH al endpoint Reembolso.

Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza curl:
curl
Consulta todos los parámetros disponibles en la solicitud.

Paso 2: Gestionar la respuesta

Respuesta exitosa

Un reembolso procesado correctamente devuelve los detalles de confirmación:

Campos de respuesta clave

Respuesta de error

Cuando falla una solicitud de reembolso, recibirás información de error:

Escenarios de errores comunes


Reembolsos del Business Portal

Los reembolsos de APM también se pueden procesar a través de la interfaz del Business Portal de Localpayment. Este método proporciona un flujo de trabajo visual para gestionar los reembolsos y es particularmente útil para:
  • Reembolsos ocasionales que no requieren automatización mediante API.
  • Supervisión administrativa cuando se requieren flujos de trabajo de aprobación.
  • Procesamiento rápido de reembolsos sin necesidad de recursos de desarrollo.
Para obtener instrucciones detalladas sobre cómo procesar reembolsos a través del Business Portal, incluyendo guías paso a paso y tutoriales sobre la interfaz, consulta la Guía de Reembolsos del Business Portal .
Se requiere aprobación:Todos los reembolsos iniciados a través del Business Portal de Localpayment requieren aprobación mediante el flujo de trabajo de autorización designado. Asegúrate de contar con los permisos de usuario necesarios antes de intentar realizar reembolsos a través del Business Portal.

Paso 3: Seguimiento del estado del reembolso

Tras iniciar un reembolso, supervisa su progreso mediante estos métodos:

Webhooks (recomendado)

Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

Endpoint de la API de estado

Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

Vista del Business Portal

Interfaz visual para el seguimiento de transacciones. Ideal para la supervisión manual y el análisis detallado de las transacciones.

Códigos de estado de reembolso comunes

Referencia completaConsulta todos los códigos de estado en nuestra documentación sobre el estado de las transacciones.

Probando tu integración

Escenarios de prueba

Verifica que tu integración gestione estos escenarios:
  1. Reembolso exitoso: Procesa el reembolso con un externalId válido y fondos suficientes.
  2. Fondos insuficientes: Intentar realizar un reembolso con saldo insuficiente en la cuenta.
  3. Transacción no válida: Intenta reembolsar un externalId inexistente.
  4. Reembolso duplicado: Intentar reembolsar una transacción que ya ha sido reembolsada.
  5. Validación de permisos: Realiza pruebas con usuarios que tengan diferentes niveles de permisos.

Próximos pasos

Ver estado de la transacción

Verifica el estado actual de las transacciones y los reembolsos utilizando la API de estado de transacciones.

Configurar webhooks

Configura webhooks para recibir notificaciones en tiempo real sobre los cambios de estado de los reembolsos.

Revisar los roles de usuario

Gestiona los permisos y roles de usuario para las funciones de procesamiento de reembolsos.
Última modificación el 10 de noviembre de 2026