- Instalación
- Ambientes
- Uso
- Tablas de referencia
- Tabla de errores operativos
- Tabla de errores de integración
Se debe descargar la última versión del SDK desde el botón Download ZIP del branch master. Una vez descargado y descomprimido, se debe agregar la librería TodoPagoConnector.dll que se encuentra dentro de la carpeta dist, a las librerías del proyecto y en el codigo se debe agregar siguiente using.
using TodoPagoConnector;
using TodoPagoConnector.Utils;
using TodoPagoConnector.l;
using TodoPagoConnector.Exceptions;La versión implementada de la SDK, esta testeada para versiones desde .net 3.5
Esta versión soporta únicamente pago en moneda nacional argentina (CURRENCYCODE = 32).
El SDK-.Net permite trabajar con los ambientes de desarrollo y de producción de Todo Pago. El ambiente se debe instanciar como se indica a continuación.
String endPointDev = "https://developers.todopago.com.ar/"; // EndPoint de Developer
var headers = new Dictionary<String, String>();
headers.Add("Authorization", "PRISMA 912EC803B2CE49E4A541068D495AB570");
TPConnector tpc = new TPConnector(endPointDev, headers);Si se cuenta con los http header suministrados por Todo Pago
- Crear un Dictionary<String, String> con los http header suministrados por Todo Pago
var headers = new Dictionary<String, String>();
headers.Add("Authorization", "PRISMA 912EC803B2CE49E4A541068D495AB570");- Crear un String con los Endpoint suministrados por TodoPago
String endPointDev = "https://developers.todopago.com.ar/"; // EndPoint de Developer
String endPointPrd = "https://apis.todopago.com.ar/"; // EndPoint de Production- Crear una instancia de la clase TodoPago\Sdk
TPConnector tpc = new TPConnector(endPointDev, headers);Si se cuenta el con User y Password del login en TodoPago
- Crear una instancia de la clase TodoPago\Sdk
String endPointDev = "https://developers.todopago.com.ar/"; // EndPoint de Developer
String endPointPrd = "https://apis.todopago.com.ar/"; // EndPoint de Production
TPConnector tpc = new TPConnector(endPointDev);- Obtener las credenciales a traves del método getCredentials de TodoPago. Ver Obtener Credenciales
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.
En este caso hay que llamar a sendAuthorizeRequest(). Este método devuelve Dictionary<string, object>
Dictionary<string, object> res = tpc.SendAuthorizeRequest(request, payload);Datos propios del comercio El primer atributo request, debe ser un Dictionary<string, string> 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 |
var request = new Dictionary<string, string>();
request.Add(ElementNames.SECURITY, "1234567890ABCDEF1234567890ABCDEF");
request.Add(ElementNames.SESSION, "ABCDEF-1234-12221-FDE1-00000200");
request.Add(ElementNames.MERCHANT, "12345678"); //dato fijo (número identificador del comercio)
request.Add(ElementNames.URL_OK, "localhost:8888/sdk-.net/ejemplo/exito?Order=27398173292187");
request.Add(ElementNames.URL_ERROR, "localhost:8888/sdk-.net/ejemplo/error?Order=27398173292187");
request.Add(ElementNames.ENCODING_METHOD, "XML");*En el ejemplo se envían parámetros en la url (en nuestro ejemplo: ?Order=27398173292187), para ser recibidos por la tienda vía get y de este modo recuperar el valor en un próximo paso.
datos propios de la operación El segundo atributo payload, debe ser un Dictionary<string, string> 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 |
var payload = new Dictionary<string, string>();
payload.Add(ElementNames.MERCHANT, "12345678"); //dato fijo (número identificador del comercio).
payload.Add(ElementNames.OPERATIONID, "8000"); //número único que identifica la operación, generado por el comercio.
payload.Add(ElementNames.CURRENCYCODE, "032"); //por el momento es el único tipo de moneda aceptada.
payload.Add(ElementNames.AMOUNT, "10.00");
payload.Add(ElementNames.EMAILCLIENTE, "some@someurl.com");
payload.Add(ElementNames.MAXINSTALLMENTS, "12"); //NO MANDATORIO, Maxima cantidad de cuotas, valor maximo 12.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 |
|
| **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
Dictionary
{
StatusCode = -1,StatusMessage = "Solicitud de Autorizacion Registrada",
URL_Request = "https://developers.todopago.com.ar/formulario/commands?command=formulario&m=td95d6e99-cebf-6b5f-89a4-b5dfe92ff5ee",
RequestKey = "ef626296-b25d-78fa-100b-6dad0ca4e2ba",PublicRequestKey = "td95d6e99-cebf-6b5f-89a4-b5dfe92ff5ee"
}Datos prevención de fraude Además se deben enviar datos adicionales para la prevención de fraude. Ver Datos adicionales para prevención de fraude
Códigos de rechazo
```C# Dictionary { StatusCode = -1, PublicRequestKey = te0b9bba5-cff9-173a-20da-b9bc8a389ac7, URL_Request = https://developers.todopago.com.ar/formulario/commands?command=formulario&m=te0b9bba5-cff9-173a-20da-b9bc8a389ac7, StatusMessage = Solicitud de Autorizacion Registrada, RequestKey = ff0f6434-a2ab-e87f-3ece-37f7081e671a } ```La 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 parameters (URL_OK, en caso de éxito o URL_ERROR, en caso de que por algún motivo el formulario rechace el pago)
Si, por ejemplo, se pasa mal el MerchantID se obtendrá la siguiente respuesta:
Dictionary <string, object>
{ StatusCode = 702,
StatusMessage = ERROR: Cuenta Inexistente }Los datos adicionales para control de fraude son obligatorios, de lo contrario baja el score de la transacción.
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 | Categoria 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 |
Los campos marcados como condicionales afectan al score negativamente si no son enviados, pero no son mandatorios o bloqueantes.
var parameters = new Dictionary<string, string>();
parameters.put("CSBTCITY", "Villa General Belgrano"); //Ciudad de facturación, MANDATORIO.
parameters.put("CSBTCOUNTRY", "AR");//País de facturación. MANDATORIO. Código ISO. (http://apps.cybersource.com/library/documentation/sbc/quickref/countries_alpha_list.pdf)
parameters.put("CSBTCUSTOMERID", "453458"); //Identificador del usuario al que se le emite la factura. MANDATORIO. No puede contener un correo electrónico.
parameters.put(CSBTIPADDRESS", "192.0.0.4"); //IP de la PC del comprador. MANDATORIO.
parameters.put(CSBTEMAIL", "some@someurl.com"); //Mail del usuario al que se le emite la factura. MANDATORIO.
parameters.put(CSBTFIRSTNAME", "Juan");//Nombre del usuario al que se le emite la factura. MANDATORIO.
parameters.put(CSBTLASTNAME", "Perez");//Apellido del usuario al que se le emite la factura. MANDATORIO.
parameters.put(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.
parameters.put(CSBTPOSTALCODE", "1010");//Código Postal de la dirección de facturación. MANDATORIO.
parameters.put(CSBTSTATE", "B");//Provincia de la dirección de facturación. MANDATORIO. Ver tabla anexa de provincias.
parameters.put(CSBTSTREET1", "Some Street 2153");//Domicilio de facturación (calle y nro). MANDATORIO.
parameters.put("CSBTSTREET2", "Piso 8");//Complemento del domicilio. (piso, departamento). NO MANDATORIO.
parameters.put(CSPTCURRENCY", "ARS");//Moneda. MANDATORIO.
parameters.put(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)
parameters.put(CSMDD7", "");// Fecha registro comprador(num Dias). NO MANDATORIO.
parameters.put(CSMDD8", "Y"); //Usuario Guest? (Y/N). En caso de ser Y, el campo CSMDD9 no deberá enviarse. NO MANDATORIO.
parameters.put(CSMDD9", "");//Customer password Hash: criptograma asociado al password del comprador final. NO MANDATORIO.
parameters.put(CSMDD10", "");//Histórica de compras del comprador (Num transacciones). NO MANDATORIO.
parameters.put(CSMDD11", "");//Customer Cell Phone. NO MANDATORIO.
//Retail
parameters.put("CSSTCITY", "Villa General Belgrano");//Ciudad de envío de la orden. MANDATORIO.
parameters.put("CSSTCOUNTRY", "AR");//País de envío de la orden. MANDATORIO.
parameters.put("CSSTEMAIL", "some@someurl.com");//Mail del destinatario, MANDATORIO.
parameters.put("CSSTFIRSTNAME", "Juan");//Nombre del destinatario. MANDATORIO.
parameters.put("CSSTLASTNAME", "Perez");//Apellido del destinatario. MANDATORIO.
parameters.put("CSSTPHONENUMBER", "541160913988");//Número de teléfono del destinatario. MANDATORIO.
parameters.put("CSSTPOSTALCODE", "1010");//Código postal del domicilio de envío. MANDATORIO.
parameters.put("CSSTSTATE", "B");//Provincia de envío. MANDATORIO. Son de 1 caracter
parameters.put("CSSTSTREET1", "Some Street 2153");//Domicilio de envío. MANDATORIO.
parameters.put("CSSTSTREET2", "");//NO MANDATORIO.
parameters.put("CSMDD12", "");//Shipping DeadLine (Num Dias). NO MADATORIO.
parameters.put("CSMDD13", "");//Método de Despacho. NO MANDATORIO.
parameters.put("CSMDD14", "");//Customer requires Tax Bill ? (Y/N). NO MANDATORIO.
parameters.put("CSMDD15", "");//Customer Loyality Number. NO MANDATORIO.
parameters.put("CSMDD16", "");//Promotional / Coupon Code. NO MANDATORIO.
//datos a enviar por cada producto, los valores deben estar separado con #:
parameters.put("CSITPRODUCTCODE", "electronic_good");//Código de producto. MANDATORIO. Valores posibles(adult_content;coupon;default;electronic_good;electronic_software;gift_certificate;handling_only;service;shipping_and_handling;shipping_only;subscription)
parameters.put("CSITPRODUCTDESCRIPTION", "Test Prd Description");//Descripción del producto. MANDATORIO.
parameters.put("CSITPRODUCTNAME", "TestPrd");//Nombre del producto. CONDICIONAL.
parameters.put("CSITPRODUCTSKU", "SKU1234");//Código identificador del producto. MANDATORIO.
parameters.put("CSITTOTALAMOUNT", "10.01");//CSITTOTALAMOUNT=CSITUNITPRICE*CSITQUANTITY "999999[.CC]" Con decimales opcional usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales. MANDATORIO.
parameters.put("CSITQUANTITY", "1");//Cantidad del producto. CONDICIONAL.
parameters.put("CSITUNITPRICE", "10.01");//Formato Idem CSITTOTALAMOUNT. CONDICIONAL.En este caso hay que llamar a getAuthorizeAnswer(), que retorna Dictionary<string, object>, enviando como parámetro un Dictionary<String, String> 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 |
var request = new Dictionary<String, String>();
request.Add(ElementNames.SECURITY, "1234567890ABCDEF1234567890ABCDEF"); // Token de seguridad, provisto por TODO PAGO. MANDATORIO.
request.Add(ElementNames.SESSION, null);
request.Add(ElementNames.MERCHANT, "12345678");
request.Add(ElementNames.REQUESTKEY, "0123-1234-2345-3456-4567-5678-6789");
request.Add(ElementNames.ANSWERKEY, "1111-2222-3333-4444-5555-6666-7777"); // *Importante
var res = tpc.GetAuthorizeAnswer(request);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 ) epecificadas 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 envianda 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 |
Dictionary<String, Object>
{ 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 = 5},
{ Request = { MERCHANT = 12345678,
OPERATIONID = ABCDEF-1234-12221-FDE1-00000012,
AMOUNT = 1.00,
CURRENCYCODE = 032,
AMOUNTBUYER = 1.20}
}
}Este método devuelve el resumen de los datos de la transacción
Aclaración: El campo AMOUNTBUYER es el monto efectivamente pagado por el comprador, que incluye el costo financiero total.
Si se pasa mal el AnswerKey o el RequestKey se verá el siguiente rechazo:
Dictionary<String, Object>
{ StatusCode = 404,
StatusMessage = ERROR: Transaccion Inexistente }Existe un ejemplo en la carpeta https://github.com/TodoPago/dev-SDK-.Net/blob/master/Solution/TPTestConsole/Program.cs que muestra los resultados de los métodos principales del SDK.
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 |
TPConnector tpc = new TPConnector(endpoint, headers);
String merchant = "2153";
String operationID = "02";
var res = tpc.GetStatus(merchant, operationID);// Merchant es el id site y operationID es el id operación que se envio en el array a través del método sendAuthorizeRequest()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ódiog 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 |
Ejemplo de Respuesta
Dictionary<string, Object>()
{ OperationsColections = {
Operations = {
RESULTCODE = 999 ,
RESULTMESSAGE = RECHAZADA,
DATETIME = 2015-05-13T14:11:38.287+00:00,
OPERATIONID = 01,
CURRENCYCODE = 32,
AMOUNT = 54,
TYPE = compra_online,
INSTALLMENTPAYMENTS = 4,
CUSTOMEREMAIL = jose@perez.com,
IDENTIFICATIONTYPE = DNI,
IDENTIFICATION = 1212121212,
CARDNUMBER = 12121212XXXXXX1212,
CARDHOLDERNAME = Jose Perez,
TICKETNUMBER = 0,
AUTHORIZATIONCODE = null,
BARCODE = null,
COUPONEXPDATE = null,
COUPONSECEXPDATE = null,
COUPONSUBSCRIBER = null,
BANKID = 11,
PAYMENTMETHODTYPE = Crédito,
PAYMENTMETHODCODE = 42,
PROMOTIONID = 2706,
AMOUNTBUYER = 10.00,
PAYMENTMETHODNAME = VISA,
PUSHNOTIFYENDPOINT = null,
PUSHNOTIFYMETHOD = null,
PUSHNOTIFYSTATES = null,
REFUNDED = null,
REFUNDS = { REFUND0 = { ID = 50163419,
DATETIME = 2016-03-18T16:03:54.987-03:00,
AMOUNT = 10.00 },
REFUND1 = { ID = 50163416,
DATETIME = 2016-03-18T15:52:07.877-03:00,
AMOUNT = 2.00 },
REFUND2 = { ID = 50163414,
DATETIME = 2016-03-18T15:51:17.447-03:00,
AMOUNT = 2.00 }
}
}
}
}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.
En este caso hay que llamar a getByRangeDateTime() y devolvera todas las operaciones realizadas en el rango de fechas dado
Dictionary<string, string> gbrdt = new Dictionary<string, string>();
gbrdt.Add(ElementNames.MERCHANT, "12345678"); // Merchant o Nro de comercio asignado por TodoPago
gbrdt.Add(ElementNames.STARTDATE, "2015-01-01");
gbrdt.Add(ElementNames.ENDDATE, "2015-12-10");
gbrdt.Add(ElementNames.PAGENUMBER, "1");
Dictionary<string, Object> res = tpc.getByRangeDateTime(gbrdt);
La SDK cuenta con un método para obtener todos los medios de pago habilitados en TodoPago.
Dictionary<string, object> res = connector.DiscoverPaymentMethods();
La 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 |
*Es requerida la presencia de sólo uno de estos 2 campos
Dictionary<string, string> gbrdt = new Dictionary<string, string>();
gbrdt.Add(ElementNames.MERCHANT, "12345678"); // Merchant o Nro de comercio asignado por TodoPago
gbrdt.Add(ElementNames.SECURITY, "1234567890ABCDEF1234567890ABCDEF"); // API Key del comercio asignada por TodoPago
gbrdt.Add(ElementNames.REQUESTKEY, "e31d340c-690c-afe6-c478-fc1bef3fc157"); // RequestKey devuelto como respuesta del servicio SendAutorizeRequest
Dictionary<string, Object> res = tpc.VoidRequest(gbrdt);También se puede llamar al método voidRequest de la esta otra manera:
Dictionary<string, string> gbrdt = new Dictionary<string, string>();
gbrdt.Add(ElementNames.MERCHANT, "12345678"); // Merchant o Nro de comercio asignado por TodoPago
gbrdt.Add(ElementNames.SECURITY, "1234567890ABCDEF1234567890ABCDEF"); // API Key del comercio asignada por TodoPago
gbrdt.put(ElementNames.AuthorizationKey, "6d2589f2-37e6-1334-7565-3dc19404480c"); // AuthorizationKey devuelto como respuesta del servicio GetAuthorizeAnswer
Dictionary<string, Object> res = tpc.VoidRequest(gbrdt);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 |
Dictionary<string, Object>
{ StatusCode = 2011,
StatusMessage = Operación realizada correctamente }
La SDK dispone de métodos para realizar la devolución parcial de una transacción realizada a través 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 (sin incluir los recargos), 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
Dictionary<string, string> gbrdt = new Dictionary<string, string>();
gbrdt.Add(ElementNames.MERCHANT, "12345678"); // Merchant o Nro de comercio asignado por TodoPago
gbrdt.Add(ElementNames.SECURITY, "1234567890ABCDEF1234567890ABCDEF"); // API Key del comercio asignada por TodoPago
gbrdt.Add(ElementNames.REQUESTKEY, "0db2e848-b0ab-6baf-f9e1-b70a82ed5844"); // RequestKey devuelto como respuesta del servicio SendAutorizeRequest
gbrdt.Add(ElementNames.AMOUNT, "10.5"); // Opcional. Monto a devolver, si no se envía, se trata de una devolución total
Dictionary<string, Object> res = tpc.ReturnRequest(gbrdt);También se puede llamar al método returnRequest de la esta otra manera:
Dictionary<string, string> gbrdt = new Dictionary<string, string>();
gbrdt.Add(ElementNames.MERCHANT, "12345678"); // Merchant o Nro de comercio asignado por TodoPago
gbrdt.Add(ElementNames.SECURITY, "1234567890ABCDEF1234567890ABCDEF"); // API Key del comercio asignada por TodoPago
gbrdt.Add(ElementNames.AuthorizationKey, "6d2589f2-37e6-1334-7565-3dc19404480c"); // AuthorizationKey devuelto como respuesta del servicio GetAuthorizeAnswer
gbrdt.Add(ElementNames.AMOUNT, "10.5"); // Opcional. Monto a devolver, si no se envía, se trata de una devolución total
Dictionary<string, Object> res = tpc.ReturnRequest(gbrdt);Respuesta de 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.
Dictionary<string, Object>
{ StatusCode = 2011,
StatusMessage = Operación realizada correctamente }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 ningun 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 número.
Javascript
window.TPFORMAPI.hybridForm.initForm({
callbackValidationErrorFunction: 'validationCollector',
callbackCustomSuccessFunction: 'customPaymentSuccessResponse',
callbackCustomErrorFunction: 'customPaymentErrorResponse',
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 informacion del pago realizado:
- billeteraPaymentResponse: Devuelve response si el pago con billetera se realizó correctamente.
- customPaymentSuccessResponse: Devuelve response si el pago se realizó correctamente.
- customPaymentErrorResponse: Si hubo algun error durante el proceso de pago, este devuelve el response con el codigo y mensaje correspondiente.
Ejemplo de Implementación: Formulario híbrido
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 util para obtener los parámetros de configuracion dentro de la implementacion.
- Crear una instancia de la clase User:
User user = new User("test@Test.com.ar","pass1234");// user y pass de TodoPago
try {
user = tpc.getCredentials(user);
tpc.setAuthorize(user.getApiKey());// set de la APIKey a TodoPagoConector
}catch (EmptyFieldException ex){ //se debe realizar catch por campos en blanco
Console.WriteLine(ex.Message);
}catch (ResponseException ex) { //se debe realizar catch User y pass invalidos
Console.WriteLine(ex.Message);
}
Console.WriteLine(user.toString());
}Mediante esta funcionalidad, se permite setear el número máximo de cuotas que se desplegará en el formulario de pago.
Para hacer uso de esta funcionalidad debe agregarse en el parámetro sendAuthorizeRequestPayload del método sendAuthorizeRequest el campo MAXINSTALLMENTS con el valor máximo de cuotas a ofrecer (generalmente de 1 a 12)
Dictionary<string, string> sendAuthorizeRequestPayload = new Dictionary<string, string>();
sendAuthorizeRequestPayload.Add(ElementNames.MAXINSTALLMENTS, "12");Mediante esta funcionalidad, se permite setear el número mínimo de cuotas que se desplegará en el formulario de pago.
Para hacer uso de esta funcionalidad debe agregarse en el parámetro sendAuthorizeRequestPayload del método sendAuthorizeRequest el campo MININSTALLMENTS con el valor mínimo de cuotas a ofrecer (generalmente de 1 a 12)
Dictionary<string, string> sendAuthorizeRequestPayload = new Dictionary<string, string>();
sendAuthorizeRequestPayload.Add(ElementNames.MININSTALLMENTS, "1");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
Para hacer uso de esta funcionalidad debe agregarse en el parámetro sendAuthorizeRequestPayload del método sendAuthorizeRequest el campo AVAILABLEPAYMENTMETHODSIDS con los ids de los medios de pago habilitados separador por "#".
Dictionary<string, string> sendAuthorizeRequestPayload = new Dictionary<string, string>();
sendAuthorizeRequestPayload.Add("AVAILABLEPAYMENTMETHODSIDS", "1#42#500");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 |
| 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. |
| **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 |