Se debe descargar la última versión del SDK desde el botón Download ZIP del branch master. Se debe crear un archivo .gem que debe ser instalado para poder utilizarlo. Se deben tener instaladas las gemas xml-simple , savon, rest-client y json

1. Creación de la gema TodoPagoConector

Abrir la consola tipear:

	cd "ruta-del-sdk"

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

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

        gem build TodoPagoConector.gemspec

Se debe obtener el archivo TodoPagoConector.gem _{Volver a inicio}

2. Instalación de la gema TodoPagoConector

        gem install ./TodoPagoConector.gem
        gem install json

_{Volver a inicio}

3. Versiones de Ruby soportadas

La versión implementada de la SDK, esta testeada para versiones de Ruby desde 1.9.3 en adelante. _{Volver a inicio}

4. Generalidades

Esta versión soporta únicamente pago en moneda nacional argentina (CURRENCYCODE = 32).

_{Volver a inicio}

Uso

Inicializar la clase correspondiente al conector (TodoPagoConector).

Crear una estrucura como la del ejemplo con las wsdl suministradas por Todo Pago

j_wsdls = {
    #Remoto
    'Authorize'=> 'https://developers.todopago.com.ar/services/t/1.1/Authorize?wsdl'
    #Local
    #'Authorize'=> '../lib/Authorize.wsdl'
    }

Crear una estructura como la del ejemplo con los http header suministrados por todo pago

j_header_http = {
    "Authorization"=>"PRISMA f3d8b72c94ab4a06be2ef7c95490f7d3"
}

Crear una instancia de la clase TodoPago

end_point = 'https://developers.todopago.com.ar/'

conector = TodoPagoConector.new(j_header_http,
                                j_wsdls,
                                end_point) # End Point, wsdl y http_header provisto por TODO PAGO

Operatoria Agrupador

Mediante una única y simple adhesión, los vendedores acceden a todos los medios de pago que el Botón de pago ofrezca sin necesidad de contar con ningún tipo de contrato adicional con cada medio de pago. La funcionalidad “agrupador” de TodoPago, se ocupa de gestionar los acuerdos necesarios con todos los medios de pago a efectos de disponibilizarlos en el Botón.

Para acceder al servicio, los vendedores podrán adherirse en el sitio exclusivo de TodoPago o a través de su ejecutivo comercial. En estos procesos se generará el usuario y clave para este servicio.

Una vez adheridos se creará automáticamente una cuenta virtual, en la cual se acreditarán los fondos provenientes de los cobros realizados con la presente modalidad de pago.

Diagrama de secuencia

imagen de configuracion

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:

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
Security	Sí	API Keys sin PRISMA o TODOPAGO y sin espacio.	Alfanumérico hasta 32 caracteres	912EC803B2CE49E4A541068D495AB570
Merchant	Sí	Nro. de Comercio (Merchant ID) provisto por TodoPago	Numérico	12345678
URL_OK	No	URL a la que el comprador será dirigido cuando la compra resulte exitosa	Alfanumérico hasta 256 caracteres	http://susitio.com/payment/Ok
URL_Error	No	URL a la que el comprador será dirigido cuando la compra no resulte exitosa	Alfanumérico hasta 256 caracteres	http://susitio.com/payment/Error

optionsSAR_comercio = Hash.new
optionsSAR_comercio[:Security]="f3d8b72c94ab4a06be2ef7c95490f7d3"
optionsSAR_comercio[:Merchant]= "2153"
optionsSAR_comercio[:EncodingMethod]="XML"
optionsSAR_comercio[:URL_OK]="http://someurl.com/ok/"
optionsSAR_comercio[:URL_ERROR]="http://someurl.com/error/"
optionsSAR_comercio[:Session]= "ABCDEF-1234-12221-FDE1-00000200"

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

Campo	Requerido	Descripción	Tipo de Dato	Valores Posibles / Ejemplos
MERCHANT	Sí	Nro. de Comercio (Merchant ID) provisto por TodoPago	Numérico	12345
OPERATIONID	Sí	Identificación de la transacción para el Comercio. Debe ser distinto para cada operación.	Alfanumérico de 1 a 40 caracteres	10000012
CURRENCYCODE	Sí	Tipo de moneda de la operación. Sólo válido pesos argentinos (32)	Numérico de dos posiciones	32
AMOUNT	Sí	Importe en Pesos de la transacción.	Numérico con 9 dígitos con hasta 2 decimales 999999[.CC] Usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales.	$125,38 -> 125.38
EMAILCLIENTE	Si	El comercio deberá enviar a TodoPago el email del cliente. Esta dirección se utilizará para enviar el mail de confirmación de la compra al cliente	Alfanumérico de hasta 80 caracteres.	cliente@mail.com

Respuesta

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
StatusCode	Sí	Código de estado o valor de retorno del Servicio	Numérico de 5 posiciones	-1 -> OK otro ->Error
StatusMessage	Sí	Descripción del códgo de retorno o estado del servicio	Alfanumérico hasta 256	-
URL_Request	Sí	Url del formulario de pago	URL	https://forms.todopago.com.ar/formulario/commands?command=formulario&m=t7d3938c9-f7b1-4ee9-e76b-9cc84f73fe81
RequestKey	No	Identificador Privado del Requerimiento obtenido en la respuesta de la operación SendAuthorizeRequest. Nunca debe ser expuesto hacia el Web Browser. Solo será utilizado entre el ecommerce y TodoPago	Alfanumérico hasta 48 caracteres	8496472a-8c87-e35b-dcf2-94d5e31eb12f
PublicRequestKey	No	Identificador Público del Requerimiento obenido en la respuesta de la operación SendAuthorizeRequest	Alfanumérico de hasta 48 caracteres	7d3938c9-f7b1-4ee9-e76b-9cc84f73fe81

Ejemplo de respuesta

Hash (size=5)
    'StatusCode' => int -1
    'StatusMessage' => string 'Solicitud de Autorizacion Registrada' (length=36)
    'URL_Request' => string 'https://developers.todopago.com.ar/formulario/commands?command=formulario&m=6d2589f2-37e6-1334-7565-3dc19404480c' (length=102)
    'RequestKey' => string '6d2589f2-37e6-1334-7565-3dc19404480c' (length=36)
    'PublicRequestKey' => string '6d2589f2-37e6-1334-7565-3dc19404480c' (length=36)

//////////////////////////////////////////////////////////////

optionsSAR_operacion = Hash.new
optionsSAR_operacion[:MERCHANT] = "2153"
optionsSAR_operacion[:OPERATIONID] = "8000"
optionsSAR_operacion[:CURRENCYCODE] = "032"
optionsSAR_operacion[:AMOUNT] = "1.00"

Tambien hay dos datos opcional para informar la cantidad minima y máxima de cuotas que ofrecerá el formulario de pago (generalmente de 1 a 12). Ejemplo :

optionsSAR_operacion[:MININSTALLMENTS] = "1"
optionsSAR_operacion[:MAXINSTALLMENTS] = "6"

Se agregó un nuevo dato opcional Timeout, mediante esta funcionalidad se permite setear el tiempo máximo en el que se puede realizar el pago en el formulario. Los valores posibles van de 300000 (5 minutos) a 21600000 (6hs) en milisegundos. En caso de que no se envíe el parámetro el valor por defecto es 1800000 (30 minutos).

optionsSAR_operacion[:TIMEOUT] = "300000"

La variable response contendrá una estuctura en la cual url_request es donde está hosteado el formulario de pago y donde hay que redireccionar al usuario, una vez realizado el pago según el éxito o fracaso del mismo, el formulario redireccionará a una de las 2 URLs seteadas en optionsSAR_comercio (URL_OK, en caso de éxito o URL_ERROR, en caso de que por algún motivo el formulario rechace el pago)

Confirmación de transacción.

En este caso hay que llamar a getAuthorizeAnswer(), enviando como parámetro un Hash como se describe a continuación.

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
Security	No	Token de Seguridad Generado en el Portal de TodoPago	Alfanumérico hasta 32 caracteres	1234567890ABCDEF1234567890ABCDEF
Merchant	Si	Nro. de Comercio (Merchant ID) provisto por TodoPago	Alfanumérico de 8 caracteres	12345678
RequestKey	Si	Identificador Privado del Requerimiento obtenido en la respuesta de la operación SendAuthorizeRequest. Nunca debe ser expuesto hacia el Web Browser. Solo será utilizado entre el ecommerce y TodoPago	Alfanumérico hasta 48 caracteres	8496472a-8c87-e35b-dcf2-94d5e31eb12f
AnswerKey	Sí	Identificador Público de la Respuesta. Recibido según el formulario utilizado, en la url de redirección hacia el ecommerce, o como propiedad retornada en el callback del formulario híbrido.	Alfanumérico hasta 48 caracteres	8496472a-8c87-e35b-dcf2-94d5e31eb12f

optionsAnwser=Hash.new
optionsAnwser[:Security]= "f3d8b72c94ab4a06be2ef7c95490f7d3" #Token de seguridad, provisto por TODO PAGO. MANDATORIO.
optionsAnwser[:MERCHANT]= "2153"
optionsAnwser[:RequestKey]= "710268a7-7688-c8bf-68c9-430107e6b9da" #Valor retornado en el SendAuthorizeRequest
optionsAnwser[:AnswerKey]= "693ca9cc-c940-06a4-8d96-1ab0d66f3ee6"  #Valor que figura en la URL del redirect luego de realizar el pago

response = conector.getAuthorizeAnswer(optionsAnwser)

RESPONSE :
{ StatusCode = -1,
      StatusMessage = APROBADA,
      AuthorizationKey = 1294-329E-F2FD-1AD8-3614-1218-2693-1378,
      EncodingMethod = XML,
      Payload = { Answer = { DATETIME = 2014/08/11 15:24:38,
                             RESULTCODE = -1,
                             RESULTMESSAGE = APROBADA,
                             CURRENCYNAME = Pesos,
                             PAYMENTMETHODNAME = VISA,
                             TICKETNUMBER = 12,
                             CARDNUMBERVISIBLE = 450799******4905,
                             AUTHORIZATIONCODE = TEST38,
                             INSTALLMENTPAYMENTS = 6 },
                { Request = { MERCHANT = 12345678,
                              OPERATIONID = ABCDEF-1234-12221-FDE1-00000012,
                              AMOUNT = 1.00,
                              CURRENCYCODE = 032,
							  AMOUNTBUYER = 1.20}
                }
    }

Se deben guardar y recuperar los valores de los campos RequestKey y AnswerKey.

El parámetro RequestKey es siempre distinto y debe ser persistido de alguna forma cuando el comprador es redirigido al formulario de pagos.

Importante El campo AnswerKey se adiciona en la redirección que se realiza a alguna de las direcciones ( URL ) especificadas en el servicio SendAurhorizationRequest, esto sucede cuando la transacción ya fue resuelta y es necesario regresar al site para finalizar la transacción de pago, también se adiciona el campo Order, el cual tendrá el contenido enviado en el campo OPERATIONID. Para nuestro ejemplo: http://susitio.com/paydtodopago/ok?Order=27398173292187&Answer=1111-2222-3333-4444-5555-6666-7777

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
StatusCode	Si	Código de estado o valor de retorno del Servicio	Numèrico de 5 posiciones	-1 -> OK 0 a 99999 o vacío -> error
StatusMessage	Si	Descripción del código de retorno o estado del servicio	Alfanumérico hasta 256	-
AuthorizationKey	No	Identificador Privado de la Respuesta	Alfanumérico hasta 256 caracteres	-
EncodingMethod	No	Especifica el tipo codificación que se usa para los datos de la transacciones de pagos	Alfanumérico hasta 16 caracteres	XML
Payload	No	Documento codificado en el formato especificado en el campo EncodingMethod el cual contiene los datos de la transacción ejecutada	Alfanumérico hasta 2048 caracteres	-

El campo o elemento Payload es utilizado para retornar los datos de la respuesta de la transacción. En la siguiente Tabla se muestran los valores enviados en el campo Answer de dicho elemento. (El otro campo presente, de nombre Request contiene información enviada en el requerimiento del GetAuthorizeAnswer)

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
DATETIME	Si	Fecha y Hora de la Transacción	Fecha y Hora. aaaammddTHHMMSSZ La hora se expresa en formato 24 hs.
RESULTCODE	Si	Código de estado o valor de retorno del Servicio	Numérico de 5 posiciones	-1 -> OK 0 a 99999 o vacío -> error
RESULTMESSAGE	Si	Descripción del código de retorno o estado del servicio	Alfanumérico hasta 256	-
CURRENCYNAME	No	Nombre de la Moneda	'Pesos'
PAYMENTMETHODNAME	Sí	Medio de pago usado para la operación	'VISA'
TICKETNUMBER	No	Número de Ticket o Voucher	Numérico de Hasta 4 dígitos
CARDNUMBERVISIBLE	No	Número de Tarjeta, enmascarado según normativas nacionales, regionales o globales
AUTHORIZATIONCODE	No	Código de Autorización	Alfanumérico de hasta 8 caracteres
INSTALLMENTPAYMENTS	No	Cantidad de cuotas elegidas para la operación	Numérico	Ejemplo: 03
AMOUNTBUYER	Si	Monto final (incluyendo Costo Financiero) pagado por el comprador	Decimal	Ejemplo: 129.68

Ejemplo

Existe un ejemplo en la carpeta https://github.com/TodoPago/sdk-ruby/blob/master/TodoPago/test.rb el cual tiene configurados estos valores, y muestra los resultados de los métodos principales del SDK. _{Volver a inicio}

Datos adicionales para control de fraude

Los datos adicionales para control de fraude son obligatorios, de lo contrario baja el score de la transacción.

Los campos marcados como condicionales afectan al score negativamente si no son enviados, pero no son mandatorios o bloqueantes.

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]="some@someurl.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]="1010" #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]="Some Street 2153" #Domicilio de facturación (calle y nro). MANDATORIO.
optionsSAR_operacion[:CSBTSTREET2]="" #Complemento del domicilio. (piso, departamento). NO MANDATORIO.
optionsSAR_operacion[:CSPTCURRENCY]="ARS" #Moneda. MANDATORIO.
optionsSAR_operacion[:CSPTGRANDTOTALAMOUNT]="10.01" #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]="" #Usuario Guest? (Y/N). En caso de ser Y, el campo CSMDD9 no deberá enviarse. NO MANDATORIO.
optionsSAR_operacion[:CSMDD9]="" #Customer password Hash: criptograma asociado al password del comprador final. NO MANDATORIO.
optionsSAR_operacion[:CSMDD10]="" #Histórica de compras del comprador (Num transacciones). NO MANDATORIO.
optionsSAR_operacion[:CSMDD11]="" #Customer Cell Phone. NO MANDATORIO.

#Retail
optionsSAR_operacion[:CSSTCITY]="Villa General Belgrano" #Ciudad de envío de la orden. MANDATORIO.
optionsSAR_operacion[:CSSTCOUNTRY]="" #País de envío de la orden. MANDATORIO.
optionsSAR_operacion[:CSSTEMAIL]="some@someurl.com" #Mail del destinatario, MANDATORIO.
optionsSAR_operacion[:CSSTFIRSTNAME]="Jose" #Nombre del destinatario. MANDATORIO.
optionsSAR_operacion[:CSSTLASTNAME]="Perez" #Apellido del destinatario. MANDATORIO.
optionsSAR_operacion[:CSSTPHONENUMBER]="541160913988" #Número de teléfono del destinatario. MANDATORIO.
optionsSAR_operacion[:CSSTPOSTALCODE]="1010" #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]="Some Street 2153" #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]="Test Prd Description" #Descripción del producto. CONDICIONAL.
optionsSAR_operacion[:CSITPRODUCTNAME]="TestPrd" #Nombre del producto. CONDICIONAL.
optionsSAR_operacion[:CSITPRODUCTSKU]="SKU1234" #Código identificador del producto. CONDICIONAL.
optionsSAR_operacion[:CSITTOTALAMOUNT]="10.01" #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]="10.01" #Formato Idem CSITTOTALAMOUNT. CONDICIONAL.
...........................................................

Parámetros Generales:

Parámetro	Requerido	Descripción	Descripción	Valores posibles
CSBTCITY	Sí	Ciudad de facturación	Alfanumérico de 50 caracteres.	Ejemplo: Villa General Belgrano
CSBTCOUNTRY	Sí	País de facturación	Alfanumérico de 2 caracteres.	Código ISO
CSBTCUSTOMERID	Si	Identificador del usuario al que se le emite la factura. No puede contener un correo electrónico	Alfanumérico de 50 caracteres.	Ejemplos: A.Carlos 453458
CSBTIPADDRESS	Sí	IP de la PC del comprador	Alfanumérico de 15 caracteres.	Ejemplo: 10.1.27.63
CSBTEMAIL	Si	Mail del usuario al que se le emite la factura	Alfanumérico de 100 caracteres.	Ejemplo: todopago@hotmail.com
CSBTFIRSTNAME	Si	Nombre del usuario al que se le emite la factura	Alfanumérico de 60 caracteres.	Ejemplo: Juan
CSBTLASTNAME	Si	Apellido del usuario al que se le emite la factura	Alfanumérico de 60 caracteres.	Ejemplo: Perez
CSBTPHONENUMBER	Si	Teléfono del usuario al que se le emite la factura. No utilizar guiones, puntos o espacios. Incluir código de país	Alfanumérico de 15 caracteres.	Ejemplo: 541160913988
CSBTPOSTALCODE	Si	Código Postal de la dirección de facturación	Alfanumérico de 10 caracteres.	Ejemplo: C1010AAP ó 1010
CSBTSTATE	Si	Provincia de la dirección de facturación	Alfanumérico de 2 caracteres.	Ver Provincias Ejemplo: Enviar C si corresponde a CABA
CSBTSTREET1	Si	Domicilio de facturación (Calle Numero interior Numero Exterior)	Alfanumérico de 60 caracteres.	Ejemplo: Cerrito 740 piso 8
CSBTSTREET2	No	Localidad	Alfanumérico de 60 caracteres.	Ejemplo: CABA
CSPTCURRENCY	Si	Moneda	Alfanumérico de 5 caracteres.	Ejemplo: ARS
CSPTGRANDTOTALAMOUNT	Si	"999999.CC" Con decimales obligatorios, usando el puntos como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales.	Numérico de 15 posiciones	Ejemplos: $125,38 -> 125.38 $12 -> 12.00
CSMDD6	No	Canal de venta	Alfanumérico de 255 caracteres.	Valores posibles: Web, Mobile, Telefonica
CSMDD7	No	Cantidad de dias que está registrado el cliente en el sitio del comercio. (num Dias)	Alfanumérico de 255 caracteres.
CSMDD8	No	Para indicar si el usuario está comprando como invitado en la página del comercio. En caso de ser "S", el campo CSMDD9 no deberá enviarse.	Valor Booleano	Valores posibles (S/N)
CSMDD9	No	Valor del password del usuario registrado en el portal del comercio. Incluir el valor en hash	Alfanumérico de 255 caracteres.
CSMDD10	No	Cantidad de transacciones realizadas por el mismo usuario registrado en el portal del comercio (Num transacciones)	Alfanumérico de 255 caracteres.
CSMDD11	No	Celular del cliente	Alfanumérico de 255 caracteres.

Parámetros del vertical "Retail":

Parámetro	Requerido	Descripción	Descripción	Valores posibles
CSSTCITY	Si	Ciudad de envío de la orden	Alfanumérico de 50 caracteres
CSSTCOUNTRY	Si	País de envío de la orden	Alfanumérico de 2 caracteres	Código ISO
CSSTEMAIL	Si	Correo electrónico del comprador	Alfanumérico de 100 caracteres
CSSTFIRSTNAME	Si	Nombre de la persona que recibe el producto	Alfanumérico de 60 caracteres
CSSTLASTNAME	Si	Apellido de la persona que recibe el producto	Alfanumérico de 60 caracteres
CSSTPHONENUMBER	Si	Número de teléfono del destinatario	Alfanumérico de 15 caracteres
CSSTPOSTALCODE	Si	Código postal del domicilio de envío	Alfanumérico de 10 caracteres
CSSTSTATE	Si	Provincia de envío	Alfanumérico de 2 caracteres	Es un carácter. Ver Provincias
CSSTSTREET1	Si	Domicilio de envío	Alfanumérico de 60 caracteres
CSSTSTREET2	No	Localidad de envío	Alfanumérico de 60 caracteres
CSMDD12	No	Cantidad de días que tiene el comercio para hacer la entrega	Alfanumérico de 255 caracteres
CSMDD13	No	Método de Despacho	Alfanumérico de 255 caracteres	Valores posibles: storepickup, deliverypropio, deliverycarrier Notas: deliverypropio: envío realizado con operador logístico propio. deliverycarrier: envío realizado con operador logístico tercerizado (ej. Andreani).
CSMDD14	No	Valor booleano para identificar si el cliente requiere un comprobante fiscal o no S / N	Valor Booleano	S/N
CSMDD15	No	CustomerLoyalityNumber - número de cliente frecuente	Alfanumérico de 255 caracteres
CSMDD16	No	Promotional / CouponCode - número de cupón de descuento	Alfanumérico de 255 caracteres

Datos a enviar por cada producto, los valores deben estar separados con "#":

Parámetro	Requerido	Descripción	Descripción	Valores posibles
CSITPRODUCTCODE	Condicional	Categoría del producto	Alfanumérico de 255 caracteres	Valor por defecto: default
CSITPRODUCTDESCRIPTION	Condicional	Descripción del producto	Alfanumérico de 255 caracteres	NOTEBOOK L845 SP4304LA DF TOSHIBA 4GB RAM 233 MHZ
CSITPRODUCTNAME	Condicional	Nombre del producto	Alfanumérico de 255 caracteres	NOTEBOOK L845 SP4304LA DF TOSHIBA
CSITPRODUCTSKU	Condicional	Código identificador del producto	Alfanumérico de 255 caracteres	Ejemplo: LEVJNSL36GN
CSITTOTALAMOUNT	Condicional	CSITTOTALAMOUNT = CSITUNITPRICE * CSITQUANTITY "999999.CC" Es mandatorio informar los decimales, usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales.	Numérico	Ejemplos: $125,38 -> 125.38 $12 -> 12.00
CSITQUANTITY	Condicional	Cantidad del producto	Numérico	Ejemplo: 1
CSITUNITPRICE	Condicional	"999999.CC" Es mandatorio informar los decimales, usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales.	Numérico	Ejemplos: $125,38 -> 125.38 $12 -> 12.00

_{Volver a inicio}

Opciones adicionales

Dentro del parámetro optionsSAR_operacion pueden enviarse opciones adicionales que habilitan características para esa transacción en particular. A continuación se describen las mismas

Rango de Cuotas

Es posible setear el rango de cuotas a mostrar en el formulario entre un mínimo y un máximo, enviando los siguientes parametros adicionales

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
MININSTALLMENTS	No	Mínimo de cuotas a mostrar en el formulario	Numérico	3
MAXINSTALLMENTS	No	Máximo de cuotas a mostrar en el formulario	Numérico	9

Ejemplo

.............................................
optionsSAR_operacion[:MAXINSTALLMENTS] = "6"
optionsSAR_operacion[:MININSTALLMENTS] = "3"
.............................................

Filtrado de Medios de Pago

Mediante esta funcionalidad es posible filtrar los medios de pago habilitados en el formulario de pago. Se debe pasar en la llamada al servicio SendAuthorizeRequest un parámetro adicional con los ids de los medio de pago que se desean habilitar, los cuales pueden consultarse mediante el método de Descubrimiento de Medios de Pago

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
AVAILABLEPAYMENTMETHODSIDS	No	Lista de los ids de medios de pago habilitados separados por #	Alfanumérico	1#42#500

Ejemplo

.............................................
optionsSAR_operacion[:AVAILABLEPAYMENTMETHODSIDS] = "1#42#500"
.............................................

_{Volver a inicio}

Tiempo de vida de la transacción

Es posible setear el tiempo máximo disponible para que el cliente complete el pago en el formulario, el valor por defecto es de 30 minutos. El rango posible es de 5 minutos a 6 horas. Los valores deben ser expresados en milisegundos

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
TIMEOUT	No	Tiempo de vida de la transacción en milisegundos	Numérico	1800000

Ejemplo

.............................................
optionsSAR_operacion[:TIMEOUT] = 10*60*1000
.............................................

_{Volver a inicio}

Modo Test

El SDK-RUBY permite trabajar con los ambiente de desarrollo y de produccion de Todo Pago.

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}

Características

Status de la Operación

estado

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:

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
MERCHANT	Sí	Código de comercio o cuenta provisto por TodoPago	Alfanumérico de 8 caracteres	12345678
OPERATIONID	Sí	Identificación de la transacción para el Comercio. Debe ser distinto para cada operación.	Alfanumérico de 1 a 40 caracteres.	141120084707

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

El siguiente método retornará el status actual de la transacción en Todopago.

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
RESULTCODE	Sí	Número identificador del estado en el que se encuentra la transacción	Numérico
RESULTMESSAGE	Sí	Describe el estado en el que se encuentra la transacción	Alfanumérico
DATETIME	No			2015-05-13T14:11:38.287+00:00
OPERATIONID	Sí	Identificación de la transacción para el Comercio. Debe ser distinto para cada operación.	Alfanumérico de 1 a 40 caracteres.	141120084707
CURRENCYCODE	Sí	Código de moneda utilizado en la transacción. Por el momento solo 32 (Pesos	Numérico/td>	32
AMOUNT	Sí	Importe original en Pesos de la transacción.	Numérico con 9 dígitos con hasta 2 decimales 999999[.CC] Usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales.	$125,38 -> 125.38 $12 -> 12.00
AMOUNTBUYER	Sí	Importe final en Pesos de la transacción.	Numérico con 9 dígitos con hasta 2 decimales 999999[.CC] Usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales.	$125,38 -> 125.38 $12 -> 12.00
TYPE	Sí	Tipo de Operación, en el caso del GetStatus siempre será compra_online	Alfanumérico	compra_online
INSTALLMENTPAYMENTS	No	Código de autorización generado por el medio de pago	Decimal de hasta dos dígitos.	01, 02, 06, 12, etc.
CUSTOMEREMAIL	Sí	Mail del usuario al que se le emite la factura	Alfanumérico de 100 caracteres.	Ejemplo: cosme@fulanito.com
IDENTIFICATIONTYPE	No	Tipo de documento		DNI CI LE LC
IDENTIFICATION	No	Número de documento	Numérico
CARDNUMBER	No	Número de Tarjeta, enmascarado según normativas nacionales	alfanumérico de 20 caracteres
TITULAR	No	Nombre del titular de la tarjeta.	Alfanumérico
NROTICKET	No	Numero de Ticket o Voucher	Numérico de Hasta 4 dígitos

Además, se puede conocer el estado de las transacciones a través del portal www.todopago.com.ar. Desde el portal se verán los estados "Aprobada" y "Rechazada". Si el método de pago elegido por el comprador fue Pago Fácil o RapiPago, se podrán ver en estado "Pendiente" hasta que el mismo sea pagado.

Ejemplo de Respuesta

{
  'Operations' =
    {
      'RESULTCODE' = string '999' (length=3)
      'RESULTMESSAGE' = string 'RECHAZADA' (length=9)
      'DATETIME' = string '2015-05-13T14:11:38.287+00:00' (length=29)
      'OPERATIONID' = string '01' (length=2)
      'CURRENCYCODE' = string '32' (length=2)
      'AMOUNT' = int 54
      'TYPE' = string 'compra_online' (length=13)
      'INSTALLMENTPAYMENTS' = string '4' (length=1)
      'CUSTOMEREMAIL' = string 'cosme@fulanito.com' (length=18)
      'IDENTIFICATIONTYPE' = string 'DNI' (length=3)
      'IDENTIFICATION' = string '1212121212' (length=10)
      'CARDNUMBER' = string '12121212XXXXXX1212' (length=18)
      'CARDHOLDERNAME' = string 'Cosme Fulanito' (length=14)
      'TICKETNUMBER' = int 0
      'AUTHORIZATIONCODE' = null
      'BARCODE' = null
      'COUPONEXPDATE' = null
      'COUPONSECEXPDATE' = null
      'COUPONSUBSCRIBER' = null
    }
}

Descubrimiento de Medios de Pago

La SDK cuenta con un método para obtener todos los medios de pago habilitados en TodoPago.

response = tpc.discoverPaymentMethods()

Consulta de operaciones por rango de tiempo

En este caso hay que llamar a getByRangeDateTime() y devolverá todas las operaciones realizadas en el rango de fechas dado

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
MERCHANT	Sí	Nro identificador del comercio	numérico	12305
STARTDATE	Sí	Fecha y hora desde	date	date("Y-m-d", time()-606024*30)
ENDDATE	Sí	Fecha y hora hasta	date	date("Y-m-d", time())
PAGENUMBER	Sí	Número de página a la que se desea acceder*	entero	2

* Este método devuelve páginas de 5 transacciones, por medio del campo PAGENUMBER se puede indicar a que página se desea acceder.

optionsGBRDT=Hash.new
optionsGBRDT[:Merchant]= "2866"
optionsGBRDT[:STARTDATE]= "2016-01-01"
optionsGBRDT[:ENDDATE]= "2016-02-19"
optionsGBRDT[:PAGENUMBER] = "1"

response = tpc.getByRangeDateTime(optionsGBRDT)

Devolución

devolucion parcial

El SDK dispone de métodos para realizar la devolución, de una transacción realizada a traves de TodoPago.

Se debe llamar al método voidRequest de la siguiente manera:

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
Security	Sí	API Key del comercio asignada por TodoPago	alfanumérico	837BE68A892F06C17B944F344AEE8F5F
Merchant	Sí	Nro de comercio asignado por TodoPago	numérico	12345
RequestKey	No*	RequestKey devuelto como respuesta del servicio SendAutorizeRequest	alfanumérico	6d2589f2-37e6-1334-7565-3dc19404480c
AuthorizationKey	No*	AuthorizationKey devuelto como respuesta del servicio GetAuthorizeAnswer	alfanumérico	4a2569a2-38e6-4589-1564-4480c3dc1940


options = Hash.new

options[:Security] = "837BE68A892F06C17B944F344AEE8F5F", #API Key del comercio asignada por TodoPago
options[:Merchant] = "35", #Merchant o Nro de comercio asignado por TodoPago
options[:RequestKey] = "6d2589f2-37e6-1334-7565-3dc19404480c" #RequestKey devuelto como respuesta del servicio SendAutorizeRequest

resp = tpc.voidRequest(options)

También se puede llamar al método voidRequest de la esta otra manera:


options[:Security] = "837BE68A892F06C17B944F344AEE8F5F", #API Key del comercio asignada por TodoPago
options[:Merchant] = "35", #Merchant o Nro de comercio asignado por TodoPago
options[:AuthorizationKey] = "6d2589f2-37e6-1334-7565-3dc19404480c" #AuthorizationKey devuelto como respuesta del servicio GetAuthorizeAnswer

resp = tpc.voidRequest(options)

Respuesta del servicio: Si la operación fue realizada correctamente se informará con un código 2011 y un mensaje indicando el éxito de la operación.

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
StatusCode	Sí	Número de identificación del motivo del resultado	Numérico	2011
StatusMessage	Sí	Resultado de la devolución	Alfanumérico	Operación realizada correctamente

Si la operación fue realizada correctamente se informará con un código 2011 y un mensaje indicando el éxito de la operación.

{:envelope=>{:body=>{:return_response=>{:status_code=>"2011", :status_message=>"TX OK", :authorization_key=>"318974f2-4866-d8e7-9622-9ac21aec0df2", :authorizationcode=>"2011", :"@xmlns:api"=>"http://api.todopago.com.ar"}}, :"@xmlns:soapenv"=>"http://schemas.xmlsoap.org/soap/envelope/"}}

Devolución parcial

devolucion parcial

La SDK dispone de métodos para realizar la devolución parcial, de una transacción realizada a traves de TodoPago.

Nota: Para el caso de promociones con costo financiero, se deberá enviar el monto a devolver en base al valor original de la transacción y no del monto finalmente cobrado. TodoPago se encargará de devolver el porcentaje del costo financiero correspondiente a la devolución parcial.

Se debe llamar al método returnRequest de la siguiente manera:

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
Security	Sí	API Key del comercio asignada por TodoPago	alfanumérico	837BE68A892F06C17B944F344AEE8F5F
Merchant	Sí	Nro de comercio asignado por TodoPago	numérico	12345
RequestKey	No*	RequestKey devuelto como respuesta del servicio SendAutorizeRequest	alfanumérico	6d2589f2-37e6-1334-7565-3dc19404480c
AuthorizationKey	No*	AuthorizationKey devuelto como respuesta del servicio GetAuthorizeAnswer	alfanumérico	4a2569a2-38e6-4589-1564-4480c3dc1940
AMOUNT	No	Monto a devolver, si no se envía, se trata de una devolución total	string usando . como separador decimal, incluyendo SIEMPRE 2 cifras decimales	23.50

*Es requerida la presencia de sólo uno de estos 2 campos


options = Hash.new

options[:Security]= "837BE68A892F06C17B944F344AEE8F5F", #API Key del comercio asignada por TodoPago
options[:Merchant] ="35", #Merchant o Nro de comercio asignado por TodoPago
options[:RequestKey] = "6d2589f2-37e6-1334-7565-3dc19404480c" #RequestKey devuelto como respuesta del servicio SendAutorizeRequest
options[:AMOUNT] = "23.50" #Opcional. Monto a devolver, si no se envía, se trata de una devolución total

resp = tpc.returnRequest(options)

También se puede llamar al método returnRequest de la esta otra manera:

options = Hash.new

options[:Security] = "837BE68A892F06C17B944F344AEE8F5F", #API Key del comercio asignada por TodoPago
options[:Merchant] = "35", #Merchant o Nro de comercio asignado por TodoPago
options[:AuthorizationKey] = "6d2589f2-37e6-1334-7565-3dc19404480c" #AuthorizationKey devuelto como respuesta del servicio GetAuthorizeAnswer
options[:AMOUNT] = "1.00" #Opcional. Monto a devolver, si no se envía, se trata de una devolución total

resp = tpc.returnRequest(options)

Respuesta de servicio:

Campo	Requerido	Descripción	Tipo de Dato	Valores posibles / Ejemplo
StatusCode	Sí	Número de identificación del motivo del resultado	Numérico	2011
StatusMessage	Sí	Resultado de la devolución	Alfanumérico	Operación realizada correctamente

Si la operación fue realizada correctamente se informará con un código 2011 y un mensaje indicando el éxito de la operación.

{:envelope=>{:body=>{:return_response=>{:status_code=>"2011", :status_message=>"TX OK", :authorization_key=>"318974f2-4866-d8e7-9622-9ac21aec0df2", :authorizationcode=>"2011", :"@xmlns:api"=>"http://api.todopago.com.ar"}}, :"@xmlns:soapenv"=>"http://schemas.xmlsoap.org/soap/envelope/"}}

Formulario híbrido

Conceptos básicos
El formulario híbrido, es una alternativa al medio de pago actual por redirección al formulario externo de TodoPago.
Con el mismo, se busca que el comercio pueda adecuar el look and feel del formulario a su propio diseño.

Librería El formulario requiere incluir en la página una librería Javascript de TodoPago.
El endpoint depende del entorno:

Desarrollo: https://developers.todopago.com.ar/resources/v2/TPBSAForm.min.js
Producción: https://forms.todopago.com.ar/resources/v2/TPBSAForm.min.js

Restricciones y libertades en la implementación

Por ningún motivo podrá bajarse el javascript provisto ni realizar cambios en el mismo. Siempre deberá ser tomado de los servidores de TodoPago.
Ninguno de los campos del formulario podrá contar con el atributo name.
Se deberá proveer de manera obligatoria un botón para gestionar el pago con Billetera Todo Pago.
Todos los elementos de tipo son completados por la API de Todo Pago.
Los campos tienen un id por defecto. Si se prefiere utilizar otros ids se deberán especificar los mismos cuando se inicialice el script de Todo Pago.
Pueden aplicarse todos los detalles visuales que se crean necesarios, la API de Todo Pago no altera los atributos class y style.
Puede utilizarse la API para setear los atributos placeholder del formulario, para ello deberá especificar dichos placeholders en la inicialización del formulario "window.TPFORMAPI.hybridForm.setItem". En caso de que no se especifiquen los placeholders se usarán los valores por defecto de la API.

HTML del formulario

El formulario implementado debe contar al menos con los siguientes campos.

<body>
	<select id="formaDePagoCbx"></select>
	<select id="bancoCbx"></select>
	<select id="promosCbx"></select>
	<label id="labelPromotionTextId"></label>
	<input id="numeroTarjetaTxt"/>
	<input id="mesTxt"/>
	<input id="anioTxt"/>
	<input id="codigoSeguridadTxt"/>
	<label id="labelCodSegTextId"></label>
	<input id="apynTxt"/>
	<select id="tipoDocCbx"></select>
	<input id="nroDocTxt"/>
	<input id="emailTxt"/><br/>
	<button id="MY_btnPagarConBilletera"/>
	<button id="MY_btnConfirmarPago"/>
</body>

Inizialización y parámetros requeridos
Para inicializar el formulario se usa window.TPFORMAPI.hybridForm.initForm. El cual permite setear los elementos y ids requeridos.

Para inicializar un ítem de pago, es necesario llamar a window.TPFORMAPI.hybridForm.setItem. Este requiere obligatoriamente el parámetro publicKey que corresponde al PublicRequestKey (entregado por el SAR). Se sugiere agregar los parámetros usuario, e-mail, tipo de documento y numero.

Javascript

window.TPFORMAPI.hybridForm.initForm({
    callbackValidationErrorFunction: 'validationCollector',
	callbackCustomSuccessFunction: 'customPaymentSuccessResponse',
	callbackCustomErrorFunction: 'customPaymentErrorResponse',
	callbackBilleteraFunction: 'billeteraPaymentResponse',
	botonPagarId: 'MY_btnConfirmarPago',
	botonPagarConBilleteraId: 'MY_btnPagarConBilletera',
	modalCssClass: 'modal-class',
	modalContentCssClass: 'modal-content',
	beforeRequest: 'initLoading',
	afterRequest: 'stopLoading'
});

window.TPFORMAPI.hybridForm.setItem({
    publicKey: 'taf08222e-7b32-63d4-d0a6-5cabedrb5782', //obligatorio
    defaultNombreApellido: 'Usuario',
    defaultNumeroDoc: 20234211,
    defaultMail: 'todopago@mail.com',
    defaultTipoDoc: 'DNI'
});

//callbacks de respuesta del pago
function validationCollector(parametros) {
}
function billeteraPaymentResponse(response) {
}
function customPaymentSuccessResponse(response) {
}
function customPaymentErrorResponse(response) {
}
function initLoading() {
}
function stopLoading() {
}

Callbacks
El formulario define callbacks javascript, que son llamados según el estado y la información del pago realizado:

billeteraPaymentResponse: Devuelve response si el pago con billetera se realizó correctamente.
customPaymentSuccessResponse: Devuelve response si el pago se realizo correctamente.
customPaymentErrorResponse: Si hubo algún error durante el proceso de pago, este devuelve el response con el código y mensaje correspondiente.

_{Volver a inicio}

Obtener credenciales

credenciales

El SDK permite obtener las credenciales "Authentification", "MerchandId" y "Security" de la cuenta de Todo Pago, ingresando el usuario y contraseña.
Esta funcionalidad es útil para obtener los parámetros de configuración dentro de la implementación.

Crear una instancia de la clase User:

u = User.new("email@ejemplo.com", "password1")
response = conector.getCredentials(u)

Observación: El Security se obtiene a partir de apiKey, eliminando TODOPAGO de este último.

_{Volver a inicio}

Tablas de Referencia

Provincias

Los siguientes códigos son utilizados para control de fraude y para el cálculo de retenciones del Impuesto sobre los Ingresos Brutos.

Provincia	Código
CABA	C
Buenos Aires	B
Catamarca	K
Chaco	H
Chubut	U
Córdoba	X
Corrientes	W
Entre Ríos	E
Formosa	P
Jujuy	Y
La Pampa	L
La Rioja	F
Mendoza	M
Misiones	N
Neuquén	Q
Río Negro	R
Salta	A
San Juan	J
San Luis	D
Santa Cruz	Z
Santa Fe	S
Santiago del Estero	G
Tierra del Fuego	V
Tucumán	T

_{Volver a inicio}

Tabla de errores operativos

Id mensaje	Mensaje
-1	Tu compra fue exitosa.
1081	Tu saldo es insuficiente para realizar la transacción.
1100	El monto ingresado es menor al mínimo permitido
1101	El monto ingresado supera el máximo permitido.
1102	La tarjeta ingresada no corresponde al Banco indicado. Revisalo.
1104	El precio ingresado supera al máximo permitido.
1105	El precio ingresado es menor al mínimo permitido.
2010	En este momento la operación no pudo ser realizada. Por favor intentá más tarde. Volver a Resumen.
2031	En este momento la validación no pudo ser realizada, por favor intentá más tarde.
2050	Lo sentimos, el botón de pago ya no está disponible. Comunicate con tu vendedor.
2051	La operación no pudo ser procesada. Por favor, comunicate con tu vendedor.
2052	La operación no pudo ser procesada. Por favor, comunicate con tu vendedor.
2053	La operación no pudo ser procesada. Por favor, intentá más tarde. Si el problema persiste comunicate con tu vendedor
2054	Lo sentimos, el producto que querés comprar se encuentra agotado por el momento. Por favor contactate con tu vendedor.
2056	La operación no pudo ser procesada. Por favor intentá más tarde.
2057	La operación no pudo ser procesada. Por favor intentá más tarde.
2059	La operación no pudo ser procesada. Por favor intentá más tarde.
90000	La cuenta destino de los fondos es inválida. Verificá la información ingresada en Mi Perfil.
90001	La cuenta ingresada no pertenece al CUIT/ CUIL registrado.
90002	No pudimos validar tu CUIT/CUIL. Comunicate con nosotros acá para más información.
99005	Tu compra no pudo realizarse. Iniciala nuevamente.
99900	El pago fue realizado exitosamente
99901	No hemos encontrado tarjetas vinculadas a tu Billetera. Podés adherir medios de pago desde www.todopago.com.ar
99902	No se encontro el medio de pago seleccionado
99903	Lo sentimos, hubo un error al procesar la operación. Por favor reintentá más tarde.
99904	Tu compra no puede ser realizada. Comunicate con tu vendedor.
99953	Tu compra no pudo realizarse. Iniciala nuevamente o utilizá otro medio de pago.
99960	Esta compra requiere autorización de VISA. Comunicate al número que se encuentra al dorso de tu tarjeta.
99961	Esta compra requiere autorización de AMEX. Comunicate al número que se encuentra al dorso de tu tarjeta.
99970	Lo sentimos, no pudimos procesar la operación. Por favor reintentá más tarde.
99971	Lo sentimos, no pudimos procesar la operación. Por favor reintentá más tarde.
99978	Lo sentimos, no pudimos procesar la operación. Por favor reintentá más tarde.
99979	Lo sentimos, el pago no pudo ser procesado.
99980	Ya realizaste un pago en este sitio por el mismo importe. Si querés realizarlo nuevamente esperá 5 minutos.
99982	Tu compra no pudo ser procesada. Iniciala nuevamente utilizando otro medio de pago.
99983	Lo sentimos, el medio de pago no permite la cantidad de cuotas ingresadas. Por favor intentá más tarde.
99984	Lo sentimos, el medio de pago seleccionado no opera en cuotas.
99985	Lo sentimos, el pago no pudo ser procesado.
99986	Lo sentimos, en este momento la operación no puede ser realizada. Por favor intentá más tarde.
99987	Lo sentimos, en este momento la operación no puede ser realizada. Por favor intentá más tarde.
99988	Lo sentimos, momentaneamente el medio de pago no se encuentra disponible. Por favor intentá más tarde.
99989	La tarjeta ingresada no está habilitada. Comunicate con la entidad emisora de la tarjeta para verificar el incoveniente.
99990	La tarjeta ingresada está vencida. Por favor seleccioná otra tarjeta o actualizá los datos.
99991	Los datos informados son incorrectos. Por favor ingresalos nuevamente.
99992	La fecha de vencimiento es incorrecta. Por favor seleccioná otro medio de pago o actualizá los datos.
99993	La tarjeta ingresada no está vigente. Por favor seleccioná otra tarjeta o actualizá los datos.
99994	El saldo de tu tarjeta no te permite realizar esta compra. Iniciala nuevamente utilizando otro medio de pago.
99995	La tarjeta ingresada es invalida. Seleccioná otra tarjeta para realizar el pago.
99996	La operación fué rechazada por el medio de pago porque el monto ingresado es inválido.
99997	Lo sentimos, en este momento la operación no puede ser realizada. Por favor intentá más tarde.
99998	Lo sentimos, la operación fue rechazada. Comunicate con la entidad emisora de la tarjeta para verificar el incoveniente o seleccioná otro medio de pago.
99999	Lo sentimos, la operación no pudo completarse. Comunicate con la entidad emisora de la tarjeta para verificar el incoveniente o seleccioná otro medio de pago.

_{Volver a inicio}

Tabla de errores de integración

Id mensaje	Descripción
98001	ERROR: El campo CSBTCITY es requerido
98002	ERROR: El campo CSBTCOUNTRY es requerido
98003	ERROR: El campo CSBTCUSTOMERID es requerido
98004	ERROR: El campo CSBTIPADDRESS es requerido
98005	ERROR: El campo CSBTEMAIL es requerido
98006	ERROR: El campo CSBTFIRSTNAME es requerido
98007	ERROR: El campo CSBTLASTNAME es requerido
98008	ERROR: El campo CSBTPHONENUMBER es requerido
98009	ERROR: El campo CSBTPOSTALCODE es requerido
98010	ERROR: El campo CSBTSTATE es requerido
98011	ERROR: El campo CSBTSTREET1 es requerido
98012	ERROR: El campo CSBTSTREET2 es requerido
98013	ERROR: El campo CSPTCURRENCY es requerido
98014	ERROR: El campo CSPTGRANDTOTALAMOUNT es requerido
98015	ERROR: El campo CSMDD7 es requerido
98016	ERROR: El campo CSMDD8 es requerido
98017	ERROR: El campo CSMDD9 es requerido
98018	ERROR: El campo CSMDD10 es requerido
98019	ERROR: El campo CSMDD11 es requerido
98020	ERROR: El campo CSSTCITY es requerido
98021	ERROR: El campo CSSTCOUNTRY es requerido
98022	ERROR: El campo CSSTEMAIL es requerido
98023	ERROR: El campo CSSTFIRSTNAME es requerido
98024	ERROR: El campo CSSTLASTNAME es requerido
98025	ERROR: El campo CSSTPHONENUMBER es requerido
98026	ERROR: El campo CSSTPOSTALCODE es requerido
98027	ERROR: El campo CSSTSTATE es requerido
98028	ERROR: El campo CSSTSTREET1 es requerido
98029	ERROR: El campo CSMDD12 es requerido
98030	ERROR: El campo CSMDD13 es requerido
98031	ERROR: El campo CSMDD14 es requerido
98032	ERROR: El campo CSMDD15 es requerido
98033	ERROR: El campo CSMDD16 es requerido
98034	ERROR: El campo CSITPRODUCTCODE es requerido
98035	ERROR: El campo CSITPRODUCTDESCRIPTION es requerido
98036	ERROR: El campo CSITPRODUCTNAME es requerido
98037	ERROR: El campo CSITPRODUCTSKU es requerido
98038	ERROR: El campo CSITTOTALAMOUNT es requerido
98039	ERROR: El campo CSITQUANTITY es requerido
98040	ERROR: El campo CSITUNITPRICE es requerido
98101	ERROR: El formato del campo CSBTCITY es incorrecto
98102	ERROR: El formato del campo CSBTCOUNTRY es incorrecto
98103	ERROR: El formato del campo CSBTCUSTOMERID es incorrecto
98104	ERROR: El formato del campo CSBTIPADDRESS es incorrecto
98105	ERROR: El formato del campo CSBTEMAIL es incorrecto
98106	ERROR: El formato del campo CSBTFIRSTNAME es incorrecto
98107	ERROR: El formato del campo CSBTLASTNAME es incorrecto
98108	ERROR: El formato del campo CSBTPHONENUMBER es incorrecto
98109	ERROR: El formato del campo CSBTPOSTALCODE es incorrecto
98110	ERROR: El formato del campo CSBTSTATE es incorrecto
98111	ERROR: El formato del campo CSBTSTREET1 es incorrecto
98112	ERROR: El formato del campo CSBTSTREET2 es incorrecto
98113	ERROR: El formato del campo CSPTCURRENCY es incorrecto
98114	ERROR: El formato del campo CSPTGRANDTOTALAMOUNT es incorrecto
98115	ERROR: El formato del campo CSMDD7 es incorrecto
98116	ERROR: El formato del campo CSMDD8 es incorrecto
98117	ERROR: El formato del campo CSMDD9 es incorrecto
98118	ERROR: El formato del campo CSMDD10 es incorrecto
98119	ERROR: El formato del campo CSMDD11 es incorrecto
98120	ERROR: El formato del campo CSSTCITY es incorrecto
98121	ERROR: El formato del campo CSSTCOUNTRY es incorrecto
98122	ERROR: El formato del campo CSSTEMAIL es incorrecto
98123	ERROR: El formato del campo CSSTFIRSTNAME es incorrecto
98124	ERROR: El formato del campo CSSTLASTNAME es incorrecto
98125	ERROR: El formato del campo CSSTPHONENUMBER es incorrecto
98126	ERROR: El formato del campo CSSTPOSTALCODE es incorrecto
98127	ERROR: El formato del campo CSSTSTATE es incorrecto
98128	ERROR: El formato del campo CSSTSTREET1 es incorrecto
98129	ERROR: El formato del campo CSMDD12 es incorrecto
98130	ERROR: El formato del campo CSMDD13 es incorrecto
98131	ERROR: El formato del campo CSMDD14 es incorrecto
98132	ERROR: El formato del campo CSMDD15 es incorrecto
98133	ERROR: El formato del campo CSMDD16 es incorrecto
98134	ERROR: El formato del campo CSITPRODUCTCODE es incorrecto
98135	ERROR: El formato del campo CSITPRODUCTDESCRIPTION es incorrecto
98136	ERROR: El formato del campo CSITPRODUCTNAME es incorrecto
98137	ERROR: El formato del campo CSITPRODUCTSKU es incorrecto
98138	ERROR: El formato del campo CSITTOTALAMOUNT es incorrecto
98139	ERROR: El formato del campo CSITQUANTITY es incorrecto
98140	ERROR: El formato del campo CSITUNITPRICE es incorrecto
98201	ERROR: Existen errores en la información de los productos
98202	ERROR: Existen errores en la información de CSITPRODUCTDESCRIPTION los productos
98203	ERROR: Existen errores en la información de CSITPRODUCTNAME los productos
98204	ERROR: Existen errores en la información de CSITPRODUCTSKU los productos
98205	ERROR: Existen errores en la información de CSITTOTALAMOUNT los productos
98206	ERROR: Existen errores en la información de CSITQUANTITY los productos
98207	ERROR: Existen errores en la información de CSITUNITPRICE de los productos

_{Volver a inicio}

FAQs

What is TodoPagoConectorSS?

Is TodoPagoConectorSS well maintained?

Package last updated on 20 Apr 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

TodoPagoConectorSS

Instalación

1. Creación de la gema TodoPagoConector

2. Instalación de la gema TodoPagoConector

3. Versiones de Ruby soportadas

4. Generalidades

Uso

Inicializar la clase correspondiente al conector (TodoPagoConector).

Operatoria Agrupador

Diagrama de secuencia

Solicitud de autorización

Confirmación de transacción.

Ejemplo

Datos adicionales para control de fraude

Opciones adicionales

Rango de Cuotas

Ejemplo

Filtrado de Medios de Pago

Ejemplo

Tiempo de vida de la transacción

Ejemplo

Modo Test

Características

Status de la Operación

Descubrimiento de Medios de Pago

Consulta de operaciones por rango de tiempo

Devolución

Devolución parcial

Formulario híbrido

Obtener credenciales

Tablas de Referencia

Provincias

Tabla de errores operativos

Tabla de errores de integración

Related posts

New Website “Is It Really FOSS?” Tracks Transparency in Open Source Distribution Models

Astral Launches pyx: A Python-Native Package Registry