Saltar al contenido principal
Comprueba si hay un alias de pago activo y consulta los datos del propietario enmascarado antes de enviar un pago. Actualmente disponible solo para Colombia. Utiliza este endpoint para consultar un alias de pago antes de enviar un payout. Devuelve el estado del alias y una vista enmascarada del propietario registrado, de modo que puedas confirmar que el alias está activo y corresponde al destinatario esperado. Se trata de una consulta de solo lectura. No crea una transacción ni reserva fondos. Llamar a este endpoint es opcional. Puedes enviar un payout directamente mediante Enviar fondos mediante transferencia bancaria sin verificar primero el alias. Comprobarlo de antemano reduce los payouts fallidos causados por un alias inactivo o no registrado.
Actualmente disponible solo para Colombia. countryISOCode solo acepta CO y aliasClassification solo acepta Breb (el sistema de pago instantáneo Bre-B de Colombia). En el futuro podría añadirse compatibilidad con otros países y clasificaciones de alias.

Antes de comenzar

Asegúrate de tener:

Endpoint

Los detalles completos de parámetros y esquemas también están disponibles en la referencia de la API Get Alias Detail.

Encabezados obligatorios

Cuerpo de la solicitud

countryISOCode toma el código de 2 letras (CO), no el código de 3 letras (COL) que utilizan la mayoría de los demás endpoints de Localpayment. Esto coincide con la API en producción y no debe “corregirse” en tu integración.

Ejemplo de solicitud

Gestionar la respuesta

Respuesta exitosa

Campos de la respuesta y enmascaramiento

Localpayment enmascara los datos personales en la respuesta. Solo se devuelven los campos que se indican a continuación, y únicamente en esta forma enmascarada.

Manejo de errores

Gestiona siempre estos casos en tu integración en lugar de suponer que todas las consultas se realizan correctamente. Para obtener orientación general sobre cómo interpretar los códigos de estado HTTP y la estructura de las respuestas de error en la API de Localpayment, consulta Manejo de errores.

Demo

Prueba la consulta con un alias de ejemplo para ver cómo aparece el resultado enmascarado. La demo refleja el alcance actual: solo Colombia.

Próximos pasos

Enviar fondos mediante transferencia bancaria

Envía un payout utilizando el alias que verificó.

Colombia

Consulta los bancos admitidos, los tipos de documento y los métodos de payout para Colombia.
Última modificación el 10 de noviembre de 2026