Incorporar pago de PayPal a su carrito de compras

de terceros
 Método 1. Transferencia del importe total del carrito de compras a PayPal
 Método 2. Transferencia de artículos sueltos a PayPal

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 obligatorias

El 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).

Define la divisa en que se indican las variables monetarias (amount, shipping,

currency_code
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).

La imagen del botón en la que hará clic su comprador al iniciar el proceso de pago de
image
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.

Nombre del artículo (o nombre del carrito de compras). Debe ser

item_name
alfanumérica, con un límite de 127caracteres

Variable de transferencia opcional para realizar seguimientos de los pagos.

item_number
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.

Valor de impuesto basado en transacción. Si aparece, el valor que aquí se

tax incluya anulará cualquier configuración de impuesto basado en el perfil que
usted posea (independientemente de la ubicación del comprador).

Dirección de envío. Si se establece como "1", no se pedirá a su cliente que

no_shipping 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.

Etiqueta opcional que aparecerá sobre el campo de notas (40 caracteres

cn
como máximo)

Incluir una nota en un pago. Si se establece como "1", se solicitará a su

no_note 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

Primer grupo de valores de opción. 200 caracteres como máximo. "on0"

os0
debe definirse para poder reconocer "os0".

on1 Nombre de campo de la segunda opción. 64 caracteres como máximo

Segundo grupo de valores de opción. 200 caracteres como máximo. "on1"

os1
debe definirse para poder reconocer "os1".

Variable de transferencia opcional que nunca se presentará a su cliente.

custom
Puede utilizarse para realizar un seguimiento del inventario.
 Variable de transferencia opcional que nunca se presentará a su cliente.
invoice
Puede utilizarse para realizar un seguimiento de números de recibos PayPal.

Usada únicamente con IPN. URL de Internet donde se realizarán envíos de

notify_url
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.

URL de Internet que contiene la imagen de 150 X 50 píxeles que usted desea
image_url
utilizar como logotipo

Establece el color de fondo de sus páginas de pago. Si se establece como "1",

cs 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 ampliadas

PayPal 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.

Nombre del cliente. Debe ser alfanumérica, con un límite de 32

first_name
caracteres

Apellidos del cliente. Debe ser alfanumérica, con un límite de 64

last_name
caracteres

Primera línea de la dirección postal del cliente. Debe ser

address1
alfanumérica, con un límite de 100 caracteres

Segunda línea de la dirección postal del cliente. Debe ser

address2
alfanumérica, con un límite de 100 caracteres

Ciudad de la dirección del cliente. Debe ser alfanumérica, con un

city
límite de 100 caracteres
 Estado del cliente. Debe presentarse como la abreviatura oficial
state
de 2 letras.

zip Código postal del cliente.

Prefijo del número de teléfono donde puede llamarse al cliente

night_phone_a
por la noche.

Primeros tres dígitos del número de teléfono donde puede

night_phone_b
llamarse al cliente por la noche.

day_phone_a Prefijo del número de teléfono del cliente durante el día.

Primeros tres dígitos del número de teléfono del cliente durante

day_phone_b
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:

1. 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">

2. 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">

3. 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

(Necesario para artículo n.º x) Nombre del artículo n.º x en el

item_name_x
carrito. Debe ser alfanumérica, con un límite de 127 caracteres

Variable de transferencia opcional asociada al artículo n.º x del

item_number_x
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.

El costo de envío de la primera parte (cantidad 1) del artículo

shipping_x
n.º x.

El costo de envío de cada parte adicional (cantidad 2 o

shipping2_x
superior) del artículo n.º x.

handling_x El costo de manejo del artículo n.º x.

Nombre de campo de la primera opción para artículo n.º x. 64

on0_x
caracteres como máximo

Primer grupo de valores de opción para artículo n.º x. 200

os0_x caracteres como máximo. "on0_x" debe definirse para poder
reconocer "os0_x".

Nombre de campo de la segunda opción para artículo n.º x. 64

on1_x
caracteres como máximo

Segundo grupo de valores de opción para artículo n.º x. 200

os1_x caracteres como máximo. "on1_x" debe definirse para poder
reconocer "os1_x".

4. 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.