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 solicitudPOST 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
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 solicitudGET 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 solicitudPOST 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 utilizacurl:
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 solicitudGET, 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
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.- Pagos mediante transferencia bancaria
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.

