Usar productos y precios

Un producto describe qué vendes. Sus planes definen cómo cobras y sus precios especifican el importe en cada moneda. Elige un precio del catálogo para vender esa oferta mediante el checkout alojado.

Por ejemplo, un curso en línea es un producto. Puedes ofrecerlo como compra única o suscripción mensual, cada una con sus propios precios.

Antes de empezar

Configura el producto, sus planes y sus precios en el Panel de Pharos. Usa una clave de API de la empresa y el entorno donde está configurada la oferta. Tu backend necesita permiso de lectura para consultar el catálogo y de escritura para crear una sesión de checkout. Mantén la clave en tu servidor.

Entender productos, planes y precios

Producto: qué vendes

El producto identifica el bien o servicio: el nombre del curso, su descripción y si está activo. Un mismo curso puede tener varias opciones de pago sin convertirse en varios productos.

Plan: cómo cobras

Elige la opción que corresponde a tu oferta. Un plan de pago único cobra una vez. Un plan de suscripción define cobros recurrentes y cualquier período de prueba configurado. Un plan gratuito representa una oferta sin cargo.

Para el curso, elige el plan de pago único para una compra o el plan de suscripción mensual para acceso continuo. Estas opciones dependen de los planes que hayas configurado.

Precio: cuánto y en qué moneda

Cada plan puede tener precios en distintas monedas. Un precio en USD y otro en ARS son importes configurados por separado para la misma opción de pago. Solicitar una moneda no convierte el importe de la otra.

Elegir una oferta disponible

Empieza por consultar tus productos. Luego elige el plan de la compra y un precio en la moneda del cliente.

Usa un producto activo con un plan y un precio que no estén archivados. Una referencia de producto guardada puede devolver elementos inactivos o archivados. Encontrarla en el catálogo no confirma que esté disponible para una nueva compra.

Comprueba los planes y precios predeterminados antes de usarlos. Puede no haber uno configurado o quedar excluido por tus filtros de moneda o archivo. Elige una opción disponible que coincida con la oferta, sin seleccionar automáticamente el primer resultado.

Si el plan no tiene precio en la moneda solicitada, ofrece otra moneda configurada o muestra la oferta como no disponible. El importe del catálogo no es una cotización final: los descuentos configurados y las promociones aplicables al cliente o la tarjeta afectan el importe en checkout.

Llevar al cliente a checkout

Para una oferta reutilizable, usa un enlace de pago. Configura la oferta una vez y comparte su URL de checkout.

Para un carrito construido por tu aplicación, usa Cart Checkout. Tu backend envía el precio elegido al crear una sesión de checkout y lleva al cliente a la URL devuelta. Este flujo también admite precios en línea para importes contextuales fuera del catálogo.

Mantén una relación entre la oferta de tu aplicación y su producto, plan y precio en Pharos. Verifica el webhook de compra firmado antes de entregar la compra; una redirección exitosa por sí sola no confirma el pago.

Detalles de implementación

Consulta solicitudes, respuestas JSON, campos, consultas por lote, paginación y manejo de errores en la referencia de Productos.