Dar alta a un cliente en la plataforma
CREAR CLIENTE (POST)
Para crear un nuevo Cliente, se requiere enviar una petición de tipo POST. Se deberá agregar en el HEADER de la petición las credenciales necesarias para acceder al servicio, estas son comercioId y contrasena. Los cuales deberán contener los valores asignados por Operaciones en Línea al momento de generada su Afiliación.
Como parte del cuerpo del POST se deberán incluir los siguientes parámetros:
| VALORES | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Admite números sin espacios. | Identificador del Comercio en OPENLINEA. Es un valor asignado. (Header) |
| 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. (Header) |
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| Nombre | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Nombre del Cliente |
| apellidos | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Apellidos del Cliente |
| calle | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Dirección del Cliente (se sugiere Calle y Numero) |
| colonia | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Dirección del Cliente (se sugiere cualquier referencia que ayude a ubicar la dirección del Cliente) |
| ciudad | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Ciudad |
| estado | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Estado |
| 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. No mayor a 20 caracteres. | País |
| 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 Anexo 1 - Código de Países |
| codigoPostal | Numérico | Admite números sin espacios. | Código Postal |
| 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. | |
| telefono | Alfanumérico | Admite letras y/o números, se permiten los símbolos de paréntesis, corchetes y guiones. | Número Telefónico |
Valores de Retorno
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| token | Alfanumérico | Admite letras y/o números de longitud variable | TOKEN mediante el cual se identifica de forma única al CLIENTE, este dato es requerido en el caso de operaciones de Actualización, Búsqueda y/o Eliminación de cliente. |
| id | Numérico | Admite números sin espacios. | ID del comercio |
| Nombre | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Nombre del Cliente |
| apellidos | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Apellidos del Cliente |
| calle | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Dirección del Cliente (se sugiere Calle y Numero) |
| colonia | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Dirección del Cliente (se sugiere cualquier referencia que ayude a ubicar la dirección del Cliente) |
| ciudad | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Ciudad |
| estado | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Estado |
| 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 Dato indispensable para el esquema 3D Secure 2.0 |
| pais | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | País |
| 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 Dato indispensable para el esquema 3D Secure 2.0 |
| codigoPostal | Numérico | Admite números sin espacios. | Código Postal |
| 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. | |
| telefono | Alfanumérico | Admite letras y/o números, se permiten los símbolos de paréntesis, corchetes y guiones. | Número Telefónico |
| estatus | Numérico | Admite números sin espacios. | Estatus de errores |
| fechaAlta | Alfanumérico | Admite letras y/o números de longitud variable | Fecha exacta en la cual se creó el cliente |
Crear Cliente Desarrollo
https://servertest.operacionesenlinea.com/OpenLineaRestAPI/api/clientes/
Crear Cliente Produccion
https://servidorseguro.operacionesenlinea.com/OpenLineaRestAPI/api/clientes/