# Billete

> Documentación pública de la API REST y el SDK de TypeScript para integrar pagos en Venezuela.

## Referencias

- [Autenticación](https://billete.run/docs/api/authentication.mdx): Una clave secreta identifica a tu negocio y al entorno de cada petición.

- [Historial de versiones](https://billete.run/docs/api/changelog.mdx): Qué cambió en cada versión de la API y cuándo se retira.

- [Checkouts](https://billete.run/docs/api/checkouts.mdx): Una página de pago para una compra concreta o un enlace que puedes compartir.

- [Reclamos](https://billete.run/docs/api/claims.mdx): Atiende los reclamos de tus clientes sobre sus pagos y resuélvelos.

- [Cupones](https://billete.run/docs/api/coupons.mdx): Descuentos por código para productos o para planes.

- [Sesiones de cliente](https://billete.run/docs/api/customer-sessions.mdx): Emite un token de corta duración para el navegador.

- [Clientes](https://billete.run/docs/api/customers.mdx): Relaciona tus usuarios con sus compras, suscripciones y cuotas.

- [Errores](https://billete.run/docs/api/errors.mdx): Interpreta las respuestas y recorre listas sin perder tu posición.

- [Eventos](https://billete.run/docs/api/events.mdx): Consulta el historial de cambios y los tipos de evento.

- [Cuotas y consumo](https://billete.run/docs/api/features.mdx): Expresa qué puede usar un cliente y cuánto le queda.

- [Entregas](https://billete.run/docs/api/fulfillments.mdx): Sigue los productos físicos desde la compra hasta la recepción.

- [Idempotencia](https://billete.run/docs/api/idempotency.mdx): Reintenta una operación sin crear una segunda compra o devolución.

- [API REST](https://billete.run/docs/api.mdx): Los recursos de tu negocio, disponibles por HTTP. Empieza en prueba y cobra con el checkout alojado.

- [Cobros](https://billete.run/docs/api/invoices.mdx): Solicita un importe a un cliente con una página de pago propia.

- [Montos y monedas](https://billete.run/docs/api/money.mdx): Precios en céntimos, tasas decimales y conversión al momento del pago.

- [Paginación](https://billete.run/docs/api/pagination.mdx): Recorre listas por cursor y conserva tus filtros.

- [Enlaces de pago](https://billete.run/docs/api/payment-links.mdx): Una URL reutilizable para cada producto o plan.

- [Pagos](https://billete.run/docs/api/payments.mdx): Consulta el resultado y el estado del dinero.

- [Planes](https://billete.run/docs/api/plans.mdx): Precios por ciclo, pruebas y cuotas para suscripciones.

- [Portal del cliente](https://billete.run/docs/api/portal.mdx): Una experiencia alojada para suscripciones y cobros.

- [Productos](https://billete.run/docs/api/products.mdx): Prepara tu catálogo de compras únicas y sus descuentos.

- [Recibos](https://billete.run/docs/api/receipts.mdx): Reenvía el comprobante de un pago por correo.

- [Reembolsos](https://billete.run/docs/api/refunds.mdx): Registra y consulta devoluciones de un pago.

- [Suscripciones](https://billete.run/docs/api/subscriptions.mdx): Gestiona períodos, renovaciones y cancelaciones.

- [De prueba a producción](https://billete.run/docs/api/testing.mdx): Verifica el flujo completo antes de aceptar pagos reales.

- [Versiones](https://billete.run/docs/api/versioning.mdx): Elige la versión de la API de tu integración; Billete nunca la cambia por debajo.

- [Webhooks](https://billete.run/docs/api/webhooks.mdx): Recibe cambios verificados sin depender de que el cliente vuelva a tu sitio.

- [Mensual y anual](https://billete.run/docs/recipes/billing-cycles.mdx): Varios ciclos de cobro en un mismo plan, elegir uno al comprar y cambiarlo después.

- [Checkout propio](https://billete.run/docs/recipes/custom-checkout.mdx): Cobra dentro de tu web o de tu app de React Native o Expo con tu propia pantalla de pago.

- [Productos digitales y servicios](https://billete.run/docs/recipes/digital-products.mdx): Cursos, plantillas, licencias o asesorías que tu aplicación entrega al confirmarse el pago, una sola vez por compra.

- [Precios en dólares, cobro en bolívares](https://billete.run/docs/recipes/dollar-prices.mdx): Fija tus precios en dólares o euros y cobra en bolívares a la tasa BCV del momento del pago.

- [Eventos y entradas](https://billete.run/docs/recipes/events-and-tickets.mdx): Tipos de entrada con su precio y su aforo, entradas emitidas por tu aplicación al pagarse y devoluciones si el evento se cancela.

- [Pruebas gratis](https://billete.run/docs/recipes/free-trials.mdx): Días gratis en un plan pago, el primer cobro al terminar y una sola prueba por cliente.

- [Pasar a producción](https://billete.run/docs/recipes/go-live.mdx): Prueba todo con pagos simulados y pasa a cobrar de verdad cambiando solo la configuración.

- [Recetas](https://billete.run/docs/recipes.mdx): Cómo modelar tu producto con clientes, planes, ventas y pagos.

- [Renovaciones con Pago Móvil](https://billete.run/docs/recipes/manual-renewals.mdx): Cómo se cobra cada renovación cuando el cliente inicia el pago, y qué muestra tu aplicación.

- [Cobros únicos y servicios](https://billete.run/docs/recipes/one-off-charges.mdx): Cobra un monto que defines tú a un cliente concreto, con su propia página de pago y fecha límite.

- [Tienda con productos físicos](https://billete.run/docs/recipes/online-store.mdx): Productos con tallas y colores, existencias, retiro, delivery o envío nacional, y la confirmación de que el cliente recibió su compra.

- [Personales y de equipo juntos](https://billete.run/docs/recipes/personal-and-team.mdx): Por qué el plan del equipo va en la organización y no en el cliente del usuario.

- [Planes personales](https://billete.run/docs/recipes/personal-plans.mdx): Un plan gratuito y planes pagos para cada usuario, con vuelta al gratuito al cancelar o dejar de pagar.

- [Descuentos en planes](https://billete.run/docs/recipes/plan-discounts.mdx): Promociones de lanzamiento, los primeros meses a mitad de precio y descuentos al subir de plan.

- [Reembolsos y reclamos](https://billete.run/docs/recipes/refunds-and-claims.mdx): Devuelve un pago completo o en parte desde tu banco, registra las devoluciones pendientes y atiende los reclamos de tus clientes.

- [Webhooks sin perder ni duplicar](https://billete.run/docs/recipes/reliable-webhooks.mdx): Recibe los eventos de Billete, guárdalos una sola vez y procésalos aparte, aunque lleguen repetidos, tarde o en otro orden.

- [Puestos extra](https://billete.run/docs/recipes/seat-addons.mdx): Un plan con puestos incluidos y un complemento que vende puestos adicionales.

- [Autoservicio del cliente](https://billete.run/docs/recipes/self-service-portal.mdx): Deja que tus clientes paguen sus renovaciones, cancelen o cambien sus puestos con el portal de Billete o con tus propias pantallas.

- [Vender por redes y WhatsApp](https://billete.run/docs/recipes/social-selling.mdx): Un enlace de pago por producto o plan para publicar en Instagram o mandar por WhatsApp, sin tienda propia.

- [Planes de equipo](https://billete.run/docs/recipes/team-plans.mdx): Una organización paga por puesto y su equipo se desactiva, sin perder nada, hasta que pague.

- [Créditos por consumo](https://billete.run/docs/recipes/usage-credits.mdx): Mensajes, tokens o proyectos limitados por plan, con el saldo a la vista y qué hacer al llegar al límite.

- [Checkout en el navegador](https://billete.run/docs/sdk/browser-checkout.mdx): Construye tu propio checkout con el cliente público, con sus métodos de pago, estados, códigos de verificación, errores y escenarios de prueba.

- [Cliente de navegador](https://billete.run/docs/sdk/browser.mdx): Consulta el estado de un cliente o construye un checkout sin una clave secreta.

- [Checkouts](https://billete.run/docs/sdk/checkouts.mdx): Crea una compra y redirige al cliente a su página de pago.

- [Reclamos](https://billete.run/docs/sdk/claims.mdx): Responde y resuelve los reclamos de tus clientes desde tu servidor.

- [Configuración](https://billete.run/docs/sdk/configuration.mdx): Un cliente explícito para cada entorno, con transporte configurable.

- [Cupones](https://billete.run/docs/sdk/coupons.mdx): Crea descuentos para productos o para planes.

- [Monedas](https://billete.run/docs/sdk/currencies.mdx): Comprueba qué monedas están disponibles para cobrar.

- [Sesiones de cliente](https://billete.run/docs/sdk/customer-sessions.mdx): Autoriza al navegador a consultar el estado de su propio cliente.

- [Clientes](https://billete.run/docs/sdk/customers.mdx): Crea y consulta los clientes de tu negocio.

- [Errores y reintentos](https://billete.run/docs/sdk/errors.mdx): Maneja fallos con códigos estables y conserva la identidad de cada operación.

- [Eventos](https://billete.run/docs/sdk/events.mdx): Consulta lo que ocurrió en tu negocio.

- [Tasas de cambio](https://billete.run/docs/sdk/exchange-rates.mdx): Consulta las tasas oficiales para mostrar precios de referencia.

- [Acceso y consumo](https://billete.run/docs/sdk/features.mdx): Conecta los límites de tus planes a las acciones de tu aplicación.

- [Entregas](https://billete.run/docs/sdk/fulfillments.mdx): Consulta el estado de una compra física y registra su entrega.

- [SDK de TypeScript](https://billete.run/docs/sdk.mdx): Menos transporte, más producto. Integra Billete desde tu servidor y tu navegador.

- [Cobros](https://billete.run/docs/sdk/invoices.mdx): Solicita a un cliente un importe pendiente con una página de pago.

- [Paginación](https://billete.run/docs/sdk/pagination.mdx): Lee una página o recorre una colección con un iterador asíncrono.

- [Enlaces de pago](https://billete.run/docs/sdk/payment-links.mdx): Publica una URL reutilizable para vender un producto o un plan.

- [Pagos](https://billete.run/docs/sdk/payments.mdx): Consulta el dinero de un checkout o de un cobro.

- [Planes](https://billete.run/docs/sdk/plans.mdx): Define precios por ciclo y las cuotas que incluye una suscripción.

- [Portal del cliente](https://billete.run/docs/sdk/portal.mdx): Abre la experiencia alojada para gestionar cobros y suscripciones.

- [Productos](https://billete.run/docs/sdk/products.mdx): Administra precios, variantes y existencias de compras únicas.

- [Inicio rápido](https://billete.run/docs/sdk/quickstart.mdx): Crea un producto y abre tu primer checkout de prueba.

- [Recibos](https://billete.run/docs/sdk/receipts.mdx): Reenvía por correo el comprobante de un pago.

- [Reembolsos](https://billete.run/docs/sdk/refunds.mdx): Solicita una devolución sin confundirla con su confirmación.

- [Recursos del SDK](https://billete.run/docs/sdk/resources.mdx): Encuentra cada recurso y consulta sus métodos, ejemplos y reglas.

- [Suscripciones](https://billete.run/docs/sdk/subscriptions.mdx): Consulta períodos, programa cancelaciones y gestiona renovaciones.

- [Endpoints de webhooks](https://billete.run/docs/sdk/webhook-endpoints.mdx): Configura dónde recibe tu servidor los eventos de Billete.

- [Verificar webhooks](https://billete.run/docs/sdk/webhooks.mdx): Valida el cuerpo original y recibe un evento con tipos discriminados.

## Acceso para agentes

- [Documentación completa](https://billete.run/llms-full.txt)

Las páginas HTML están renderizadas en el servidor y no requieren sesión ni JavaScript.

Añade .mdx o .md a una página, o envía Accept: text/markdown, para obtener su Markdown.