---
title: "Crear"
method: POST
path: "/programs"
tags: ["Programs"]
---

# Crear

`POST /programs`

## Request

- Base URL: `https://api.ventipay.com/v1`
- URL: `https://api.ventipay.com/v1/programs`
- Auth: HTTP bearer

Crea un nuevo objeto `Program`.

## Request body

- object
  - `name` string, required: Nombre interno del programa. El cliente solo lo verá si no se define `description`.
  - `description` string: Nombre del programa visible para el cliente al pagar. Si no se define, el cliente verá `name`.
  - `currency` string, required: Moneda de las cuentas del programa (ej: `clp`).
  - `default_credit_limit` integer, required: Límite de crédito por defecto para nuevas cuentas, en unidades menores.
  - `max_credit_limit` integer, required: Límite de crédito máximo permitido para una cuenta, en unidades menores.
  - `billing_cycle_days` integer: Días del ciclo de facturación. Por defecto: 30. Se ignora si se define `billing_anchor`.
  - `billing_anchor` string: Día del mes en que cierra el ciclo (`1` a `31`) o `nearest`. Si se define, el ciclo es mensual anclado a ese día.
  - `grace_period_days` integer: Días de gracia entre el cierre del ciclo y el vencimiento del estado de cuenta. Por defecto: 5.
  - `min_payment_type` 'full' | 'percentage' | 'fixed': Cómo se calcula el pago mínimo del estado de cuenta. Por defecto: `full`.
  - `min_payment_percentage` number: Porcentaje del total adeudado para el pago mínimo (solo con `min_payment_type: percentage`).
  - `min_payment_fixed_amount` integer: Monto fijo del pago mínimo en unidades menores (solo con `min_payment_type: fixed`).
  - `metadata` string, json: Pares clave-valor con información adicional del programa. No es visible para el cliente.

---

[API](https://skmtc.dev/ventipay/apis/cuentas-venti.md) - [All operations](https://skmtc.dev/ventipay/apis/cuentas-venti/llms.txt) - [OpenAPI document](https://skmtc.dev/ventipay/apis/cuentas-venti/revisions/28cc24151d4a?raw)