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

# Preguntas frecuentes

Encuentra respuestas a tus preguntas más frecuentes sobre pagos, integración de API y servicios de Localpayment, lo que te ayudará a solucionar problemas más rápidamente y a mantenerte informado.

Obtén respuestas inmediatas a las preguntas más frecuentes sobre Localpayment. Este recurso abarca la integración, el procesamiento de pagos, la administración de cuentas y la resolución de problemas.

## Integración

> [accordion] ¿Cuánto tiempo se tarda en integrarse con Localpayment?
>
> La mayoría de los comerciantes puede completar la integración en un plazo de 1 a 2
> semanas, según sus recursos técnicos y la complejidad de su implementación.
> Nuestras API bien documentadas ayudan a acelerar el proceso.

> [accordion] ¿Cuáles son las diferentes opciones de integración disponibles?
>
> Localpayment ofrece múltiples opciones de integración:
>
> * **Integración por API**: Control
>   total sobre los flujos de pago con nuestra API REST
> * **Web Checkout**: Redirige
>   a los clientes a nuestra página de pago alojada
> * **Smart Fields**: Incrusta campos de pago
>   seguros en tu checkout
>
> Elige según tu experiencia técnica, los requisitos de cumplimiento de
> PCI DSS y la experiencia de usuario deseada.

> [accordion] ¿Proporcionáis SDK o bibliotecas cliente?
>
> Actualmente, ofrecemos API REST completas con documentación detallada y ejemplos. Si bien por el momento no ofrecemos SDK oficiales, nuestras API, bien estructuradas, están diseñadas para una fácil integración con cualquier lenguaje de programación.

> [accordion] ¿Cómo puedo probar mi integración antes de ponerla en marcha?
>
> Utiliza nuestro entorno de prueba con credenciales de prueba, que incluye números de tarjeta, cuentas bancarias, webhooks simulados y documentación completa para las pruebas. Recomendamos probar exhaustivamente todos los métodos de pago y escenarios de error antes de la implementación en producción para garantizar que tu integración gestione correctamente todos los casos posibles.

> [accordion] ¿Cuál es la diferencia entre los entornos de Stage y de producción?
>
> **Entorno de Stage**:
>
> * Solo para pruebas y desarrollo
> * No se procesa dinero real
> * Funcionalidad completa de la API
> * Datos de prueba y respuestas simuladas
>
> **Entorno de producción:**
>
> * Procesamiento de pagos en vivo
> * Transacciones financieras reales
> * Requisitos de seguridad más elevados
> * Rendimiento respaldado por SLA

***

## Pagos

> [accordion] ¿Qué métodos de pago admite Localpayment?
>
> Admitimos una amplia gama de métodos de pago en toda Latinoamérica:
>
> **Tarjetas**: Visa, Mastercard, American Express y esquemas de tarjetas locales Transferencias\
> **bancarias**: Debin (Argentina), Pix (Brasil) y más\
> **Billeteras digitales**: Wallet Fri y más\
> **Cuentas virtuales**: Números de cuenta dedicados para transferencias bancarias
>
> Los métodos disponibles varían según el país; consulta nuestra documentación sobre la cobertura por país para obtener información específica.

> [accordion] ¿Cómo funcionan las conversiones de divisas?
>
> Localpayment gestiona la conversión de divisas automáticamente:
>
> * Acepta pagos en monedas locales.
> * Realiza el pago en tu moneda preferida (USD, EUR, etc.).
> * Tipos de cambio competitivos con precios transparentes.
> * Tipos de cambio en tiempo real disponibles a través de API.

> [accordion] ¿A qué países apoyas?
>
> Actualmente brindamos soporte a operaciones en:
>
> * Argentina
> * Bolivia
> * Brasil
> * Chile
> * Colombia
> * Costa Rica
> * Guatemala
> * Honduras
> * México
> * Panamá
> * Paraguay
> * Perú
> * República Dominicana
>
> Nos expandimos constantemente a nuevos mercados. Contacta con nuestro equipo de ventas para conocer los próximos lanzamientos en otros países.

> [accordion] ¿Cuánto tiempo tarda en procesarse el pago?
>
> La velocidad de procesamiento varía según el método de pago utilizado. Los pagos con tarjeta generalmente se autorizan de inmediato, mientras que las transferencias bancarias pueden tardar más dependiendo de la red bancaria, y las billeteras digitales suelen procesarse rápidamente. El abono en tu cuenta bancaria se realiza según los plazos estándar establecidos para cada método de pago.

> [accordion] ¿Cuáles son los límites de las transacciones?
>
> Los límites de transacción varían según tu nivel de verificación, el método de pago utilizado, la normativa local y las evaluaciones de riesgo continuas. Recibirás límites predeterminados durante el proceso de registro y podrás solicitar límites más altos a medida que tu negocio crezca. Para consultar tus límites actuales, visita tu Business Portal o ponte en contacto con nuestro equipo de soporte.

***

## Cuentas y facturación

> [accordion] ¿Cómo creo una cuenta de Localpayment?
>
> Para crear una cuenta de Localpayment, primero deberás ponerte en contacto con nuestro equipo para que podamos evaluar tu negocio e iniciar el proceso de incorporación. Te guiaremos en cada paso necesario, incluyendo la verificación del negocio, el envío de documentación y la revisión de cumplimiento. Una vez aprobada tu incorporación, activaremos tu cuenta y te proporcionaremos tus credenciales de API para que puedas comenzar la integración.

> [accordion] ¿Qué tarifas cobran?
>
> Nuestros precios son transparentes y competitivos: - **Comisión porcentual**: Según
> el volumen de transacciones y el método de pago - **Comisión fija**: Cargo por transacción
>
> * **Margen de FX**: Por la conversión de divisas (si corresponde) - **Sin comisiones mensuales**
>   para cuentas estándar Los precios específicos se proporcionan durante el onboarding según
>   tu modelo de negocio, volumen y países. Contacta con ventas para obtener
>   precios personalizados para empresas.

> [accordion] ¿Cómo puedo acceder a mis fondos?
>
> Opciones de acceso a los fondos: - **Liquidaciones automáticas**: Diarias, semanales o mensuales a
> tu cuenta bancaria - **Retiros manuales**: Inicia payouts bajo demanda -
> **Cuentas en moneda local**: Mantén fondos en monedas locales - **Liquidaciones
> multidivisa**: Recibe fondos en USD, EUR u otras divisas principales Configura
> tus preferencias de liquidación en el Business Portal, en "Configuración de la cuenta".

> [accordion] ¿Qué documentos se requieren para la verificación de la cuenta?
>
> La documentación necesaria para la incorporación varía según el tipo de negocio, los métodos de pago que planees utilizar, el país donde operas y las obligaciones regulatorias aplicables. Nuestro equipo de cumplimiento revisará tu información y te proporcionará una lista de verificación personalizada durante el proceso de incorporación para garantizar que cumplas con todos los requisitos necesarios.

***

## Técnico

> [accordion] ¿Cómo funcionan los webhooks y cómo los configuro?
>
> Los webhooks proporcionan notificaciones en tiempo real de los eventos de las transacciones: Configura
> la URL de tu webhook en el Business Portal Selecciona qué eventos deseas recibir (payins,
> payouts, etc.) Implementa la verificación de firmas con el secreto de tu webhook
> Gestiona las solicitudes POST entrantes con cargas útiles JSON Todos los webhooks se envían por
> HTTPS e incluyen firmas de verificación por seguridad. Consulta nuestra documentación
> de webhooks para conocer todos los detalles de la implementación.

> [accordion] ¿Cómo gestiono los errores y los rechazos?
>
> Nuestra API devuelve respuestas de error estandarizadas: - Códigos de estado HTTP (4xx para
> errores del cliente, 5xx para errores del servidor) - Códigos y mensajes de error detallados -
> Errores de validación específicos de cada campo cuando corresponda Implementa un manejo
> de errores adecuado para mostrar mensajes fáciles de entender y registrar los errores para tu depuración. Consulta
> nuestra guía de manejo de errores para conocer las mejores prácticas.

> [accordion] ¿Ofrecen alguna colección de postman para realizar pruebas?
>
> ¡Sí! Ofrecemos colecciones de Postman completas que incluyen: -
> Entornos preconfigurados para Stage y Producción - Solicitudes de ejemplo para
> todos los endpoints de la API - Datos de prueba para diversos escenarios - Asistentes de autenticación
> Descarga nuestra colección de Postman desde el sitio de documentación.

> [accordion] ¿Cómo puedo consultar el estado de la transacción?
>
> Varias formas de consultar el estado de una transacción: API: Utiliza el endpoint
> de estado de la transacción con tu ID externo Business Portal: Consulta los informes de transacciones en tiempo real
> Webhooks: Recibe actualizaciones de estado automáticas Informes: Descarga los informes
> diarios de liquidación Recomendamos usar webhooks para el seguimiento del estado en tiempo real en tu
> aplicación.

***

## Seguridad y cumplimiento

> [accordion] ¿Localpayment cumple con la norma PCI DSS?
>
> Sí, Localpayment cumple con el Nivel 1 de PCI DSS, el nivel más alto de
> certificación en el sector de los pagos. Esto significa que mantenemos los
> estándares de seguridad más estrictos para el manejo de datos de pago. Al usar nuestras API o
> Web Checkout, reduce de forma significativa el alcance de tu cumplimiento de PCI DSS. Contáctenos
> para obtener una guía de cumplimiento específica para tu método de integración.

> [accordion] ¿Cómo protegen los datos de sus clientes?
>
> Empleamos múltiples medidas de seguridad: - Cifrado de datos en tránsito (TLS 1.2+)
> y en reposo - Tokenización para reemplazar los datos sensibles - Auditorías de seguridad periódicas
> y pruebas de penetración - Cumplimiento de SOC 2 Tipo II - Sistemas de detección y
> prevención de fraude La seguridad es fundamental para nuestra plataforma y
> invertimos continuamente en proteger tus datos.

> [accordion] ¿Qué herramientas de prevención de fraude ofrecen?
>
> Nuestra completa prevención del fraude incluye: - **3D Secure**: Autenticación
> adicional para los pagos con tarjeta - **Puntuación de riesgo**: Detección de fraude
> basada en aprendizaje automático - **Controles de velocidad**: Supervisión de los patrones de transacciones - **Geolocalización
> de IP**: Detección de patrones de ubicación sospechosos.

***

## Soporte

> [accordion] ¿Cómo puedo contactar con el servicio de asistencia?
>
> Soporte técnico:
> [support@localpayment.com](mailto:support@localpayment.com)

> [accordion] ¿Ofrecen asistencia técnica durante la integración?
>
> ¡Sí! Ofrecemos soporte integral para la integración: - Gerente técnico de cuenta
> dedicado para los clientes - Revisiones de integración y orientación sobre
> mejores prácticas - Asistencia en la revisión de código - Soporte y validación de pruebas
> Contacta con nuestro equipo de integración para programar una llamada de inicio y obtener
> soporte dedicado durante tu implementación.

> [accordion] ¿Dónde puedo encontrar la documentación de la API?
>
> Documentación completa disponible en: - **Referencia de la API**:
> docs.localpayment.com/reference - **Guías de integración**:
> docs.localpayment.com/docs -
> **Postman Collection**: Descárguela desde la documentación.

***

## Cuentas virtuales

> [accordion] ¿En nombre de quién se crean las cuentas virtuales?
>
> El titular legal de la cuenta (el nombre registrado en el sistema bancario) varía según el país. La siguiente tabla detalla los aspectos específicos:
>
> <table>
>   <thead>
>     <tr>
>       <th>
>         País
>       </th>
>
>       <th>
>         Residentes locales
>       </th>
>
>       <th>
>         residentes extranjeros
>       </th>
>
>       <th>
>         Propietario de la cuenta
>       </th>
>
>       <th>
>         Alias
>       </th>
>
>       <th>
>         Nombre para mostrar de la transferencia bancaria
>       </th>
>     </tr>
>   </thead>
>
>   <tbody>
>     <tr>
>       <td>
>         Argentina
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         * **FBO** = Residentes Extranjeros
>         * **DDA** = Residentes locales
>       </td>
>
>       <td>
>         Creación de hasta 1 alias
>       </td>
>
>       <td>
>         * **Nombre del beneficiario** (proporcionado durante la creación de la cuenta virtual, si es argentino)
>         * **Nombre de la entidad legal de Localpayment** (en todos los demás casos)
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Brasil
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         * **FBO** = Residentes Extranjeros
>         * **DDA** = Residentes locales
>       </td>
>
>       <td>
>         N / A
>       </td>
>
>       <td>
>         **Nombre de la entidad legal de Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Chile
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         N / A
>       </td>
>
>       <td>
>         **Nombre de la entidad legal de Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Colombia
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         Clave predeterminada
>       </td>
>
>       <td>
>         **Nombre de la entidad legal de Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         México
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **DDA** = Residentes locales
>       </td>
>
>       <td>
>         N / A
>       </td>
>
>       <td>
>         **Nombre de la entidad legal de Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Perú
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         N / A
>       </td>
>
>       <td>
>         **Nombre de la entidad legal de Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Costa Rica
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         N / A
>       </td>
>
>       <td>
>         **Nombre de la entidad legal de Localpayment**
>       </td>
>     </tr>
>   </tbody>
> </table>

> [accordion] ¿Las normas sobre cuentas virtuales son diferentes para las empresas locales?
>
> No. La posibilidad de crear cuentas virtuales tanto para residentes locales como extranjeros es la misma en Argentina, Brasil, Chile, Colombia, México y Perú.
>
> **Distinción importante para Argentina**: El **propietario legal (titular)** de la cuenta virtual difiere según la residencia del beneficiario:
>
> * **Para un beneficiario argentino**: La cuenta es propiedad legal del beneficiario designado.
>
> * **Para un beneficiario extranjero**: La cuenta es propiedad legal de la entidad local de Localpayment.

> [accordion] ¿Cuál es el costo del servicio de Cuenta Virtual?
>
> Las tarifas del servicio de Cuenta Virtual pueden variar según tu contrato comercial, volumen de operaciones y país. Para obtener información detallada y actualizada sobre precios, ponte en contacto con nuestro equipo de [ventas](mailto:sales@localpayment.com).

> [accordion] ¿Cuál es la diferencia entre una cuenta virtual y mi cuenta de Localpayment?
>
> Se trata de dos tipos de cuentas distintas que cumplen diferentes funciones en tu flujo de pagos:
>
> * **Tus cuentas internas de Localpayment**: Esta es tu cuenta maestra administrativa y de tesorería. Puedes tener varias cuentas maestras para diferentes unidades de negocio o regiones. Creada durante la incorporación, se utiliza para gestionar todas tus finanzas, configuraciones, informes, ajustes y operaciones de pago a través del Business Portal. Todos los fondos recaudados mediante Cuentas Virtuales y otros métodos se liquidan aquí para la gestión de tesorería.
>
> * **Cuenta Virtual**: Este es un **producto de Payin**. Se trata de una cuenta de cobro de pagos bajo demanda que funciona como una cuenta bancaria dedicada para recibir fondos mediante transferencias bancarias electrónicas. Su único propósito es canalizar los pagos entrantes de los clientes.

> [accordion] ¿Puedo transferir fondos directamente de una cuenta virtual a otra en diferentes países?
>
> No, esto no es posible. **Las cuentas virtuales están diseñadas exclusivamente para recibir fondos (pagos)**. No se pueden realizar transferencias ni enviar fondos de una cuenta virtual a otra.
>
> Una vez que los fondos se reciben en una Cuenta Virtual, se transfieren a tu **cuenta interna de Localpayment** vinculada. Luego, puedes distribuir estos fondos (incluso entre diferentes países) utilizando los servicios de pago o transferencia adecuados desde tu cuenta principal.

***

## Solución rápida de problemas

* **Problemas de autenticación:** comprueba tus credenciales de API, la validez del token y la inclusión de direcciones IP en la lista blanca.
* **Rechazo de pagos:** Verifica las tarjetas de prueba en el entorno de pruebas y revisa el estado y los límites de tu cuenta.
* **Problemas con los webhooks:** asegúrate de que tu endpoint utilice HTTPS, valide las firmas y devuelva respuestas 200 OK.
* **Errores de integración:** revisa los registros de tu API, realiza pruebas en el entorno de pruebas y consulta la documentación.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.