Actualizar cuenta de pago

Reemplaza los datos de una cuenta de pago. Las cotizaciones ya creadas no cambian: guardan su copia. Token de usuario (`user_sk_…`). La empresa va en la ruta por su UUID.

PATCHhttps://api.facturalo.pe/api/v3/empresas/{uuid}/cuentas-pago/{id}

Parámetros del request

Campo

Descripción

cuenta

objectrequerido

Datos de la cuenta.

tipo

stringrequerido

BANCO o BILLETERA.Ej: BANCO

entidad

stringrequerido

Banco, caja o billetera (máx. 60): BCP, BBVA, INTERBANK, SCOTIABANK, BANCO DE LA NACION, YAPE, PLIN… Se guarda en mayúsculas.Ej: BCP

moneda

stringopcional

PEN o USD. Obligatoria en BANCO; en billeteras siempre PEN.Ej: PEN

numero

stringrequerido

BANCO: número de cuenta (dígitos, guiones y espacios, máx. 30). BILLETERA: celular de 9 dígitos que empieza con 9.Ej: 191-1234567-0-12

cci

string | nullopcional

Código de cuenta interbancario, 20 dígitos. Solo BANCO.Ej: 00219100123456701254

titular

string | nullopcional

Titular o "a nombre de" (máx. 200).Ej: EMPRESA DEMO S.A.C.

descripcion

string | nullopcional

Por ejemplo "Cuenta corriente" (máx. 100).Ej: Cuenta corriente

enCotizaciones

booleanopcional

Marcada por defecto en cotizaciones nuevas. Default true.Ej: true

Language

Credentials

Header

Authorization

Token de la empresa · HTTP directo

Fetch Request

$ # Node 18+ fetch

const response = await fetch("https://api.facturalo.pe/api/v3/empresas/mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3/cuentas-pago/mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3", {
  method: "PATCH",
  headers: {
    "Authorization": "sk_test_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "cuenta": {
      "tipo": "BANCO",
      "entidad": "BCP",
      "moneda": "PEN",
      "numero": "191-1234567-0-12",
      "cci": "00219100123456701254",
      "titular": "EMPRESA DEMO S.A.C.",
      "descripcion": "Cuenta corriente",
      "enCotizaciones": false
    }
  })
});

const data = await response.json();
console.log(data);

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Cuenta actualizada.",
  "data": {
    "cuenta": {
      "id": "a32ef8b1-b485-43e8-af6b-a744e01857a0",
      "tipo": "BANCO",
      "entidad": "BCP",
      "moneda": "PEN",
      "numero": "191-1234567-0-12",
      "cci": "00219100123456701254",
      "titular": "EMPRESA DEMO S.A.C.",
      "descripcion": "Cuenta corriente",
      "enCotizaciones": false,
      "orden": 1
    }
  }
}