La siguiente sección está dedicada para aquellos que estén utilizando un carrito de tercero que soporta el método de pago de 2Checkout. Si no está seguro si su carrito soporta a 2Checkout, por favor pregunte al fabricante del carrito.

Aunque no podemos proveerle soporte directo para programas de carrito de tercero, la integración generalmente consiste en llenar varios campos correctamente en las áreas de administración del carrito de compras y de su cuenta de vendedor de 2Checkout (Vendor Admin). Debajo se encuentran las explicaciones sobre la información más comúnmente requerida para la integración de carrito.

Por favor note que dado que no hay estándares entre los fabricantes de carritos, los nombres de campo pueden diferir.

SID (ID de Usuario, ID de Vendedor)

El SID es su número de cuenta de vendedor con 2Checkout, no su nombre de usuario. También nos referimos a este número como su ID de Vendedor o ID de Proveedor. Este número identifica su cuenta de 2Checkout cuando una orden pase a través de la rutina de compra. Si este valor es incorrecto, lo más probable es que reciba un error de parámetro. Si desconoce su SID, el mismo puede ser fácilmente localizado ingresando a su cuenta de 2Checkout. Su número de cuenta estará localizado en la parte superior izquierda de su página de inicio.

Approved URL

Una vez que una venta se haya completado, el carrito de compras necesitará ser notificado y actualizado con los detalles de la compra. La mayoría de los carritos de compra hacen ésto usando un script de retorno para procesar los parámetros que se envían de regreso. El URL completo para dicho script de retorno debería ser identificado por la documentación de su carrito y debe ser ingresado en su cuenta de vendedor de 2Checkout. Este URL puede ser configurado junto con la configuración de retorno en su página de Site Management (“Manejo de Sitio”).

Una vez que una orden haya sido completada éxitosamente, esta configuración decidirá si su cliente es enviado directamente a su URL de aprobación o a nuestra página de orden procesada. La página de orden procesada mostrará el siguiente mensaje: “Haga clic aquí para Finalizar su Orden”. Haciendo clic en el botón transferirá al cliente y los parámetros de venta a su URL de aprobación. Los carritos generalmente recomiendan que esta configuración sea “Immediately returned to my website” (“Inmediatamente devolver a mi sitio”) para asegurarse de que el cliente es retornado éxitosamente. Debido a la manera en la cual el retorno directo funciona, puede ser que no sea soportado por su carrito por lo cual es importante que esta configuración siga las recomendaciones especificadas por la documentación de su carrito.

Palabra Secreta (“Secret Word”)

Su palabra secreta es usada en el cifrado del hash MD5 que 2Checkout le envía al completarse una compra. A modo de autenticar la compra correctamente, la palabra secreta debe ser configurada al mismo valor en su carrito de compras y en su cuenta de vendedor. La palabra secreta puede ser configurada en la página de Manejo de Sitio (“Site Management”).

El Proceso de Retorno

Luego de la finalización exitosa de una venta, 2Checkout puede devolver los parámetros del cliente y la venta a un script o página en su sitio. Este URL puede ser ingresado en la página de Manejo de Sitio (“Site Management”) haciendo clic en la pestilla de Account (“Cuenta”) seguida de la sub-categoría de Site Management (“Manejo de Sitio”).

Especificar un URL de aprobación a nivel de cuenta dirigirá a todos los clientes al mismo URL luego de que un pedido haya sido exitoso. Un URL de aprobación puede ser configurado al nivel de producto cuando se provee un URL de aprobación para cada producto de forma individual en la página de detalles. URLs de aprobación a nivel de producto anulará cualquier URL de aprobación proporcionado a nivel de cuenta y podrá dirigir al cliente a una locación específica para ese producto, como ser una página de descarga. Si se ordenaran productos múltiples, el cliente será proveído con múltiples URLs de aprobación lo cual les permitirá acceso a cada producto en la compra. Las instrucciones sobre cómo configurar sus productos pueden ser encontradas en la sección de Creación de Producto.

También puede elegir pasar el URL de aprobación en la marcha usando el parámetro x_receipt_link. Este parámetro anulará ambos URLs de aprobación a nivel de producto y cuenta. El valor que se vaya a pasar deberá coincidir con el dominio registrado en la cuenta.

Si usted está devolviendo al cliente a un script de su lado, es importante que note que la información de parámetro será típicamente devuelta a través de POST. Los parámetros pueden ser convertidos de POST a GET, si el conjunto de parámetros de plug and play es usado y varios productos están siendo comprados al mismo tiempo. Por lo pronto, si está utilizando un URL de aprobación a nivel de producto, su script de retorno debería poder manejar ambos métodos sin que se rompan. También podrá verificar la autenticidad de cada retorno utilizando la retransmisión de hash MD5 de cada venta. Más información sobre cómo utilizar este parámetro y el hash MD5 puede ser encontrada en nuestra Guía de Usuario de Integración Avanzada.

Finalmente, usted determinará el método a través del cual el cliente será devuelto al URL de aprobación. 2Checkout.com provee dos métodos. Puede enviar al cliente a la página de orden procesada o usar la función de Retorno Directo para sobrepasar la página e inmediatamente mostrar su URL de aprobación. Su método de retorno puede ser seleccionado en la página de Manejo de Sitio (“Site Management”).

Con el Retorno Directo (“Direct Return”) configurado a “Given links back to my website” (“Enlaces proveídos para regresar a mi sitio”), el cliente será llevado a nuestra página de Orden Procesada luego de que una compra haya sido completada de forma exitosa. Esta página ofrece un botón de “Click Here to Finalize Your Order” (“Haga Clic Aquí para Finalizar su Orden”). Cuando se hace clic en este botón, los parámetros que se han colectado del cliente y la compra serán dirigidos al URL de aprobación que se haya proveído.

Con el Retorno Directo configurado a “Immediately returned to my website” (“Inmediatamente devolver a mi sitio”) los parámetros de venta serán enviados al URL de aprobación mientras son traídos por nuestro servidor y mostrados al cliente. Cuando utilice esta función de Retorno Directo, el URL será enmascarado al cliente, lo que aparecerá como si aún estuviera en el dominio de 2Checkout.com. Este método puede ser usado con redirecciones mientras que cada página emita al navegador contenido que sobrepase los 255 caracteres. Si el Retorno Directo tropieza con una página que redireccione sin emitir contenido, el proceso fallará y el cliente será enviado a nuestra página de Orden Procesada. Ésto ocurre usualmente con la redirección de un título, específicamente contenido por debajo de 255 caracteres. Ésto es un problema común dado que muchos desarrolladores configurarán sus URLs de aprobación a un script que procese los parámetros devueltos de las ventas y que luego dirige a los clientes a otra página. Ésta es usualmente una página de agradecimiento o descarga para productos intangibles. La mejor solución es manejar todo el proceso luego de una orden en la página configurada como su URL de aprobación, incluyendo el mensaje de agradecimiento. Si ninguna redirección es usada, lo que significa que el URL es enmascarado por nuestros servidores, entonces los enlaces relativos no apuntará a la locación correcta. Ésto puede ser corregido con el uso de rutas absolutas en la página de URL de aprobación o simplemente usando una etiqueta de “base” en la cabecera del documento para proveer una referencia a las rutas relativas. Si tiene problemas con el proceso de retorno, nos puede contactar a techsupport@2co.com para que le asistamos a solucionar el problema.

Por favor note: Si no especifica un URL de aprobación a nivel de cuenta, de producto, o con el parámetro x_receipt_link, el cliente permanecerá en la página 2Checkout de Orden Procesada luego de finalizada la compra.

Modo de Demostración (Demo Mode)

Ahora que usted completó la integración, querrá hacer algunas órdenes de compra de demostración para probar la integración de su cuenta. Lo más fácil para ejecutar ésto es cambiar la configuración de demostración de su cuenta en la página de Manejo de Sitio (“Site Management”).

Las siguientes tres opciones están disponibles para la función de Configuración Demo (“Demo Setting”).

On: Al usar esta configuración, todas las ventas serán tratadas como de demostración (demo), sin importar ninguno de los valores de parámetro.

Off: Al usar esta configuración, todas las ventas serán tratadas como activas, sin importar ninguno de los valores de parámetro.

Parameter: Al usar esta configuración, un parámetro de demostración que se envía a la rutina de compra, controlará la configuración de demostración.

Haga clic en el botón de Save Changes (“Guardar Cambios”) localizado al final de la página para actualizar su configuración. Cuando esté usando la herramienta de Demo Setting para hacer compras de prueba, limpie el caché y las cookies en su navegador entre pruebas para hacerse seguro de que la nueva configuración en su cuenta se aplica.

Logos de Compra

Aunque opcionales, recomendamos que exhiba el logo de su compañía en las páginas de compra a través de la herramienta de Purchase Logos (Logos de Compra). Nuestra especificación de 300×50 píxeles puede requerir que tenga que ajustar sus logos o usar nuestra función para cambiar el tamaño automáticamente. Una vez que el tamaño se haya cambiado, podrá subir su logo haciendo clic en la pestilla de Account (“Cuenta”) seguida por la sub-categoría de Site Management (“Manejo del Sitio”). La sección de sus logos estará localizada en la parte derecha de la página.

Haga clic en el símbolo de “+” debajo de “Purchase” (“Compra”) para abrir la página de Configuración de Logos de la Página de Compra (“Set Purchase Page Logo”)

Para seleccionar la imagen que desea subir, haga clic en el botón de Browse (“Navegar”) a la izquierda del campo de Image to Upload (“Imagen a Subir”). Luego provea un nombre para su imagen y la carpeta en donde agrupará la imagen si así lo desea. Las opciones de Auto Resize Image (“Cambiar el Tamaño de la Imagen Automáticamente”) y Auto Convert to JPEG (“Convertir Automáticamente a JPEG”) son seleccionadas por defecto y son recomendadas dado que aseguran que la imagen se muestra apropiadamente dentro de la rutina de compra. Haga clic en el botón de Upload Image (“Subir Imagen”) para completar el proceso. El logo será automáticamente configurado como su logo de compra y se mostrará a los clientes durante la rutina de compra. Podrá editar el logo de compra en cualquier momento haciendo clic en el ícono de edición debajo de la imagen miniatura en la página de Site Management (“Manejo de Sitio”), o haciendo clic en la imagen miniatura para seleccionar un logo diferente que ya haya sido subido.

Sí, si el programador del carrito ha desarrollado un módulo que funciona con 2Checkout.com, podrá utilizar el carrito con su cuenta de proveedor de 2Checkout. Más información sobre los carritos admitidos podrá ser encontrada aquí. Dado que nuestra rutina de compra actúa como un carrito, no es necesario que instale un carrito en su sitio para poder utilizar 2Checkout.

También contamos con nuestro propio conjunto de parámetros, en el caso que desee diseñar un carrito personalizado para su sitio. Podrá encontrar más información sobre los conjuntos de los parámetros admitidos y de nuestro carrito Plug-n-Play aquí.

Si usted es un programador y desea crear un módulo, contacte a integration@2co.com para mayor asistencia y certificación de que su carrito es compatible con nosotros. Si su carrito ha sido certificado, podremos incorporarlo a la lista de carritos compatibles recomendados. Le sugerimos utilizar nuestra exclusiva área para programadores (developers.2Checkout area – sitio en inglés) y chequear los distintos sets de parámetros y cómo funcionan, así como también podrá probar el desarrollo de su retorno y los script(s) INS.

Si utiliza un carrito de otro fabricante, todos los gastos de envío se deberán manejar en el carrito, antes de utilizar nuestro formulario de pago. Las características de envío del panel de administración se aplican a nuestros vínculos y carritos Plug N Play.

Sí, tenemos nuestro propio conjunto de parámetros patentados que usted puede utilizar si su carrito los admite.

Rutina de pago de página múltiple:
https://www.2checkout.com/2co/buyer/purchase Admite todos los métodos de pago. Admite productos tangibles/intangibles.

Rutina de pago de página simple:

https://www.2checkout.com/checkout/spurchase Admite solamente pagos con tarjeta de crédito y productos/servicios intangibles.

Parámetros obligatorios:
sid: su número de cuenta de proveedor de 2Checkout
total: el importe total que se va a facturar, en formato decimal, sin símbolo de moneda (8 caracteres, decimal, 2 caracteres:
Ejemplo: 99999999.99)
cart_order_id: ID única de pedido de su sistema (máx. 128 caracteres)

Parámetros de identificación de productos:

Los proveedores que utilicen este conjunto de parámetros, deberán pasar los parámetros para identificar qué está siendo vendido durante la compra. Estos parámetros también beneficiarán al proveedor cuando sean usados correctamente, dado que la información de producto será mostrada a los clientes en las páginas de compra, y en la página del detalle de venta del proveedor.

id_type- Debido a los cambios producidos en el conjunto de parámetros de identificación de producto, este parámetro deberá ser pasado solamente una vez durante la compra y necesitará tener el valor configurado en 1.

c_prod- El ID del producto siendo comprado. La cantidad del producto podrá ser también pasada anteponiendo una coma a la cantidad denominada de forma numérica, luego del ID de producto.

c_name- El valor de este parámetro deberá contener el nombre del producto a ser creado (128 caracteres max).

c_description- El valor de este parámetro deberá contener una descripción corta del producto a ser vendido (255 caracteres max).

c_price- El precio del producto. Tome en cuenta que como medida para evitar cualquier discrepancia entre el parámetro total y la suma de los parámetros de identificación de producto c_price, los cuales pueden confundir al cliente, el precio del producto no se mostrará en la página de compra. (8 caracteres, decimal, 2 caracteres: Ejemplo: 99999999.99)

Usted puede utilizar estos parámetros de identificación para pasar múltiples productos de una sola vez. Para hacerlo, deberá colocar un dígito a cada parámetro. Por ejemplo, c_prod_1, c_name_1, c_description_1, c_price_1 describirá el primer producto, luego para describir el segundo producto usará el numero 2, entonces los parámetros se leerán c_prod_2, c_name_2, etc.

Parámetros adicionales:
demo: ‘Y’ para activar el modo de demostración; no se debe utilizar en las ventas reales. Puede también ser controlado desde dentro de la cuenta.
lang: ’sp’ para las páginas de rutina de compra en español. Si está ausente, se utiliza de forma predeterminada el idioma inglés, pero también se puede utilizar ‘en’ para el inglés.
merchant_order_id: utilice este parámetro para especificar su número de pedido. También se incluirá en los mensajes de correo electrónico de confirmación que recibirán usted y el cliente. (máx. 50 caracteres)
pay_method: ‘CC’ para tarjeta de crédito o ‘CK’ para cheque, PPI para PayPal, PPL para PayPal Pay Later, o FXS para FXSource. Este parámetro seleccionará el método de pago al final del proceso de compra.

skip_landing: si se determina ‘1′ salteará la página de revisión de la orden en la rutina de compra.

x_Receipt_Link_URL: Se utiliza para especificar un URL aprobado al momento, pero está limitado al mismo dominio que se utiliza con su cuenta de 2Checkout.com, o de lo contrario fallaría. Este parámetro reemplazara cualquier URL configurado en la página de Look and Feel (sin limite).

Para completar de antemano la página de información de facturación que podrá transmitir:
card_holder_name: nombre del titular de la tarjeta (máx. 128 caracteres)

El nombre del titular de la tarjeta podrán ser completados usando los parámetros de first_name, middle_initial y last_name. IMPORTANTE: Si utiliza estos tres parámetros, la información será combinada en el parámetro de card_holder_name y devuelta de esta manera a su secuencia de comandos de su URL de aprobación (Approved URL).

street_address: domicilio del titular de la tarjeta (máx. 64 caracteres)
street_address2: la segunda línea para el domicilio que suele contener el barrio o el número de apartamento >(máx. 64 caracteres)
city: ciudad del titular de la tarjeta (máx. 64 caracteres)
state: estado/provincia del titular de la tarjeta (máx. 64 caracteres)
zip: código postal del titular de la tarjeta (máx. 16 caracteres)
country: país del titular de la tarjeta (máx. 64 caracteres)
email: dirección de correo electrónico del titular de la tarjeta (máx. 64 caracteres)
phone: teléfono del titular de la tarjeta (máx. 16 caracteres)

Para completar de antemano la página de información de envío que podrá transmitir:
ship_street_address
ship_city
ship_state
ship_zip
ship_country

Tenga en cuenta que la información de envío sólo será recopilada para los artículos que estén definidos como tangibles en nuestro sistema. Los gastos de envío también se cobrarán sólo para los artículos tangibles. Le solicitaremos la información de envío si transmite cualquier parámetro de envío, independientemente de si el artículo es tangible, o no. Esto no significa que aplicaremos gastos de envío a la venta, sino que se reunirá la información de dicha venta.

La página de información de facturación también se completará con la información de la página de envío si tal información se reuniera en esa venta y la información de facturación no se transmitiera.

Parámetros personalizados:
Puede transmitir cualquier otro parámetro adicional que necesite, el cual le será devuelto al finalizar la venta. Las únicas restricciones en los parámetros personalizados son que no pueden compartir el nombre de NINGÚN parámetro utilizado por nuestro sistema, incluso de los otros conjuntos. Tenga en cuenta que DEBERÁ configurar una secuencia de comandos de devolución en la página de configuración Look and Feel para recibir cualquiera de estos parámetros ya que no se incluyen en los mensajes de correo electrónico de confirmación.

Podrá recibir de vuelta todos los parámetros que nos transmite, así como también los parámetros siguientes:
order_number: número de pedido de 2Checkout.com
cart_order_id: número de ID de carrito transmitido
credit_card_processed: ‘Y’ si el proceso se completó correctamente (Approved), ‘K’ si está pendiente de aprobación (Pending)
key: el hash MD5 que se utiliza para verificar que la venta provino de uno de nuestros servidores

Consulte la documentación que vino con su carrito o contacte a la empresa fabricante para más asistencia sobre cómo configurar los parámetros o para determinar que dirección URL tendrá que utilizar en la página de Look and Feel para que su carrito reciba la información del producto.

Cargos recurrentes o periódicos no podrán ser realizados con este conjunto de parámetros. Deberá utilizar el conjunto del carrito Plug-N-Play y configurar los productos recurrentes como tal en nuestra base de datos.

Importante: No podrá mezclar los tres conjuntos de parámetros. Esto podría ocasionar problemas durante la realización del pago, o podrá ocasionar que las páginas de pago no funcionen en absoluto.

Nota importante: Cuando esté probando los parámetros, por favor asegúrese de limpiar las cookies en su navegador entre cada prueba para estar seguro de que los cambios hechos tomarán efecto. Para más información sobre cómo limpiar las cookies, por favor lea aquí.

Para utilizar nuestro servicio no necesita un carrito de compras de otro fabricante. Le ofrecemos la posibilidad de utilizar nuestro práctico carrito de compras Plug-N-Play, que emplea vínculos HTML sencillos y no requiere software adicional.

No obstante, si desea utilizar un carrito de compras de otro fabricante con nuestro servicio, puede hacerlo. Generalmente, el servicio de 2Checkout es compatible con los siguientes carritos de compras de otros fabricantes:

• Cualquier carrito de compras compatible con el conjunto de parámetros de Authorize.net, siempre que le permita cambiar la dirección URL de la puerta de enlace. En la actualidad, prácticamente todos los carritos de compras admiten el estándar de Authorize.net.
• Cualquier carrito de compras que anuncia su compatibilidad con 2Checkout en su sitio Web debiera funcionar con nuestro servicio.
• Carritos de compras varios. Si su carrito de compras no satisface los criterios anteriores, o si tiene alguna inquietud al respecto, existe una manera de determinar si su carrito es compatible con nuestro servicio, o no. Simplemente, consulte con el fabricante del carrito de compras para confirmar su compatibilidad. Puede comunicarse con el fabricante personalmente, visitar su sitio Web o leer la documentación que recibió con el carrito de compras.

SOPORTE TÉCNICO

2Checkout no puede suministrarle asistencia técnica en cuestiones relacionadas con carritos de compras de terceros. Básicamente, no los desarrollamos, de manera que no conocemos sus mecanismos internos. Las preguntas sobre la instalación y/o configuración se deberán dirigir al fabricante del carrito. No obstante, podemos brindarle la asistencia técnica que necesita para configurar el carrito de compras a fin de que funcione con nuestro servicio.

Para buscar ayuda adicional con relación a los carritos de compras de alguno de nuestros proveedores, visite nuestra comunidad en http://www.2checkout.com/public/