plan_.
Usa la API de Variants para crear variantes de productos, listar las variantes existentes, obtener o actualizar la configuración de una variante, calcular impuestos para el checkout y eliminar las variantes que ya no deban ofrecerse.
Endpoints
Atributos
Si los precios adaptativos están habilitados para esta variante. Configuración sin procesar: no comprueba la compatibilidad del procesador ni los feature flags.
Si se puede comprar más de una unidad en un pedido. Las variantes de renovación no pueden habilitarlo. Cuando es
false, los checkouts, carritos y facturas rechazan una cantidad superior a 1.Valores de atributos que distinguen esta variante dentro de su producto, como un mapa de nombre de atributo a valor, p. ej.
\{"color": "Blue", "size": "Large"}. Los nombres son identificadores en snake_case y se devuelven en orden alfabético. Todas las variantes con atributos de un producto tienen los mismos nombres de atributo y un conjunto distinto de valores; el producto lista el conjunto completo de opciones como variant_attributes. null cuando la variante no tiene atributos.Número de días entre cargos recurrentes, como 30 para mensual o 365 para anual.
null para variantes de pago único.Cuánto dura el descuento por cancelación:
0 para siempre, 1 solo el siguiente pago, o un número de meses naturales desde que el cliente lo acepta. null cuando no se ofrece ninguno o el actor no tiene el alcance plan:basic:read.Descuento por cancelación como porcentaje entero.
null cuando no se ofrece ninguno o el actor no tiene el alcance plan:basic:read.Estilo del checkout a nivel de variante (
background_color, button_color, font_family, border_style); null hereda el valor predeterminado de la cuenta.Si se cobran impuestos en las compras de esta variante, según la configuración fiscal de la cuenta.
Código ISO 4217 de tres letras, en minúsculas, de la divisa en la que se expresa cada precio de esta variante: la divisa propia de la variante, o la
presentment_currency que pidió la lectura cuando la variante se puede convertir a ella.Campos de entrada personalizados recopilados en el formulario del checkout.
Propiedades
Propiedades
Texto de marcador de posición que se muestra en el campo vacío.
null si no se ha establecido ninguno.Si la variante se puede eliminar (no tiene membresías ni entradas en la lista de espera).
null a menos que el actor tenga el alcance plan:basic:read en la cuenta de la variante.Descripción de la variante visible para el cliente. Máximo 1000 caracteres.
null si no se ha establecido ninguna descripción.La configuración que rige un checkout para esta variante, resuelta a través de todas las capas (la de la propia variante y la de la cuenta): la forma que tiene el
payment_method_configuration de una sesión. Aplícala sobre el catálogo de tipos de métodos de pago para obtener el conjunto ofrecible. null significa los valores predeterminados de la plataforma; payment_method_configuration sigue siendo la anulación editable propia de la variante.Propiedades
Propiedades
Métodos de pago que este checkout excluye, incluso cuando los valores predeterminados los ofrecerían.
Métodos de pago que este checkout ofrece además de los que proporcionan los valores predeterminados.
Duración del acceso en días para variantes con caducidad, como 365 para un pase de un año.
null para variantes sin caducidad.Imagen del nivel de precios (
url, blurhash) que se muestra en la página del producto; null cuando no se ha establecido ninguna imagen.Total cobrado en el checkout por una unidad, antes de códigos promocionales e impuestos:
initial_price más el primer renewal_price para variantes recurrentes, o solo initial_price mientras se aplica una prueba gratuita. La prueba no se aplica cuando el usuario que la ve ya ha usado una para esta variante. Expresado en currency.Propiedades
Propiedades
El importe en unidades principales, como cadena decimal exacta. Por ejemplo,
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
Notas privadas que no se muestran a los clientes.
null a menos que el actor tenga el alcance plan:basic:read en la cuenta de la variante.Factura para la que se generó esta variante;
null a menos que se haya creado para una factura.Membresías activas a través de esta variante.
null a menos que el actor tenga el alcance plan:basic:read en la cuenta de la variante.Pares clave-valor personalizados almacenados en la variante. Se incluyen en los payloads de webhook de los eventos de pagos y membresías. Máximo 50 claves, 100 caracteres por clave y 500 caracteres por valor. Las claves reservadas
custom_cta y custom_cta_url, cuando se establecen, anulan la llamada a la acción del checkout del producto para esta variante.Si se ofrece un descuento por cancelación.
null a menos que el actor tenga el alcance plan:basic:read en la cuenta de la variante.Configuración de métodos de pago (
enabled, disabled, include_platform_defaults); null cuando la variante usa la configuración predeterminada.Adónde se envía al cliente después de pagar esta variante.
null cuando no se ha establecido ninguna, o a menos que el actor tenga el alcance plan:basic:read en la cuenta de la variante.Stock keeping unit (SKU), texto libre establecido por el vendedor (p. ej.
TSHIRT-LARGE-BLUE). No se exige que sea único. null cuando no está establecido.Pagos a plazos requeridos antes de que la suscripción se pause. Debe ser mayor que 1.
null si el pago fraccionado no está configurado.Unidades disponibles para la compra.
null a menos que el actor tenga el alcance plan:basic:read en la cuenta de la variante.Precio inicial original mostrado tachado, en
currency. null cuando no se ha establecido un precio tachado.Precio de renovación original mostrado tachado, en
currency. null cuando no se ha establecido un precio tachado.Cómo se gestionan los impuestos para esta variante, incluido si el impuesto está incluido en el precio, se añade en el checkout o no está configurado.Opciones disponibles:
inclusive, exclusive, unspecifiedComportamiento de 3D Secure para pagos con tarjeta compatibles en sesión.
mandate_challenge exige un desafío 3DS antes de procesar el pago; mandate_if_required exige un desafío solo cuando el procesador de pagos lo requiere; frictionless_if_required usa el flujo 3DS sin fricción habitual. Los pagos de $1,000 o más usan mandate_if_required a menos que se seleccione mandate_challenge. Los requisitos de riesgo y de recuperación de autenticación pueden anular la preferencia. null hereda el valor predeterminado de la cuenta.Opciones disponibles: mandate_challenge, mandate_if_required, frictionless_if_requiredNombre visible de la variante que se muestra a los clientes. Máximo 30 caracteres. Una variante creada sin nombre usa por defecto sus valores de atributo unidos con
/. null si no se ha establecido ningún título.Días de prueba gratuita antes del primer cargo de renovación.
null si no hay prueba configurada o el usuario ya ha usado una prueba para esta variante.Si la variante tiene stock ilimitado. Cuando es
true, se ignora el campo stock; las variantes de lista de espera siempre informan true.Número de facturas emitidas para esta variante que no están pagadas ni anuladas. Mientras sea mayor que
0, no puedes cambiar los precios, el periodo de facturación, la prueba, el número de pagos, la divisa ni el tipo de facturación de la variante. null a menos que el actor tenga el alcance plan:basic:read en la cuenta de la variante.Variant

