API Reference

Token Cliente

Este método le permite generar un Catálogo de Clientes el cual servirá para identificar a la persona que realiza una Transacción y poder asociar una o más tarjetas al mismo.

Para guardar los datos de un CLIENTE, deberá enviar las siguientes variables mediante un mensaje SOAP al webservice previamente indicado, invocando el método tokenCliente el cual le permitirá almacenar la información.

Variables de Envio

VARIABLE

FORMATO

RESTRICCIONES

DESCRIPCION

comercioId

Numérico

Admite números sin espacios.

Identificador del Comercio en OPENLINEA. Es un valor asignado.

contraseña

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 12 caracteres.

Clave de Acceso a la Terminal Virtual, configurado para su aplicación.

operacion

Carácter

Admite una solo letra

Identificador de la operación a realizar, A=Almacena un Nuevo Cliente, U=Actualiza los datos de un Cliente, D=Elimina un Cliente

token

Alfanumérico

Admite letras y/o números sin espacio, se permite el uso de guiones (-).

TOKEN mediante el cual se identifica de forma única al CLIENTE, este dato es requerido en el caso de operaciones de Actualización y/o Eliminación de Cliente.

nombre

Alfanumérico

Admite letras. No mayor a 20 caracteres.

Nombre del Cliente

apellidos

Alfanumérico

Admite letras. No mayor a 20 caracteres.

Apellidos del cliente

calle

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Dirección del Cliente (se sugiere Calle y Numero)

colonia

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Dirección del Cliente

ciudad

Alfanumérico

Admite letras sin espacios. No mayor a 20 caracteres.

Ciudad del Cliente

estado

Alfanumérico

Admite letras sin espacios. No mayor a 20 caracteres.

Estado del Cliente

estadoid

Alfanumérico

Admite letras. Solo debe contener 2 caracteres.

Estado del Tarjetahabiente
Ejemplo: Nuevo León = NL
Anexo 2 - Código de Estados para México

pais

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Pais del cliente

paisId

Alfanumérico

Admite letras. Solo debe contener 2 caracteres.

País de Tarjetahabiente
Ejemplo: México = MX

Anexo 1 - Código de Países

codigoPostal

Numérico

Admite números sin espacios.

Código postal del cliente

email

Alfanumérico

Admite letras y/o números sin espacios, se permiten los símbolos de arroba (@), punto (.) y guiones (-), (_). No mayor a 20 caracteres.

Dirección de Correo Electrónico para el envío de Notificaciones.
Dato indispensable si posteriormente desea realizar Búsqueda de Transacciones mediante el correo registrado

telefono

Numérico

Admite letras y/o números, se permiten los símbolos de paréntesis, corchetes y guiones.

Numero Telefónico

Variables de Retorno

La petición regresara una respuesta en formato SOAP conteniendo la siguiente información:

VARIABLEFORMATORESTRICCIONESDESCRIPCION
comercioIdNuméricoNúmeros sin espaciosIdentificador del Comercio en OPENLINEA. Es un valor asignado.
tokenAlfanuméricoLetras y/o números sin espacios. No mayor a 20 caracteresIdentificador Único TOKEN del CLIENTE sobre el cual se realizó la operación.
fechaTransaccionAlfanuméricoRepresentación de fecha con formato MM/DD/AAFecha procesamiento de la Operación
horaTransaccionAlfanuméricoRepresentación de hora con formato HH:MM:SSHora de procesamiento de la Operación.
codigoRespuestaNuméricoNúmeros sin espacios.Se regresa los siguientes valores: 0 = Aprobada , 1= Rechazada, 2 = Pendiente
ccReturnMsgAlfanuméricoAlfanumérico de longitud variableTexto específico retornado por el procesador de pagos
procReturnMsgAlfanuméricoAlfanumérico de longitud variableCódigo retornado por el procesador de la tarjeta.

Formato de envío

📘

tokenCliente Desarrollo

https://servertest.operacionesenlinea.com/gateway/opGateway.asmx?op=tokenCliente

📘

tokenCliente Produccion

https://servidorseguro.operacionesenlinea.com/gateway/OpGateway.asmx?op=tokenCliente