Cuentas bancarias
POST
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 | Sí |
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
}
}
}