Crear cuenta de pago

Agrega una cuenta bancaria o una billetera digital a la empresa (hasta 20). Token de usuario (`user_sk_…`). La empresa va en la ruta por su UUID.

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

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

Billetera digitaljson

{
  "cuenta": {
    "tipo": "BILLETERA",
    "entidad": "YAPE",
    "numero": "987654321",
    "titular": "Juan Pérez"
  }
}

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", {
  method: "POST",
  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": true
    }
  })
});

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

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

201Created

{
  "success": true,
  "message": "Cuenta agregada.",
  "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": true,
      "orden": 1
    }
  }
}