Historial de versiones

Cada versión de la API tiene aquí lo que cambió respecto de la anterior y cómo migrar. Lo que solo agrega (endpoints, campos opcionales, tipos de evento) llega a todas las versiones vigentes y no necesita versión nueva. Lee cómo elegir y actualizar tu versión.

2026-11-09 (beta)Copiar enlace

Publicada el 9 de noviembre de 2026

Si tus clientes pueden escribir un cupón al pagar lo decide ahora tu negocio, para todos sus pagos, en Configuración › Cobros › Cupones (activo por defecto). Ya no lo decide cada checkout ni cada enlace, así que esta versión quita allowCoupons de:

• POST /v1/checkouts y POST /v1/subscriptions/:subscription/changes.
• POST /v1/payment-links, PATCH /v1/payment-links/:link y el enlace de pago que responde la API (también en el evento payment_link.deleted).

Cómo migrar: deja de enviar allowCoupons. Si no quieres que tus clientes apliquen cupones, desactívalos en el dashboard; tu integración sigue pudiendo aplicar uno con coupon. Las versiones anteriores aceptan allowCoupons pero lo ignoran, y leen allowCoupons: true en cada enlace.

En todas las versiones, el cliente también puede aplicar un cupón al pagar un cobro: el checkout sigue respondiendo allowCoupons, ahora según el ajuste de tu negocio. Lo que se agrega llega a todas las versiones: PATCH /v1/client/invoices/:invoice y, en el cobro del navegador, allowCoupons y subscriptionCouponCode.

2026-11-06 (beta)Copiar enlace

Publicada el 6 de noviembre de 2026

Billete ya no guarda el dinero de tu negocio: al confirmarse cada pago, envía su neto al Pago Móvil donde recibes tus pagos. Sin saldo que consultar ni retirar, esta versión quita:

• GET /v1/balance, GET /v1/payouts y GET /v1/payouts/:payout.
• Los eventos payout.created, payout.paid, payout.failed y payout.canceled: un webhook ya no puede suscribirse a ellos (events los rechaza).
• En el SDK, billete.balance y billete.payouts, con sus tipos (Balance, BalanceAmount, Payout).

Cómo migrar: deja de llamar a esas rutas y quita los eventos payout.* de tus webhooks. Cada envío al Pago Móvil de tu negocio se ve en el dashboard, en la actividad de su pago. Las versiones anteriores siguen respondiendo GET /v1/balance con un saldo vacío y /v1/payouts sin retiros, y aceptan esos eventos en un webhook aunque nunca llegue ninguno, hasta que se retiren.

En todas las versiones, Billete ya no devuelve los reembolsos por su cuenta: los devuelve tu negocio desde su banco por Pago Móvil y los registra con la referencia (reembolsos pendientes). Ya no se crean reembolsos con mode: "billete"; los anteriores lo conservan. Lo que se agrega llega a todas las versiones: reference en el reembolso y en POST /v1/payments/:payment/refunds, y GET /v1/client/refunds/:token y PUT /v1/client/refunds/:token/destination para la página donde tu cliente indica dónde recibirlo.

2026-10-24Copiar enlace

Publicada el 24 de octubre de 2026

Primera versión de la API. Úsala en Billete-Version (o en apiVersion del SDK, desde su versión 9) y en tus webhooks. Cuando salga una versión nueva, aquí verás qué cambia y cómo migrar.