Puede comenzar sin sitio web ni desarrollador, y pasar a la API más tarde sin cambiar de cuenta ni volver a presentar la solicitud. Cada ruta a continuación utiliza el mismo pago alojado, el mismo panel y los mismos pagos.
Enlaces de pago
Crea un enlace en tu panel y compártelo por correo electrónico, WhatsApp, un mensaje o una publicación. El cliente paga en la página de pago seguro y el pago aparece en su panel con su nombre, dirección de correo electrónico y número de teléfono móvil.
Nada que instalar y sin código. Un enlace para un producto recurrente inicia una suscripción en lugar de un pago único, y la página de pago muestra los términos de renovación antes de que el cliente pague.
Sesiones de pago organizadas
Su servidor crea una sesión de pago con lo que el cliente está comprando y luego lo envía a la dirección de la sesión. Pagan en la página alojada y regresan a la dirección de devolución que usted elija.
Una sesión es válida por 24 horas. Un webhook firmado le informa a su servidor el resultado, por lo que puede liberar el pedido incluso si el cliente nunca regresa a su sitio.
La API REST
JSON sobre HTTPS en utopia-paids.com/api/v1, con una clave secreta que usted crea en Panel → Desarrolladores. Los recursos son productos, clientes, sesiones de pago, pagos, suscripciones, puntos finales de webhook, eventos y su propia cuenta.
- Los importes son unidades enteras menores: 34900 son 349,00 AED.
- Las listas se paginan con un cursor, por lo que un historial largo se lee en orden y sin espacios.
- Un POST con una clave de idempotencia reproduce su primera respuesta durante 24 horas, por lo que un reintento después de un tiempo de espera no puede cobrar dos veces.
- Las claves están limitadas a 240 solicitudes por minuto.
Las claves de prueba pueden crear productos y clientes hoy, pero un proceso de pago de prueba alojado necesita credenciales de espacio aislado que aún no están habilitadas y no hay números de tarjeta de prueba. Hasta que lo sean, pruebe el flujo con una clave activa y un pequeño pago real, nunca con los datos de la tarjeta de alguien como sustituto.
Bibliotecas de nodos y PHP
Ambas bibliotecas cubren la misma API, incluyen recursos escritos y verifican las firmas de webhooks en una sola llamada.
npm install @utopia-payments/nodecomposer require utopia-payments/utopia-phpWooCommerce
Un complemento de WordPress agrega Utopia como método de pago en WooCommerce: el comprador paga en la página alojada y el pedido se marca como pagado desde el webhook en lugar de hacerlo desde el navegador del cliente.
Descargue el zip de la documentación e instálelo en Complementos → Agregar nuevo → Cargar complemento. Aún no figura en WordPress.org, por lo que se actualiza reemplazando el zip.
Todavía no existe una aplicación nativa de Shopify. Las tiendas Shopify utilizan un enlace de pago Utopia junto con un método de pago manual hasta que haya uno.
Documentación
¿No estás seguro de qué ruta encaja? Describe tu configuración para sales@utopia-payments.com.