Descripción
USDPAY adds a USDT payment gateway to Easy Digital Downloads. A customer completes the normal EDD checkout, is redirected to the hosted USDPAY checkout, and sends USDT directly to the merchant’s configured wallet. USDPAY monitors the blockchain and sends a signed webhook. Only a valid invoice.paid webhook completes the EDD order and unlocks the standard receipt and download access.
USDPAY no custodia fondos. No guarda el dinero de los clientes ni solicita claves privadas o frases semilla.
Servicio externo
Este plugin se conecta a USDPAY, un servicio externo de facturas de pago y verificación de blockchain, cuando un cliente selecciona USDPAY y envía el checkout de Easy Digital Downloads.
El plugin envía el importe y la moneda del pedido, la referencia del pedido del vendedor, la caducidad de la factura, la URL de retorno, la URL del webhook y la red elegida cuando está configurada. No envía el nombre, correo electrónico, dirección de facturación, productos comprados, claves privadas ni frases semilla del cliente.
The customer is then redirected to the hosted USDPAY checkout. When that page is opened, USDPAY may process standard technical information such as the customer’s IP address, browser, and device information, as described in the USDPAY Privacy Policy.
USDPAY utiliza los metadatos de pago enviados para crear una factura, supervisar la red blockchain elegida, relacionar el pago y enviar webhooks de estado al sitio del vendedor.
Los fondos del cliente se envían directamente a la wallet del vendedor. USDPAY no recibe ni custodia los fondos y no tiene acceso a las claves privadas del vendedor.
Servicio USDPAY:
https://usdpay.me/
Términos del servicio:
https://usdpay.me/legal/terms
Política de privacidad:
https://usdpay.me/legal/privacy
Requisitos
- WordPress 6.7 o posterior.
- PHP 8.0 o posterior.
- Easy Digital Downloads 3.0 o posterior.
- Una cuenta de vendedor USDPAY con una clave API activa, un secreto de webhook y una wallet receptora.
Configuración
Enable the gateway in the standard EDD Payment Gateways settings. Configure the API credentials, webhook, invoice expiration, network, checkout copy, and debug logging under Downloads > Settings > Extensions > USDPAY.
Configuración de la clave API
Paste the USDPAY Secret API Key under Downloads > Settings > Extensions > USDPAY. The saved key is stored server-side, displayed only as a mask, and is never sent to browser JavaScript or written to plugin logs.
Configuración del webhook
Copia la URL del webhook que aparece en los ajustes a la tienda USDPAY correspondiente. Pega el secreto del webhook de la tienda en WordPress. Los webhooks se verifican sobre el cuerpo original con HMAC-SHA256 y se procesan con bloqueos de idempotencia persistentes.
Redes compatibles
Se admiten TRC20, TON y BEP20. Cuando se elige El cliente elige la red, el plugin omite la red al crear la factura y USDPAY muestra las opciones disponibles.
Compras compatibles
La versión 1.0.0 admite compras digitales únicas de invitados y usuarios registrados.
Compatibilidad con el carrito
Se crea una factura USDPAY por el total final pagadero del pedido completo de EDD, incluidos los carritos con varios productos y paquetes compatibles.
Precios variables
La pasarela usa el total final del pedido de EDD, por lo que respeta el precio variable elegido por el cliente.
Descuentos
Fixed and percentage EDD discounts are reflected in the final order total. A 100% discounted order uses EDD’s free checkout and does not call USDPAY.
Impuestos
EDD calcula los impuestos. El plugin envía el total final y no vuelve a calcular el impuesto.
Pedidos gratuitos
Orders with a final total of zero use the standard EDD free checkout. No USDPAY invoice is created.
Pagos recurrentes
Los pagos recurrentes automáticos con criptomonedas no se admiten en la versión 1.0.0. Los carritos recurrentes se bloquean antes de crear una factura USDPAY.
Reembolsos
USDPAY does not process automatic blockchain refunds because payments are sent directly from the customer to the merchant’s wallet. USDPAY does not have access to the merchant’s wallet or private keys. If an order is marked as refunded or cancelled in Easy Digital Downloads, the plugin can update the local order and access status, but no USDT is sent back automatically. Any financial refund must be sent manually by the merchant from their own wallet.
El identificador original de la factura, el hash de la transacción, la red, el importe, la moneda y la hora del pago permanecen en el historial del pedido con fines de auditoría.
Seguridad
El plugin verifica las firmas de los webhooks sobre el cuerpo original, utiliza una comparación segura frente a ataques de temporización, relaciona los identificadores de factura y pedido y aplica restricciones de unicidad en la base de datos para la idempotencia del webhook y del cumplimiento. Los parámetros de retorno del navegador nunca completan un pedido. Los secretos y datos del cliente se excluyen de los registros de depuración.
Solución de problemas
Si no se puede iniciar el pago, comprueba que Easy Digital Downloads esté activo, que la pasarela esté habilitada, que ambos secretos de USDPAY estén configurados, que la moneda de la tienda sea compatible y que la URL del webhook pertenezca a la misma tienda USDPAY que la clave API.
Instalación
- Sube la carpeta
usdpay-for-easy-digital-downloadsa/wp-content/plugins/o instala el ZIP desde WordPress. - Activa el plugin.
- Open Downloads > Settings > Payments > Gateways and enable
USDPAY — USDT. - Open Downloads > Settings > Extensions > USDPAY and complete the setup.
FAQ
-
¿Cuándo se habilitan los enlaces de descarga?
-
Solo después de que un webhook
invoice.paidcorrectamente firmado complete el pedido mediante el ciclo de vida estándar de EDD. -
¿Volver desde la página de pago alojada confirma el pago?
-
No. La página de retorno es de solo lectura y muestra si el webhook ya ha completado el pedido.
-
¿Puede el plugin reembolsar USDT automáticamente?
-
No. Los USDT llegan directamente a la wallet del vendedor, por lo que este debe enviar manualmente cualquier reembolso económico.
-
¿Se admiten suscripciones?
-
No. La versión 1.0.0 solo admite pagos únicos.
Reseñas
No hay valoraciones para este plugin.
Colaboradores y desarrolladores
«USDPAY for Easy Digital Downloads» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores«USDPAY for Easy Digital Downloads» está traducido en 1 idioma. Gracias a los traductores por sus contribuciones.
Traduce «USDPAY for Easy Digital Downloads» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.0.1
- Moved USDPAY-specific settings to Downloads > Settings > Extensions > USDPAY to align with Easy Digital Downloads third-party extension guidelines.
- Added backward-compatible, idempotent settings migration without changing existing setting keys.
- Preserved the existing payment, checkout, REST webhook, HMAC, idempotency, fulfillment, free-order, recurring, refund, and uninstall behavior.
1.0.0
- Versión inicial.
- Página de pago alojada de USDPAY para EDD 3.x.
- Gestión firmada e idempotente de webhooks de pago y caducidad.
- Compatibilidad con carritos de uno o varios productos, precios variables, descuentos, impuestos y checkout gratuito.
- Se definió expresamente el modelo de compra única y reembolso manual.
- Easy Digital Downloads se declaró dependencia obligatoria del plugin.
- Los avisos administrativos se limitaron a las pantallas correspondientes del plugin y de pedidos de EDD.
