---
title: "Crear un medio de pago manual del PDV"
method: POST
path: "/ecommerce/stores/{storeId}/configuration/payment-methods"
---

# Crear un medio de pago manual del PDV

`POST /ecommerce/stores/{storeId}/configuration/payment-methods`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/ecommerce/stores/{storeId}/configuration/payment-methods`
- Auth: none declared

Crea un medio de pago manual con nombre y tipo. No conecta proveedores ni cobra dinero. Las opciones adicionales se modifican con PUT al medio creado. Requiere una conexión con usuario; un token de integración sin usuario devuelve userRequired. Se aplican los permisos del usuario conectado y las mismas validaciones que en el administrador. Si el local replica esta configuración a locales hijos, el cambio también se aplica allí, como en el PDV. La conexión debe tener acceso a todos los locales afectados. Conserva el registro de auditoría bajo el usuario conectado.

## Path parameters

- `storeId` string, required

## Request body

- ApiConfigurationPaymentCreate: Crea un medio de pago manual. No conecta proveedores ni configura credenciales.
  - `name` string, nullable, required: Nombre visible del medio de pago.
  - `paymentType` 'cash' | 'debitCard' | 'creditCard' | 'transfer' | 'other', required: Clasificación del medio de pago para el PDV.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` ApiConfigurationPayment: Medio de pago del PDV, sin credenciales de proveedores.
    - `_id` string, nullable: ID Justo del recurso.
    - `websiteId` string, nullable: ID de la marca autorizada.
    - `storeId` string, nullable: ID del local autorizado.
    - `name` string, nullable: Nombre visible del medio de pago.
    - `paymentType` 'cash' | 'debitCard' | 'creditCard' | 'transfer' | 'other': Clasificación del medio de pago para el PDV.
    - `disabled` boolean, nullable: Deshabilita temporalmente el medio de pago sin eliminarlo.
    - `isCash` boolean, nullable: Lo trata como efectivo y permite movimientos de caja.
    - `shouldMakeInvoice` boolean, nullable: Incluye los pagos en el monto facturable.
    - `omitFromShiftBalance` boolean, nullable: Excluye el medio de pago de la cuadratura del cierre de caja.
    - `openCashDrawerAtPrinterId` string, nullable: ID Justo de una impresora del mismo local; null desactiva la apertura de gaveta.
    - `allowedOnlyForRoles` string[], nullable: Roles autorizados para usar el medio. Los roles personalizados usan custom:<código>.
    - `schedule` object: Horario del medio de pago, en la zona horaria del local.
      - `timezone` string, nullable: Zona horaria IANA usada por el horario, por ejemplo America/Santiago.
      - `availableAtPeriods` boolean, nullable: Restringe el medio de pago a los periodos indicados.
      - `closedUntilDate` string, date-time, nullable: Cierre temporal hasta esta fecha; null lo elimina.
      - `closedDays` string[], nullable: Días cerrados en formato ISO 8601.
      - `openPeriods` object[], nullable: Periodos semanales; reemplaza la lista actual.
        - `daysOfWeek` integer[], required: Días de la semana: 1 lunes a 7 domingo.
        - `fromMinute` number, nullable, required: Minutos desde medianoche al inicio.
        - `toMinute` number, nullable, required: Minutos desde medianoche al término.
      - `specialPeriods` object[], nullable: Periodos por fecha; reemplaza la lista actual.
        - `days` string[], required: Fechas ISO 8601 en que aplica.
        - `fromMinute` number, nullable, required: Minutos desde medianoche al inicio.
        - `toMinute` number, nullable, required: Minutos desde medianoche al término.
    - `fromParentId` string, nullable: Medio de pago de origen cuando fue replicado desde un local padre.
    - `externalId` string, nullable: Identificador de la integración que administra este medio de pago.
    - `digitalProvider` object: Proveedor digital asociado.
      - `providerId` string, nullable: Identificador del proveedor.

## Other responses

- `400`: Errors

## Changes

- **2026-10-31** `4ad06bd631ce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/ecommerce/stores/:storeId/configuration/payment-methods/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)