Saltearse al contenido
Nappai Documentation

Stripe Price

Stripe Price gestiona los precios de tus productos en Stripe. Un precio dice cuánto cuesta un producto y si se paga una sola vez o de forma periódica, por ejemplo 49,00 € una vez o 9,90 € al mes. Un mismo producto puede tener varios precios, por ejemplo en distintas monedas o con distinta periodicidad.

Las suscripciones de Stripe Subscription necesitan un precio periódico.

Cuándo usarlo

  • Das de alta un producto nuevo y quieres crear su precio desde el mismo flujo.
  • Quieres ofrecer un producto con pago mensual y otro precio con pago anual.
  • Vendes en varios países y quieres un precio por cada moneda.
  • Quieres consultar los precios que tienes en Stripe para mostrarlos en tu web o en un catálogo.

Configuración

Necesitas una credencial Stripe API con la clave secreta de tu cuenta de Stripe. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Stripe API de tu cuenta.
Operation (obligatorio)La acción que realiza el componente. Por defecto, Create. Consulta Operaciones.
ModeSolo en Get. By ID consulta un precio concreto; All devuelve la lista de precios. Por defecto, By ID.
Price IDEl identificador del precio en Stripe (empieza por price_). Obligatorio en Get con By ID.
AmountSolo en Create. El importe por unidad en la unidad más pequeña de la moneda, por ejemplo céntimos: 990 son 9,90.
CurrencySolo en Create, y obligatorio en ella. La moneda del precio, como eur o usd. Por defecto, usd.
Product IDSolo en Create, y obligatorio en ella. El producto de Stripe al que pertenece el precio (empieza por prod_).
TypeSolo en Create. one_time para un pago único o recurring para un pago periódico. Por defecto, one_time.
Billing IntervalSolo en Create. Cada cuánto se cobra un precio periódico: day, week, month o year. Obligatorio cuando Type es recurring.
LimitSolo en Get con All. Número máximo de precios que se devuelven, entre 1 y 100. Por defecto, 100.

Operaciones

  • Create: crea un precio para un producto.
  • Get: con By ID devuelve un precio; con All devuelve la lista de precios.

Resultado

La salida Data devuelve el precio creado o consultado. Con Get y All, devuelve un elemento por cada precio. Cada elemento incluye el identificador del precio, el producto, el importe, la moneda y, si es periódico, su intervalo.

Puedes conectarla a Stripe Subscription para suscribir clientes a ese precio o a tu catálogo. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.

Ejemplo

Una app de recetas ofrece su plan premium con pago mensual.

  1. Crea el producto “Premium” con Stripe Product.
  2. Añade Stripe Price con Operation en Create y pasa el identificador del producto a Product ID.
  3. Pon Amount en 499, Currency en eur, Type en recurring y Billing Interval en month.
  4. Guarda el identificador del precio: es el que usarás en Price ID de Stripe Subscription.

Componentes relacionados