> ## 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_KjbE0Vobf5Lg1yNZ4HoKawDItDs3Rod9VXNBWrEYmGn06tkesPIi" \
  -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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.