> ## 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 conversión de divisas masiva

Utiliza la API de cambio de divisas masivo para convertir fondos de manera eficiente entre tus propias cuentas multidivisa dentro del mismo país. Es ideal para empresas que gestionan operaciones internacionales y desean optimizar su tesorería interna.

> **Importante**
>
> * `account.debited.amount`: La cantidad que se deducirá de la cuenta de origen.
> * `account.credited.amount`: La cantidad que se agregará a la cuenta de destino.
>   El valor del campo proporcionado debe ser mayor que 0.

> [!NOTE]
>
> ¿Deseas fijar un tipo de cambio antes de ejecutar la transacción?
>
> Utiliza la [API de cotización de cambio de divisas ](https://docs.localpayment.com/es/reference/currency-exchange-quote.md)para generar una cotización de tipo de cambio para el par de divisas. La respuesta incluye un `exchangeRateToken`  inclúyelo en tu solicitud de conversión de divisas para asegurar ese tipo de cambio. El tipo de cambio cotizado está garantizado hasta el `expirationDate` del token, lo que lo protege tanto a ti como a tu usuario de las fluctuaciones del mercado.


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/currency-exchange
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/currency-exchange:
    post:
      summary: Crear conversión de divisas masiva
      operationId: exchange-bulk
      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:
                country:
                  type: string
                  description: El país donde se procesará el pago.
                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.
                exchangeRateToken:
                  type: string
                  description: >-
                    Token proporcionado por el servicio de cambio de divisas
                    para utilizar un tipo de cambio acordado previamente
                account:
                  type: object
                  description: >-
                    Objeto que contiene los detalles de la cuenta de la
                    transacción.
                  properties:
                    debited:
                      type: object
                      description: Detalles de la cuenta que se debitará.
                      properties:
                        currency:
                          type: string
                          description: Moneda de la cuenta debitada.
                        accountNumber:
                          type: string
                          description: >-
                            Número de cuenta desde la cual se debitarán los
                            fondos.
                        amount:
                          type: integer
                          description: >-
                            Importe a debitar. Este parámetro debe establecerse
                            en 0 si el campo `account.credited.amount` es mayor
                            que 0.
                      required:
                        - currency
                        - accountNumber
                        - amount
                    credited:
                      type: object
                      description: Detalles de la cuenta que se acreditará.
                      properties:
                        currency:
                          type: string
                          description: Moneda de la cuenta acreditada.
                        accountNumber:
                          type: string
                          description: >-
                            Número de cuenta a la cual se acreditarán los
                            fondos.
                        amount:
                          type: integer
                          description: Importe a acreditar
                      required:
                        - currency
                        - accountNumber
                  required:
                    - debited
                    - credited
              required:
                - country
                - externalId
                - exchangeRateToken
                - account
              x-examples:
                Example 1:
                  country: ARG
                  currency: EUR
                  externalId: '11112222'
                  exchangeRateToken: ''
                  account:
                    debited:
                      currency: EUR
                      accountNumber: 111.1111.11111111
                      amount: 10
                    credited:
                      currency: USD
                      accountNumber: '{{accountNumber}}'
            examples:
              Without requesting a quote:
                value:
                  country: ARG
                  currency: ARS
                  externalId: 7a9c72a0-7a8e-4f72-b2b3-a04054d3129f
                  account:
                    debited:
                      currency: ARS
                      accountNumber: '{{accountNumber}}'
                      amount: 10000
                    credited:
                      currency: EUR
                      accountNumber: '{{accountNumber}}'
              With quote:
                value:
                  country: ARG
                  externalId: '11112222'
                  exchangeRateToken: af5606b0-1ce7-48f8-ad8a-734934c601ec
                  account:
                    debited:
                      currency: EUR
                      accountNumber: '{{accountNumber}}'
                      amount: 10
                    credited:
                      currency: USD
                      accountNumber: '{{accountNumber}}'
                      amount: 0
              Credited amount set:
                value:
                  country: ARG
                  externalId: '{{externalId}}'
                  exchangeRateToken: ''
                  account:
                    debited:
                      currency: ARS
                      accountNumber: 111.111.1111111
                      amount: 0
                    credited:
                      currency: USD
                      accountNumber: '{{accountNumber}}'
                      amount: 10
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactionType:
                    type: string
                    description: >-
                      Tipo de transacción. Para las operaciones de cambio de
                      divisas, este valor es `CurrencyExchange`.
                  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
                    description: País donde se procesa la transacción.
                  currency:
                    type: string
                    description: La moneda original de la transacción.
                  exchangeRateToken:
                    type: string
                    description: >-
                      Un identificador único utilizado para rastrear el tipo de
                      cambio de la transacción.
                  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.
                  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
                    properties:
                      code:
                        type: string
                        description: >-
                          Un código que representa el estado actual de la
                          transacción.
                      description:
                        type: string
                        description: Una breve descripción del estado de la transacción.
                      detail:
                        type: string
                        description: >-
                          Detalles adicionales sobre el estado de la
                          transacción.
                  account:
                    type: object
                    properties:
                      debited:
                        type: object
                        properties:
                          currency:
                            type: string
                            description: La moneda de la cuenta debitada.
                          accountNumber:
                            type: string
                            description: El número de cuenta de la cuenta debitada.
                          amount:
                            type: number
                            description: El importe debitado de la cuenta.
                      credited:
                        type: object
                        properties:
                          currency:
                            type: string
                            description: La moneda de la cuenta acreditada.
                          accountNumber:
                            type: string
                            description: El número de cuenta de la cuenta acreditada.
                          amount:
                            type: number
                            description: El importe acreditado en la cuenta.
                      appliedFx:
                        type: number
                        description: El tipo de cambio aplicado a la transacción.
                x-examples:
                  Example 1:
                    transactionType: CurrencyExchange
                    externalId: ''
                    internalId: X11111XX-11X1-111X-X11X-111111X1X1XX
                    country: ARG
                    currency: ARS
                    exchangeRateToken: ''
                    clientCode: '0005'
                    creationDate: '2023-03-21T21:25:14.533+00:00'
                    errors: []
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: CURRENCY EXCHANGE
                    account:
                      debited:
                        currency: ARS
                        accountNumber: '{{accountNumber}}'
                        amount: 40
                      credited:
                        currency: EUR
                        accountNumber: '{{accountNumber}}'
                        amount: 0.18
                      appliedFx: 224.54
              examples:
                200 - Currency Exchange Bulk:
                  value:
                    transactionType: CurrencyExchange
                    externalId: 7a9c72a0-7a8e-4f72-b2b3-a04054d3129f
                    internalId: 8888ad65-aa6e-4643-b9ba-ff62318fd90b
                    country: ARG
                    currency: ARS
                    exchangeRateToken: ''
                    clientCode: '0005'
                    creationDate: '2023-03-21T21:25:14.533+00:00'
                    errors: []
                    status:
                      code: '200'
                      description: COMPLETED
                      detail: CURRENCY EXCHANGE
                    account:
                      debited:
                        currency: ARS
                        accountNumber: '{{accountNumber}}'
                        amount: 10000
                      credited:
                        currency: EUR
                        accountNumber: '{{accountNumber}}'
                        amount: 44.52
                      appliedFx: 224.54
        '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.
                  internalId:
                    type: string
                    description: Identificador de transacción de Localpayment.
                  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: Detalle del error.
                  status:
                    type: object
                    properties:
                      code:
                        type: string
                        description: >-
                          Un código que representa el estado actual de la
                          transacción.
                      description:
                        type: string
                        description: Una breve descripción del estado de la transacción.
                      detail:
                        type: string
                        description: >
                          Detalles adicionales sobre el estado de la
                          transacción.
                x-examples:
                  Example 1:
                    externalId: '11112222'
                    internalId: 6fc7e955-7704-4558-8a05-6f4a2c3d9b45
                    errors:
                      - code: '705'
                        detail: Credited account currency not match
                    status:
                      code: '705'
                      description: REJECTED
                      detail: Credited account currency not match
              examples:
                705 - Credited account currency not match:
                  value:
                    externalId: '11112222'
                    internalId: 6fc7e955-7704-4558-8a05-6f4a2c3d9b45
                    errors:
                      - code: '705'
                        detail: Credited account currency not match
                    status:
                      code: '705'
                      description: REJECTED
                      detail: Credited account currency not match
                707 - Debited and credited amounts are mutually exclusive:
                  value:
                    errors:
                      - code: '707'
                        detail: >-
                          Fields debited.amount and credited.amount are mutually
                          exclusive. Only one of them must be reported
                    status:
                      code: '707'
                      description: REJECTED
                      detail: >-
                        Fields debited.amount and credited.amount are mutually
                        exclusive. Only one of them must be reported
        '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.