Restofy Docs

Crear cuenta bancaria

POST /api/bank-accounts/create-bank-account

Descripción

Registra una cuenta bancaria nueva del restaurante.

Detalles

Crea la cuenta bancaria con su nombre y datos del banco. Solo el nombre es obligatorio; el banco, el número y el titular son opcionales. La cuenta nace activa y con saldo en cero.

Permisos requeridos

finance.module

Request

Nombre Tipo Requerido Reglas
name string
min:2 max:150
bankName string No
max:100
accountNumber string No
max:50
accountHolder string No
max:150
accountSubtype string No
in:checking,savings,credit default:checking

Ejemplo de request

curl -X POST https://app.restofy.co/api/bank-accounts/create-bank-account \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "name": "string"
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "name": "Nequi negocio 6a5788a8ac97c"
}

Response

{
    "success": true,
    "message": "Cuenta bancaria creada",
    "data": {
        "bankAccount": {
            "bankAccountId": 9104,
            "name": "Nequi negocio 6a5788a8ac97c",
            "bankName": null,
            "accountNumber": null,
            "accountHolder": null,
            "accountSubtype": "checking",
            "isActive": 1,
            "currentBalanceCents": 0
        }
    }
}