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:
403si el usuario no es administrador.404si el código no existe (o es una condición reservada del sistema, que no se administra por la API).422si falta el archivo, no es una imagen permitida o pesa más de 1 MB.401sin 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.