Quizá algunos desarrolladores Web deseen integrar el procesamiento de pagos de PayPal con su carrito de compras de terceros, en lugar de con el carrito de compras estándar de PayPal. Siga las instrucciones siguientes para que sus compradores puedan pagar con PayPal, una vez hayan añadido todos los artículos a su carrito de compras de terceros y estén listos para realizar el pago.
Actualmente existen dos maneras de integrar su carrito de compras de terceros con el flujo de pago de PayPal. La primera consiste en transferir el importe total del pago del carrito, en lugar del pago de artículos sueltos. La segunda consiste en transferir a PayPal los detalles de los artículos que se han seleccionado, en lugar del importe total del carrito completo. Nota: Quizá tenga que implementar ciertas secuencias de comandos en su sitio Web al enviar las variables necesarias a PayPal, tal y como se describe a continuación.
Método 1. Transferencia del importe total del carrito de compras a PayPal |
|
Si lo desea, puede agrupar todo su carrito de compras y transferir el importe total al código del
botón Comprar ahora de PayPal (esto es, usted deberá dar un solo nombre a todo el carrito y al precio total del contenido del carrito, como si se tratara de la compra de un único artículo).
Un inconveniente de este método es que sus compradores no podrán ver los artículos por separado en sus carros. Además, usted no podrá cambiar los nombres de nuestras variables, ni añadir sus propios nombres de variables.
Si, tras revisar la información anterior, sigue teniendo dudas sobre cuestiones técnicas, rogamos visite nuestra zona de
Asistencia para desarrolladores. Para obtener más información sobre el código de botones Comprar ahora o sobre las variables que aparecen a continuación, diríjase a
Guía de integración para Pagos en sitio web.
Variables obligatoriasEl código para su envío de PayPal requiere las siguientes 4 variables ocultas y una imagen para entregar el formulario:
| Variables obligatorias | | Nombre | Valor | | business | Correo electrónico en su cuenta PayPal. | | item_name | Nombre del artículo (o nombre del carrito de compras). | | currency_code | Define la divisa en que se indican las variables monetarias (amount, shipping, shipping2, handling, tax). Valores posibles: "USD", "EUR", "GBP", "CAD", "JPY". | | amount | Precio del artículo (precio total de todos los artículos del carrito de compras). | | image | La imagen del botón en la que hará clic su comprador al iniciar el proceso de pago de PayPal. Puede sustituir su propia imagen cambiando el src por la URL de su imagen. |
|
Esto significa que el código mínimo que se requiere para su envío a PayPal quedará así:
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_xclick">
<input type="hidden" name="business" value="[email protected]">
<input type="hidden" name="item_name" value="Item Name">
<input type="hidden" name="currency_code" value="USD">
<input type="hidden" name="amount" value="0.00">
<input type="image" src="http://www.paypal.com/es_XC/i/btn/x-click-but01.gif" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>
|
|
PayPal ofrece variables adicionales para personalizar el envío de su formulario. A continuación se muestran todas las variables disponibles (los nombres de variables deben estar en minúscula):
| Variables disponibles | | Nombre | Valor | | business | Correo electrónico en su cuenta PayPal. | | quantity | Número de artículos. Esto multiplicará la cantidad si es superior a uno. | | item_name | Nombre del artículo (o nombre del carrito de compras). Debe ser alfanumérica, con un límite de 127caracteres | | item_number | Variable de transferencia opcional para realizar seguimientos de los pagos. Debe ser alfanumérica, con un límite de 127 caracteres | | amount | Precio del artículo (precio total de todos los artículos del carrito de compras). | | shipping | Costo del envío del artículo. | | shipping2 | Costo del envío de cada artículo adicional. | | handling | Costo de manejo. | | tax | Valor de impuesto basado en transacción. Si aparece, el valor que aquí se incluya anulará cualquier configuración de impuesto basado en el perfil que usted posea (independientemente de la ubicación del comprador). | | no_shipping | Dirección de envío. Si se establece como "1", no se pedirá a su cliente que facilite una dirección de envío. Esto es opcional; si se omite o si se establece como "0", se solicitará a su cliente que incluya una dirección de envío. | | cn | Etiqueta opcional que aparecerá sobre el campo de notas (40 caracteres como máximo) | | no_note | Incluir una nota en un pago. Si se establece como "1", se solicitará a su cliente que incluya una nota. Esto es opcional; si se omite o si se establece como "0", se solicitará a su cliente que incluya una nota. | | on0 | Nombre de campo de la primera opción. 64 caracteres como máximo | | os0 | Primer grupo de valores de opción. 200 caracteres como máximo. "on0" debe definirse para poder reconocer "os0". | | on1 | Nombre de campo de la segunda opción. 64 caracteres como máximo | | os1 | Segundo grupo de valores de opción. 200 caracteres como máximo. "on1" debe definirse para poder reconocer "os1". | | custom | Variable de transferencia opcional que nunca se presentará a su cliente. Puede utilizarse para realizar un seguimiento del inventario. | | invoice | Variable de transferencia opcional que nunca se presentará a su cliente. Puede utilizarse para realizar un seguimiento de números de recibos PayPal. | | notify_url | Usada únicamente con IPN. URL de Internet donde se realizarán envíos de formularios de IPN. | | return | URL de Internet a donde se redirigirá a su cliente tras finalizar el pago. | | cancel_return | URL de Internet a donde se redirigirá a su cliente tras cancelar un pago. | | image_url | URL de Internet que contiene la imagen de 150 X 50 píxeles que usted desea utilizar como logotipo | | cs | Establece el color de fondo de sus páginas de pago. Si se establece como "1", el color de fondo será negro. Esto es opcional; si se omite o si se establece como "0", el color de fondo será blanco. |
|
Variables ampliadasPayPal le permite
enviar variables ampliadas si cambia esta entrada "cmd":
| <input type="hidden" name="cmd" value="_xclick"> |
|
para:
<input type="hidden" name="cmd" value="_ext-enter">
<input type="hidden" name="redirect_cmd" value="_xclick"> |
|
Al realizar el cambio anterior a la entrada "cmd", también puede utilizar las siguientes variables:
| Variables ampliadas | | Nombre | Valor | | email | Dirección de correo electrónico del cliente. | | first_name | Nombre del cliente. Debe ser alfanumérica, con un límite de 32 caracteres | | last_name | Apellidos del cliente. Debe ser alfanumérica, con un límite de 64 caracteres | | address1 | Primera línea de la dirección postal del cliente. Debe ser alfanumérica, con un límite de 100 caracteres | | address2 | Segunda línea de la dirección postal del cliente. Debe ser alfanumérica, con un límite de 100 caracteres | | city | Ciudad de la dirección del cliente. Debe ser alfanumérica, con un límite de 100 caracteres | | state | Estado del cliente. Debe presentarse como la abreviatura oficial de 2 letras. | | zip | Código postal del cliente. | | night_phone_a | Prefijo del número de teléfono donde puede llamarse al cliente por la noche. | | night_phone_b | Primeros tres dígitos del número de teléfono donde puede llamarse al cliente por la noche. | | | | day_phone_a | Prefijo del número de teléfono del cliente durante el día. | | day_phone_b | Primeros tres dígitos del número de teléfono del cliente durante el día. | | |
|
Nota: Para especificar importes de envío y manejo diferentes a los importes que aparecen por defecto en su Perfil, diríjase a su Perfil, edite sus Cálculos de envío y haga clic en la casilla de verificación "permitir la anulación de los gastos de envío basados en transacciones".
Método 2. Transferencia de artículos sueltos a PayPal |
|
Si se puede configurar su carrito de compras de terceros para transferir artículos sueltos a PayPal, se incluirá información sobre los artículos en los registros de historial y notificaciones tanto de los compradores como de los vendedores. Para incluir información sobre los artículos, deberá enviar elementos de formulario HTML a una nueva versión del flujo del carrito de compras de PayPal. Este proceso es muy similar al descrito en la sección n.º 1 de "Transferencia del importe total del carrito a PayPal", con las siguientes excepciones:
- Establecer la variable "cmd" como "_cart"
Cambiar esta línea obligatoria de HTML
| <input type="hidden" name="cmd" value="_xclick"> |
|
por
| <input type="hidden" name="cmd" value="_cart"> |
|
- Añadir nueva variable llamada "upload"
Añadir la siguiente línea entre las etiquetas <form> y </form> :
| <input type="hidden" name="upload" value="1"> |
|
- Definir detalles de los artículos
Para cada uno de los siguientes parámetros específicos de los artículos, defina un nuevo grupo de valores que corresponda a cada artículo comprado mediante su carrito de terceros. Añadir "_x" al nombre de la variable, siendo x el número del artículo, empezando por 1 y aumentando en uno cada artículo que se añade.
| Nombre | Valor | | item_name_x | (Necesario para artículo n.º x) Nombre del artículo n.º x en el carrito. Debe ser alfanumérica, con un límite de 127 caracteres | | item_number_x | Variable de transferencia opcional asociada al artículo n.º x del carrito. Debe ser alfanumérica, con un límite de 127 caracteres | | amount_x | (Necesario para artículo n.º x) Precio del artículo n.º x. | | shipping_x | El costo de envío de la primera parte (cantidad 1) del artículo n.º x. | | shipping2_x | El costo de envío de cada parte adicional (cantidad 2 o superior) del artículo n.º x. | | handling_x | El costo de manejo del artículo n.º x. | | on0_x | Nombre de campo de la primera opción para artículo n.º x. 64 caracteres como máximo | | os0_x | Primer grupo de valores de opción para artículo n.º x. 200 caracteres como máximo. "on0_x" debe definirse para poder reconocer "os0_x". | | on1_x | Nombre de campo de la segunda opción para artículo n.º x. 64 caracteres como máximo | | os1_x | Segundo grupo de valores de opción para artículo n.º x. 200 caracteres como máximo. "on1_x" debe definirse para poder reconocer "os1_x". |
|
- Repetir para cada artículo dentro del carrito
Incluir un grupo de variables obligatorias, así como cualquier otra variable de la tabla anterior, para cualquier artículo dentro de su carrito de comprador. El primer artículo dentro del carrito debe definirse con parámetros que terminen en "_1", como "item_name_1", "amount_1", etc. Del mismo modo, el segundo artículo debería definirse con variables como "item_name_2", "amount_2", etc. Nota: Los valores "_x" deben incrementarse en uno para que puedan reconocerse. Si pasa del artículo n.º 1 al artículo n.º 3 sin definir un artículo n.º 2, se ignorará el tercer artículo.
Para especificar la divisa: Todas las variables monetarias (amount, shipping, shipping2, handling, tax) se interpretarán en la divisa designada por la variable "currency_code" que se envía con el pago. Ya que ésta no es específica para cada artículo, no es necesario añadir un "_x" al nombre de variable. Si no se envía ninguna variable de "currency_code", asumiremos que todos los valores monetarios están en dólares estadounidenses.
Si, tras revisar la información anterior, sigue teniendo dudas sobre cuestiones técnicas, rogamos visite nuestra zona de
Servicio de asistencia para desarrolladores. Para obtener información adicional sobre el código del carrito de compras o sobre las siguientes variables, diríjase a
Guía de integración para Pagos en sitio web.
