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

# Crear una suscripción

Este endpoint te permite crear una nueva suscripción para un cliente. La creación de una suscripción implica asociar al cliente con un plan de suscripción específico y registrar su información de pago.


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/payin/subscriptions
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/payin/subscriptions:
    post:
      summary: Crear una suscripción
      operationId: create-a-subscription
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                paymentMethod:
                  type: object
                  properties:
                    type:
                      type: string
                      description: >-
                        [Tipo de método de
                        pago](/es/reference/get-available-payment-methods).
                    code:
                      type: string
                      description: >-
                        [Código del método de
                        pago](/es/reference/get-available-payment-methods).
                    flow:
                      type: string
                      description: >-
                        Define cómo se recopilan los datos de pago: `DIRECT`
                        (dentro de la solicitud de API) o `REDIRECT` (formulario
                        externo). Actualmente solo se admite `DIRECT`.
                  required:
                    - type
                    - code
                    - flow
                  x-examples:
                    Example 1:
                      type: BankTransfer
                      code: '1005'
                      flow: DIRECT
                externalId:
                  type: string
                  description: >-
                    Un identificador único generado por tu sistema para rastrear
                    la transacción (alfanumérico y con guiones). Recomendamos
                    usar UUID4 para garantizar su unicidad.
                country:
                  type: string
                  enum:
                    - COL
                    - MEX
                    - PER
                  description: >-
                    [País del documento](/es/reference/country-codes). ISO
                    3166-1 alfa-3.
                amount:
                  type: number
                  description: Importe de la transacción.
                currency:
                  type: string
                  enum:
                    - COP
                    - MXN
                    - PEN
                    - USD
                  description: '[Códigos de moneda](/es/reference/currency-codes).'
                accountNumber:
                  type: string
                  description: Número de cuenta de Localpayment.
                conceptCode:
                  type: string
                  enum:
                    - '0001'
                    - '0002'
                    - '0003'
                    - '0004'
                    - '0005'
                    - '0006'
                    - '0007'
                    - '0008'
                    - '0009'
                    - '0010'
                    - '0011'
                    - '0012'
                    - '0013'
                    - '0014'
                    - '0015'
                    - '0016'
                    - '0017'
                    - '0018'
                    - '0019'
                    - '0020'
                    - '0021'
                    - '0022'
                    - '0023'
                    - '0024'
                    - '0025'
                    - '0026'
                    - '0027'
                    - '0028'
                    - '0029'
                    - '0030'
                    - '0031'
                    - '0032'
                    - '0033'
                    - '0034'
                    - '0035'
                    - '0036'
                    - '0037'
                    - '0038'
                    - '0039'
                    - '0040'
                  description: Motivo del pago, [código](/es/reference/concept-codes).
                comment:
                  type: string
                  description: Información adicional
                exchangeRateToken:
                  type: string
                  description: >-
                    Token proporcionado por el [servicio de cambio de
                    divisas](/es/reference/currency-exchange-quote) para
                    utilizar un tipo de cambio acordado previamente.
                payer:
                  type: object
                  description: Información del pagador.
                  properties:
                    type:
                      type: string
                      enum:
                        - COMPANY
                        - INDIVIDUAL
                      description: Tipo de pagador.
                    name:
                      type: string
                      description: >-
                        El nombre del pagador. Los caracteres permitidos
                        dependen del campo `type`: para `individual`, letras
                        (incluidos los caracteres acentuados), espacios y puntos
                        (`.`); para `company`, el mismo conjunto más dígitos,
                        guion bajo (`_`) y guion (`-`).
                      minLength: 2
                      maxLength: 255
                    lastName:
                      type: string
                      description: >-
                        El apellido del pagador. Obligatorio cuando `type` es
                        `individual` y se ignora cuando `type` es `company`. Los
                        caracteres permitidos dependen de `type`: para
                        `individual`, letras (incluidos los caracteres
                        acentuados), espacios y puntos (`.`); para `company`, el
                        mismo conjunto más dígitos, guion bajo (`_`) y guion
                        (`-`).
                      minLength: 2
                      maxLength: 255
                    document:
                      type: object
                      description: Información del documento de identidad del pagador.
                      properties:
                        type:
                          type: string
                          description: >-
                            El tipo de [documento de
                            identidad](/es/reference/identity-document-types),
                            como el Número de Identidad Nacional, el Número de
                            la Seguridad Social o el Permiso de Conducir, según
                            el país de expedición.
                          examples:
                            - RUC
                        id:
                          type: string
                          description: >-
                            Número de documento de identidad (generalmente un
                            número). Este debe ser un número válido según las
                            normas del tipo de documento específico.
                          examples:
                            - '1791234561009'
                      required:
                        - type
                        - id
                      examples:
                        - type: RUC
                          id: '1791234561009'
                    userReference:
                      type: string
                      description: Nombre de usuario o ID del pagador en tu plataforma.
                    email:
                      type: string
                      description: Correo electrónico del usuario.
                    phone:
                      type: object
                      description: Número de teléfono del pagador.
                      properties:
                        countryCode:
                          type: string
                          description: Código de país del teléfono.
                        areaCode:
                          type: string
                          description: Código de área del país del teléfono.
                        number:
                          type: string
                          description: Número de teléfono.
                      required:
                        - countryCode
                        - areaCode
                        - number
                    birthDate:
                      type: string
                      description: Fecha de nacimiento del pagador en formato `yyyy-mm-dd`.
                    nationality:
                      type: string
                      description: Nacionalidad del pagador.
                    address:
                      type: object
                      description: Dirección del pagador.
                      properties:
                        street:
                          type: string
                          description: Nombre de la calle.
                          examples:
                            - Independencia
                        number:
                          type: string
                          description: Número de calle.
                          examples:
                            - '123'
                        city:
                          type: string
                          description: Ciudad.
                          examples:
                            - Cordoba
                        state:
                          type: string
                          description: Estado.
                          examples:
                            - Cordoba
                        country:
                          type: string
                          description: País de la dirección.
                          examples:
                            - Argentina
                        zipCode:
                          type: string
                          description: Código postal.
                          examples:
                            - X5000IUO
                        comment:
                          type: string
                          description: Información adicional sobre la dirección.
                          examples:
                            - Sucursal 123
                      examples:
                        - street: Independencia
                          number: '123'
                          city: Cordoba
                          state: Cordoba
                          country: ARG
                          zipCode: X5000IUO
                          comment: Sucursal 123
                  required:
                    - type
                    - name
                    - document
                    - email
                    - phone
                  x-examples:
                    Example 1:
                      beneficiary:
                        type: COMPANY
                        name: ITAU ARG
                        document:
                          type: CUIT
                          id: '20907920276'
                        userReference: Lorem
                        email: aldana@mail.com
                        phone:
                          countryCode: countryCode
                          areaCode: areaCode
                          number: phoneNumber
                        birthDate: '2021-11-08'
                        nationality: beneficiary nationality
                        address:
                          street: Beneficiary adress
                          number: '234'
                          city: City
                          state: Villa Rosa
                          country: Country
                          zipCode: '1411'
                          comment: TEST
                        bank:
                          name: ARG TEST
                          code: '007'
                          account:
                            type: C
                            number: '1234567891234567891234'
                intermediaries:
                  type: array
                  description: >-
                    Matriz de objetos "Parte". Representa a otras partes en la
                    cadena de pago, ya que el usuario final no es tu cliente
                    directo. Ten en cuenta la secuencia de la matriz: tu cliente
                    debe ser el primer elemento, el cliente de tu cliente el
                    segundo, y así sucesivamente, hasta que no haya más
                    intermediarios.
                device:
                  type: object
                  properties:
                    id:
                      type: string
                      description: >-
                        ID del dispositivo Android / iPhone. Puede dejarse en
                        blanco para otros tipos de dispositivo, como PC / Mac.
                    ip:
                      type: string
                      description: Dirección IP del dispositivo
                    browser:
                      type: string
                      description: Navegador del dispositivo.
                metaData:
                  type: string
                  description: >-
                    Objeto no estructurado para registrar cualquier metadato que
                    sea significativo para ti.
                commercialData:
                  type: object
                  description: >-
                    Información adicional relacionada con los bienes o servicios
                    comercializados. 
                  properties:
                    lastName:
                      type: string
                      description: >-
                        El apellido de la entidad comercial. Obligatorio cuando
                        el valor representa a una persona física y se ignora
                        cuando representa a una empresa. Caracteres permitidos:
                        para una persona física, letras (incluidos los
                        caracteres acentuados), espacios y puntos (`.`); para
                        una empresa, el mismo conjunto más dígitos, guion bajo
                        (`_`) y guion (`-`).
                      minLength: 2
                      maxLength: 255
                    name:
                      type: string
                      description: >-
                        El nombre de la entidad comercial. Los caracteres
                        permitidos dependen de si el valor representa a una
                        persona física o a una empresa: para una persona física,
                        letras (incluidos los caracteres acentuados), espacios y
                        puntos (`.`); para una empresa, el mismo conjunto más
                        dígitos, guion bajo (`_`) y guion (`-`).
                      minLength: 2
                      maxLength: 255
                merchant:
                  type: object
                  description: Información del comerciante.
                  properties:
                    type:
                      type: string
                      description: Tipo de comerciante.
                    name:
                      type: string
                      description: >-
                        El nombre del comerciante. Los caracteres permitidos
                        dependen del campo `type`: para `individual`, letras
                        (incluidos los caracteres acentuados), espacios y puntos
                        (`.`); para `company`, el mismo conjunto más dígitos,
                        guion bajo (`_`) y guion (`-`).
                      minLength: 2
                      maxLength: 255
                    lastName:
                      type: string
                      description: >-
                        El apellido del comerciante. Obligatorio cuando `type`
                        es `individual` y se ignora cuando `type` es `company`.
                        Los caracteres permitidos dependen de `type`: para
                        `individual`, letras (incluidos los caracteres
                        acentuados), espacios y puntos (`.`); para `company`, el
                        mismo conjunto más dígitos, guion bajo (`_`) y guion
                        (`-`).
                      minLength: 2
                      maxLength: 255
                    document:
                      type: object
                      description: Información del documento de identidad del comerciante.
                      properties:
                        type:
                          type: string
                          description: >-
                            El tipo de [documento de
                            identidad](/es/reference/identity-document-types),
                            como el Número de Identidad Nacional, el Número de
                            la Seguridad Social o el Permiso de Conducir, según
                            el país de expedición.
                          examples:
                            - RUC
                        id:
                          type: string
                          description: >-
                            Número de documento de identidad (generalmente un
                            número). Este debe ser un número válido según las
                            normas del tipo de documento específico.
                          examples:
                            - '1791234561009'
                      examples:
                        - type: RUC
                          id: '1791234561009'
                    phone:
                      type: object
                      description: Número de teléfono del comerciante.
                      properties:
                        countryCode:
                          type: string
                          description: Código de país del teléfono.
                        areaCode:
                          type: string
                          description: Código de área del país del teléfono.
                        number:
                          type: string
                          description: Número de teléfono.
                    email:
                      type: string
                      description: Correo electrónico del comerciante.
                    userReference:
                      type: string
                      description: Nombre de usuario o ID del comerciante en tu plataforma.
                    address:
                      type: object
                      description: Dirección del comerciante.
                      properties:
                        street:
                          type: string
                          description: Nombre de la calle.
                          examples:
                            - Independencia
                        number:
                          type: string
                          description: Número de calle.
                          examples:
                            - '123'
                        city:
                          type: string
                          description: Ciudad.
                          examples:
                            - Cordoba
                        state:
                          type: string
                          description: Estado.
                          examples:
                            - Cordoba
                        country:
                          type: string
                          description: País de la dirección.
                          examples:
                            - Argentina
                        zipCode:
                          type: string
                          description: Código postal.
                          examples:
                            - X5000IUO
                        comment:
                          type: string
                          description: Información adicional sobre la dirección.
                          examples:
                            - Sucursal 123
                      examples:
                        - street: Independencia
                          number: '123'
                          city: Cordoba
                          state: Cordoba
                          country: ARG
                          zipCode: X5000IUO
                          comment: Sucursal 123
                    nationality:
                      type: string
                      description: Nacionalidad del comerciante.
                    birthDate:
                      type: string
                      description: >-
                        Fecha de nacimiento del comerciante en formato
                        yyyy-mm-dd.
                  x-examples:
                    Example 1:
                      merchant:
                        type: COMPANY
                        name: Merchant Name
                        lastName: Merchant LastName
                        document:
                          type: Type Document
                          id: ID Document
                        userReference: additional information
                        email: email@Merchant.address
                        phone:
                          countryCode: '55'
                          areaCode: '55'
                          number: '66666666'
                        birthDate: '2001-01-01'
                        nationality: Merchant Nacionality
                        address:
                          street: Av Merchant Address
                          number: '1234'
                          city: City Name
                          state: State Name
                          country: Country Name
                          zipCode: Zip Code
                          comment: Additional address information
                card:
                  type: object
                  description: 'Datos de la tarjeta de débito del pagador. '
                  properties:
                    name:
                      type: string
                      description: ' Nombre del titular de la tarjeta, tal como figura impreso en el frente de la tarjeta de débito.'
                    number:
                      type: string
                      description: Número de tarjeta (PAN).
                    cvv:
                      type: string
                      description: Valor de verificación de la tarjeta
                    expirationMonth:
                      type: string
                      description: Mes de vencimiento de la tarjeta. Formato `MM`.
                      examples:
                        - '01'
                    expirationYear:
                      type: string
                      description: Año de vencimiento de la tarjeta. Formato `YYYY`.
                      examples:
                        - '2025'
                    token:
                      type: string
                      description: >-
                        Utiliza una tarjeta previamente tokenizada enviando el
                        token.
                  required:
                    - name
                    - number
                    - cvv
                    - expirationMonth
                    - expirationYear
                invoice:
                  type: string
                  description: Referencia de la factura.
                item:
                  type: object
                  description: Lista de artículos vendidos.
                  properties:
                    id:
                      type: string
                      description: ' ID del artículo.'
                    quantity:
                      type: number
                      description: ' ID del artículo.'
                    categoryId:
                      type: string
                      description: Categoría del artículo.
                    pictureUrl:
                      type: string
                      description: ' URL que apunta a una imagen del artículo.'
                    description:
                      type: string
                      description: Descripción del artículo.
                    title:
                      type: string
                      description: "Título del artículo.\r\n"
                    unitPrice:
                      type: number
                      description: Precio unitario
                shipments:
                  type: object
                  description: Lista de direcciones de envío
                  properties:
                    city:
                      type: string
                      description: Ciudad
                    number:
                      type: string
                      description: 'Dirección: número'
                    street:
                      type: string
                      description: Dirección
                    country:
                      type: string
                      description: Country
                    state:
                      type: string
                      description: Estado/Provincia
                    comment:
                      type: string
                      description: Información adicional
                    zipCode:
                      type: string
                      description: Código postal
                beneficiary:
                  type: object
                  description: Información del beneficiario de la cuenta.
                  properties:
                    type:
                      type: string
                      enum:
                        - INDIVIDUAL
                        - COMPANY
                      description: Tipo de beneficiario.
                    name:
                      type: string
                      description: >-
                        El nombre del beneficiario. Los caracteres permitidos
                        dependen del campo `type`: para `individual`, letras
                        (incluidos los caracteres acentuados), espacios y puntos
                        (`.`); para `company`, el mismo conjunto más dígitos,
                        guion bajo (`_`) y guion (`-`).
                      minLength: 2
                      maxLength: 255
                    lastName:
                      type: string
                      description: >-
                        El apellido del beneficiario. Obligatorio cuando `type`
                        es `individual` y se ignora cuando `type` es `company`.
                        Los caracteres permitidos dependen de `type`: para
                        `individual`, letras (incluidos los caracteres
                        acentuados), espacios y puntos (`.`); para `company`, el
                        mismo conjunto más dígitos, guion bajo (`_`) y guion
                        (`-`).
                      minLength: 2
                      maxLength: 255
                    document:
                      type: object
                      description: Información del documento de identidad del beneficiario.
                      properties:
                        type:
                          type: string
                          description: >-
                            El tipo de [documento de
                            identidad](/es/reference/identity-document-types),
                            como el Número de Identidad Nacional, el Número de
                            la Seguridad Social o el Permiso de Conducir, según
                            el país de expedición.
                        id:
                          type: string
                          description: >-
                            Número de documento de identidad (generalmente un
                            número). Este debe ser un número válido según las
                            normas del tipo de documento específico.
                type:
                  type: string
                  enum:
                    - SOFTWARE
                    - STREAMING
                    - CONTENT
                    - PRODUCTS
                    - MEMBERSHIP
                  description: 'Especifica la categoría de suscripción. '
                autoRecurring:
                  type: object
                  description: Propiedades de suscripción
                  properties:
                    type:
                      type: string
                      enum:
                        - day
                        - month
                        - custom
                      description: >-
                        Define la unidad del intervalo de recurrencia. Para
                        recurrencia bajo demanda, envía el parámetro con
                        `value=custom`.
                    trialDays:
                      type: number
                      description: Número de días de prueba de la suscripción.
                  required:
                    - type
                retry:
                  type: object
                  description: Opciones de reintento de payin.
                  properties:
                    repetitions:
                      type: number
                      description: Número de veces que se reintentará el cobro.
                    intervalUnit:
                      type: string
                      enum:
                        - day
                        - hour
                      description: >-
                        La unidad de tiempo en la que se ejecutarán los
                        reintentos. Valores permitidos: `day` y `hour`.
                    intervalValue:
                      type: string
                      description: >-
                        Intervalo en el que se realizarán los reintentos. Define
                        el número de unidades de tiempo entre reintentos.
                discount:
                  type: object
                  description: Opciones de descuento.
                  properties:
                    amount:
                      type: string
                      description: Importe a cobrar a tu usuario final.
                    period:
                      type: number
                      description: Período de descuento.
                  required:
                    - amount
                    - period
              required:
                - paymentMethod
                - externalId
                - country
                - amount
                - currency
                - accountNumber
                - conceptCode
                - payer
                - card
                - type
                - autoRecurring
              x-examples:
                Example 1:
                  paymentMethod:
                    type: CreditCard
                    code: '1000'
                    flow: DIRECT
                  externalId: '1662647310'
                  country: ARG
                  amount: 100
                  currency: ARS
                  accountNumber: '{{accountNumber}}'
                  conceptCode: '0001'
                  comment: subs test 1 del 7/9 xdia
                  merchant:
                    type: INDIVIDUAL
                    name: Obi Wan
                    lastname: Kenobi
                    document:
                      type: DNI
                      id: '12345678'
                    userReference: abc123
                    email: obiwankenobi@starwars.com
                    phone:
                      countryCode: '54'
                      areaCode: '11'
                      number: '98789632'
                    birthdate: '2000-01-01'
                    nationality: Argentinian
                    address:
                      street: Charruas
                      number: '938'
                      city: Hurlingham
                      state: state
                      country: ARG
                      zipCode: '1688'
                      comment: portero 801
                  payer:
                    type: INDIVIDUAL
                    name: Luke
                    lastname: Skywalker
                    document:
                      id: '37993830'
                      type: DNI
                    email: jane.doe@example.com
                    phone:
                      countryCode: '1'
                      areaCode: '11'
                      number: '98789632'
                    birthdate: 01/01/1990
                    nationality: American
                    address:
                      street: Siempre viva
                      number: '1234'
                      city: Springfield
                      state: Ohio
                      country: USA
                      zipCode: '1686'
                      comment: May the force be with you, always!
                  card:
                    name: APRO
                    number: '4509953566233704'
                    cvv: '123'
                    expirationMonth: '11'
                    expirationYear: '2025'
                    installments: 1
                  type: SOFTWARE
                  autoRecurring:
                    type: day
            examples:
              200 - Suscription:
                value:
                  paymentMethod:
                    type: CreditCard
                    code: '1000'
                    flow: DIRECT
                  externalId: 820d6e89-3715-4296-9975-def5c7750f65
                  country: ARG
                  amount: 100
                  currency: ARS
                  accountNumber: '{{accountNumber}}'
                  conceptCode: '0001'
                  comment: Test
                  merchant:
                    type: COMPANY
                    name: Company
                    document:
                      type: DNI
                      id: '12345678'
                    userReference: abc123
                    email: merchant@mail.com
                    phone:
                      countryCode: '54'
                      areaCode: '11'
                      number: '98781234'
                  payer:
                    type: INDIVIDUAL
                    name: John
                    lastname: Doe
                    document:
                      id: '37993812'
                      type: DNI
                    email: john.doe@example.com
                    phone:
                      countryCode: '1'
                      areaCode: '11'
                      number: '98789123'
                  card:
                    name: APRO
                    number: '4000000000000002'
                    cvv: '123'
                    expirationMonth: '11'
                    expirationYear: '2029'
                    installments: 1
                  type: SOFTWARE
                  autoRecurring:
                    type: day
              COL - Subscription:
                summary: COL - Subscription
                value:
                  paymentMethod:
                    type: CreditCard
                    code: '1900'
                    flow: DIRECT
                  externalId: 550e8400-e29b-41d4-a716-446655440000
                  country: COL
                  amount: 100
                  currency: COP
                  accountNumber: '{{yourLocalpaymentAccountNumber}}'
                  conceptCode: '0001'
                  comment: Subscription
                  merchant:
                    type: COMPANY
                    name: Example Company S.A.
                    document:
                      type: NIT
                      id: '900123456'
                  payer:
                    type: INDIVIDUAL
                    name: Jane
                    lastName: Doe
                    document:
                      type: CC
                      id: '1234567890'
                    email: jane.doe@example.com
                  card:
                    name: Jane Doe
                    number: '4000000000000002'
                    cvv: '123'
                    expirationMonth: '12'
                    expirationYear: '2029'
                    installments: 1
                  type: SOFTWARE
                  autoRecurring:
                    repetitions: 2
                    type: day
              PER - Subscription (PEN):
                summary: PER - Subscription (PEN)
                value:
                  paymentMethod:
                    type: CreditCard
                    code: '6000'
                    flow: DIRECT
                  externalId: 550e8400-e29b-41d4-a716-446655440000
                  country: PER
                  amount: 100
                  currency: PEN
                  accountNumber: '{{yourLocalpaymentAccountNumber}}'
                  conceptCode: '0001'
                  comment: Subscription
                  merchant:
                    type: COMPANY
                    name: Example Company S.A.
                    document:
                      type: RUC
                      id: '20123456789'
                  payer:
                    type: INDIVIDUAL
                    name: Jane
                    lastName: Doe
                    document:
                      type: DNI
                      id: '12345678'
                    email: jane.doe@example.com
                  card:
                    name: Jane Doe
                    number: '4000000000000002'
                    cvv: '123'
                    expirationMonth: '12'
                    expirationYear: '2029'
                    installments: 1
                  type: SOFTWARE
                  autoRecurring:
                    repetitions: 2
                    type: day
              PER - Subscription (USD):
                summary: PER - Subscription (USD)
                value:
                  paymentMethod:
                    type: CreditCard
                    code: '6004'
                    flow: DIRECT
                  externalId: 550e8400-e29b-41d4-a716-446655440000
                  country: PER
                  amount: 100
                  currency: USD
                  accountNumber: '{{yourLocalpaymentAccountNumber}}'
                  conceptCode: '0001'
                  comment: Subscription
                  merchant:
                    type: COMPANY
                    name: Example Company S.A.
                    document:
                      type: RUC
                      id: '20123456789'
                  payer:
                    type: INDIVIDUAL
                    name: Jane
                    lastName: Doe
                    document:
                      type: DNI
                      id: '12345678'
                    email: jane.doe@example.com
                  card:
                    name: Jane Doe
                    number: '4000000000000002'
                    cvv: '123'
                    expirationMonth: '12'
                    expirationYear: '2029'
                    installments: 1
                  type: SOFTWARE
                  autoRecurring:
                    repetitions: 2
                    type: day
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  subscriptionId:
                    type: string
                    description: Identificador único para la suscripción.
                  status:
                    type: object
                    title: status
                    description: Estado de la operación.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          estado](/es/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: >-
                          [Descripción del
                          estado](/es/reference/transaction-status-error-codes).
                      detail:
                        type: string
                        description: Información de estado adicional.
                  creationDate:
                    type: string
                    description: >-
                      Fecha y hora de creación de la suscripción. La marca de
                      tiempo sigue el formato ISO 8601.
                  nextPaymentDate:
                    type: string
                    description: >-
                      Fecha y hora de vencimiento del próximo pago de la
                      suscripción. La marca de tiempo sigue el formato ISO 8601.
                  payments:
                    type: array
                    description: >-
                      Conjunto de objetos que representan los pagos asociados a
                      la suscripción.
                    items:
                      type: object
                      properties:
                        externalId:
                          type: string
                          description: >-
                            Un identificador único generado por tu sistema para
                            rastrear la transacción (alfanumérico y con
                            guiones). Recomendamos usar UUID4 para garantizar su
                            unicidad.
                        internalId:
                          type: string
                          description: Identificador de transacción de Localpayment.
                        status:
                          type: object
                          title: status
                          description: Estado de la operación.
                          properties:
                            code:
                              type: string
                              description: >-
                                [Código de
                                estado](/es/reference/transaction-status-error-codes).
                            description:
                              type: string
                              description: >-
                                [Descripción del
                                estado](/es/reference/transaction-status-error-codes).
                            detail:
                              type: string
                              description: Información de estado adicional.
                x-examples:
                  Example 1:
                    subscriptionId: 133640f9-ac06-49fc-aa82-08bfe52ceb5e
                    status:
                      code: '105'
                      description: INPROGRESS
                      detail: The subscription is in progress
                    creationDate: '2022-05-31T15:05:47.665+00:00'
                    nextPaymentDate: '2022-06-30T15:05:47.665+00:00'
                    payments:
                      - externalId: bb7d32e5-04da-4b8a-856f-8caf89d986ea
                        internalId: 9977c353-ce00-48fd-b3ac-f685bce30895
                        status:
                          code: '103'
                          description: APPROVED
                          detail: The payin was confirmed but not credited yet
              examples:
                200 - Subscription:
                  value:
                    subscriptionId: 133640f9-ac16-49fc-aa82-08bfe52ceb5e
                    status:
                      code: '105'
                      description: INPROGRESS
                      detail: The subscription is in progress
                    creationDate: '2024-05-31T15:05:47.665+00:00'
                    nextPaymentDate: '2024-06-30T15:05:47.665+00:00'
                    payments:
                      - externalId: bb7d3235-04da-4b8a-85bf-8caf89d986ea
                        internalId: 9977c453-ce00-48fd-baac-f685bce30895
                        status:
                          code: '103'
                          description: APPROVED
                          detail: The payin was confirmed but not credited yet
                COL - Subscription:
                  summary: COL - Subscription
                  value:
                    type: SOFTWARE
                    externalId: 550e8400-e29b-41d4-a716-446655440000
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    country: COL
                    currency: COP
                    accountNumber: '{{yourLocalpaymentAccountNumber}}'
                    status:
                      code: '105'
                      description: ACTIVE
                      detail: The subscription is active
                    date:
                      creationDate: '2024-01-15T10:30:00Z'
                      nextPaymentDate: '2024-01-16T10:30:00Z'
                    payments:
                      - externalId: f47ac10b-58cc-4372-a567-0e02b2c3d479
                        internalId: 9b2e4c1d-7a3f-4e8b-b6d5-2c1f0a9e8d7c
                        status:
                          code: '103'
                          description: APPROVED
                          detail: The payin was confirmed but not credited yet
                    errors: []
                PER - Subscription (PEN):
                  summary: PER - Subscription (PEN)
                  value:
                    type: SOFTWARE
                    externalId: 550e8400-e29b-41d4-a716-446655440000
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    country: PER
                    currency: PEN
                    accountNumber: '{{yourLocalpaymentAccountNumber}}'
                    status:
                      code: '105'
                      description: ACTIVE
                      detail: The subscription is active
                    date:
                      creationDate: '2024-01-15T10:30:00Z'
                      nextPaymentDate: '2024-01-16T10:30:00Z'
                    payments:
                      - externalId: f47ac10b-58cc-4372-a567-0e02b2c3d479
                        internalId: 9b2e4c1d-7a3f-4e8b-b6d5-2c1f0a9e8d7c
                        status:
                          code: '103'
                          description: APPROVED
                          detail: The payin was confirmed but not credited yet
                    errors: []
                PER - Subscription (USD):
                  summary: PER - Subscription (USD)
                  value:
                    type: SOFTWARE
                    externalId: 550e8400-e29b-41d4-a716-446655440000
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    country: PER
                    currency: USD
                    accountNumber: '{{yourLocalpaymentAccountNumber}}'
                    status:
                      code: '105'
                      description: ACTIVE
                      detail: The subscription is active
                    date:
                      creationDate: '2024-01-15T10:30:00Z'
                      nextPaymentDate: '2024-01-16T10:30:00Z'
                    payments:
                      - externalId: f47ac10b-58cc-4372-a567-0e02b2c3d479
                        internalId: 9b2e4c1d-7a3f-4e8b-b6d5-2c1f0a9e8d7c
                        status:
                          code: '103'
                          description: APPROVED
                          detail: The payin was confirmed but not credited yet
                    errors: []
        '400':
          description: Solicitud incorrecta.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: object
                    title: status
                    description: Estado de la operación.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          estado](/es/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: >-
                          [Descripción del
                          estado](/es/reference/transaction-status-error-codes).
                      detail:
                        type: string
                        description: Información de estado adicional.
                  errors:
                    type: array
                    description: Lista de errores que se produjeron durante la transacción.
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Código de error.
                        detail:
                          type: string
                          description: Detalles del error.
                x-examples:
                  Example 1:
                    status:
                      code: '501'
                      description: REJECTED
                      detail: Country not found
                    errors:
                      - code: '501'
                        detail: Country not found
                      - code: '817'
                        detail: Invalid concept code
              examples:
                501 - Country not found:
                  value:
                    status:
                      code: '501'
                      description: REJECTED
                      detail: Country not found
                    errors:
                      - code: '501'
                        detail: Country not found
                      - code: '817'
                        detail: Invalid concept code
        '401':
          description: No autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                  code:
                    type: string
                    description: Código de estado.
                  messages:
                    type: array
                    description: Lista de mensajes.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase de token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensaje con información adicional.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

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