> ## Documentation Index
> Fetch the complete documentation index at: https://developers.ebioro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enlaces de Pago

> Crea un enlace compartible que permite a cualquiera pagarte — sin necesidad de integrar un checkout

## Resumen

Un enlace de pago es un pago normal con una ventana de expiración más larga y una URL corta y compartible. Envíalo por correo, chat o código QR — el pagador lo abre en cualquier navegador y completa el pago en la página de pago alojada por Ebioro. No se necesita integración de tienda ni widget.

|                       | Pago de checkout                              | Enlace de pago                                   |
| --------------------- | --------------------------------------------- | ------------------------------------------------ |
| Se crea vía           | `POST /payments`                              | `POST /payments`                                 |
| Expiración            | 30 minutos (por defecto)                      | De horas a días — tú eliges con `expiresInHours` |
| El pagador termina en | Tu sitio tras la redirección                  | Pantalla de confirmación alojada por Ebioro      |
| URL compartible       | `hostedUrl` (larga, lleva un token de sesión) | `shortUrl` (corta, sin token en la URL)          |

## Crear un enlace de pago

Crea un pago como de costumbre, pero define `expiresInHours` y omite `redirectUrl`:

```bash theme={null}
POST /payments
{
  "amount": { "currency": "USD", "value": 25000 },
  "description": "Factura 2026-104 — servicios de diseño",
  "name": "Tu Tienda",
  "expiresInHours": 168
}
```

La respuesta contiene el enlace a compartir:

```json theme={null}
{
  "id": "pt_8CZ3BFuIbw",
  "status": "open",
  "shortUrl": "https://pay.ebioro.com/iqtRR_42J4TAIFbciUUlV",
  "hostedUrl": "https://pay.ebioro.com/payments?paymentId=pt_8CZ3BFuIbw&auth_token=...",
  "expiresAt": "2026-06-17T14:44:47.578Z"
}
```

Comparte `shortUrl`. No contiene token de sesión — la página de pago lo resuelve de forma segura al abrirse — por lo que se mantiene compacta y segura de reenviar.

<Info>
  En el entorno de pruebas, los enlaces cortos se sirven desde `https://sandbox-pay.ebioro.com`. En producción usan `https://pay.ebioro.com`.
</Info>

## Detalles de comportamiento

* **`expiresInHours`** — acepta cualquier número de horas (p. ej. `24`, `168` para 7 días). Si se omite, el pago expira a los 30 minutos, lo cual es adecuado para un checkout en vivo pero no para un enlace compartido con un pagador. Tras la expiración el estado del pago pasa a `expired` y el enlace muestra un aviso de expiración.
* **Sin `redirectUrl`** — cuando lo omites, el pagador ve una pantalla de confirmación alojada por Ebioro después de pagar. Defínelo si quieres que el pagador sea redirigido a tu propia página.
* **Flujo de estados** — idéntico al de cualquier otro pago (`open → paid → settled`), y los webhooks se disparan de la misma forma. Consulta [Pagos](/es/concepts/payments).
* **Un enlace, un pago** — cada enlace pertenece a un único pago por un monto fijo. Para solicitar el mismo monto a varios pagadores, crea un pago por pagador.

## Cancelar un enlace

Todavía no existe una operación de cancelación para un pago estándar abierto — define un `expiresInHours` conservador y deja que los enlaces no usados expiren. El pago expira automáticamente y el enlace deja de aceptar pagos.