Enlaces de pago
Una URL reutilizable para cada producto o plan.
Enlaces reutilizables
{
"type": "product",
"product": "prod_ejemplo",
"adjustableQuantity": true,
"maxQuantity": 5
}Para un plan usa type: "plan", plan y, opcionalmente, months como lista de ciclos. Un enlace abre checkouts nuevos para compradores distintos.
adjustableQuantity deja que el cliente elija cuántas unidades compra; maxQuantity limita cada compra (en productos, nunca más de las existencias). En un plan por puesto, adjustableQuantity: true deja que elija los puestos entre el mínimo y el máximo del plan, y maxQuantity (dentro de ese rango, si no quantity_out_of_range) baja el máximo por compra. Sin adjustableQuantity, cada compra es de una unidad o del mínimo de puestos del plan. En un plan que no se cobra por puesto es quantity_not_adjustable.
{
"type": "plan",
"plan": "plan_equipo",
"adjustableQuantity": true,
"maxQuantity": 25
}| Método | Ruta | Acción |
|---|---|---|
| POST / GET | /v1/payment-links | Crear / listar |
| GET / PATCH | /v1/payment-links/:link | Consultar / actualizar |
| DELETE | /v1/payment-links/:link | Eliminar el enlace |
La lista admite active y deleted=true, que muestra solo los eliminados. Un enlace eliminado deja de abrir checkouts y su página dice que ya no existe; los checkouts que ya abrió se pueden pagar.
Configura datos solicitados con collect, campos propios con customFields y el resultado con afterCompletion. El enlace puede tener un límite de pagos con maxPayments.
Parámetros en la URL
La url de un enlace acepta parámetros que abren el checkout con algo ya elegido, para una publicación o un mensaje sobre una opción concreta:
| Parámetro | Elige | Cuándo aplica |
|---|---|---|
variant | Una variante, por su ID | Enlaces de producto con variantes |
quantity | Unidades o puestos | Enlaces con adjustableQuantity |
months | Un ciclo de cobro | Enlaces de plan con más de un ciclo |
coupon | Un cupón, por su código | Si tu negocio acepta cupones |
https://billete.run/l/plink_ejemplo?quantity=2&coupon=VERANOEl cliente puede cambiar lo elegido si el enlace se lo permite. Si un parámetro ya no aplica (una variante eliminada, un cupón vencido), el checkout se abre como sin parámetros. Cualquier otro parámetro, como utm_source, se ignora.