Giters

MatayoshiMariano / SDK-Ruby

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

sdk-ruby

Modulo para conexión con gateway de pago Todo Pago

######Instalación ######Versiones de Ruby soportadas ######Generalidades ######Uso ######[Datos adicionales para prevencion de fraude] (#datosadicionales) ######Ejemplo ######Modo test ######Status de la operación ######Tablas de referencia

Instalación

Se debe descargar la última versión del SDK desde el botón Download ZIP y descomprimirlo. Se debe crear un archivo .gem que debe ser instalado para poder utilizarlo.

Creación e Instalación de la gema TodoPagoConector.gem

Abrir la consola tipear:

	cd "ruta-del-sdk"

Donde ruta-del-sdk es la ruta donde se descomprimió el zip

Crear gem TodoPagoConector

Situarse en el directorio que contiene el archivo TodoPagoConector.gemspec, de esta forma:

	cd sdk-ruby-master

Para crear el archivo .gem se debe ejecutar el comando gem build

   ..\sdk-ruby-master>gem build TodoPagoConector.gemspec
   Successfully built RubyGem
   Name: TodoPagoConector
   Version: 1.1.0
   File: TodoPagoConector-1.1.0.gem

Se debe obtener el archivo TodoPagoConector-1.1.0.gem

Instalación de gem TodoPagoConector-1.1.0

 sdk-ruby-master>gem install ./TodoPagoConector-1.1.0.gem
 Successfully installed TodoPagoConector-1.1.0
 1 gem installed
 Installing ri documentation for TodoPagoConector-1.1.0...
 Installing RDoc documentation for TodoPagoConector-1.1.0...

Uso del archivo TodoPagoConector-1.1.0.gem

Abrir el Interactive RuBy shell

     ..\sdk-ruby-master>irb

Tipear el siguiente comando para comprobar que está listo para ser utilizado

     irb(main):004:0> require 'todo_pago_conector'
     => true

Volver a inicio

##Versiones soportadas de Ruby La versión implementada de la SDK, esta testeada para versiones de ruby desde 1.9.3 en adelante. Volver a inicio

##Genaralidades Esta versión soporta únicamente pago en moneda nacional argentina (CURRENCYCODE = 32). Volver a inicio

Uso

####1. Inicializar la clase correspondiente al conector (TodoPago).

  • crear una estrucura como la del ejemplo con las wsdl suministradas por Todo Pago
j_wsdls = {
    "Authorize"=>"https://developers.todopago.com.ar/services/Authorize?wsdl",
    "PaymentMethods"=>"https://developers.todopago.com.ar/services/PaymentMethods?wsdl",
    "Operations"=>"https://developers.todopago.com.ar/services/Operations?wsdl"}
  • crear una estructura como la del ejemplo con los http header suministrados por todo pago
j_header_http = {
    "Authorization"=>"PRISMA 912EC803B2CE49E4A541068D495AB570"
}
  • crear una instancia de la clase TodoPago
conector = TodoPagoConector.new(j_header_http,
                                j_wsdls,
                                end_point) # End Point, wsdl y http_header provisto por TODO PAGO

####2.Solicitud de autorización En este caso hay que llamar a sendAuthorizeRequest().

response = conector.sendAuthorizeRequest(optionsSAR_comercio,optionsSAR_operacion)

Datos propios del comercio optionsSAR_comercio debe ser un Hash con la siguiente estructura:

optionsSAR_comercio = Hash.new
optionsSAR_comercio[:Security]="1234567890ABCDEF1234567890ABCDEF"
optionsSAR_comercio[:Merchant]= "350"
optionsSAR_comercio[:EncodingMethod]="XML"
optionsSAR_comercio[:URL_OK]="http://www.misitio.com/controller/success"
optionsSAR_comercio[:URL_ERROR]="http://www.misitio.com/controller/fail"

Datos propios de la operación optionsSAR_operacion debe ser un Hash con la siguiente estructura:

optionsSAR_operacion = Hash.new
optionsSAR_operacion[:MERCHANT] = "305"
optionsSAR_operacion[:OPERATIONID] = "ABCDEF-1234-12221-FDE1-00000200"
optionsSAR_operacion[:CURRENCYCODE] = "032"
optionsSAR_operacion[:AMOUNT] = "54.00"

La variable response contendrá una estuctura en la cual url_request nos dara la url del formulario de pago a la cual habra que redirigir al comprador y request_key será un datos que será requerido en el paso de la confirmación de la transacción a través del método getAuthorizeRequest ####3.Confirmación de transacción. En este caso hay que llamar a getAuthorizeRequest(), enviando como parámetro un Hash como se describe a continuación.

optionsAnwser=Hash.new
optionsAnwser[:Security]= "1234567890ABCDEF1234567890ABCDEF" #Token de seguridad, provisto por TODO PAGO. MANDATORIO.
optionsAnwser[:MERCHANT]= "305"
optionsAnwser[:RequestKey]= "8496472a-8c87-e35b-dcf2-94d5e31eb12f"
optionsAnwser[:AnswerKey]= "8496472a-8c87-e35b-dcf2-94d5e31eb12f"

response = conector.getAuthorizeRequest(optionsAnwser)

Volver a inicio

Datos adicionales para control de fraude

Parámetros Adicionales en el post inicial:
optionsSAR_operacion=Hash.new 		
...........................................................................		
optionsSAR_operacion[:CSBTCITY] = "Villa General Belgrano" #Ciudad de facturación, MANDATORIO.		
optionsSAR_operacion[:CSBTCOUNTR]="AR" #País de facturación. MANDATORIO. Código ISO. (http://apps.cybersource.com/library/documentation/sbc/quickref/countries_alpha_list.pdf)		
optionsSAR_operacion[:CSBTCUSTOMERID]="453458" #Identificador del usuario al que se le emite la factura. MANDATORIO. No puede contener un correo electrónico.		
optionsSAR_operacion[:CSBTIPADDRESS]="192.0.0.4" #IP de la PC del comprador. MANDATORIO.		
optionsSAR_operacion[:CSBTEMAIL]="decidir@hotmail.com" #Mail del usuario al que se le emite la factura. MANDATORIO.	
optionsSAR_operacion[:CSBTFIRSTNAME]="Juan" #Nombre del usuario al que se le emite la factura. MANDATORIO.		
optionsSAR_operacion[:CSBTLASTNAME]="Perez" #Apellido del usuario al que se le emite la factura. MANDATORIO.		
optionsSAR_operacion[: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.		
optionsSAR_operacion[:CSBTPOSTALCODE]="C1010AAP" #Código Postal de la dirección de facturación. MANDATORIO.		
optionsSAR_operacion[:CSBTSTATE]="B" #Provincia de la dirección de facturación. MANDATORIO. Ver tabla anexa de provincias.
optionsSAR_operacion[:CSBTSTREET1]="Cerrito 740" #Domicilio de facturación (calle y nro). MANDATORIO.		
optionsSAR_operacion[:CSBTSTREET2]="Piso 8" #Complemento del domicilio. (piso, departamento). NO MANDATORIO.		
optionsSAR_operacion[:CSPTCURRENCY]="ARS" #Moneda. MANDATORIO.		
optionsSAR_operacion[: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)
optionsSAR_operacion[:CSMDD7]="" # Fecha registro comprador(num Dias). NO MANDATORIO.		
optionsSAR_operacion[:CSMDD8]="Y" #Usuario Guest? (Y/N). En caso de ser Y, el campo CSMDD9 no deberá enviarse. NO MANDATORIO.
optionsSAR_operacion[:CSMDD9]="asjhskajshiuyiquwyiqw" #Customer password Hash: criptograma asociado al password del comprador final. NO MANDATORIO.	
optionsSAR_operacion[:CSMDD10]="5" #Histórica de compras del comprador (Num transacciones). NO MANDATORIO.		
optionsSAR_operacion[:CSMDD11]="540111564893736" #Customer Cell Phone. NO MANDATORIO.		
optionsSAR_operacion[:CSSTCITY]="rosario" #Ciudad de enví­o de la orden. MANDATORIO.		
optionsSAR_operacion[:CSSTCOUNTRY]="" #País de envío de la orden. MANDATORIO.		
optionsSAR_operacion[:CSSTEMAIL]="jose@gmail.com" #Mail del destinatario, MANDATORIO.		
optionsSAR_operacion[:CSSTFIRSTNAME]="Jose" #Nombre del destinatario. MANDATORIO.		
optionsSAR_operacion[:CSSTLASTNAME]="Perez" #Apellido del destinatario. MANDATORIO.		
optionsSAR_operacion[:CSSTPHONENUMBER]="541155893737" #Número de teléfono del destinatario. MANDATORIO.		
optionsSAR_operacion[:CSSTPOSTALCODE]="1414" #Código postal del domicilio de envío. MANDATORIO.		
optionsSAR_operacion[:CSSTSTATE]="D" #Provincia de envío. MANDATORIO. Son de 1 caracter		
optionsSAR_operacion[:CSSTSTREET1]="San Martín 123" #Domicilio de envío. MANDATORIO.		
optionsSAR_operacion[:CSMDD12]="" #Shipping DeadLine (Num Dias). NO MADATORIO.		
optionsSAR_operacion[:CSMDD13]="" #Método de Despacho. NO MANDATORIO.		
optionsSAR_operacion[:CSMDD14]="" #Customer requires Tax Bill ? (Y/N). NO MANDATORIO.		
optionsSAR_operacion[:CSMDD15]="" #Customer Loyality Number. NO MANDATORIO. 		
optionsSAR_operacion[:CSMDD16]="" #Promotional / Coupon Code. NO MANDATORIO. 

#Datos a enviar por cada producto, los valores deben estar separado con #.		
optionsSAR_operacion[:CSITPRODUCTCODE]="electronic_good" #Código de producto. CONDICIONAL. Valores posibles(adult_content;coupon;default;electronic_good;electronic_software;gift_certificate;handling_only;service;shipping_and_handling;shipping_only;subscription)		
optionsSAR_operacion[:CSITPRODUCTDESCRIPTION]="NOTEBOOK L845 SP4304LA DF TOSHIBA" #Descripción del producto. CONDICIONAL.
optionsSAR_operacion[:CSITPRODUCTNAME]="NOTEBOOK L845 SP4304LA DF TOSHIBA" #Nombre del producto. CONDICIONAL.		
optionsSAR_operacion[:CSITPRODUCTSKU]="LEVJNSL36GN" #Código identificador del producto. CONDICIONAL.		
optionsSAR_operacion[:CSITTOTALAMOUNT]="1254.40" #CSITTOTALAMOUNT=CSITUNITPRICE*CSITQUANTITY "999999[.CC]" Con decimales opcional usando el puntos como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales. CONDICIONAL.		
optionsSAR_operacion[:CSITQUANTITY]="1" #Cantidad del producto. CONDICIONAL.		
optionsSAR_operacion[:CSITUNITPRICE]="1254.40" #Formato Idem CSITTOTALAMOUNT. CONDICIONAL.		
...........................................................

Ejemplo

Existe un ejemplo en la carpeta https://github.com/TodoPago/sdk-ruby/blob/master/TodoPago/test.rb que muestra los resultados de los métodos principales del SDK. Volver a inicio

##Modo test Para utlilizar el modo test se debe pasar un end point de prueba (provisto por TODO PAGO).

conector_test = TodoPagoConector.new(j_header_http_test, j_wsdls_test, end_point_test)

Volver a inicio

##Status de la Operación La SDK cuenta con un método para consultar el status de la transacción desde la misma SDK. El método se utiliza de la siguiente manera:

optionsOperations=Hash.new
optionsOperations[:MERCHANT]= merchant #merchant es una variable 
optionsOperations[:OPERATIONID]= operationid #operationid es una variable (id de la opereacion)
conector.getOperations(optionsOperations)

Volver a inicio

Tablas de Referencia

######Códigos de Estado ######Provincias

Codigos de Estado

IdEstadoDescripción
1Ingresada
2A procesar
3Procesada
4Autorizada
5Rechazada
6Acreditada
7Anulada
8Anulación Confirmada
9Devuelta
10Devolución Confirmada
11Pre autorizada
12Vencida
13Acreditación no cerrada
14Autorizada *
15A reversar
16A registar en Visa
17Validación iniciada en Visa
18Enviada a validar en Visa
19Validada OK en Visa
20Recibido desde Visa
21Validada no OK en Visa
22Factura generada
23Factura no generada
24Rechazada no autenticada
25Rechazada datos inválidos
28A registrar en IdValidador
29Enviada a IdValidador
32Rechazada no validada
38Timeout de compra
50Ingresada Distribuida
51Rechazada por grupo
52Anulada por grupo

Provincias

Solo utilizado para incluir los datos de control de fraude

ProvinciaCódigo
CABAC
Buenos AiresB
CatamarcaK
ChacoH
ChubutU
CórdobaX
CorrientesW
Entre RíosR
FormosaP
JujuyY
La PampaL
La RiojaF
MendozaM
MisionesN
NeuquénQ
Río NegroR
SaltaA
San JuanJ
San LuisD
Santa CruzZ
Santa FeS
Santiago del EsteroG
Tierra del FuegoV
TucumánT
 [Volver a inicio](#inicio)

About

Languages

Language:Ruby 100.0%