Skip to main content

​
¿Qué es una Cuenta Bancaria?

Una cuenta bancaria es un método de pago registrado a nombre de un cliente. Permite recibir transferencias (dispersiones) o realizar débitos automáticos desde la cuenta del cliente.
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.

​
¿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
Recibir transferencias (dispersar)NoEnvía dinero a la cuenta con un cashout
Fintech as a ServiceNoEnvía dinero desde el saldo de un cliente a un tercero

​
Ejemplo rápido

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
  }'
Consulta los bancos disponibles con GET /accounts/banks antes de registrar una cuenta.

​
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

BancoTiempo de procesamientoNotas
AV VillasSiguiente día hábil
Banco AgrarioSiguiente día hábil
Banco Caja SocialSiguiente día hábil
Banco CompartirSiguiente día hábil
Banco Cooperativo CoopcentralSiguiente día hábil
Banco de BogotáSiguiente día hábil
Banco de OccidenteSiguiente día hábil
Banco FalabellaSiguiente día hábil
Banco PopularSiguiente día hábil
Banco SerfinanzaSiguiente día hábil
BancolombiaSiguiente día hábil
BancoomevaSiguiente día hábil
BBVASiguiente día hábil
CitibankSiguiente día hábil
DaviviendaSiguiente día hábil
GNB SudamerisSiguiente día hábil
ItaúSiguiente día hábil
NequiTiempo realRequiere intervención del usuario al conectar
Scotiabank ColpatriaSiguiente día hábil
DaviplataTiempo realRequiere intervención del usuario al conectar
Para vincular Nequi o Daviplata, consulta la guía de tokenización de cuentas.

​
Endpoints

MétodoEndpointDescripción
GET/accounts/banksListar bancos disponibles
POST/accountsRegistrar cuenta bancaria
GET/accountsListar cuentas bancarias
GET/accounts/Detalle de una cuenta
DELETE/accounts/Eliminar cuenta