Saltar al contenido
Facturador

Subir logotipo del método de pago

POST /api/payment-method-types/{payment_method_type_id}/logo

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Sube el logotipo oficial de la marca del método (se muestra al cobrar). Reemplaza el anterior. Si un método no tiene logo, el sistema muestra sus iniciales (initials) sobre monogram_color.

Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.

Formato de respuesta: estándar {success, data, message?} (registro único). data es el método actualizado, con logo_url.

Parámetros de la ruta:

Campo Tipo Obligatorio Descripción / valores permitidos
payment_method_type_id string Sí Código del método.

Cuerpo (multipart/form-data):

Campo Tipo Obligatorio Descripción / valores permitidos
file archivo Sí Imagen jpeg, jpg, png, svg o webp, máximo 1 MB.

Errores:

  • 403 si el usuario no es administrador.
  • 404 si el código no existe (o es una condición reservada del sistema, que no se administra por la API).
  • 422 si falta el archivo, no es una imagen permitida o pesa más de 1 MB.
  • 401 sin token o con un token inválido.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
payment_method_type_id ruta sí 13

Cuerpo

Content-Type: multipart/form-data

Campo Tipo Obligatorio Ejemplo Descripción
file archivo sí Logotipo (jpeg, png, svg o webp, máx. 1 MB).

Respuestas

200 — Logotipo actualizado

{
  "success": true,
  "data": {
    "id": "21",
    "description": "Plin",
    "sort_order": 140,
    "is_active": true,
    "is_credit": false,
    "number_days": 0,
    "has_card": false,
    "charge": 0.0,
    "is_payment_medium": true,
    "goes_to_cash_drawer": false,
    "use_for_income": true,
    "use_for_expense": true,
    "destination_rule": "account:5",
    "default_destination_id": 5,
    "allowed_destination_type": null,
    "destination_label": "PLIN TIENDA CENTRO",
    "uses_label": "Cobros y pagos",
    "has_no_use": false,
    "can_delete": true,
    "logo_url": "https://empresa.dominio/logo/payment-methods/plin-21.png",
    "initials": "PL",
    "monogram_color": "#155e75"
  },
  "message": "Logotipo actualizado"
}

422 — Sin archivo

{
  "success": false,
  "message": {
    "file": [
      "El campo file es obligatorio."
    ]
  }
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.