Catálogo de productos¶
Un producto es el elemento reutilizable detrás de todo lo que vendes: un plan SaaS, un bien físico, un servicio o una oferta puntual. Defínelo una vez y conéctalo a enlaces de pago, planes de suscripción o sesiones de checkout en lugar de repetir los mismos datos en cada cobro.
En resumen
Para quién: equipos que venden uno o varios productos o servicios.
Tiempo: 5 minutos.
Resultado: un producto reutilizable listo para planes y enlaces de pago.
¿Qué es un producto?¶
Un producto guarda el nombre, la descripción y el estado de algo que vendes. Los planes y enlaces de pago referencian el producto en lugar de duplicar su información.
- Una sola fuente de verdad — actualiza el producto una vez y reutilízalo.
- Reportes más claros — agrupa ingresos por producto en lugar de por cargo individual.
- Configuración más rápida — crea un plan o un enlace sin volver a escribir la oferta.
Disponibilidad en la consola
El catálogo está disponible hoy a través de la API. La vista en la consola se está desplegando por workspace. Si aún no ves Payments → Products, usa la API o contacta a soporte para habilitarla.
Crear un producto¶
curl -X POST 'https://api.4geeks.io/v1/products' \
-H 'X-Api-Key: sk_test_your_api_key_here' \
-H 'Content-Type: application/json' \
-d '{
"name": "Plan Premium",
"description": "Suscripción mensual con todas las funciones",
"active": true
}'
La respuesta devuelve el id del producto, que puedes usar al crear un plan o un enlace de pago.
- Abre la Consola de 4Geeks.
- Ve a Payments → Products.
- Selecciona New product.
- Escribe un nombre y una descripción opcional.
- Guarda el producto y copia su ID.
Campos del producto¶
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
name | string | Sí | Nombre visible para el cliente |
description | string | No | Explicación breve de lo que recibe el cliente |
active | boolean | No | Por defecto true; un producto inactivo no se puede vender |
Productos, planes y enlaces de pago¶
| Si necesitas… | Usa… | Por qué |
|---|---|---|
| Un cobro único con descripción reutilizable | Producto + enlace de pago | Comparte una URL sin reconstruir la oferta |
| Una suscripción recurrente | Producto + plan | El plan añade monto, moneda e intervalo |
| Un checkout totalmente personalizado | Producto + sesión de checkout | Controlas la experiencia dentro de tu app |
Gestiona tu catálogo¶
- Lista productos con
GET /v1/productsy pagina conlimityoffset. - Desactiva un producto en lugar de eliminarlo para conservar el historial.
- Mantén nombres estables — aparecen en checkout, recibos y reportes.
Preguntas frecuentes¶
¿Puedo cambiar un producto después de crear un plan?
Sí. Puedes actualizar el nombre y la descripción. El precio vive en el plan, así que cambiar el monto no exige crear otro producto.
¿Los enlaces de pago requieren un producto?
No. Los enlaces de pago pueden crearse solo con descripción y monto. Los productos se recomiendan cuando quieres un catálogo reutilizable y reportes consistentes.
¿Qué pasa si desactivo un producto?
Los planes y enlaces existentes conservan su historial, pero los nuevos checkouts deben usar un producto activo.
Relacionado¶
¿Aún tienes dudas? Pregunta en Discord o explora los tutoriales.