Enlaces de pago

Una URL reutilizable para cada producto o plan.

Enlaces reutilizables

POST /v1/payment-links
{
  "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.

POST /v1/payment-links
{
  "type": "plan",
  "plan": "plan_equipo",
  "adjustableQuantity": true,
  "maxQuantity": 25
}
MétodoRutaAcción
POST / GET/v1/payment-linksCrear / listar
GET / PATCH/v1/payment-links/:linkConsultar / actualizar
DELETE/v1/payment-links/:linkEliminar 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ámetroEligeCuándo aplica
variantUna variante, por su IDEnlaces de producto con variantes
quantityUnidades o puestosEnlaces con adjustableQuantity
monthsUn ciclo de cobroEnlaces de plan con más de un ciclo
couponUn cupón, por su códigoSi tu negocio acepta cupones
https://billete.run/l/plink_ejemplo?quantity=2&coupon=VERANO

El 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.