Endpoints de un vistazo
| Endpoint | Autenticación | Para qué sirve |
|---|---|---|
POST /v1/payments | clave secreta | Crear un pago con tarjeta o wallet |
POST /v1/pay | — | Crear un pago sin cuenta (con una wallet de cobro) |
POST /v1/crypto/payments | clave secreta | Crear un pago en cripto |
POST /v1/crypto/pay | — | Pago en cripto sin cuenta |
GET /v1/payments/:id | clave secreta | Estado del pago |
GET /v1/payments | clave secreta | Lista de pagos |
GET /v1/providers | — | Métodos de pago disponibles para un importe y una moneda |
GET /v1/crypto/coins | — | Monedas, redes y mínimos de la pasarela cripto |
GET /v1/currencies | — | Monedas fiat aceptadas |
La referencia completa con todos los campos, errores y ejemplos está en la documentación de la API.
Crear un pago
Envía el importe y la moneda; opcionalmente fija un método con provider (por ejemplo stripe para tarjetas y Apple Pay, paypal, revolut o transak para UPI). Redirige al comprador a checkout_url.
curl -X POST https://api.utopay.app/v1/payments \
-H "Authorization: Bearer utopay_sk_live_..." \
-H "content-type: application/json" \
-d '{ "amount": 49.90, "currency": "EUR", "description": "Order #1042",
"success_url": "https://shop.example/thanks" }'
# → { "id": "ord_…", "status": "pending",
# "checkout_url": "https://api.utopay.app/pay/ord_…" }
Confirmar con webhooks
Registra un endpoint en el panel. UTOPAY envía payment.succeeded, payment.underpaid, payment.expired y payment.failed con la cabecera x-utopay-signature (HMAC-SHA256 sobre la marca de tiempo y el cuerpo original). Los reintentos duran unas siete horas. Hay ejemplos de verificación en Node.js, PHP y Python en la documentación de webhooks.
Opciones sin código y con poco código
- Enlaces de pago: crea un enlace en el panel y compártelo, sin nada de código. Consulta los enlaces de pago.
- Plugins para CMS: WooCommerce, WHMCS, OpenCart, PrestaShop, MODX, Easy Digital Downloads, Paid Memberships Pro y Tilda. Consulta los plugins.
- Modo de prueba: las claves de prueba crean pedidos sin dinero real y puedes simular estados desde el panel.
Actualizado · Equipo de UTOPAY