Paso 1. Obtén el login y el secreto
Crea una clave secreta en el panel de UTOPAY (Integration → API keys); empieza con una clave de prueba utopay_sk_test_…. Pégala aquí: la clave se envía solo a api.utopay.app y no se guarda en esta página.
Una clave de prueba da ajustes de sandbox; una clave live, los de producción. Cada una tiene su propio login y secreto.
Paso 2. Crea el sistema de pago en Tilda
- Tilda → Site settings → Payment systems → Universal payment system → plantilla «New payment system (for developers)».
- Campos principales: Login y Secret for order signing, del paso 1; Currency: USD, EUR u otra moneda que acepte UTOPAY (RUB no se acepta); Country.
- Ajustes avanzados → API URL: el valor del paso 1 (
https://api.utopay.app/tilda/pay). - Correspondencia de campos: Login →
login, Currency →currency, Notification URL →notify_url, Order number →order_number, Order description →order_description, Order amount →order_amount, Buyer email →client_email, Signature →signature. - Firma del pedido: reglas personalizadas
{{login}}{{order_amount}}{{order_number}}{{secret}}, algoritmo SHA-256, marca «Use the secret as the algorithm key (HMAC)». - Firma de la notificación: reglas personalizadas
{{login}}{{order_amount}}{{order_number}}{{secret}}{{paid}}, SHA-256, HMAC. Indicador de éxito: campopaid, valor1. Id de transacción:transaction_id. - Guarda, vuelve a publicar las páginas con el carrito, haz un pedido de prueba y pulsa el botón verde ✅ en el sandbox de UTOPAY: Tilda muestra el pedido como pagado. Después repite el paso 1 con la clave live y sustituye el login y el secreto.
Opciones en la API URL
| Añade a la API URL | Qué hace |
|---|---|
?method=crypto&coin=bep20/usdt | Cripto en lugar de tarjeta (1,5%). Añade tu wallet para la red en el panel → Funds & payouts. |
?provider=paypal | Envía a los compradores directamente a un método de tarjeta (stripe, paypal, revolut…). |
?success=https://tu-sitio/gracias | Página a la que vuelve el comprador tras pagar (por defecto, la página de inicio de tu sitio). |
Las opciones se combinan: https://api.utopay.app/tilda/pay?method=crypto&coin=bep20/usdt&success=https://tu-sitio/gracias. Para ofrecer tarjeta y cripto, crea en Tilda dos sistemas de pago universales con API URL distintas.
Cómo se confirma el pedido
Tilda firma cada pedido con tu secreto (HMAC-SHA256); UTOPAY rechaza un pedido con firma incorrecta, así que el importe no puede cambiarse por el camino. Tras el pago, UTOPAY envía a Tilda una notificación firmada igual, con paid = 1 y el id del pago de UTOPAY; Tilda comprueba la firma, el número de pedido y el importe y marca el pedido como pagado. Si Tilda no responde, UTOPAY reintenta durante seis horas.
Historial de versiones
- 1.0 — Sistema de pago universal: tarjeta / PayPal y cripto, pedidos y notificaciones firmados.
Actualizado · Equipo de integraciones de UTOPAY