Hay varias formas a través de las cuales usted podrá configurar su sitio usando los 3 distintos conjuntos de parámetros que se encuentran disponibles en el sistema de compra de 2Checkout. El sistema funciona enviando los parámetros HTML (es decir, las variables) a la rutina de compra para iniciar una compra, ya sea que los mismos sean enviados a través de un formulario HTML o un enlace de compra directo.
Mientras trabaja en el desarrollo de la integración de su sitio, puede visitar el área de developers de 2Checkout para probar y jugar con los diferentes conjuntos de parámetros, y ver la interacción con la rutina de compra de 2Checkout.
Parámetros Universales
Cuatro parámetros universales estarán disponibles para su uso con cada conjunto. Estos parámetros le asistirán con varios aspectos de la integración del sistema de compra de 2Checkout con su sitio:
- demo – Podrá configurar este parámetro a “Y” para decir a la rutina de compra que la transacción es de prueba. Mientras que el carrito se comportará de la misma manera (hasta le preguntará por los detalles de pago), ninguna transacción se completará.
- lang – Chino – zh, Danés – da, Holandés– nl, Francés– fr, Alemán – gr, Griego – el, Italiano – it, Japonés – jp, Noruego – no, Portugués – pt, Esloveno– sl, Español (castellano) – es_ib, Español (latinoamericano)– es_la, Sueco– sv. Por defecto está configurado a Inglés si este parámetro está ausente, pero igual se puede usar “en” como valor para Inglés.
- pay_method — Éste parámetro se puede configurar a alguno de los siguientes valores para configurar la rutina de compra específicamente para que use el método de pago especificado: CC para Tarjetas de Crédito, AL para las compras con PIN a través de Acculynk, PPI para PayPal.
- merchant_order_id — Podrá configurar este parámetro a cualquier número ID (ej. ‘merchant_order_id=VENTA-001′), el cual se mostrará en el recibo de compra que el cliente recibirá por correo y puede asistirlo en organizar a los clientes y sus compras dentro de sus récords. (50 caracteres máx.)
Los siguientes son explicaciones de los tres conjuntos de parámetros individuales dentro de nuestro sistema.
Parámetros Plug and Play
Los parámetros Plug and Play le proveerán el método más simple a los vendedores para vender sus productos. Usando este método, los vendedores crearán los productos dentro de su cuenta y pondrán enlaces a esos productos en su sitio. Aunque le proveemos otras maneras de vender sus productos además del método Plug and Play, por favor tenga en cuenta que éste es el único método que está disponible para las órdenes periódicas.
Enlace de Pago Básico
Para crear un enlace de compra directo usando los parámetros Plug and Play una vez que haya creado los productos bajo su cuenta de vendedor, necesitará usar al menos los tres parámetros base para el conjunto (ID de vendedor [SID], product_id,cantidad [quantity]). Un ejemplo de un enlace de pago directo se ve así:
https://www.2checkout.com/checkout/purchase?sid=123456&product_id=101&quantity=1
Para poner ésto en términos más fáciles, nuestra rutina de compra (https://www.2checkout.com/checkout/purchase) recibe información de que el cliente quiere comprar uno (cantidad=1) del producto al cual le fue asignado el ID de “101″ (product_id=101) por nuestro sistema para este vendedor (sid=123456).
Éste puede ser representado dentro del formulario HTML, el cual puede darle más flexibilidad en términos de cómo construye su sitio. Debajo se encuentra los elementos básicos necesarios para un formulario HTML para un solo producto:
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='123456' >
<input type='hidden' name='product_id' value='101' >
<input type='hidden' name='quantity' value='1' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>
Múltiples Productos en un Sólo Formulario
Puede tener varios productos dentro de un enlace de pago directo o formulario HTML. Es útil para los vendedores que venden productos como un paquete o al por mayor. Para hacer ésto, necesitará agregar un dígito de forma incremental al final de cada ‘product_id’ y ‘quantity’ por cada producto individual que se compra. Un enlace de pago directo se verá así:
https://www.2checkout.com/checkout/purchase?sid=123456&product_id1=101&
quantity1=1&product_id2=202&quantity2=1
El mismo formato se reflejará dentro del formulario HTML:
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='123456' >
<input type='hidden' name='product_id1' value='101' >
<input type='hidden' name='quantity1' value='1' >
<input type='hidden' name='product_id2' value='202' >
<input type='hidden' name='quantity2' value='1' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>
Parámetros Adicionales
Junto con los parámetros universales, usted también tendrá disponible el parámetro ‘fixed’ (fijo) como parte del conjunto. Configurar este valor a “Y” trabará los campos de cantidad en la rutina de compra y removerá el botón de “continuar comprando”.
Más Información
Para más información sobre cómo usar el conjunto de parámetros, por favor revea el siguiente enlace:
http://www.2checkout.com/?p=205
Parámetros de Carritos de 3ero
Los parámetros de Carritos de 3ero funcionan enviando al cliente desde su sitio a la rutina de compra de 2Checkout con sólo un monto total para la venta y un número de orden de carrito. Este conjunto no requiere que tenga productos configurados en su cuenta de vendedor, aunque si requiere que los parámetros de Identificación de Producto sean usados para especificar los detalles de los productos contenidos dentro del carrito. Este conjunto de parámetros trabaja mejor con el software de carritos de tercero dado que permite que el software en su sitio maneje la mayoría del proceso de finalización de compra, incluyendo la retención de la información de producto dentro del área administrativa de su carrito y los detalles de los productos en el recibo del cliente.
Enlace de Pago Básico
Para crear un enlace de pago directo usando los parámetros de carrito de 3ero, necesitará usar al menos tres parámetros de base requiridos para el conjunto (sid, total, cart_order_id). Un ejemplo de enlace de pago directo se ve de la siguiente manera:
https://www.2checkout.com/checkout/purchase?sid=123456&total=2.00&
cart_order_id=CART-001
Para simplificarlo, nuestra rutina de compra recibe información de que el cliente quiere comprar los artículos en el carrito (los cuales serán manejados por el software de carrito en su sitio) desde el vendedor (sid=123456), y el monto total de la orden por los artículos en el carrito más cualquier costo de envío cuesta 1 dólar (total 2,00). La orden en el carrito tiene un ID (cart_order_id=CART-001) el cual identificará esta orden de manera única para el vendedor entre las demás órdenes.
Para simplificarlo, nuestra rutina de compra recibe información de que el cliente quiere comprar los artículos en el carrito (los cuales serán manejados por el software del carrito en su sitio) del vendedor (sid=123456), y el monto total de la orden por los artículos en el carrito más cualquier cargo por envío totaliza 1 dólar (total 2,00). La orden en el carrito tiene un ID (cart_order_id=CART-001) el cual identificará esta orden de forma única entre las demás órdenes que vaya a tener.
El enlace de pago directo que se muestra arriba puede ser representado dentro de un formulario HTML using las etiquetas de entrada apropiadas para los tres parámetros requeridos. Sin embargo, al enlace que se muestra arriba le faltan los parámetros que especificarán los detalles de los productos que estén contenidos en el carrito. Mientras que el enlace que se muestra arriba funcionará y el cliente será cobrado por el monto, no habrá record de los artículos que se están comprando. Para especificar los detalles de los productos, use los parámetros de Identificación de Producto.
Combinando con los parámetros de Identificación de Producto
Para especificar los productos individualmente dentro del carrito de compras, necesitará utilizar los siguientes parámetros:
- c_prod — El ID del producto que se está comprando. La cantidad del producto siendo comprado podrá ser pasado con este parámetro poniendo una coma detrás del ID y luego especificando la cantidad en formato numérico.
- id_type — Debido a los cambios con los parámetros de Identificación de Producto, este parámetro deberá ser pasado una vez durante la compra y necesitará tener un valor configurado a 1.
- c_name — Contendrá el nombre del producto individual, y será mostrado al momento de la finalización de la compra para que su cliente sepa lo que está siendo comprado.
- c_description — El valor de este parámetro deberá contener una pequeña descripción del producto a ser vendido (255 caracteres máx.)
- c_price — El precio del producto. Por favor, note que para prevenir una discrepancia entre el parámetro del total y la suma de los parámetros de identificación de producto c_price que podría confundir a los clientes, el precio del producto no se mostrará en la página de compra (8 caracteres, decimal, 2 caracteres: Ejemplo: 99999999.99).
Un enlace de compra directo que usa los parámetros de Identificación de Producto en su forma más básica se verá de la siguiente manera:
https://www.2checkout.com/checkout/purchase?sid=123456&total=2.00&
cart_order_id=CART-001&id_type=1&c_prod=PRODUCT-10,1&
c_name=Product 10&c_description=This is my 10th product&c_price=1.00
Éste también podrá ser representado dentro de un formulario HTML. Debajo se pueden ver los elementos básicos requeridos para un formulario HTML para el mismo producto:
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='123456' >
<input type='hidden' name='total' value='2.00' >
<input type='hidden' name='cart_order_id' value='CART-001' >
<input type='hidden' name='id_type' value='1' >
<input type='hidden' name='c_prod' value='PRODUCT-10,1' >
<input type='hidden' name='c_name' value='Product 10' >
<input type='hidden' name='c_description' value='This is my 10th product' >
<input type='hidden' name='c_price' value='1.00' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>
Productos Múltiples en el Mismo Formulario
También puede especificar varios productos. Para hacerlo, necesitará agregar un guión bajo seguido de un dígito en incremento al final de cada parámetro para definir los productos (por ej. parámetros que comienzan con “c_”). Un enlace de compra directa se verá así:
https://www.2checkout.com/checkout/purchase?sid=123456&total=4.00&
cart_order_id=CART-001&id_type=1&c_prod_1=PRODUCT-10,1&
c_name_1=Product 10&c_description_1=This is my 10th product&c_price_1=1.00&
amp;c_prod_2=PRODUCT-20,1&c_name_2=Product 20&c_description_2=This is my 20th
product&c_price_2=2.00
Al convertir éste en un formulario HTML de sumisión, aparecerá de la siguiente forma:
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='123456' >
<input type='hidden' name='total' value='4.00' >
<input type='hidden' name='cart_order_id' value='CART-001' >
<input type='hidden' name='id_type' value='1' >
<input type='hidden' name='c_prod_1' value='PRODUCT-10,1' >
<input type='hidden' name='c_name_1' value='Product 10' >
<input type='hidden' name='c_description_1' value='This is my 10th product' >
<input type='hidden' name='c_price_1' value='1.00' >
<input type='hidden' name='c_prod_2' value='PRODUCT-20,1' >
<input type='hidden' name='c_name_2' value='Product 20' >
<input type='hidden' name='c_description_2' value='This is my 20th product' >
<input type='hidden' name='c_price_2' value='2.00' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>
Parámetros de Authorize.net
Este conjunto de parámetros funciona como el conjunto de parámetros de carritos de tercero, excepto que los nombres de parámetro utilizan los formatos proporcionados por Authorize.net. El único cambio son los nombres de los parámetros, dado que la rutina de compra se mantiene de la misma forma como si estuviera usando los parámetros de carrito de tercero. Este conjunto simplemente lo hace más fácil para los desarrolladores y carritos de compra que ya saben o utilizan los nombre de parámetros de Authorize.net.
Los tres parámetros requeridos por Authorize.net son:
- x_login — lo mismo que ‘sid’
- x_amount — lo mismo que ‘total’
- x_invoice_num — lo mismo que ‘cart_order_id’
Enlace Básico de Pago
Tomando el ejemplo que se muestra arriba para las compras de un solo producto usando el conjunto de carritos de tercero en combinación con el conjunto de Creación de Nuevo Producto, un enlace de compra directa se verá así:
https://www.2checkout.com/checkout/purchase?x_login=123456&x_amount=2.00&
amp;x_invoice_num=CART-001&id_type=1&c_prod=PRODUCT-10,1&
c_name=Product 10&c_description=This is my 10th product&c_price=1.00
Fíjese que todos los otros parámetros se mantienen igual excepto por los tres parámetros requeridos. Ésto también significa que la configuración del formulario de sumisión HTML, así como la configuración de productos múltiples, se mantiene igual sin importar si usted está usando los parámetros de carrito de tercero o los parámetros de Authorize.net.
Parámetros Adicionales
Adicionalmente, también tendrá el parámetro ‘x_receipt_link_url’ disponible como parte de este conjunto. Sin embargo, este parámetro ciene con una excepción, dado que puede ser usado con *todos* los conjuntos de parámetros. Este parámetro le permitirá especificar el URL de aprobación (el URL al cual sus clientes volverán una vez que hayan completado la transacción de manera exitosa) sobre la marcha pasándolo en la rutina de compra.
Este parámetro tiene muy pocos comportamientos especídicos a los cuales usted debería prestar atención para que pueda ser usado efectivamente:
- Este parámetro le permitirá anular cualquie URL de aprobación dentro de su cuenta.
- El Método de Retorno configurado en “Regresar a mi sitio web a través de los vínculos brindados”–Este parámetro controlará dónde el botón de ‘Haga clic aquí para finalizar su orden’ llevará al cliente luego de una compra exitosa. Si hay URLs de aprobación que son específicos a sus productos y sólo se ordena un producto, anulará el URL individual del producto. Si tiene URLs de aprobación que son específicos a sus productos y se ordena más de un producto, entonces el parámetro controlará dónde el botón de ‘Haga clic aquí para finalizar su orden’ llevará al cliente luego de una compra exitosa, pero cualquier URLs de retorno que sean específico a los productos se listarán en la página de Orden Completa junto a cada artículo comprado.
- El Método de Retorno configurado en “Ser enviados inmediatamente a mi sitio web” o “Redirección del Encabezado (Su URL)” — Este parámetro controlará a dónde el cliente será redireccionado automáticamente luego de una compra exitosa. Si hay URLs de aprobación específicos a los productos ordenados y sólo se ordena un producto, este parámetro *no* anulará los URLs de retorno en los productos individuales. Si hay URLs de aprobación específicos a los productos y más de un producto está siendo ordenado, entonces este parámetro anulará todos los URLs de retorno específicos a los productos.
Más Información
Para más información sobre el conjunto de parámetros de los Carritos de 3ero, por favor vea el artículo que detalla este conjunto de parámetros aquí.
Si necesita más información sobre los parámetros de Authorize.net, por favor revea el artículo que detalla este conjunto de parámetros aquí.
INFORMACIÓN DE FACTURACIÓN Y MÉTODO DE ENVÍO
Por último, los conjuntos de parámetros ofrecen la habilidad de obtener información de facturación y método de envío. Ésto le permitirá crear su propia interfase en su sitio desde donde podrá pedir la información del cliente, y luego pasar dicha información a la rutina de compra de 2Checkout para llenar los formularios de Información de Facturación e Información Método de Envío. De esta manera, usted podrá registrar información sobre su cliente antes de que lleguen a 2Checkout, y los clientes no tendrán que ingresar su información dos veces.
Hay dos nombres de parámetros para la facturación y el método de envío. El nombre convencional puede ser usado con los parámetros del carrito Plug-n-Play y de un Carrito de 3ero. La segunda variante del nombre podrá ser usado con el conjunto de Authorize.net solamente.
Nombres Estándar
Para llenar la página de Información de Facturación , los siguientes parámetros podrán ser usados:
- card_holder_name – Nombre del dueño de la tarjeta. Esta información puede ser llenada usando los parámetros de ‘first_name’ (nombre), ‘middle_initial’ (segundo nombre), y ‘last_name’ (apellido). Sin embargo, si utiliza los tres parámetros, la información será combinada y devuelta como ‘card_holder_name’ en los parámetros que se pasen al script del URL de aprobación.
- street_address — Dirección del cliente.
- street_address2 — Información adicional de la dirección del cliente.
- city — Ciudad.
- state — Estado o provincia.
- zip — Código postal.
- country — País.
- email — Correo electrónico.
- phone — Teléfono.
- phone_extension — Extensión telefónica.
Para llenar la página de Información de Envío, los siguientes parámetros pueden ser usados:
- ship_name — Nombre de la persona que recibe la orden.
- ship_street_address — Dirección de envío.
- ship_street_address2 — Información adicional de la dirección de envío.
- ship_city — Ciudad.
- ship_state — Estado o provincia.
- ship_zip — Código postal.
- ship_country — País.
Nombres de Authorize.net
Para llenar la página de Información de Facturación, los siguientes parámetros podrán ser usados:
- x_First_Name
- x_Last_Name
- x_Phone
- x_Email
- x_Address
- x_City
- x_State
- x_Zip
- x_Country
Para llenar la página de Información de Envío, los siguientes parámetros podrán ser usados:
- x_Ship_To_First_Name
- x_Ship_To_Last_Name
- x_Ship_To_Address
- x_Ship_To_City
- x_Ship_To_Country
- x_Ship_To_State
- x_Ship_To_Zip
EJEMPLOS MÁS AMPLIOS
Debajo podrá encontrar tres ejemplos de conjuntos de parámetros, los cuales incluyen varios de los otros parámetros disponibles en conjunto con los que son requeridos para cada conjunto.
Ejemplo de Plug-n-Play
El siguiente ejemplo muestra una venta de dos productos, cuyas cantidades no pueden ser alteradas por el parámetro ‘fixed’ en la configuración, y la recolección de información de facturación y envío.
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='123456' >
<input type='hidden' name='product_id1' value='101' >
<input type='hidden' name='quantity1' value='1' >
<input type='hidden' name='product_id2' value='202' >
<input type='hidden' name='quantity2' value='1' >
<input type='hidden' name='fixed' value='Y' >
<input type='hidden' name='card_holder_name' value='Checkout Shopper' >
<input type='hidden' name='street_address' value='1785 OBrien Road' >
<input type='hidden' name='street_address2' value='Suite 200' >
<input type='hidden' name='city' value='Columbus' >
<input type='hidden' name='state' value='OH' >
<input type='hidden' name='zip' value='43228' >
<input type='hidden' name='country' value='USA' >
<input type='hidden' name='email' value='example@2co.com' >
<input type='hidden' name='phone' value='614-921-2450' >
<input type='hidden' name='phone_extension' value='197' >
<input type='hidden' name='ship_name' value='Gift Receiver' >
<input type='hidden' name='ship_street_address' value='1234 Address Road' >
<input type='hidden' name='ship_street_address2' value='Apartment 123' >
<input type='hidden' name='ship_city' value='Columbus' >
<input type='hidden' name='ship_state' value='OH' >
<input type='hidden' name='ship_zip' value='43235' >
<input type='hidden' name='ship_country' value='USA' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>
Ejemplo de Carrito de 3ero
Esta es una venta de dos productos, usando los IDs de producto específicos del vendedor, especificando el URL de aprobación a donde el cliente será llevado luego de una compra, y solamente llenado la información de facturación.
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='123456' >
<input type='hidden' name='total' value='4.00' >
<input type='hidden' name='cart_order_id' value='CART-001' >
<input type='hidden' name='id_type' value='1' >
<input type='hidden' name='c_prod_1' value='PRODUCT-10,1' >
<input type='hidden' name='c_name_1' value='Product 10' >
<input type='hidden' name='c_description_1' value='This is my 10th product' >
<input type='hidden' name='c_price_1' value='1.00' >
<input type='hidden' name='c_prod_2' value='PRODUCT-20,1' >
<input type='hidden' name='c_name_2' value='Product 20' >
<input type='hidden' name='c_description_2' value='This is my 20th product' >
<input type='hidden' name='c_price_2' value='2.00' >
<input type='hidden' name='card_holder_name' value='Checkout Shopper' >
<input type='hidden' name='street_address' value='1785 OBrien Road' >
<input type='hidden' name='street_address2' value='Suite 200' >
<input type='hidden' name='city' value='Columbus' >
<input type='hidden' name='state' value='OH' >
<input type='hidden' name='zip' value='43228' >
<input type='hidden' name='country' value='USA' >
<input type='hidden' name='email' value='example@2co.com' >
<input type='hidden' name='phone' value='614-921-2450' >
<input type='hidden' name='phone_extension' value='197' >
<input type='hidden' name='x_receipt_link_url'
value='http://www.yourdomain.com/returnscript.php' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>
Ejemplo de Authorize.net
Esta es una compra de dos productos utilizando los nombres de Authorize.net, usando los IDs de producto especificados por el vendedor y especificando la información de envío solamente.
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='x_login' value='123456' >
<input type='hidden' name='x_amount' value='2.00' >
<input type='hidden' name='x_invoice_num' value='CART-001' >
<input type='hidden' name='id_type' value='1' >
<input type='hidden' name='c_prod_1' value='PRODUCT-10,1' >
<input type='hidden' name='c_name_1' value='Product 10' >
<input type='hidden' name='c_description_1' value='This is my 10th product' >
<input type='hidden' name='c_price_1' value='1.00' >
<input type='hidden' name='c_prod_2' value='PRODUCT-20,1' >
<input type='hidden' name='c_name_2' value='Product 20' >
<input type='hidden' name='c_description_2' value='This is my 20th product' >
<input type='hidden' name='c_price_2' value='2.00' >
<input type='hidden' name='x_ship_to_first_name' value='Gift' >
<input type='hidden' name='x_ship_to_last_name' value='Receiver' >
<input type='hidden' name='x_ship_to_address' value='1234 Address Road' >
<input type='hidden' name='x_ship_to_city' value='Columbus' >
<input type='hidden' name='x_ship_to_state' value='OH' >
<input type='hidden' name='x_ship_to_zip' value='43235' >
<input type='hidden' name='x_ship_to_country' value='USA' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>
