La siguiente documentación de configuración es para la pasarela de pago Stripe.
Stripe Standard está incluido con la versión gratuita de Easy Digital Downloads. La extensión de pasarela de pago Stripe Pro es una extensión opcional que añade soporte para Pagos preaprobados y elimina la comisión añadida a los pagos de Stripe Standard.
Configuración de Stripe
Para poder usar la pasarela de pago Stripe, primero debes tener una cuenta de Stripe. Crear una cuenta de Stripe es gratis, y probarla también es gratis.
Consulta también los requisitos de información comercial de Stripe.
1. Conectar con Stripe
Selecciona la subpestaña Stripe dentro de la pestaña Pagos, luego haz clic en el botón Conectar con Stripe.
Esto te llevará al sitio web de Stripe donde podrás iniciar sesión en tu cuenta existente si tienes una o crear una nueva cuenta si no la tienes.
2. Habilitar la pasarela de pago Stripe
Ve a la administración de WordPress → Descargas → Ajustes → Pagos, y luego habilita la pasarela de pago Stripe.
Cuentas de la India:
1. Las tiendas con sede en la India necesitan tener el país de la tienda establecido en India en Descargas → Ajustes → Tienda para funcionar con Stripe.
2. Las empresas que se registren en la India experimentarán un período de espera para activar su cuenta y comenzar a procesar pagos. Puedes obtener más información sobre este cambio aquí.
3. Configuración de webhooks
Los webhooks son eventos en vivo enviados desde Stripe a tu tienda EDD para actualizar la información de pago o recibir pagos de renovación al usar Pagos recurrentes.
Por ejemplo, si procesas un reembolso directamente desde Stripe, esto permite que el pedido correspondiente se actualice para ser reembolsado con la información adecuada.
Configuración de webhooks
Los webhooks se configuran automáticamente al conectar una nueva tienda EDD a tu cuenta de Stripe.
Notas para la prueba:
– Es posible que los webhooks no se creen automáticamente en sitios locales / de staging o en modo de prueba. Verás una opción para probar la creación de webhooks, que configurará los webhooks al hacer clic.
– Si usas la cuenta temporal con modo de prueba y Stripe, no podemos crear los webhooks.
Es posible que veas las opciones para configurar automáticamente los webhooks o añadirlos manualmente a tu cuenta. Recomendamos hacer clic en la opción automática. Consulta las instrucciones a continuación si los añades manualmente.
Configuración manual de webhooks
1. Para añadir los puntos finales de webhook apropiados, en tu panel de Stripe ve a Desarrolladores → Webhooks (enlace directo). Recomendamos crear dos puntos finales de webhook: uno para el modo de prueba y otro para el modo en vivo. Si creas ambos, necesitarás repetir el proceso a continuación después de cambiar los modos.
2. Haz clic en + Añadir punto final
3. Añade la siguiente URL:
https://example.com/?edd-listener=stripe
Nota: Reemplaza “example.com” con la URL real de tu sitio. La URL exacta que necesitas introducir se encuentra en tu administrador de WP en Descargas → Ajustes → Pagos → Stripe.
4. Escucha: Selecciona “Eventos en tu cuenta”
5. La versión debe configurarse como “Última versión de la API”.
6. Selecciona Todos los eventos para escuchar.
Después de añadir el punto final, verás la nueva URL listada en los ajustes de webhooks.
Nota: Tus webhooks no funcionarán directamente en un entorno de desarrollo local como Vagrant, WAMP, MAMP, Desktop Server o Local by Flywheel. Estas son típicamente direcciones IP no accesibles públicamente y Stripe no puede alcanzarlas.
4. Integración de Pagos Recurrentes (Requerido para vender suscripciones)
La pasarela de pago Stripe tiene soporte completo para la extensión Pagos Recurrentes. Consulta la documentación de configuración de Pagos Recurrentes con Stripe para obtener instrucciones de configuración.
Ajustes/Funciones Adicionales de la Pasarela Stripe
A continuación se muestran ajustes y funciones adicionales que puedes encontrar en Descargas → Ajustes → Pagos → Stripe.
Descriptor de estado de cuenta
Una breve descripción de la compra aparecerá en el extracto bancario/de tarjeta junto con el cargo. El descriptor se establece a través de tus Ajustes de Stripe y debe tener entre 5 y 22 caracteres.
Incluir resumen de compra
Este es un ajuste opcional si deseas incluir el/los nombre(s) del producto en el descriptor. Esto utiliza el Descriptor abreviado de Stripe para permitirte establecer un nombre más corto para que los caracteres restantes utilicen el nombre del producto. Por ejemplo, si tu descriptor abreviado es ACME y tu nombre de producto es Easy Digital Downloads, Stripe establecerá el descriptor como “ACME* EASYDIGITALDOWNL”. El nombre del producto se trunca en este ejemplo debido al límite de 22 caracteres. Stripe añade el * y no se puede eliminar.
Notas de importación:
1. Solo se permiten 22 caracteres para los descriptores de extracto. Por lo tanto, si el nombre de tu producto es demasiado largo, se truncará.
2. Los descriptores de pago son gestionados por el emisor de la tarjeta/banco. Aunque puedes especificar un descriptor, el banco puede o no usarlo exactamente como se especifica. Consulta esta documentación de Stripe para obtener detalles.
Nota: Cuando un producto está configurado como suscripción usando nuestra extensión Pagos Recurrentes, el comportamiento es ligeramente diferente para los Pagos de Renovación. Consulta la documentación de Pagos Recurrentes con Stripe para obtener detalles.
Pagos Preaprobados (Función Pro de Stripe)
Activa este ajuste si deseas recopilar la información de pago, pero no el pago hasta una fecha posterior.
Normalmente, esta opción se utiliza para pedidos anticipados. La mayoría de las tiendas típicas no necesitan esta opción.
Para procesar el pago y proporcionar acceso a tus descargas, haz clic en Procesar en la columna Estado al ver la lista del historial de pagos.
Nota: Cuando está activado, esto afecta a todos los pagos de Stripe para todos los productos.
Restringir activos de Stripe
Esta configuración evita que los activos de Stripe se carguen en todas las páginas. La mayoría de los sitios no deberían habilitar esta configuración. Stripe recomienda que su biblioteca de JavaScript se cargue en todas las páginas para aprovechar sus reglas avanzadas de detección de fraude. Si no le preocupa esto, habilite esta configuración para cargar el JavaScript solo cuando sea necesario.
Estilo de métodos de pago
Seleccione el estilo de diseño (Pestañas o Acordeón) para la sección Métodos de pago en el formulario de pago.
Métodos de pago
Puede habilitar o deshabilitar los Métodos de pago de Stripe dentro de su configuración de Stripe. Los métodos que se muestran realmente a sus clientes variarán según múltiples factores, como la moneda, el país y lo que haya en su carrito.
Los cambios que realice aquí actualizarán sus métodos de pago en el modo de prueba de Stripe. Cuando deshabilite el Modo de prueba de EDD, revise esta configuración.
Mostrar tarjetas usadas previamente
Las tarjetas usadas anteriormente ahora son administradas por Link de Stripe, para obtener mejores conversiones y seguridad.
Correo electrónico de advertencia temprana de fraude de Stripe
Reciba alertas cuando Stripe detecte una advertencia temprana de fraude mediante su aprendizaje automático. Evite disputas antes de que ocurran revisando los pedidos marcados para verificarlos y considere reembolsar de forma proactiva si el pago parece ser fraudulento.
Habilítelo en Descargas → Correos electrónicos. Busque la opción de correo electrónico de Advertencia de fraude de Stripe y haga clic en el interruptor en la columna Estado.
Esto requiere el evento webhook radar.early_fraud_warning.created. Deberá agregarse si limita los Webhooks de Stripe que se envían a su sitio. Consulte Configuración de Webhook para obtener detalles.
Comprar ahora
Si cumple con el requisito de Comprar ahora, esto permitirá a los clientes pagar a través de una ventana emergente. Para obtener detalles sobre cómo funciona, consulte nuestra documentación de Botones de Comprar ahora.
Configuración de Apple Pay
Para usar Apple Pay, deberá registrar sus dominios en su cuenta de Stripe.
Nota: Intentamos registrar su dominio para Apple Pay en su cuenta de Stripe automáticamente una vez que se conecta, pero en algunos casos, es posible que deba realizar este proceso manualmente.
Revise las instrucciones disponibles aquí.
Para usar Apple Pay, debe registrar en Apple todos sus dominios web que mostrarán un botón de Apple Pay. Vaya a la pestaña de Apple Pay en la Configuración de la cuenta de su Panel de Stripe.
Si el registro del dominio falla, deberá verificar el archivo de asociación de dominio en su host. La extensión EDD Stripe intentará hacerlo automáticamente cuando habilite una de las opciones de pago Express anteriores por primera vez. Para confirmar que el archivo se agregó correctamente, siga estos pasos de Stripe que explican cómo agregarlo manualmente.
Una vez que haya registrado sus dominios, podrá realizar pagos en su tienda con Apple Pay, usando el navegador web Safari. Para más detalles, consulte la documentación de Stripe sobre Verificación de su dominio con Apple Pay.
Prueba de Stripe
Puedes probar Stripe en Modo de prueba, lo que te permite probar el proceso de pago sin usar una tarjeta de crédito real. Stripe ofrece tarjetas de prueba para este proceso (ver abajo).
1. Habilitar modo de prueba de EDD
Navega a Descargas → Ajustes → Pasarelas de pago y habilita el Modo de prueba.
2. Conectar con Stripe
Selecciona la subpestaña Stripe dentro de la pestaña Pagos, luego haz clic en el botón Conectar con Stripe. Si ya te has conectado a Stripe con el Modo de prueba deshabilitado, tendrás que volver a conectarte en Modo de prueba. Una vez que estés conectado tanto en Modo en vivo como en Modo de prueba, no necesitarás volver a conectarte al cambiar entre uno y otro.
Esto te llevará al sitio web de Stripe donde podrás iniciar sesión en tu cuenta existente si tienes una o crear una nueva cuenta si no la tienes.
Cuenta de prueba temporal de Stripe
Stripe ofrece una cuenta de prueba temporal haciendo clic en "Omitir este formulario". NO recomendamos esta opción, ya que es mejor usar una cuenta real, la misma cuenta que tu cuenta en vivo. Esto te permite configurar webhooks y ApplyPay una vez para el Modo en vivo y de prueba. Además, si estás probando Pagos recurrentes, las renovaciones no funcionarán con una cuenta de prueba temporal.
3. Probar una compra
Ahora en modo de prueba, añade un producto a tu carrito y procede al pago.
Puedes usar el número de tarjeta 4242424242424242 con cualquier CVC y una fecha de caducidad válida (cualquier fecha en el futuro).
Probar pago exprés (Apple Pay/Google Pay)
Para probar estos métodos, debes tener un método de pago añadido.
Apple Pay
Se debe añadir una tarjeta real a tu cartera de Apple Pay, pero cuando el Modo de prueba está habilitado, no se utilizan fondos reales al probar.
Google Pay
Google Pay te permite añadir cualquier Tarjeta de prueba de Stripe. Debería añadirse en chrome://settings/payments; si no existe ninguna tarjeta de prueba (incluso con una tarjeta real listada) es posible que no veas el botón de Google Pay.
Si los botones de pago exprés no aparecen, puedes probar tus navegadores aquí:
https://stripe.com/docs/stripe-js/elements/payment-request-button
Deberías ver el botón apropiado aparecer en la parte superior de la página (ver captura de pantalla a continuación). Si no aparece, se debe a tu navegador:
Apple Pay está disponible pero falla al procesar el pago:
Intenta volver a registrar tu dominio con Apple Pay eliminando tu sitio y registrándolo de nuevo.
Recursos adicionales
Consulta Pruebas de Stripe para más números de tarjetas de prueba y opciones de prueba adicionales.
Migración a Elementos de Pago
Nota: La siguiente sección solo es aplicable a los clientes que utilizaron nuestra integración de Stripe antes de la introducción de los Elementos de Pago. A estas tiendas se les ha dado acceso a una opción para cambiar a Elementos de Pago durante la fase inicial de este lanzamiento, lo que les permite verificar que ninguna personalización de su página de pago se vea afectada durante la actualización, antes de realizar el cambio a Elementos de Pago a través de sus Ajustes de EDD Stripe.
Si utilizaste nuestra integración de Stripe antes de la introducción de los Elementos de Pago, te hemos otorgado acceso temporal a una configuración llamada "Modo Elementos" en Descargas → Configuración → Pagos → Stripe. Al actualizar, tu tienda permanecerá en Elementos de Tarjeta y te dará la capacidad de cambiar a Elementos de Pago solo después de que hayas confirmado que tu proceso de pago funciona con ellos.
Si tu página de pago ha sido personalizada, consulta este documento para obtener detalles adicionales sobre lo que necesitará ser actualizado.
Plugins o servicios de caché
Al cambiar al Elemento de Pago, asegúrate de vaciar cualquier caché que tengas, incluyendo la caché de páginas, la caché de objetos y servicios como Cloudflare, para garantizar que se carguen los archivos Javascript y CSS correctos.
Configuraciones obsoletas y sus alternativas
Con la introducción de los Elementos de Pago, ha habido algunos cambios en las configuraciones disponibles dentro de la integración EDD Stripe. Hemos agregado la mayor paridad de funciones posible, al mismo tiempo que proporcionamos una integración óptima.
Tarjetas usadas previamente
Los elementos de tarjeta heredados utilizaban la API de Stripe para buscar métodos de pago usados previamente por los usuarios cuando estaban conectados. Con la nueva integración Link integrada en el Elemento de Pago, los usuarios ahora pueden autenticarse y guardar tarjetas con el servicio Link de Stripe. Esto es mucho más beneficioso ya que ofrece una forma más segura de guardar tarjetas, da a los usuarios la opción de guardar su tarjeta, y el elemento de tarjeta heredado solo mostraba las tarjetas usadas en tu tienda, mientras que las tarjetas guardadas de Link son globales y se aplican a cualquier tienda que use la integración Link.
Campos de tarjeta divididos
Esta función no es compatible oficialmente en los Elementos de Pago y ha sido obsoleta.
Apple Pay/Google Pay
Estos métodos aparecen por defecto y se mostrarán cuando sean relevantes para los usuarios, de forma no intrusiva, junto con los otros métodos de pago que son compatibles con su navegador.
Tarjetas de prepago
Con la introducción de la función Radar de Stripe, puedes restringir tarjetas de forma más fiable a nivel de Stripe, en lugar de depender de nuestra configuración. Para obtener más información sobre cómo crear reglas, consulta la documentación de Reglas de Radar de Stripe, que tiene ejemplos para bloquear o permitir tarjetas de prepago.
Preguntas frecuentes sobre la configuración de la pasarela Stripe
¿Qué métodos de pago admite la pasarela Stripe?
Al usar la pasarela de pago Stripe, hay una serie de métodos de pago que puedes ofrecer a los clientes a través de Stripe sin tener cuentas individuales con los métodos de pago. Por ejemplo, puedes aceptar Cash App sin tener una cuenta de Cash App.
Aquí tienes una lista de métodos de pago que EDD admite a través de Stripe, que se pueden habilitar/deshabilitar a través de tu configuración de EDD Stripe:
Tarjeta de crédito / Tarjeta de débito*
Affirm
Alipay
Amazon Pay*
Apple Pay*
Bacs Debit
Bancontact*
Canadian Debit
Cartes Bancaires*
Cash App*
EPS
giropay
Google Pay*
iDEAL*
Klarna*
Link*
Przelewy24
SEPA Direct Debit
SOFORT
US Bank Account
WeChat Pay
*Soporta Pagos Recurrentes
En los Estados Unidos, puedes aceptar estas tarjetas: Visa, Mastercard, American Express, Discover, JCB, Diners Club, China UnionPay, tarjetas de débito.
Puedes leer más sobre las divisas aceptadas por Stripe en su documentación.
Nota: EDD no soporta todos los métodos de pago de Stripe, algunos métodos de pago tienen requisitos que EDD no puede soportar.
¿Cómo elimino la comisión adicional del 3% de mis transacciones de Stripe?
No incurrirás en una comisión adicional del 3% por aplicación en tus transacciones de Stripe si compras una licencia de un Pase Extended (o superior) de EDD. La clave de licencia debe activarse en tu sitio de EDD y permanecer activa y en buen estado para evitar que ocurra la comisión. La comisión volverá si la clave de licencia no se renueva y/o expira.
El estado de tu conexión EDD Stripe reflejará si la comisión se aplica a tu tienda.
¿Qué características tiene Stripe Pro de EDD que la versión estándar/gratuita de Stripe no tiene?
Actualmente, Stripe Pro añade la capacidad de aceptar pagos pre-aprobados.
¿La comisión del 3% se aplica a PayPal?
No, la comisión del 3% solo se aplica a las transacciones procesadas a través de Stripe cuando se utiliza la versión gratuita de Stripe.
¿La comisión del 3% se aplica a las transacciones recurrentes de Stripe?
Sí, la comisión del 3% se aplica a los pedidos de renovación.
¿Puedo conectarme a mi cuenta de Stripe manualmente usando mis claves API de Stripe?
Para ofrecer la mejor experiencia, solo ofrecemos Stripe Connect para la integración con Stripe.
¿Puedo degradar de Stripe Pro a Stripe Standard?
Sí, puedes desactivar y eliminar la extensión Stripe Pro y Stripe Standard se hará cargo automáticamente. Inicia sesión en tu cuenta para cancelar tu suscripción a Stripe Pro.
