---
title: "Crear"
method: POST
path: "/financial_accounts"
tags: ["Financial Accounts"]
---

# Crear

`POST /financial_accounts`

## Request

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

Crea una nueva cuenta para un cliente bajo un programa. Debes indicar `customer_id` o `customer_email` (si el cliente no existe, se crea y se asocia al comercio). La moneda se hereda del programa y solo puede existir una cuenta por cliente y programa.

## Request body

- object
  - `program_id` string, required: ID del `Program` bajo el cual se crea la cuenta.
  - `customer_id` string: ID del `Customer` titular de la cuenta.
  - `customer_email` string: Email del cliente titular. Alternativa a `customer_id`; crea el cliente si no existe.
  - `credit_limit` integer: Límite de crédito de la cuenta en unidades menores. Por defecto usa el límite por defecto del programa. No puede superar el máximo del programa.
  - `metadata` string, json: Pares clave-valor con información adicional de la cuenta. 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)