Decidir SDK .Net

Modulo para conexión con gateway de pago DECIDIR

Instalación
Manual de Integración
Generalidades
SendAuthorizeRequest
[GetAuthorizeAnswer] (#getauthorizeanswer)
Execute
GetByOperationId
Tablas de referencia

Instalación

Se debe descargar la última versión del SDK desde el botón Download ZIP, branch master. Una vez descargado y descomprimido, debe incluirse al proyecto.

Volver al inicio

Manual de Integración

Se encuentra disponible en Gitbook el [Manual de Integración Decidir] (https://www.gitbook.com/book/decidir/documentacion/details) para su consulta online o descarga, donde se detalla el proceso de integración. En el mismo se explican los servicios y operaciones disponibles, con ejemplos de requerimientos y respuestas, aquí se ejemplificará la forma de llamar a los distintos servicios usando la presente SDK.

Volver al inicio

Generalidades

La versión implementada de la SDK, esta testeada para versiones desde .net 4.5.1 C#. Instanciación de la clase 'Decidir' La misma recibe como parámetros el Header HTTP provisto por Decidir para el comercio y un numero entero que representa el Endpoint en el que se realizaran las operaciones.

	using Decidir_SDK;
	/*
	....
	*/
	
		int endpoint = Decidir.sandbox;//Developer sandbox
		//int endpoint = Decidir.production; //produccion
		decidir = new Decidir(endpoint, getHeaders());
	}
	
	public static Dictionary<string, string> getHeaders()
        {
            var headers = new Dictionary<String, String>();
            headers.Add("Authorization", authorization);
            //Add here aditional HTTP Headers
            return headers;
        }

Volver al inicio

SendAuthorizeRequest

La operación SendAuthorizeRequest que forma parte del servicio Authorize, envía el requerimiento inical de autorización para comenzar con el ciclo de pago de la transacción, debe llamarse de la siguiente manera: Primero se debe inicializar el conector.

	decidir.initAuthorize();

Luego Crear los datos a enviar:

	using Decidir_SDK.RequestData;
	/*
	...
	*/

	private static SendAuthorizeRequestData initSendAuthorizeRequestData() {
		
		SendAuthorizeRequestData sar = new SendAuthorizeRequestData();
		
		sar.setEncodingMethod(ENCODINGMETHOD);
		sar.setMerchant(MERCHANT);
		sar.setSecurity(SECURITY);
		sar.setUrl_error("http://someurl.com/error/");
		sar.setUrl_ok("http://someurl.com/ok/");
		
		return sar;
	}

Luego se debe invocar al servicio pasándole como parámetro el objeto anteriormente creado

	SendAuthorizeRequestResponse sarResponse = decidir.sendAuthorizeRequest(initSendAuthorizeRequestData());

El mismo devolverá una instalcia de la clase SendAuthorizeRequestResponse

	Console.WriteLine("Status Code: " + sarResponse.getStatusCode());
	Console.WriteLine("StatusMessage: " + sarResponse.getStatusMessage());
	Console.WriteLine("PublicRequestKey: " + sarResponse.getPublicRequestKey());
	Console.WriteLine("RequestKey: " + sarResponse.getRequestKey());
	Console.WriteLine("URLRequest: " + sarResponse.getURLRequest());

Volver al inicio

Medios de Pago

En la operación SendAuthorizeRequest deben enviarse datos adicionales dependiendo de los distintos medios de pago que se utilicen, para ello se proveen clases específicas para cada medio de pago que deben agregarse al objeto de datos.

Volver al inicio

Tarjetas de Crédito

Para utilizar tarjetas de crédito como medio de pago, se debe instanciar un objeto de la clase TarjetaCredito, con los siguientes parámetros

	using Decidir_SDK.MeidioDePago;
	/*
	...
	*/

	MedioDePago medioDePago = new TarjetaCredito("1"/* Mandatorio. Código del tipo de tarjeta a utilizar. [Tabla Medios de Pago] (#tablas-medios-de-pago)*/
													, "6"/*Mandatorio. Nro. de cuotas en los que se hará la operacion*/);
	//Se puede pasar como parametro adicional el BIN:
	MedioDePago medioDePago = new TarjetaCredito("1"/* Mandatorio. Código del tipo de tarjeta a utilizar. [Tabla Medios de Pago] (#tablas-medios-de-pago)*/
													, "6"/*Mandatorio. Nro. de cuotas en los que se hará la operacion*/
													, "450799");/*Opcional. Código BIN que identifica al emisor de la tarjeta de crédito. Permite al comercio operar con promociones bancarias.*/

Luego se debe incluir la información del medio de pago en el objeto de datos

	sar.setMedioPago(medioDePago);

Volver al inicio

Rapipago

Para utilizar Rapipago como medio de pago, se debe instanciar un objeto de la clase Rapipago, con los siguientes parámetros

	MedioDePago medioDePago = new Rapipago("26"/*Mandatorio. Código del tipo de tarjeta a utilizar. [Tabla Medios de Pago] (#tablas-medios-de-pago)*/
											, "10" /*Mandatorio. Son los días que existen entre el 1ra y 2da vencimiento de la factura. Poner "00" si la factura no tiene 2do vencimiento.*/
											, "12" /*Mandatorio. Son los días después del 1Âº vencimiento y hasta el que el cliente puede pagar la factura por Rapipago.*/
											, "22.00" /*Mandatorio. Recargo por vencimiento del plazo. Es un monto (no un porcentaje).*/
											, "1601010" /*Mandatorio. Fecha de vencimiento para el pago del cupón. Formato AAMMDD*/
											, "12345678"/*Mandatorio. Código de cliente provisto por Rapipago al momento de habilitar el comercio.*/
											);

Luego se debe incluir la información del medio de pago en el objeto de datos

	sar.setMedioPago(medioDePago);

} Volver al inicio

Pago Fácil

Para utilizar Pago Fácil como medio de pago, se debe instanciar un objeto de la clase PagoFacil, con los siguientes parámetros

	MedioDePago medioDePago = PagoFacil("26"
										, "2500" /*Mandatorio. Se debe enviar el monto toal para el segundo vencimiento.*/
										, "1601010"/*Mandatorio. Fecha de vencimiento para el pago del cupón. Formato AAMMDD*/
										, "1601010"/*Mandatorio. Fecha del segundo vencimiento para el pago del cupón. Formato AAMMDD*/
										);

Volver al inicio

Pago mis Cuentas

Para utilizar Pago Mis Cuentas como medio de pago, se debe instanciar un objeto de la clase PagoMisCuentas, con los siguientes parámetros

	MedioDePago medioDePago = PagoMisCuentas("26", "1601010" /*Mandatorio. Fecha y hora de vencimiento de la factura. En formato DDMMYY HHMM. Puede omitirse las "horas" y "minutos", informando solo la fecha con formato DDMMYY*/ );

Volver al inicio

Integración con Cybersource

Para utilizar el Servicio de Control de Fraude Cybersource, en la operación SendAuthorizeRequest, deben enviarse datos adicionales sobre la operación de compra que se quiere realizar. Se han definido cinco verticales de negocio que requieren parámetros específicos, así como también parámetros comunes a todas las verticales.

Volver al inicio

Parámetros Comunes

Los parámetros comunes a todas las verticales deben enviarse junto con los datos específicos de cada uno. A continuación, describiremos los párametros comúnes que se deberan agregar a los datos de cada vertical al momento de instanciar la clase correspondiente.

	CyberSourceData fcd = new CyberSourceData();

	fcd.add(CyberSourceData.CSBTCITY, "Villa General Belgrano"); //Ciudad de facturación, MANDATORIO.
	fcd.add(CyberSourceData.CSBTCOUNTRY, "AR"); //País de facturación. MANDATORIO. Código ISO. (http://apps.cybersource.com/library/documentation/sbc/quickref/countries_alpha_list.pdf)
	fcd.add(CyberSourceData.CSBTCUSTOMERID, "453458"); //Identificador del usuario al que se le emite la factura. MANDATORIO. No puede contener un correo electrónico
	fcd.add(CyberSourceData.CSBTEMAIL, "decidir@hotmail.com"); //Mail del usuario al que se le emite la factura. MANDATORIO.
	fcd.add(CyberSourceData.CSBTFIRSTNAME, "Juan"); //Nombre del usuario al que se le emite la factura. MANDATORIO.
	fcd.add(CyberSourceData.CSBTLASTNAME, "Perez"); //Apellido del usuario al que se le emite la factura. MANDATORIO.
	fcd.add(CyberSourceData.CSBTIPADDRESS, "194.0.0.4"); //IP de la PC del comprador. MANDATORIO.
	fcd.add(CyberSourceData.CSBTPHONENUMBER, "541160913988"); //Teléfono del usuario al que se le emite la factura. No utilizar guiones, puntos o espacios. Incluir código de país. MANDATORIO.
	fcd.add(CyberSourceData.CSBTPOSTALCODE, "1010"); //Código Postal de la dirección de facturación. MANDATORIO.
	fcd.add(CyberSourceData.CSBTSTATE, "B"); //Provincia de la dirección de facturación. MANDATORIO. Ver tabla anexa de provincias.
	fcd.add(CyberSourceData.CSBTSTREET1, "Cerrito 740"); //Domicilio de facturación (calle y nro). MANDATORIO.
	fcd.add(CyberSourceData.CSBTSTREET2, "Piso 8"); //Complemento del domicilio. (piso, departamento). NO MANDATORIO. 
	fcd.add(CyberSourceData.CSPTCURRENCY, "ARS"); ////Moneda. MANDATORIO.
	fcd.add(CyberSourceData.CSPTGRANDTOTALAMOUNT, "125.38"); //Con decimales opcional usando el puntos como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales. MANDATORIO. (Ejemplos:$125,38-> 125.38 $12-> 12 o 12.00)
	fcd.add(CyberSourceData.device_fingerprint, "dj94utjg93"); // Device Fingerprint Id. MANDATORIO.
	fcd.add(CyberSourceData.CSMDD6, "Mobile"); // Canal de venta. NO MANDATORIO. (Valores posibles: Web, Mobile, Telefonica)
	fcd.add(CyberSourceData.CSMDD7, ""); // Fecha registro comprador(num Dias). NO MANDATORIO.
	fcd.add(CyberSourceData.CSMDD8, "Y"); //Usuario Guest? (Y/N). En caso de ser Y, el campo CSMDD9 no deberá enviarse. NO MANDATORIO.
	fcd.add(CyberSourceData.CSMDD9, ""); //Customer password Hash: criptograma asociado al password del comprador final. NO MANDATORIO.
	fcd.add(CyberSourceData.CSMDD10, ""); //Histórica de compras del comprador (Num transacciones). NO MANDATORIO.
	fcd.add(CyberSourceData.CSMDD11, ""); //Customer Cell Phone. NO MANDATORIO.