---
title: "Crear o actualizar un método de pago"
method: POST
path: "/paymentMethods"
tags: ["Métodos de Pago"]
---

# Crear o actualizar un método de pago

`POST /paymentMethods`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/paymentMethods`
- Auth: HTTP bearer

Crea un nuevo método de pago o actualiza uno existente en el negocio del usuario autenticado.

- Si el body **no incluye `_id`**, se **crea** un nuevo método de pago.
- Si el body **incluye `_id`**, se **actualiza** el método de pago existente con ese ID.

**Permisos requeridos:** `BU_POST`

**Autenticación requerida:** Este endpoint requiere autenticación Bearer Token.
Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header:
`Authorization: Bearer {tokenCurrent}`

## Headers

- `Authorization` string, required

## Request body

- PaymentMethodInput: Datos para crear o actualizar un método de pago. Si se incluye `_id` se actualiza el existente; si no, se crea uno nuevo.
  - `_id` string: ID del método de pago. Incluir para actualizar un registro existente.
  - `name` string, required: Nombre del método de pago (requerido)
  - `externalIntegration` object: Configuración opcional de integración con sistemas externos
    - `loggro` object
      - `id` string
      - `bankAccount` object
        - `id` string
        - `accountNumber` string
        - `accountName` string
    - `siigo` object
      - `id` number
    - `DIAN` object
      - `id` string
    - `credibanco` object
      - `isActive` boolean
    - `bold` object
      - `name` string
      - `isActive` string

## Response `200`

Método de pago creado o actualizado exitosamente

- PaymentMethod: Modelo de método de pago del negocio
  - `_id` string: ID único del método de pago (ObjectId de MongoDB)
  - `business` string: ID del negocio al que pertenece el método de pago
  - `name` string: Nombre del método de pago
  - `deleted` boolean: Indica si el registro fue eliminado lógicamente (soft delete)
  - `modifiedOn` string, date-time: Fecha de última modificación
  - `createdOn` string, date-time: Fecha de creación del registro
  - `externalIntegration` object: Configuración de integración con sistemas externos de facturación y pago
    - `loggro` object: Integración con Loggro
      - `id` string: ID del método en Loggro
      - `bankAccount` object: Cuenta bancaria asociada en Loggro
        - `id` string: ID de la cuenta bancaria
        - `accountNumber` string: Número de cuenta bancaria
        - `accountName` string: Nombre de la cuenta bancaria
    - `loggroEnterprise` object: Integración con Loggro Enterprise
      - `bankAccount` string: ID de cuenta bancaria en Loggro Enterprise
      - `code` string: Código del método en Loggro Enterprise
    - `siigo` object: Integración con Siigo
      - `id` number: ID numérico del método en Siigo
    - `DIAN` object: Integración con DIAN (Dirección de Impuestos y Aduanas Nacionales)
      - `id` string: Código del método de pago en DIAN
    - `credibanco` object: Integración con Credibanco
      - `isActive` boolean: Indica si está activo en Credibanco
    - `bold` object: Integración con Bold (pasarela de pagos)
      - `name` string: Nombre del método en Bold
      - `isActive` string: Estado del método en Bold

## Other responses

- `401`: No autorizado - Token JWT requerido o permisos insuficientes
- `500`: Error interno del servidor

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)