Recomendaciones para la resolución de problemas con los botones y enlaces de pago de PayPal

Recibo un mensaje de error y el botón no se muestra en mi sitio web.

1. Verifica que la conexión a Internet funcione.

2. Visita otras páginas en tu sitio web y verifica si se cargan correctamente. Ve a la página Botones de PayPal para verificar que el botón se muestre en Botones guardados y que el código coincida con el que está en tu sitio web.

3. Haz clic con el botón derecho en la página de tu producto (donde hayas pegado el código del botón) y haz clic en Inspeccionar. Ve a la pestaña Consola (esquina superior derecha de la página). Es posible que veas errores relacionados con la Content Security Policy (CSP, Política de seguridad de contenido). Si implementaste una CSP, es posible que veas errores como los siguientes:

  • El sistema se negó a cargar la secuencia de comandos "https://www.paypal.com/sdk/js**' porque infringe la directiva “default-src 'self'” de la Política de seguridad de contenido. Ten en cuenta que 'connect-src' no se estableció explícitamente, por lo que 'default-src' se usa como alternativa.
  • El sistema se negó a cargar la secuencia de comandos "https://www.paypal.com/**' porque infringe la directiva “default-src 'self'” de la Política de seguridad de contenido. Ten en cuenta que 'connect-src' no se estableció explícitamente, por lo que 'default-src' se usa como alternativa.
  • El sistema se negó a cargar la secuencia de comandos "https://www.paypal.com/sdk/js**' porque infringe la directiva “default-src 'self'” de la Política de seguridad de contenido. Ten en cuenta que 'connect-src' no se estableció explícitamente, por lo que 'default-src' se usa como alternativa.
  • 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.
  • Se rechazó enmarcar '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.


Puedes intentar agregar lo siguiente para resolver cualquiera de los errores anteriores:
Opción 1 (HTML): Si tu CSP está configurada en un archivo HTML, utiliza el código siguiente para reemplazar el código de tu CSP

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á configurada del lado del servidor, utiliza el código siguiente para reemplazar el código de tu 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 puedo cambiar los atributos de los botones, como el diseño, el tamaño, el color, el nombre del producto, el precio o la cantidad?

A continuación te indicamos cómo cambiar los atributos del botón:

  1. Ve a la página Botones de PayPal guardados.
  2. Haga clic en Abrir junto al botón Guardar y seleccione Editar.
  3. Haz clic en Personalizar tus botones y efectúa los cambios necesarios.

He editado algunos atributos de botón, ¿tengo que volver a copiar y pegar el código del botón?

No. Tomamos toda la información del servidor de PayPal. Una vez que hayas guardado los cambios en tu cuenta, no es necesario que actualices el código en tu sitio web.

¿Cuál es el ID de cliente en el código?

Un id. de cliente de PayPal es un identificador único que se utiliza para autenticar la cuenta de PayPal de un comercio cuando se integra con nuestras API REST.

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

  • Si has copiado o pegado el mismo Id. de botón varias veces en la misma página web, solo se mostrará el primer botón. No se puede repetir el mismo Id. de botón varias veces.
  • Si has copiado o pegado diferentes Id. de botón, pero con otras divisas y en la misma página web, solo se mostrará el primer botón. No se pueden agregar divisas extranjeras a los botones en la misma página web.
  • Si copiaste y pegaste diferentes identificadores de botón y experimentas latencia, asegúrate de que la etiqueta de la secuencia de comandos con el id. de cliente solo se haya agregado una vez. La línea de la etiqueta de la secuencia de comandos se ve así:

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

¿Qué tipo de cuentas de PayPal pueden crear enlaces y botones de pago?

Solo las cuentas Empresas de PayPal pueden crear botones y enlaces de pago. Para utilizar esta función, debes actualizar o crear una cuenta Empresas.

¿Cómo puedo probar esta experiencia?

Para probar esta experiencia, utiliza nuestro entorno Sandbox.

¿Cómo pruebo el botón de Venmo en Sandbox?

Pagar con Venmo no está disponible actualmente en Sandbox. Para probar, será necesaria una prueba en vivo.

Mi cliente indicó que no todas las formas de pago están disponibles.

Los métodos de pago específicos, como PayPal, Venmo y Pay Later, dependen de si el país del comprador reúne los requisitos.

La expansión de tarjetas de crédito y débito en la misma página no se muestra de manera completa en mi página web. 

Asegúrate de que la anchura y la altura del contenedor principal estén configuradas para adaptarse a la expansión en línea. Consulta la documentación y la sección de asistencia de la plataforma de alojamiento para obtener más información.

¿Notificaciones instantáneas de pago (IPN) es compatible con los botones y enlaces de pago?

Sí, IPN es compatible con los enlaces y botones de pago.

Revisa ¿Qué es Notificaciones instantáneas de pago o IPN? para obtener información sobre la configuración.

¿Los enlaces y botones de pago son compatibles con la transferencia de datos de pago (PDT)?

Sí, se admite PDT. Revisa nuestra documentación sobre la variable de PDT. Si activas la configuración de redireccionamiento automático durante la configuración de los botones y enlaces de pago, recibirás transferencias de datos de pago.

¿Los enlaces y botones de pago admiten configuraciones regionales agregadas manualmente en el código de botón?

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

Los comercios pueden anular esto para los enlaces de pago y los códigos de los botones si agregan “locale.x=fr_FR and country.x=” como parámetro de consulta. La lista de códigos compatibles para configuraciones regionales se puede encontrar en nuestra documentación del SDK de JavaScript. Cualquier texto ingresado por un comercio durante la configuración no se traducirá.

Por ejemplo: https://www.paypal.com/ncp/payment/F3YMU2ZGT49XX?locale.x=ja_JP&country.x=JP

Ejemplo: <script src="……¤cy=USD&locale.x=ja_JP"></script>

¿Se pueden ocultar las etiquetas de los botones y enlaces de pago?

Entendemos que puede tener una configuración visual diferente en su sitio web. Sin embargo, no recomendamos ocultar el código de botón que proporcionamos.

Ocultarlo en tu sitio web no cambiará la forma en que se procesa la transacción. La transacción igualmente utilizará la configuración de Id. del botón alojado.

Cuando utilizas un tipo de botón que no requiere la intervención del cliente, puedes ocultar parte o la totalidad del texto alrededor de los botones. Por ejemplo, si el cliente tiene que seleccionar la cantidad o una lista de selección de varios artículos y has ocultado esos elementos de entrada, se producirá un error en la transacción.

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

Por ejemplo, agregue este script debajo del código del botón. Reemplácelo por <HostedButtonID> el identificador de botón real.

<style>

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

#price-label { 

display: none !important;  

}  

}  

</style> 

De manera similar a como se oculta el precio de un artículo, puedes hacer lo mismo con otros textos: 

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

Si deseas ocultar varios, usa id. separados:

<style> #paypal-container-

{ #paypal-form-fields-container-

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

Si quieres ocultar todo el texto alrededor de los botones, recuerda que tu tipo de botón no debe requerir ninguna selección o entrada por parte del cliente:

<style>

#paypal-containter-<HostedButton_ID>

{

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

{

display: none !important;

}

}

</style>



¿Es posible anular los botones y enlaces de pago para utilizar la configuración de “enviar desde”?

Los botones y enlaces de pago no responden a la anulación en lote del envío desde la configuración de la cuenta. La configuración Usar la tarifa de envío de la transacción en lugar de la configuración de mi calculadora debe estar establecida en “No”.

Cambié la divisa de mi botón, pero no la veo actualizada en mi página web.

Si ha cambiado la divisa de un botón después de publicarlo en su página web, deberá copiar y pegar el nuevo código de botón en su página web.

Cuando selecciono No recolectar dirección de envío, no puedo seleccionar Usar envío en Configuración ni Usar impuesto en Configuración.

Aunque actualmente no están disponibles, estamos trabajando para habilitar estas opciones para Venmo.

¿Los webhooks admiten botones y enlaces de pago?

Sí. Los webhooks son compatibles con los botones y enlaces de pago.

A continuación se explica cómo habilitar webhooks:

  1. Inicia sesión en el Panel para desarrolladores con las credenciales de tu cuenta de comercio de PayPal.
  2. Mueve el cursor a Entorno de producción.
  3. Haga clic en Aplicaciones y credenciales.
  4. Desplázate hacia abajo y selecciona Administrar webhooks.
  5. Ahora puede agregar una URL de webhook para el entorno de producción. Si deseas agregar webhooks para Sandbox, permanece en esta página y mueve el cursor de Entorno de producción a Sandbox en la esquina superior derecha.
  6. Agrega la URL de devolución de llamada/escucha de webhooks y selecciona los eventos específicos a los que deseas suscribirte o todos los eventos.