Saltar al contenido principal
Commet tiene estas capas de precios complementarias: Currency Pricing sigue siendo el fallback. Agrega Markets cuando necesites segmentación por país o variantes seleccionables.

Configurar precios por moneda

Con solo currency y exchangeRate, Commet deriva cada precio, balance incluido y overage de los valores en USD. Envía prices o features para fijar montos exactos. Cada cambio publica una nueva versión del plan; los suscriptores existentes conservan la suya hasta que los muevas. Monedas soportadas: USD, ARS, BOB, BRL, CAD, CLP, CNY, COP, EUR, GBP, HKD, INR, JPY, KRW, MXN, PEN, PYG, SGD, THB, TWD y UYU. Una moneda aplica a los países que la usan. Los compradores del Reino Unido pagan en GBP, y EUR cubre los países del euro. Los compradores de un país sin moneda configurada pagan el precio base en USD.

Configurar precios por país

En el dashboard, la pestaña Regional prices del plan configura precios país por país en un borrador:
  1. Elige Add a country y la moneda en la que paga, USD incluido.
  2. Define cada precio By hand, o sigue la base en USD a un tipo de cambio.
  3. Define de la misma forma los precios del país para los add-ons y packs de créditos que vende el plan.
Publicar el borrador publica todos los países juntos en una versión del plan. Un país al que le falta un precio bloquea la publicación. Con la API, el bloque countries de PATCH /plans/{id}/drafts/{draftId} define los mismos términos. Un suscriptor paga los precios de su propio país en su versión; un comprador de un país que la versión no lista paga el precio base en USD. Un movimiento a otra versión conserva la moneda de una suscripción, y una versión que no la vende no puede recibir la suscripción, salvo que el movimiento le cobre en USD desde su próxima renovación (ver Mover suscriptores). Lo mismo aplica cuando una suscripción cancelada se reactiva en la última versión de lo que se compró: si esa versión no vende su moneda, la reactivación devuelve 422 missing_regional_price.

Crear un Market

Un Market es un recurso de Sales de primer nivel. No requiere un plan ni un precio.
Un país puede pertenecer a un solo Market activo. Las rutas REST de v9 son /markets y /markets/{id}.

Agregar precios de Market

El monto base sigue siendo el fallback para todos los países sin override de Market.
En checkout, Commet resuelve el Market a partir del país de la solicitud. El checkout de Sandbox permite cambiar Country para probar otro Market; el checkout live ignora ese override.

Variantes seleccionables

Una variante hereda un precio base y solo reemplaza Markets ya configurados en esa base:
Envía priceId solamente cuando el customer elige deliberadamente esa variante:
Omitir priceId conserva la resolución normal del precio por defecto y Market.

Renovación y archivado

  • La suscripción guarda la identidad del precio seleccionado y su versión del plan.
  • Las renovaciones usan el precio de la versión del plan de la suscripción. Los precios de Market no tienen versión: las renovaciones usan el valor actual del precio de Market.
  • Un movimiento de versión conserva el precio de Market del suscriptor, y un borrador no puede quitar una moneda que usa un precio de Market.
  • Una variante hereda todos los Markets que no reemplaza.
  • Archivar un precio impide nuevas selecciones sin romper suscripciones existentes.
  • Un Market referenciado no puede eliminarse.
Las fases aceptadas de una Offer son un snapshot inmutable separado; el precio seleccionado del catálogo sigue siendo editable.

Compatibilidad con v8

La API 2026-07-24 y el SDK v8 conservan /pricing/market-groups y commet.pricing.*. La API 2026-07-31 y el SDK v9 usan la superficie de Markets de primer nivel.