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

# Authorize exchange

> Transfer funds between your own accounts in different currencies.



## OpenAPI

````yaml post /v1/global-payout/exchange/authorize
openapi: 3.0.1
info:
  description: ''
  title: Vendor API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.nomba.com
  - description: Sandbox
    url: https://sandbox.nomba.com
security: []
tags:
  - name: Authenticate
  - name: Accounts
  - name: Virtual Accounts
  - name: Online Checkout
  - name: Charge
  - name: Transfers
  - name: Direct Debits
  - name: Terminals
  - name: Transactions
  - name: Airtime and Data Vending
  - name: Electricity Vending
  - name: CableTV Subscription
  - name: Betting Vending
paths:
  /v1/global-payout/exchange/authorize:
    post:
      description: Transfer funds between your own accounts in different currencies.
      operationId: Authorize Exchange
      parameters:
        - description: Bearer token for authentication.
          in: header
          name: Authorization
          schema:
            type: string
            example: Bearer <token>
          required: true
        - description: The parent accountId of the business.
          in: header
          name: accountId
          schema:
            type: string
            example: 890022ce-bae0-45c1-9b9d-ee7872e6ca27
          required: true
      requestBody:
        required: true
        description: Exchange authorization payload
        content:
          application/json:
            schema:
              type: object
              required:
                - amount
                - sourceCurrency
                - destinationCurrency
                - senderName
                - receiverName
                - sourceCountryIsoCode
                - destinationCountryIsoCode
                - authCode
              properties:
                amount:
                  type: number
                  example: 1
                sourceCurrency:
                  type: string
                  example: USD
                destinationCurrency:
                  type: string
                  example: CDF
                senderName:
                  type: string
                  example: John Doe
                receiverName:
                  type: string
                  example: John Doe
                sourceCountryIsoCode:
                  type: string
                  example: CD
                destinationCountryIsoCode:
                  type: string
                  example: CD
                authCode:
                  type: string
                  format: password
                  example: '5555'
                narration:
                  type: string
                  example: Transfer between my accounts
                lockedExchangeRateId:
                  type: string
                  example: 01kkk4b7rh8pcvtw1s1nxs144s
                  description: >-
                    The exchangeRateId from a prior Fetch Exchange Rates call.
                    When provided, the exchange is fulfilled at that exact rate.
      responses:
        '200':
          description: Exchange authorized successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: '00'
                  description:
                    type: string
                    example: Successful
                  data:
                    type: object
                    properties:
                      wtTransactionId:
                        type: string
                        example: 01kkk8cjk0fpw9jx2n01wd8yfw
                      coreTransactionId:
                        type: string
                        example: API-P2P-CB9EC-0c2d962e-4730-48e7-b522-d65cac511549
                      status:
                        type: string
                        example: PROCESSING
                      coreStatus:
                        type: string
                        example: SUCCESS
                      type:
                        type: string
                        example: EXCHANGE

````