Centro de ayuda: Cuenta Personal

Consejos para solucionar problemas con el vínculo y botón de pago de PayPal

Me aparece error y el botón no se muestra en mi sitio web.

  1. Revisá que tu conexión a internet funcione.
  2. Visitá otras páginas en tu sitio web y revisá que carguen correctamente.
  3. Andá a la página de botones de PayPal y seguí estos pasos:
    * Revisá si se muestra el botón en la sección “Botones guardados”
    * Seleccioná Editar y verificá que el código del cupón del botón coincida con lo que figura en tu sitio web.
  4. Hacé clic derecho en la página del producto (donde pegaste el ID del código del cupón del botón) y hacé clic en Inspeccionar. Andá a la pestaña Consola (la verás en la parte superior). Puede que veas errores de CSP. Si implementaste una política de seguridad de contenido, puede que veas errores de CSP como los siguientes (ejemplos de errores de CSP):

  • Se rechazó la carga del script “https://www.paypal.com/sdk/js**” porque infringe la siguiente directiva de la Política de seguridad de contenido: "default-src 'self'". Tené en cuenta que 'script-src-elem' no se estableció explícitamente, por lo que 'default-src' se usa como alternativa.
  • No se conectó a “https://www.paypal.com/**” porque infringe la siguiente directiva de la Política de seguridad de contenido: "default-src 'self'". Tené en cuenta que 'connect-src' no se estableció explícitamente, por lo que 'default-src' se usa como alternativa.
  • Se rechazó la ejecución del script en línea porque infringe la siguiente directiva de la Política de seguridad de contenido: "script-src https://*.paypal.com". Se requiere la palabra clave 'unsafe-inline', un hash ('sha256-WYDWDPwB8j2VePYrqy38aHPcJLsasO//lnXymmxscUk=') o un nonce ('nonce-...') para habilitar la ejecución en línea.
  • Se rechazó la carga de la imagen 'https://tracking.qa.paypal.com/webapps/tracking/ts?**' porque infringe la siguiente directiva de la Política de seguridad de contenido: "default-src 'self'". Tené en cuenta que 'img-src' no se estableció explícitamente, por lo que 'default-src' se usa como alternativa.
  • No se enmarcó 'https://www.paypal.com/' porque infringe la siguiente directiva de la Política de seguridad de contenido: "default-src 'self'". Tené en cuenta que 'frame-src' no se estableció explícitamente, por lo que 'default-src' se usa como alternativa.

Podés intentar agregar el siguiente contenido para resolver cualquiera de los errores anteriores:

Opción 1 (HTML): Si la CSP está configurada en un archivo HTML, usá el siguiente código para reemplazar tu código de la CSP

<meta http-equiv="Content-Security-Policy" content="default-src 'self';
script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com;
style-src 'unsafe-inline' https://*.paypal.com; connect-src
https://*.paypal.com; frame-src https://*.paypal.com; img-src
https://*.paypal.com https://*.paypalobjects.com">

Opción 2 (lado del servidor): Si tu CSP está configurado del lado del servidor, usá el siguiente código para reemplazar tu código CSP

Content-Security-Policy: script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com
Content-Security-Policy: style-src 'unsafe-inline' https://*.paypal.com
Content-Security-Policy: connect-src https://*.paypal.com
Content-Security-Policy: frame-src https://*.paypal.com
Content-Security-Policy: img-src https://*.paypal.com https://*. paypalobjects.com

¿Cómo hago para cambiar el diseño, tamaño o color del nombre, precio o cantidad del producto?

A continuación, se indica cómo cambiar el diseño, el tamaño, el color del nombre del producto, el precio y la cantidad en el sitio web de PayPal:

  1. Dirigite a la página Botones de PayPal.
  2. Hacé clic en Abrir junto al botón Guardado y seleccioná Editar.
  3. Hacé clic en Personalizar tus botones e implementá los cambios necesarios.

Edité información del producto (nombre, importe u otro), ¿necesito

copiar y pegar el código del botón de nuevo?

No, tomamos toda la información del servidor de PayPal. Una vez que hayas guardado los cambios en tu cuenta, no tenés que actualizar el ID del botón de tu sitio web que se copió y pegó. 

Nota: Si cambiás el código de divisa de tu producto, tendrás que actualizar el botón de pago.

Veo una Id. de cliente en el código, ¿qué significa?

EI id. de cliente es el id. de cliente del establecimiento que forma parte de tu cuenta. No deberías editarla. Se debe utilizar tal como se proporciona en el código del botón.

Agregué varios botones, pero ninguno se muestra en mi página web.

Varios botones de una misma página web no funcionarán en los siguientes escenarios:

  • Si copiaste y pegaste la misma Id. de botón varias veces en la misma página web, solo se mostrará el primer botón. No podés repetir la misma Id. de botón varias veces.
  • Si copiaste y pegaste Id. de botones con diferentes divisas en la misma página web, solo se mostrará el primer botón. No podés agregar divisas extranjeras en los botones de la misma página web.
  • Si copiaste y pegaste diferentes Id. de botón y la página funciona con lentitud, asegurate de que la etiqueta del script con la Id. de cliente solo se haya agregado una vez. La línea del script se verá así:

    • <script src="https://www.paypal.com/sdk/js?client-id=XYZ&components=hosted-buttons&enable-funding=venmo&currency=USD"></script> 

Tengo una cuenta PayPal Premier y no veo los vínculos ni los botones de pago como

una opción.

Esta función solo está disponible para Cuentas Empresas PayPal. Para utilizar esta función, subí de categoría o creá una Cuenta Empresas.

¿Cómo hago para probar esta experiencia en el entorno de pruebas Sandbox de PayPal?

El vínculo y botón de pago están disponibles para probarlos en Sandbox.

La expansión en línea de Crédito/Débito no se muestra completamente en mi

sitio web.

Asegurate de que el ancho y la altura del contenedor principal estén configurados para acomodar la expansión en línea. Consultá la documentación o la página de soporte de la plataforma de hospedaje para obtener más información.

¿Los vínculos y botones de pago admiten una IPN (notificación instantánea de pago)?

Sí. Seguí estos pasos para configurar y habilitar IPN.

A continuación, te indicamos cómo encontrar la configuración de IPN en PayPal:

  1. Dirigite a Configuración de la cuenta.
  2. Seleccioná Notificaciones y Notificaciones instantáneas de pago.
  3. Hacé clic en Actualizar vínculo.

A continuación, te indicamos cómo habilitar la configuración de IPN:

  1. Agregá el URL del controlador de IPN y seleccioná Recibir mensajes IPN (habilitado).
  2. Hacé clic en Guardar.

Manejar la IPN en el código del servidor:

  • Cada vez que se completen transacciones del botón y el vínculo de pago, la IPN de PayPal invoca el URL de notificación configurado en el paso 2.

Acceder al historial de la IPN:

Referencias

Introducción: https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/

Verificá que estás utilizando el URL de la IPN correcta en el código del servidor

Muestras para diferentes idiomas GitHub - PayPal/ipn-code-samples

Cuando se envía a un cliente a la página de redireccionamiento, ¿qué información acerca de la

compra envía PayPal? ¿Los botones y vínculos de pago son compatibles con la transferencia de datos de pago?

¿Qué variables se admiten?

Sí, admitimos variables de la transferencia de datos de pago tal como se documenta aquí. Recibirás transferencias de datos de pago si activás la configuración de redireccionamiento automático durante la configuración del botón y el vínculo de pago. 

¿Los vínculos y botones de pago admiten una configuración local si la agrega manualmente

el establecimiento en el código del botón o en el vínculo de pago?

De forma predeterminada, los vínculos y botones de pago utilizan las preferencias del navegador de los clientes para mostrar el código del botón y la experiencia del vínculo de pago.

Los establecimientos pueden anular lo mismo solo para el vínculo de pago y el código del botón al agregar "locale.x=fr_FR" como parámetro de consulta. La lista de códigos admitidos para configuraciones locales se puede encontrar aquí. Cualquier texto ingresado por un establecimiento durante la configuración no se traducirá.

Ejemplo: https://www.paypal.com/ncp/payment/F3YMU2ZGT49XX?locale.x=jp_JP

Ejemplo: 

<script src="……¤cy=USD&locale.x=jp_JP"></script>

¿Es posible ocultar algunas de las etiquetas que provienen de los vínculos y

del código de botón de pago?

Entendemos que es posible que tengas una configuración visual diferente en tu sitio web. Sin embargo, no recomendamos ocultar el código del botón que proporcionamos. 

Ocultarlos de tu sitio web no cambiará la forma en que se procesa la transacción. La transacción seguirá utilizando la configuración de tu Id. de botón alojado. 

Podés ocultar parte o todo el texto alrededor de los botones una vez que estés utilizando un tipo de botón que no requiera la intervención del cliente. Por ejemplo, si tu cliente necesita seleccionar la cantidad o la lista de selección de varios artículos y ocultaste esos elementos de entrada, la transacción fallará. 

A continuación, te mostramos un ejemplo de cómo ocultar el precio de un artículo:

Agregá esta secuencia debajo de tu código de botón, reemplazá el HostedButton_ID con el identificador de botón real.

<style> #paypal-container-<HostedButton_ID> {

                #paypal-form-fields-container-<HostedButton_ID> {

                                 #price-label {

                                                 display: none !important;

                                }

                }

 

}

</style>

                   

Similar a ocultar el precio de un artículo, también podés hacer lo mismo para otro texto:

  • desc-label (para el nombre del producto)
  • price-label (para el precio)

Si querés ocultar muchos de ellos, utilizá un ID separado:

style> #paypal-container-

{ #paypal-form-fields-container-

{ #price-label,  #desc-label { display: none !important; }} }

Si querés ocultar todo el texto alrededor de los botones, recordá que tu tipo de botón no debería requerir ninguna selección o entrada de tu cliente:

<style>

#paypal-container-<HostedButton_ID>

{

                #paypal-form-fields-container-<HostedButton_ID>

                {

                                display: none !important;

                }

}

</style>


¿Es posible anular mis botones y vínculos de pago para utilizar el envío desde la

configuración?

Los vínculos y botones de pago no respetarán la anulación masiva de envíos desde la configuración de la cuenta, también conocida como el siguiente ajuste de Configuración de envío.

image

Cambié la divisa de mi botón, pero no la veo actualizada en el

sitio web.

Si cambiás la divisa de un botón después de haberlo pegado en tu sitio web, tendrás que volver a copiar/pegar el código del botón en tu sitio web. 

No puedo seleccionar “Usar envío desde Configuración” y “Usar impuesto desde

Configuración” cuando selecciono “No cobrar dirección de envío”.

El envío y los impuestos de Configuración dependen del código postal o el país de envío del cliente. Si seleccionás "No recopilar la dirección de envío", no recibirás la dirección de envío del cliente para permitir el cálculo de gastos de envío e impuestos desde la Configuración. Te recomendamos utilizar otras opciones de los menús desplegables "Gastos de envío" y "Tasa impositiva".

¿Los vínculos y botones de pago son compatibles con Webhooks?

Sí. A continuación, se indica cómo activar Webhooks:

  1. Iniciá sesión en el Panel de desarrollador con las credenciales de tu cuenta de comercio.
  2. Cambiá a Live.
  3. Hacé clic en Aplicaciones y credenciales.
  4. Desplazate hacia abajo y seleccioná Administrar webhooks.
  5. Ahora podés agregar una URL de Webhook para Live. Si deseas agregar Webhooks para Sandbox, permanecé en esta página y cambiá de Live a Sandbox desde la esquina superior derecha.
  6. Agregá la URL de retorno de Webhooks, seleccioná todos los eventos o pagos, es decir, los eventos de pago que serán invocados por PayPal, según los eventos seleccionados y la utilización de la configuración NVP o SOAP de la API. Para obtener más información acerca de la implementación de los Webhooks, comunícate con la sección NVP/SOAP de la API de PayPal.

Ejemplo de respuesta de un webhook:

"id": "WH-12D11567VE3425924-2G120938U32719946", 
 "event_version": "1.0", 
 "create_time": "2024-09-14T15:55:58.043Z", 
 "resource_type": "capture", 
 "resource_version": "2.0", 
 "event_type": "PAYMENT.CAPTURE.COMPLETED", 
 "summary": "Payment completed for $ 128.88 USD", 
 "resource": { 
 "supplementary_data": { 
 "related_ids": { 
 "order_id": "8LM68409BR5528307" 
 } 
 ], 
 "id": "7KK30254642170736", 
 "status": "COMPLETED" 

Temas relacionados

Más formas en las que podemos ayudarte

Utilizaremos cookies a fin de mejorar y personalizar tu experiencia si continuás navegando. ¿Está bien si también usamos cookies para mostrarte anuncios personalizados? Obtener más información y administrar tus cookies