> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear un medio de pago manual del PDV

> 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.



## OpenAPI

````yaml post /ecommerce/stores/{storeId}/configuration/payment-methods
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /ecommerce/stores/{storeId}/configuration/payment-methods:
    post:
      summary: Crear un medio de pago manual del PDV
      description: >-
        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.
      parameters:
        - in: path
          name: storeId
          required: true
          schema:
            type: string
          description: >-
            ID Justo o ID externo de un local de GET /ecommerce/stores, dentro
            de la autorización.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/apiConfigurationPaymentCreate'
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/apiConfigurationPayment'
        '400':
          description: Errors
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: 'false'
                  error:
                    type: object
                    properties:
                      error:
                        type: string
                        example: error
                      message:
                        type: string
                        example: The request has an error
components:
  schemas:
    apiConfigurationPaymentCreate:
      type: object
      description: >-
        Crea un medio de pago manual. No conecta proveedores ni configura
        credenciales.
      additionalProperties: false
      properties:
        name:
          type:
            - string
            - 'null'
          description: Nombre visible del medio de pago.
        paymentType:
          type: string
          enum:
            - cash
            - debitCard
            - creditCard
            - transfer
            - other
          description: Clasificación del medio de pago para el PDV.
      required:
        - name
        - paymentType
      example:
        name: Transferencia bancaria
        paymentType: transfer
    apiConfigurationPayment:
      type: object
      description: Medio de pago del PDV, sin credenciales de proveedores.
      additionalProperties: false
      properties:
        _id:
          type:
            - string
            - 'null'
          description: ID Justo del recurso.
        websiteId:
          type:
            - string
            - 'null'
          description: ID de la marca autorizada.
        storeId:
          type:
            - string
            - 'null'
          description: ID del local autorizado.
        name:
          type:
            - string
            - 'null'
          description: Nombre visible del medio de pago.
        paymentType:
          type: string
          enum:
            - cash
            - debitCard
            - creditCard
            - transfer
            - other
          description: Clasificación del medio de pago para el PDV.
        disabled:
          type:
            - boolean
            - 'null'
          description: Deshabilita temporalmente el medio de pago sin eliminarlo.
        isCash:
          type:
            - boolean
            - 'null'
          description: Lo trata como efectivo y permite movimientos de caja.
        shouldMakeInvoice:
          type:
            - boolean
            - 'null'
          description: Incluye los pagos en el monto facturable.
        omitFromShiftBalance:
          type:
            - boolean
            - 'null'
          description: Excluye el medio de pago de la cuadratura del cierre de caja.
        openCashDrawerAtPrinterId:
          type:
            - string
            - 'null'
          description: >-
            ID Justo de una impresora del mismo local; null desactiva la
            apertura de gaveta.
        allowedOnlyForRoles:
          type:
            - array
            - 'null'
          description: >-
            Roles autorizados para usar el medio. Los roles personalizados usan
            custom:<código>.
          items:
            type: string
        schedule:
          type: object
          description: Horario del medio de pago, en la zona horaria del local.
          additionalProperties: false
          properties:
            timezone:
              type:
                - string
                - 'null'
              description: >-
                Zona horaria IANA usada por el horario, por ejemplo
                America/Santiago.
            availableAtPeriods:
              type:
                - boolean
                - 'null'
              description: Restringe el medio de pago a los periodos indicados.
            closedUntilDate:
              type:
                - string
                - 'null'
              description: Cierre temporal hasta esta fecha; null lo elimina.
              format: date-time
            closedDays:
              type:
                - array
                - 'null'
              description: Días cerrados en formato ISO 8601.
              items:
                type: string
                format: date-time
            openPeriods:
              type:
                - array
                - 'null'
              description: Periodos semanales; reemplaza la lista actual.
              items:
                type: object
                description: Periodo semanal.
                additionalProperties: false
                properties:
                  daysOfWeek:
                    type: array
                    description: 'Días de la semana: 1 lunes a 7 domingo.'
                    items:
                      type: integer
                  fromMinute:
                    type:
                      - number
                      - 'null'
                    description: Minutos desde medianoche al inicio.
                  toMinute:
                    type:
                      - number
                      - 'null'
                    description: Minutos desde medianoche al término.
                required:
                  - daysOfWeek
                  - fromMinute
                  - toMinute
            specialPeriods:
              type:
                - array
                - 'null'
              description: Periodos por fecha; reemplaza la lista actual.
              items:
                type: object
                description: Periodo especial.
                additionalProperties: false
                properties:
                  days:
                    type: array
                    description: Fechas ISO 8601 en que aplica.
                    items:
                      type: string
                      format: date-time
                  fromMinute:
                    type:
                      - number
                      - 'null'
                    description: Minutos desde medianoche al inicio.
                  toMinute:
                    type:
                      - number
                      - 'null'
                    description: Minutos desde medianoche al término.
                required:
                  - days
                  - fromMinute
                  - toMinute
          required: []
        fromParentId:
          type:
            - string
            - 'null'
          description: Medio de pago de origen cuando fue replicado desde un local padre.
        externalId:
          type:
            - string
            - 'null'
          description: Identificador de la integración que administra este medio de pago.
        digitalProvider:
          type: object
          description: Proveedor digital asociado.
          additionalProperties: false
          properties:
            providerId:
              type:
                - string
                - 'null'
              description: Identificador del proveedor.
          required: []
      required: []

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.