Configuración comercial

Programas, programas externos, talleres y checkouts comparten el mismo objeto commercial. Si cambias la configuración comercial de un producto ya publicado, el cambio queda en un borrador y se aplica al volver a publicar (crea una nueva versión).

"commercial": {
  "base_currency": "USD",
  "dcc": { "enabled": true, "base_country": null },
  "pricing": [
    { "currency": "USD", "value": 99.0 },
    { "currency": "COP", "value": 400000 }
  ],
  "installment_plan": {
    "enabled": true,
    "counts": [3, 6]
  },
  "subscription_plans": []
}

Campos

Consulta las monedas soportadas en cualquier momento con GET /reference/currencies.

Pago único vs. suscripción

Un producto o checkout vende o un pago único (precio + cuotas opcionales) o una lista de planes de suscripción. No se pueden combinar.

Planes de suscripción

"subscription_plans": [
  {
    "name": "Mensual",
    "description": "Acceso completo, cancela cuando quieras",
    "recurrence": { "unit": "MONTH", "count": 1 },
    "price": 29.0,
    "initial_price": 9.0,
    "trial_days": 7
  }
]

Frecuencias soportadas:

Cualquier otra combinación se rechaza (nunca se redondea a la más cercana). GET /reference/recurrences devuelve los nombres de estas frecuencias (DAILY, WEEKLY, MONTHLY, QUARTERLY, SEMIANNUAL, ANNUAL); en el request se envían como { unit, count }.

Notas

• La tasa de interés de las cuotas no se configura por la API: se ajusta desde el Hub. Si actualizas installment_plan por la API, se mantiene la tasa que ya tenía el producto.
• Los campos installment_plan.plan y installment_plan.credit_card_enabled se aceptan pero todavía no tienen efecto.