1. Autorización

El llamado a este servicio WEB se hace desde el servidor del comercio y es el primer paso para interactuar con Plexo, obteniendo como resultado una sesión de usuario. Autorización enviada como objeto

El llamado a este servicio REST se hace desde el servidor del comercio y como resultado se obtiene una sesión de usuario para interactuar con la Web de Plexo, cuyo layout y comportamiento se basará en las opciones que se especifiquen en la invocación.

• Se hará un post a:

https://testing.plexo.com.uy:4043/SecurePaymentGateway.svc/Authtesting.plexo.com.uy

Firmado como todos los demás paquetes, con la versión JSON del objeto Authorization

• Campos de una autorización

Los campos requeridos se detallan a continuación:

• AuthorizationType

  Anonymous si no quiere dejar registro de usuario (el token se borra en 24 hrs) y sino por OAuth o ClientReference (se guarda referencia al usuario).

• MetaReference

  Si el AuthorizationType no es Anonymous, debe pasarse en este campo una referencia - ejemplo una casilla de correo - para que Plexo guarde una referencia a dicho usuario.

• ActionType (flags)

  ○ SelectInstrument

  Es solamente para seleccionar los medios de pago previamente registrados por el cliente.

  ○ RegisterInstrument

  Si se envía, da la opción de solamente poder registrar un nuevo medio de pago.

  ○ DeleteInstrument

  Si se envía, en la lista de medios de pago disponibles se habilita la opción de borrar.

• RedirectUri

  URL donde se va a redirigir al cliente web luego de finalizar el caso de uso.

Los campos opcionales se detallan a continuación:

• OptionalMetadata

  En este campo se puede guardar cualquier información que se quiera recibir en el callback y evitar mantenerlo en sesión.

• OptionalCommerceId

  Este campo es mandatorio para quienes son multicomercio, donde se debe especificar el ID del comercio que está operando. Para quienes solo utilizan un comercio, pueden obviar el envío de este campo, pero deben definir un comercio por defecto (se especifica más adelante).

• ClientInformation

  Es un diccionario de datos que se guarda en la base de datos para uso futuro. La idea es guardar datos para autocompletar formularios, donde se solicite por ejemplo el email, dirección, número y tipo de documento, etc. Los valores se definen en

Plexo.Models/FieldType.cs at master · plexouy/Plexo.ModelsGitHub

• LimitIssuers

  Si se envía, se despliega solamente la lista de medios de pago indicados en este campo (4=MasterCard, 11=VISA, 15=OCA. Solicitar la lista en el método ISecurePaymentGateway.GetSupportedIssuers(ClientSignedRequest creq)).

  La Web de Plexo se encarga de solicitar el valor del CVC si la tarjeta que está ingresando el usuario es de este banco y lo guarda por unos segundos para evitar que el cliente vuelva a ingresar el valor si va a realizar la compra inmediatamente después de registrar su tarjeta.

• ExtendedBINInformation Es un nuevo parámetro opcional para obtener por separado el BIN de la tarjeta registrada. Debido a la nueva especificación de BINes de 8 dígitos, se agrega esta funcionalidad para obtener este dato en el InstrumentCallback, donde se recibirá el valor en OptionalBIN dentro de OptionalMetadata.

• WebFormSettings

  Estas es una nueva funcionalidad de la versión 4.2, donde se permite hacer ciertas configuraciones en el formato de la Web de Plexo. Se puede cambiar el color primario, secundario y de fondo, así como el tema, logo, pie, titulo, etc.

Ver en los Modelos de Plexo la especificación de WebFormSettings en

Plexo.Models/WebFormSettingsDto.cs at master · plexouy/Plexo.ModelsGitHub

Como ejemplo:

WebFormSettingsDto webSettings = new WebFormSettingsDto();
UIOptionsDto uiOptions = new UIOptionsDto();
TokenizationSettingsDto tokenizDto = new TokenizationSettingsDto();
DisplayOptionsDto displayDto = new DisplayOptionsDto();
Map<String, String> colours = new HashMap<>();
colours.put("Primary","#000080");
colours.put("Secondary","#008080");
colours.put("Background","#C0C0C0");
uiOptions.setColors(colours);
uiOptions.setAutoDarkTheme(true);
uiOptions.setTheme("dark");
uiOptions.setLogoURL("https://via.placeholder.com/196x64.png?text=MiComercio");
webSettings.setuI(uiOptions);
displayDto.setAccessibility(true);
displayDto.setDetails(true);
displayDto.setFooter(false);
displayDto.setLogo(true);
displayDto.setTitles(false);

Como resultado se obtendrá un ID de sesión (*) en formato string que se usará en el siguiente paso.