Saltar al contenido principal
Aprende cómo realizar tu primer pago de prueba utilizando la API de Localpayment y comprende los aspectos esenciales para ejecutar flujos de pago seguros en tu entorno de pruebas. Para empezar, realiza tu primer pago de prueba con la API de Localpayment en el entorno de pruebas. Podrás autenticar tus solicitudes, explorar los métodos de pago disponibles, realizar un pago con tarjeta, gestionar webhooks y comprobar el estado final de la transacción.

Descripción general

Localpayment Sandbox es una plataforma de pruebas completa que reproduce nuestro entorno de producción sin procesar transacciones reales. Proporciona un espacio seguro para probar tu integración con diversos métodos de pago, monedas y países antes de su lanzamiento.

Entorno de pruebas

Utiliza nuestro endpoint de API de entorno de pruebas dedicado para todas las actividades de prueba.

Datos de prueba

Accede a tarjetas de prueba y cuentas completas para todos los escenarios.

Simulación en tiempo real

Recibe notificaciones instantáneas de webhook para todas las transacciones de prueba.

Referencia de la API

Explora nuestra documentación completa de la API con ejemplos.

Antes de comenzar

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.

Paso 1: Generar token de acceso

Para interactuar con la API de Localpayment, necesitas un token de acceso para la autenticación. Este token es necesario para todas las solicitudes a la API. Para generar un token de acceso, deberás enviar una solicitud POST al endpoint Generar un token de acceso con tu username y password de Localpayment incluidos en el cuerpo de la solicitud como un objeto JSON.

Ejemplo de solicitud

curl

Respuesta exitosa

ImportanteUtiliza el token access de la respuesta en todas las solicitudes posteriores a la API. Inclúyelo en el encabezado Authorization como Bearer <your_access_token>. Los tokens caducan por motivos de seguridad; utiliza el token de actualización para obtener nuevos tokens de acceso sin necesidad de volver a autenticarse.

Paso 2: Recuperar los métodos de pago disponibles

Antes de realizar un pago, comprueba qué métodos de pago están disponibles para tu cuenta y país de destino. Para conocer los métodos de pago disponibles, envía una solicitud GET al endpoint Obtener métodos de pago disponibles , incluyendo tu accountNumber como parámetro de consulta.

Ejemplo de solicitud

curl

Respuesta exitosa

Para pagos con tarjeta, busca los métodos de pago donde paymentMethodType sea CreditCard o DebitCard. Toma nota del valor de code (por ejemplo, 1000 para Visa en Argentina), ya que lo necesitarás para la solicitud de pago.

Paso 3: Crear una solicitud de pago

Ahora ya puedes crear tu primer pago de prueba. Usaremos como ejemplo un pago con tarjeta de crédito para Argentina. Para crear un pago con tarjeta de crédito, envía una solicitud POST al endpoint Crear Payin, incluyendo tu token access en el encabezado Authorization.

Campos 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

Respuesta exitosa

Una respuesta exitosa incluye información detallada de la transacción e identificadores de seguimiento:

Campos de respuesta clave


Paso 4: Gestionar las notificaciones de webhook

Los webhooks proporcionan notificaciones en tiempo real sobre los cambios en el estado de las transacciones. Configura la URL de tu webhook en el Business Portal de Localpayment para recibir estas notificaciones.

Ejemplo de carga útil del webhook

Consejo de implementación:Tu endpoint de webhook debería devolver un estado 200 OK inmediatamente después de recibir el webhook y, a continuación, procesar la notificación de forma asíncrona para evitar tiempos de espera.

Paso 5: Seguimiento del estado de la transacción

Puedes verificar de forma proactiva el estado de la transacción utilizando el endpoint Obtener estado de la transacción. Envía una solicitud GET, reemplazando {externalId} con tu identificador de transacción único para obtener el estado de la transacción.

Ejemplo de solicitud

curl

Respuesta exitosa

Códigos de estado comunes

ImportanteRevisa siempre el campo status.code para determinar el resultado de la transacción. Para ver la lista completa de posibles estados de transacción, consulta la referencia de estados completa.

Probando diferentes métodos de pago

Localpayment admite diversos métodos de pago además de las tarjetas de crédito. Cada método tiene parámetros de solicitud y estructuras de respuesta específicos. A continuación, se muestran ejemplos de transferencias bancarias con las principales diferencias resaltadas.
Los pagos mediante transferencia bancaria permiten a los clientes pagar directamente desde sus cuentas bancarias a través de los sistemas de pago locales.

Ejemplo de solicitud

Principales diferencias en las solicitudes de transferencias bancarias

Respuesta exitosa

Principales diferencias en la respuesta a las transferencias bancarias


Próximos pasos

Explora las opciones de Payins

Descubre todos los métodos de pago disponibles, incluyendo tarjetas y APM.

Explora las opciones de Payouts

Aprende cómo enviar pagos a cuentas bancarias y monederos digitales.

Descubra la cobertura por país

Consulta los métodos de pago disponibles, las monedas y los requisitos específicos para cada país.

Referencia de la API

Accede a la documentación completa de la API, que incluye endpoints, parámetros y ejemplos de código.
Última modificación el 10 de noviembre de 2026