> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Gestiona las cuentas bancarias inscritas de tus clientes.

## ¿Qué es una Cuenta Bancaria?

Una cuenta bancaria es un método de pago registrado a nombre de un [cliente](/client/customers/index). Permite recibir transferencias (dispersiones) o realizar débitos automáticos desde la cuenta del cliente.

<Warning>
  Para todos los casos, los datos de **número de cuenta**, **tipo de cuenta** y **tipo de documento** deben coincidir exactamente con los registros del banco. Datos incorrectos causarán rechazo de la transacción.
</Warning>

## ¿Para qué se usa?

| Caso de uso                        | ¿Necesitas `authorization`? | Descripción                                                        |
| ---------------------------------- | --------------------------- | ------------------------------------------------------------------ |
| Débito automático (cobrar)         | Sí (`true`)                 | Debita la cuenta del cliente con un [cargo](/client/charges/index) |
| Recibir transferencias (dispersar) | No                          | Envía dinero a la cuenta con un [cashout](/client/cashouts/index)  |
| Fintech as a Service               | No                          | Envía dinero desde el saldo de un cliente a un tercero             |

## Ejemplo rápido

```bash theme={null}
curl https://api.onepay.la/v1/accounts \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: cuenta-001" \
  -d '{
    "customer_id": "CUSTOMER_ID",
    "bank_id": "BANK_ID",
    "subtype": "SAVINGS",
    "account_number": "123456789",
    "authorization": true
  }'
```

<Note>
  Consulta los bancos disponibles con `GET /accounts/banks` antes de registrar una cuenta.
</Note>

## Autorización para débitos

Si necesitas **cobrar** desde la cuenta (crear cargos), debes registrarla con `"authorization": true`. Sin este campo, la cuenta solo servirá para recibir transferencias.

El cliente recibirá una notificación de su banco confirmando la autorización.

## Bancos disponibles para débitos

| Banco                         | Tiempo de procesamiento | Notas                                         |
| ----------------------------- | ----------------------- | --------------------------------------------- |
| AV Villas                     | Siguiente día hábil     |                                               |
| Banco Agrario                 | Siguiente día hábil     |                                               |
| Banco Caja Social             | Siguiente día hábil     |                                               |
| Banco Compartir               | Siguiente día hábil     |                                               |
| Banco Cooperativo Coopcentral | Siguiente día hábil     |                                               |
| Banco de Bogotá               | Siguiente día hábil     |                                               |
| Banco de Occidente            | Siguiente día hábil     |                                               |
| Banco Falabella               | Siguiente día hábil     |                                               |
| Banco Popular                 | Siguiente día hábil     |                                               |
| Banco Serfinanza              | Siguiente día hábil     |                                               |
| Bancolombia                   | Siguiente día hábil     |                                               |
| Bancoomeva                    | Siguiente día hábil     |                                               |
| BBVA                          | Siguiente día hábil     |                                               |
| Citibank                      | Siguiente día hábil     |                                               |
| Davivienda                    | Siguiente día hábil     |                                               |
| GNB Sudameris                 | Siguiente día hábil     |                                               |
| Itaú                          | Siguiente día hábil     |                                               |
| Nequi                         | Tiempo real             | Requiere intervención del usuario al conectar |
| Scotiabank Colpatria          | Siguiente día hábil     |                                               |
| Daviplata                     | Tiempo real             | Requiere intervención del usuario al conectar |

<Note>
  Para vincular Nequi o Daviplata, consulta la guía de [tokenización de cuentas](/client/use-cases/tokenizar-cuentas).
</Note>

## Endpoints

| Método   | Endpoint                 | Descripción               |
| -------- | ------------------------ | ------------------------- |
| `GET`    | /accounts/banks          | Listar bancos disponibles |
| `POST`   | [/accounts](create)      | Registrar cuenta bancaria |
| `GET`    | [/accounts](list)        | Listar cuentas bancarias  |
| `GET`    | [/accounts/{id}](detail) | Detalle de una cuenta     |
| `DELETE` | [/accounts/{id}](delete) | Eliminar cuenta           |