> ## 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 Wire In

Recibe fondos de una cuenta bancaria externa directamente en tu cuenta de Localpayment mediante transferencia bancaria. Este endpoint es ideal para aceptar pagos de clientes o socios que utilizan la banca tradicional.

Al enviar la solicitud, recibirás un `internalId` único para dar seguimiento a la transacción. Utiliza este identificador para monitorear la transferencia hasta que los fondos se acrediten correctamente en tu cuenta.


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/account/wire-in
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/account/wire-in:
    post:
      summary: Crear Wire In
      operationId: wire-in
      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:
          multipart/form-data:
            schema:
              type: object
              properties:
                request:
                  type: string
                  description: "| Nombre                    | Tipo   | Obligatorio | Descripción                                                                                                                                                |\r\n| ------------------------- | ------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |\r\n| transactionType           | String | Obligatorio | Tipo de transacción (WireIn).                                                                                                                              |\r\n| currency                  | String | Obligatorio | [Códigos de moneda.](https://docs.localpayment.com/docs/global-coverage)                                                                                   |\r\n| country                   | String | Obligatorio | [País del documento.](https://docs.localpayment.com/docs/global-coverage) ISO 3166-1 alfa-3.                                                               |\r\n| amount                    | String | Obligatorio | Importe de la transacción.                                                                                                                                 |\r\n| comment                   | String | Opcional    | Un comentario o descripción adicional asociado a la transacción.                                                                                           |\r\n| externalId                | String | Obligatorio | Un identificador único generado por tu sistema para rastrear la transacción (alfanumérico y guiones). Recomendamos usar UUID4 para garantizar la unicidad. |\r\n| accountNumber             | String | Obligatorio | Número de cuenta de Localpayment.                                                                                                                          |\r\n| to                        | Object | Obligatorio | Datos del beneficiario.                                                                                                                                    |\r\n| to.name                   | String | Obligatorio | Nombre del beneficiario.                                                                                                                                   |\r\n| to.swift                  | String | Obligatorio | Código de identificación bancaria más utilizado para realizar transferencias internacionales de dinero.                                                    |\r\n| to.address                | String | Obligatorio | Dirección del banco.                                                                                                                                       |\r\n| to.accountNumber          | String | Obligatorio | Número de cuenta de Localpayment.                                                                                                                          |\r\n| to.accountName            | String | Obligatorio | Nombre del titular del beneficiario.                                                                                                                       |\r\n| to.beneficiaryAddress     | String | Obligatorio | Dirección del titular de la cuenta.                                                                                                                        |\r\n| from                      | Object | Obligatorio | Datos del banco ordenante.                                                                                                                                 |\r\n| from.name                 | String | Obligatorio | Nombre del banco ordenante.                                                                                                                                |\r\n| from.swift                | String | Obligatorio | Código de identificación del banco ordenante para realizar transferencias internacionales de dinero.                                                       |\r\n| from.address              | String | Obligatorio | Dirección del banco ordenante.                                                                                                                             |\r\n| from.accountNumber        | String | Obligatorio | Número de cuenta de Localpayment.                                                                                                                          |\r\n| from.routingNumber        | String | Opcional    | Código identificador de transacción para indicar las entidades bancarias de origen y destino de las transferencias en Estados Unidos.                      |\r\n| from.accountName          | String | Obligatorio | El nombre asociado a la cuenta bancaria ordenante.                                                                                                         |\r\n| from.beneficiaryAddress   | String | Obligatorio | La dirección de la parte ordenante.                                                                                                                        |\r\n| intermediaryAccountNumber | String | Opcional    | El número de cuenta en el banco intermediario (si lo hay)                                                                                                  |\r\n| intermediaryBankSwift     | String | Opcional    | El código SWIFT del banco intermediario (si lo hay).                                                                                                       |\r\n| intermediaryBankName      | String | Opcional    | El nombre del banco intermediario (si lo hay).                                                                                                             |\r\n\r\n"
                  examples:
                    - >-
                      {"transactionType":"WireIn","currency":"BOB","country":"BOL","amount":100,"comment":"Comment","externalId":"a11h7890-78ju-098j-hu78-124ftn8lo0io","accountNumber":"{{accountNumber}}","to":{"name":"Bankname","swift":"BCBHDOSD","address":"BankAddress","accountNumber":"1310825187","accountName":"BeneficiaryBankName","beneficiaryAddress":"BeneficiaryAddress"},"from":{"name":"OrderingBankName","swift":"BICAARBS","address":"OrderingBankAddress","accountNumber":"123456789","routingNumber":null,"accountName":"accountName","beneficiaryAddress":"BeneficiaryAddress","intermediaryBankName":null,"intermediaryBankSwift":null,"intermediaryAccountNumer":null}}
                filecontent:
                  type: string
                  description: "Comprobante de la transacción\r\n"
                  contentMediaType: application/octet-stream
              required:
                - request
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactionType:
                    type: string
                    description: El tipo de transacción que se está procesando.
                  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.
                  country:
                    type: string
                    enum:
                      - ARG
                      - BOL
                      - BRA
                      - CHL
                      - COL
                      - CRI
                      - DOM
                      - ECU
                      - SLV
                      - GTM
                      - HND
                      - MEX
                      - PAN
                      - PRY
                      - PER
                      - URY
                    description: >-
                      [País del documento](/es/reference/country-codes). ISO
                      3166-1 alfa-3.
                  currency:
                    type: string
                    enum:
                      - ARS
                      - BOB
                      - BRL
                      - CLP
                      - COP
                      - CRC
                      - DOP
                      - USD
                      - GTQ
                      - MXN
                      - PYG
                      - PEN
                      - UYU
                    description: '[Códigos de moneda](/es/reference/currency-codes).'
                  clientCode:
                    type: string
                    description: >-
                      Un identificador único asignado al cliente dentro del
                      sistema Localpayment.
                  creationDate:
                    type: string
                    description: >-
                      La fecha y hora en que se creó la transacción, en formato
                      ISO 8601.
                  errors:
                    type: array
                    description: >-
                      Un conjunto de objetos de error, en caso de que se haya
                      producido algún error durante la transacción.
                    items:
                      type: object
                  status:
                    type: object
                    description: Objeto que indica el estado actual de la transacción.
                    properties:
                      code:
                        type: string
                        description: >-
                          Un código que representa el [estado actual de la
                          transacción](/es/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: >-
                          Una breve descripción del [estado de la
                          transacción](/es/reference/transaction-status-error-codes).
                      detail:
                        type: string
                        description: >-
                          Detalles adicionales sobre el estado de la
                          transacción.
                  accountNumber:
                    type: string
                    description: Número de cuenta de Localpayment.
                  amount:
                    type: number
                    description: Importe de la transacción.
                  fees:
                    type: object
                    description: Detalles sobre las tarifas que se apliquen.
                    properties:
                      description:
                        type: string
                        description: Descripción de la comisión aplicada a la transacción.
                      currency:
                        type: string
                        description: '[Códigos de moneda](/es/reference/currency-codes).'
                      amount:
                        type: number
                        description: El importe de la comisión aplicada a la transacción.
                      account:
                        type: string
                        description: El número de cuenta al que se aplica la comisión.
                  localTaxes:
                    type: array
                    description: >-
                      Una lista de los impuestos locales aplicados a la
                      transacción. Si está vacía, no se aplicaron impuestos.
                    items:
                      type: object
                  withHoldings:
                    type: array
                    description: >-
                      Una lista de las retenciones aplicadas a la transacción.
                      Si está vacía, no se aplicaron retenciones.
                    items:
                      type: object
                  comment:
                    type: string
                    description: Un comentario o nota asociada a la transacción.
                x-examples:
                  Example 1:
                    transactionType: WireIn
                    externalId: External15
                    internalId: 0f1d47dc-e9c6-4fdf-8ba1-c9b29916574d
                    country: ARG
                    currency: ARS
                    clientCode: '0001'
                    creationDate: '2024-02-28T13:47:58.808+00:00'
                    errors: []
                    status:
                      code: '100'
                      description: PENDING_CREDIT
                      detail: WIRE IN
                    accountNumber: '{{accountNumber}}'
                    amount: 49500
                    fees:
                      description: Fee
                      currency: ARS
                      amount: 500
                      account: '{{accountNumber}}'
                    localTaxes: []
                    withHoldings: []
                    comment: Ducupublica
              examples:
                101 - Wire In Example Response:
                  value:
                    transactionType: WireIn
                    transactionFlow: wireInAutomatic
                    externalId: a11h7890-78ju-098j-hu78-124ftn8lo0io
                    internalId: b97fe1cd-50d3-4ee2-8a6e-34ee6d7e4f4e
                    country: BOL
                    currency: BOB
                    clientCode: '0001'
                    creationDate: '2025-12-04T21:07:41.689+00:00'
                    errors: []
                    status:
                      code: '101'
                      description: PENDING_AUTH
                      detail: Pending Auth
                    accountNumber: '{{accountNumber}}'
                    amount: 97.32
                    fees:
                      description: Fee
                      currency: BOB
                      amount: 0.5
                      account: '{{accountNumber}}'
                    localTaxes:
                      - code: '0016'
                        percentage: 2.18
                        description: FNA
                        currency: BOB
                        fxSource: 6.911493
                        fxQuote: 0
                        amount: 2.18
                        account: '{{accountNumber}}'
                    withHoldings: []
                    comment: Comment
                    code: '101'
        '400':
          description: Solicitud incorrecta.
          content:
            application/json:
              schema:
                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.
                  errors:
                    type: array
                    description: >-
                      Un conjunto de objetos de error, en caso de que se haya
                      producido algún error durante la transacción.
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Código de error.
                        detail:
                          type: string
                          description: Detalles del error.
                  status:
                    type: object
                    description: Objeto que indica el estado actual de la transacción.
                    properties:
                      code:
                        type: string
                        description: >-
                          Un código que representa el [estado actual de la
                          transacción.](/es/reference/transaction-status-error-codes)
                      description:
                        type: string
                        description: >-
                          Una breve descripción del [estado de la
                          transacción](/es/reference/transaction-status-error-codes).
                      detail:
                        type: string
                        description: >-
                          Detalles adicionales sobre el estado de la
                          transacción.
                x-examples:
                  Example 1:
                    externalId: e84657e9-65d8-4de5-afbb-f62cc14f30b7
                    errors:
                      - code: '812'
                        detail: External Id already used - duplication
                    status:
                      code: '812'
                      description: REJECTED
                      detail: External Id already used - duplication
              examples:
                500 - Error master service.:
                  value:
                    status:
                      code: '500'
                    timestamp: '2025-01-10 16:22:20.569138644'
                    code: '500'
                    description: Error master service
                812 - External Id already used - duplication.:
                  value:
                    externalId: e84657e9-65d8-4de5-afbb-f62cc14f30b7
                    errors:
                      - code: '812'
                        detail: External Id already used - duplication
                    status:
                      code: '812'
                      description: REJECTED
                      detail: External Id already used - duplication
                404 - This beneficiary account is invalid.:
                  value:
                    externalId: 089c81c6-7be2-4798-8e53-d4bfff61f852
                    errors:
                      - code: '404'
                        detail: This beneficiary account is invalid
                    status:
                      code: '404'
                      description: REJECTED
                      detail: This beneficiary account is invalid
        '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.