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

# Retrieve Transaction

> Retrieve transaction details given an id.



## OpenAPI

````yaml crypto-as-a-service/openapi.json GET /api/v1/transactions/{txn_id}/
openapi: 3.0.2
info:
  title: B2B API
  version: '1.0'
  description: >-
    B2B API allows a third party to access different use cases and services
    inside of Ripio ecosystem. It is organized around RESTful constraints, with
    requests and responses in JSON format, using HTTP in the standard format and
    the answer codes. The API is designed to be compliant with OpenAPI
    Specification v3.0, which is a trusted open source standard for HTTP-Based
    APIs.


    The API offers the ability to test it with a simple, yet powerful sandbox
    that will enhance developer experience and replicate production capabilities
    in a well isolated and safe environment, giving developers full freedom to
    try the integration without compromises.


    # Error Handling


    If a request to B2B REST API fails, the response will contain an five-digit
    error code with a corresponding error message to indicate the details of the
    error.


    The following code snippet is a sample error response that contains an error
    code and message pair:


    ````

    {

    "code": 40001,

    "type": "NotAuthenticated",

    "detail": {

    "message": "Authentication credentials were not provided.",

    "code": "not_authenticated"

    },

    "status": 403

    }

    ````


    ## Error Codes


    | Code | Error Category | Description | Resolution |

    | :------- | :------ | :------ | :----- |

    | 20000   | Validation Error |  Raised when there is a semantic error in the
    payload of the request.  | Check the docs for precise information on how to
    provide correct values for each resource atribute.   |

    | 20001   | Parse Error |  Raised when the API receives a malformed JSON
    document. |  Check for syntax errors in the payload of your request. Also
    look for sample requests in the docs related to the desired operation.  |

    | 20010   | Expired Quote |  Raised when the received quote to execute has
    expired.  |  Generate a new quote and execute it within the 30 seconds time
    window.  |

    | 20011   | Already Executed Quote |  Raised when the received quote to
    execute has been executed before. |  Try Generating a new quote with the
    former pair/amounts to replicate a similar trade.  |

    | 20012  | Not Enough Balance |  Raised when the amount to operate
    (sale/purchase) is larger than the balance amount of the debited currency.
    |  Check end user's balances in order to inform the discrepancy before quote
    execution. Please contact our support team for further assistance.  |

    | 20013  | Buy Limit Frequency Exceeded |  Raised when the "BUY" frequency
    limit for a given end user has been reached.|  Check end user's limits using
    Limits API in order to inform the discrepancy before performing a quote
    execution. |

    | 20014  | Sell Limit Frequency Exceeded |  Raised when the "SELL" frequency
    limit for a given end user has been reached.|  Check end user's limits using
    Limits API in order to inform the discrepancy before performing a quote
    execution. |

    | 20015  | Buy Limit Amount Exceeded |  Raised when the "BUY" amount limit
    for a given end user has been reached.|  Check end user's limits using
    Limits API in order to inform the discrepancy before performing a quote
    execution. |

    | 20016  | Sell Limit Amount Exceeded |  Raised when the "SELL" amount limit
    for a given end user has been reached.|  Check end user's limits using
    Limits API in order to inform the discrepancy before performing a quote
    execution. |

    | 20017  | Buy Transaction Min Limit Exceeded |  Raised when the "BUY"
    amount min limit on a single transaction is exceeded.|  Check Ripio's min
    and max transaction limits. |

    | 20018  | Buy Transaction Max Limit Exceeded |  Raised when the "BUY"
    amount max limit on a single transaction is exceeded.|  Check Ripio's min
    and max transaction limits. |

    | 20019  | Sell Transaction Min Limit Exceeded |  Raised when the "SELL"
    amount min limit on a single transaction is exceeded.|  Check Ripio's min
    and max transaction limits. |

    | 20020  | Sell Transaction Max Limit Exceeded |  Raised when the "SELL"
    amount max limit on a single transaction is exceeded.|  Check Ripio's min
    and max transaction limits. |

    | 20021  | Banned EndUser |  Raised when a quote execution request comes
    from a banned user.| Please reach out our support team in order to get full
    detail on why the end user has been banned. |

    | 20022  | Swap Transaction Min Limit Exceeded |  Raised when the "SWAP"
    amount min limit on a single transaction is exceeded.|  Check Ripio's min
    and max transaction limits. |

    | 20023  | Swap Transaction Max Limit Exceeded |  Raised when the "SWAP"
    amount max limit on a single transaction is exceeded.|  Check Ripio's min
    and max transaction limits. |

    | 20024  | Swap Limit Frequency Exceeded |  Raised when the "SWAP" frequency
    limit for a given end user has been reached.|  Check end user's limits using
    Limits API in order to inform the discrepancy before performing a quote
    execution. |

    | 20025  | Swap Limit Amount Exceeded |  Raised when the "SWAP" amount limit
    for a given end user has been reached.|  Check end user's limits using
    Limits API in order to inform the discrepancy before performing a quote
    execution. |

    | 20026  | Quote With No Price |  Raised when the received reusable quote to
    execute has no price. |  Try Generating a new reusable quote with the former
    pair to replicate a similar trade.  |

    | 20027  | Expired Withdrawal Fee |  Raised when trying to execute a 
    withdrawal fee that has already expired. |  Request another withdrawal Fee. 
    |

    | 20029  | Invalid address |  Raised when the address provided  is not valid
    on given network. |  Try with a valid addres for that network.  |

    | 20030  | Kyc not approved for end user |  Raised  when the end user
    doesn't have a kyc process approved. |  Check the status of end user's
    verification submission |

    | 20031  | Kyc already approved for end user |  Raised  when the end user
    already has an approved kyc process. |  - |

    | 20032  | Invalid or disabled payment method type |  Raised  when the
    payment_method_type does not exist or is disabled  for the acccount. |
    Please reach out our support team.  |

    | 20033  | Frequency limit exceeded for fiat withdrawals |  Raised  when the
    QTY limit for a given currency in a FIAT_WITHDRAWAL  operation is exceeded.
    | -  |

    | 20034  | Amount limit exceeded for fiat withdrawals |  Raised when the
    amount limit for a given currency in a FIAT_WITHDRAWAL operation is
    exceeded. | -  |

    | 20035  | Fiat account is required |  Raised  when a fiat account is
    required. | Create a Fiat account first.  |

    | 20036  | Withdrawal amount less than network dust limit. |  Raised when
    the amount of withdrawal request is less to the network dust limit. |
    Increase Withrawal amount.  |

    | 20037  | There is no address created for end user and given network. | 
    Raised when there is no address for a given concrete network name. | Create
    an AutoSwap address first.  |

    ||

    | 40000   | Authentication Failed | Raised when an incoming request includes
    incorrect authentication. | Check for invalid credentials in your request
    when trying to authenticate. |

    | 40001   | Not Authenticated |  Raised when an unauthenticated request
    fails the permission checks. | Check if your request contains a valid and
    non-expired `access_token`. |

    | 40003   | Permission Denied | Raised when an authenticated request fails
    the permission checks. | Check if you have OAuth scopes to access requested
    resource. Please contact our support team if you think this is an error. |

    | 40004   | Not Found |  Raised when a resource does not exists at the given
    URL. | Check if the resource you're looking for does exist. |

    | 40005   | Method Not Allowed | Raised when an incoming request has been
    performed with certain HTTP verb that is not valid for the requested
    resource. | Check the resource's docs section to learn the accepted HTTP
    methods. |

    | 40006   | Bad Request | Raised when historical market price API endpoint
    has not been used properly. | Check for syntax errors in the payload of your
    request. Also look for sample requests in the docs related to the desired
    operation. |

    | 40007   | Bad Request | Raised when a currency network is not allowed to
    operate the selected currency. | Check if your request contains a valid
    network for the selected currency. |

    | 40008   | Not Found | Raised when a currency doesn't have its limits
    configured. | Please reach out our support team with the error details and
    detailed execution flow. |

    | 40009   | Bad Request | Raised when an existing Quote with  defined
    external_ref has not been executed, thus it can  not be excuted
    idempotently. | Use another external_ref for the Quote. |

    | 40010   | Service Unavailable | Raised when there are  no addresses
    available for networks compatible with a specific network name. | Please
    reach out our support team with the error details and detailed execution
    flow. |

    | 40015   | Unsupported Media Type | Raised when the content type of the
    request data is not JSON compliant. | Check if your request data is
    compliant with JSON format. |

    | 40029   | Throttled | Raised when an incoming request fails the throttling
    checks. | Check if you are exceding the daily/hourly request quota for your
    account. Please contact our support team if you think you'll need an
    extended quota for your use-case. |

    ||

    | 50003   | Service Unavailable | Raised when the service (or requested
    resource) is not available. | Please reach out our support team with the
    error details and detailed execution flow. |
  contact:
    name: Ripio
    email: b2b@ripio.com
    url: https://ripio.com
  termsOfService: https://www.ripio.com/ar/terms/
servers:
  - url: https://sandbox-b2b.ripio.com
    description: Sandbox environment
  - url: https://b2b-api.ripio.com/
    description: Production environment
security:
  - OAuth2: []
tags:
  - name: Access Token
  - name: Addresses
  - name: Auto Swap Addresses
  - name: Balance
  - name: Beneficiary Fiat Accounts
  - name: Deposit IPN
  - name: Deposits
  - name: End User
  - name: Fiat Accounts
  - name: IPN Webhooks
  - name: Pairs
  - name: Periodic Limits
  - name: Quote Execution
  - name: Quotes
  - name: Rates
  - name: Reusable Quote Execution
  - name: Reusable Quotes
  - name: Service Status
  - name: Swap Reusable Quote Execution
  - name: Swap Reusable Quotes
  - name: Transactions
  - name: TXN Limits
  - name: Withdrawals
  - name: Fiat Withdrawals
  - name: Fiat Deposits
  - name: KYC Requirements
  - name: KYC Submissions
  - name: Simulate Fiat Deposit
  - name: Yields
paths:
  /api/v1/transactions/{txn_id}/:
    parameters:
      - schema:
          type: string
        name: txn_id
        in: path
        required: true
    get:
      tags:
        - Transactions
      summary: Retrieve Transaction
      description: Retrieve transaction details given an id.
      operationId: retrieveTransaction
      parameters:
        - name: txn_id
          in: path
          required: true
          description: ''
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                description: ''
                title: Transaction
                properties:
                  id:
                    type: string
                    format: uuid
                    description: UUID used as txn identifier.
                  created_at:
                    type: string
                    format: date-time
                    description: ISO DateTime indicating creation date of txn.
                    readOnly: true
                  end_user:
                    type: string
                    description: Indicates which end user was involved in the transaction.
                    readOnly: true
                  op_type:
                    enum:
                      - BUY
                      - SELL
                      - SWAP
                      - DEPOSIT
                      - WITHDRAWAL
                      - PEER_TO_PEER
                      - COIN_EARN
                      - COIN_BURN
                      - FIAT_DEPOSIT
                      - FIAT_WITHDRAWAL
                    type: string
                    description: >-
                      Indicates whether the transaction is for `BUY`, `SELL`,
                      `SWAP`, `DEPOSIT`, `WITHDRAWAL`, `PEER_TO_PEER`,
                      `COIN_EARN`, `COIN_BURN`, `FIAT_DEPOSIT`,
                      `FIAT_WITHDRAWAL`.
                    readOnly: true
                  operation:
                    oneOf:
                      - type: object
                        description: >-
                          If the transaction represents a `BUY` or `SELL`
                          operation, this object will detail the information of
                          the trade.
                        x-examples:
                          example-1:
                            id: 636ed595-714b-4785-8d36-3dcac7d2567d
                            external_ref: 71736720-4d62-473b-9916-015e59986e69
                            quote_id: 02642013-9310-47c4-8e85-67cba34d60a5
                            txn_id: 39402e8a-0f0e-49dc-928f-c72cf973383e
                            end_user_id: 73aa41e6-8a97-45f8-8d20-b2bd0cc91193
                            rate: '140.00000000'
                            market_rate: '140.00000000'
                            charged_fee: '0E-8'
                            fee_charged_in_fiat: true
                            deferred_charged_fee: true
                            crypto_charged_fee: '0E-20'
                            base_amount: '11.13622013'
                            quote_amount: '1559.07081820'
                            base_asset: RTEST
                            quote_asset: ARS
                            created_at: '2025-01-22T20:20:26.218009Z'
                            metadata: '{}'
                            invoice_pdf: null
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: UUID used as trade identifier.
                          external_ref:
                            type: string
                            description: >-
                              Arbitrary identifier used as external_ref when the
                              quote was created.
                          quote_id:
                            type: string
                            format: uuid
                            description: UUID used as quote identifier.
                          txn_id:
                            type: string
                            format: uuid
                            description: >-
                              UUID used as Transaction identifier. Useful to
                              relate this object trade with a transaction
                              object.
                          end_user_id:
                            type: string
                            description: Arbitrary string used as end_user identifier.
                          rate:
                            type: string
                            description: Indicates the exchange rate used for conversion.
                          market_rate:
                            type: string
                            description: >-
                              Indicates the market rate when the trade was
                              executed.
                          charged_fee:
                            type: string
                            description: Indicates trade's applied fee.
                          fee_charged_in_fiat:
                            type: boolean
                            description: Indicates if the fee was charged in fiat currency.
                          deferred_charged_fee:
                            type: boolean
                            description: Indicates if the fee was deferred.
                          crypto_charged_fee:
                            type: string
                            description: Indicates the fee charged in crypto currency.
                          base_amount:
                            type: string
                            description: >-
                              Indicates the amount of units or equivalence in
                              the quote for base currency.
                          quote_amount:
                            type: string
                            description: >-
                              Indicates the amount of units or equivalence in
                              the quote for quote currency.
                          base_asset:
                            type: string
                            description: >-
                              Indicates the base currency involved in the
                              quotation.
                          quote_asset:
                            type: string
                            description: >-
                              Indicates the quote currency involved in the
                              quotation.
                          created_at:
                            type: string
                            format: date-time
                            description: ISO DateTime indicating creation date of trade.
                            readOnly: true
                        required:
                          - id
                          - external_ref
                          - quote_id
                          - txn_id
                          - end_user_id
                          - rate
                          - charged_fee
                          - fee_charged_in_fiat
                          - deferred_charged_fee
                          - base_amount
                          - quote_amount
                          - base_asset
                          - quote_asset
                          - created_at
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                      - type: object
                        description: >-
                          If the transaction represents a `SWAP` operation, this
                          object will detail the information of the swap.
                        x-examples:
                          example-1:
                            id: e5151bb5-7bae-4013-b27b-0f49c2d65597
                            external_ref: 71736720-4d62-473b-9916-015e59986e69
                            quote_id: 02642013-9310-47c4-8e85-67cba34d60a5
                            txn_id: 5f753809-062b-41e7-b048-7c5bc3948b94
                            end_user_id: 73aa41e6-8a97-45f8-8d20-b2bd0cc91193
                            rate: '140.00000000'
                            market_rate: '140.00000000'
                            charged_fee: '0E-8'
                            base_amount: '11.13622013'
                            quote_amount: '1559.07081820'
                            base_asset: RTEST
                            quote_asset: ARS
                            created_at: '2025-01-22T20:20:26.218009Z'
                            metadata: '{}'
                            invoice_pdf: base64_encoded_pdf
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: UUID used as trade identifier.
                          external_ref:
                            type: string
                            description: >-
                              Arbitrary identifier used as external_ref when the
                              quote was created.
                          quote_id:
                            type: string
                            format: uuid
                            description: UUID used as quote identifier.
                          txn_id:
                            type: string
                            format: uuid
                            description: >-
                              UUID used as Transaction identifier. Useful to
                              relate this object trade with a transaction
                              object.
                          end_user_id:
                            type: string
                            description: Arbitrary string used as end_user identifier.
                          rate:
                            type: string
                            description: Indicates the exchange rate used for conversion.
                          market_rate:
                            type: string
                            description: >-
                              Indicates the market rate when the trade was
                              executed.
                          charged_fee:
                            type: string
                            description: Indicates trade's applied fee.
                          base_amount:
                            type: string
                            description: >-
                              Indicates the amount of units or equivalence in
                              the quote for base currency.
                          quote_amount:
                            type: string
                            description: >-
                              Indicates the amount of units or equivalence in
                              the quote for quote currency.
                          base_asset:
                            type: string
                            description: >-
                              Indicates the base currency involved in the
                              quotation.
                          quote_asset:
                            type: string
                            description: >-
                              Indicates the quote currency involved in the
                              quotation.
                          created_at:
                            type: string
                            format: date-time
                            description: ISO DateTime indicating creation date of trade.
                            readOnly: true
                        required:
                          - id
                          - external_ref
                          - quote_id
                          - txn_id
                          - end_user_id
                          - rate
                          - charged_fee
                          - base_amount
                          - quote_amount
                          - base_asset
                          - quote_asset
                          - created_at
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                      - type: object
                        description: >-
                          If the transaction represents a `DEPOSIT` operation,
                          this object will detail the information of the
                          deposit.
                        x-examples:
                          example-1:
                            id: c6e5fb9b-b57e-46d1-b911-812c8e65e382
                            hash: >-
                              0xd32844ded49dc0288dcfebd5229fc9535dd648992eaca66ee841af39e03db5cc
                            index: 101
                            amount: '0.000100000000000000'
                            create_date: '2024-11-14T19:18:11.635653Z'
                            created_at: '2024-11-14T19:18:11.635653Z'
                            update_date: '2024-11-14T19:20:46.353098Z'
                            updated_at: '2024-11-14T19:20:46.353098Z'
                            confirmation_date: '2024-11-14T19:20:46.330463Z'
                            currency_code: RTEST
                            is_blocked: false
                            reason: ''
                            address_destination: '0x2642662552D718244240EadbC25514198791dc83'
                            address_origin: '0x05946b0d5E413e45069BeC923004F9A3c8F70B2B'
                            end_user_id: 86c741a2-c3c8-46b1-a807-4fa1f40bf069
                            status: COMPLETED
                            network: ethereum_sepolia
                            risk_score: null
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: UUID used to identify the deposit.
                          hash:
                            type: string
                            description: Hash of the transaction on the blockchain.
                          index:
                            type: integer
                            description: Index of the transaction on the blockchain.
                          amount:
                            type: string
                            description: Amount of the deposit.
                          created_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating creation date of the
                              deposit.
                            readOnly: true
                          updated_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating last update date of the
                              deposit.
                            readOnly: true
                          confirmation_date:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating confirmation date of the
                              deposit.
                          currency_code:
                            type: string
                            description: Currency of the deposit.
                          is_blocked:
                            type: boolean
                            description: Indicates if the deposit is blocked.
                          reason:
                            type: string
                            description: >-
                              If the deposit is blocked this field will contain
                              the reason.
                          address_destination:
                            type: string
                            description: Destination address of the deposit.
                          address_origin:
                            type: string
                            description: Origin address of the deposit.
                          end_user_id:
                            type: string
                            description: Arbitrary string used as end_user identifier.
                          status:
                            type: string
                            description: Indicates the status of the deposit.
                          network:
                            type: string
                            description: Indicates the network where the deposit was made.
                        required:
                          - id
                          - amount
                          - created_at
                          - updated_at
                          - currency_code
                          - is_blocked
                          - reason
                          - address_destination
                          - address_origin
                          - end_user_id
                          - status
                          - network
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                      - type: object
                        description: >-
                          If the transaction represents a `WITHDRAWAL`
                          operation, this object will detail the information of
                          the withdrawal.
                        x-examples:
                          example-1:
                            id: c749d1e0-47c1-4478-af0b-1149bdc1e594
                            transaction_id: d48d24f1-6801-44f6-a9ac-c5210ab700c5
                            created_at: '2024-11-14T19:17:41.538960Z'
                            confirmation_date: '2024-11-14T19:20:02.547553Z'
                            txn_hash: >-
                              d32844ded49dc0288dcfebd5229fc9535dd648992eaca66ee841af39e03db5cc
                            provisory_txn_hash: >-
                              d32844ded49dc0288dcfebd5229fc9535dd648992eaca66ee841af39e03db5cc
                            end_user_id: 86c741a2-c3c8-46b1-a807-4fa1f40bf069
                            currency: RTEST
                            amount: '0.000100000000000000'
                            debited_amount: '0.012857840000000000'
                            address: '0x2642662552D718244240EadbC25514198791dc83'
                            network_name: ETHEREUM_SEPOLIA
                            risk_score: null
                            status: COMPLETED
                            is_blocked: false
                            reason: ''
                            external_ref: test_IPN_sandbox_1
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: UUID used to identify the withdrawal.
                          transaction_id:
                            type: string
                            format: uuid
                            description: UUID used to identify the transaction.
                          created_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating creation date of the
                              withdrawal.
                            readOnly: true
                          confirmation_date:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating confirmation date of the
                              withdrawal.
                          txn_hash:
                            type: string
                            description: Hash of the transaction on the blockchain.
                          end_user_id:
                            type: string
                            description: Arbitrary string used as end_user identifier.
                          currency:
                            type: string
                            description: Currency of the withdrawal.
                          amount:
                            type: string
                            description: Amount of the withdrawal.
                          debited_amount:
                            type: string
                            description: Amount debited from the user.
                          address:
                            type: string
                            description: Destination address of the withdrawal.
                          network_name:
                            type: string
                            description: >-
                              Indicates the network where the withdrawal was
                              made.
                          status:
                            type: string
                            description: Indicates the status of the withdrawal.
                          is_blocked:
                            type: boolean
                            description: Indicates if the withdrawal is blocked.
                          reason:
                            type: string
                            description: >-
                              If the withdrawal is blocked this field will
                              contain the reason.
                          external_ref:
                            type: string
                            description: >-
                              Arbitrary string used as external_ref when the
                              withdrawal was created.
                        required:
                          - id
                          - transaction_id
                          - created_at
                          - txn_hash
                          - end_user_id
                          - currency
                          - amount
                          - debited_amount
                          - address
                          - status
                          - is_blocked
                          - reason
                          - external_ref
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                      - type: object
                        description: >-
                          If the transaction represents a `PEER_TO_PEER`
                          operation, this object will detail the information of
                          the peer to peer transaction.
                        x-examples:
                          example-1:
                            id: peer_to_peer_id_example
                            sender: sender_external_ref
                            receiver: receiver_external_ref
                            sender_transaction_id: sender_transaction_id_example
                            receiver_transaction_id: receiver_transaction_id_example
                            currency: RTEST
                            amount: '100.00'
                            created_at: '2025-01-22T20:20:26.328972Z'
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: >-
                              UUID used to identify the peer to peer
                              transaction.
                          sender:
                            type: string
                            description: >-
                              Arbitrary string used as end_user identifier for
                              the one performing the transaction.
                          receiver:
                            type: string
                            description: >-
                              Arbitrary string used as end_user identifier for
                              the one receiving the transaction.
                          sender_transaction_id:
                            type: string
                            format: uuid
                            description: >-
                              UUID used to identify the transaction of the
                              sender.
                          receiver_transaction_id:
                            type: string
                            format: uuid
                            description: >-
                              UUID used to identify the transaction of the
                              receiver.
                          currency:
                            type: string
                            description: Currency of the peer to peer transaction.
                          amount:
                            type: string
                            description: Amount of the peer to peer transaction.
                          created_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating creation date of the peer
                              to peer transaction.
                            readOnly: true
                        required:
                          - id
                          - sender
                          - receiver
                          - sender_transaction_id
                          - receiver_transaction_id
                          - currency
                          - amount
                          - created_at
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                      - type: object
                        description: >-
                          If the transaction represents a `COIN_EARN` operation,
                          this object will detail the information of the coin
                          earn transaction.
                        x-examples:
                          example-1:
                            id: coin_earn_id_example
                            external_ref: external_ref_example
                            end_user: end_user_external_ref
                            transaction_id: transaction_id_example
                            currency: RTEST
                            amount: '50.00'
                            created_at: '2025-01-22T20:20:26.328972Z'
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: UUID used to identify the coin earn transaction.
                          external_ref:
                            type: string
                            description: >-
                              Arbitrary string used as external_ref when the
                              coin earn transaction was created.
                          end_user:
                            type: string
                            description: Arbitrary string used as end_user identifier.
                          transaction_id:
                            type: string
                            format: uuid
                            description: UUID used to identify the transaction.
                          currency:
                            type: string
                            description: Currency of the coin earn transaction.
                          amount:
                            type: string
                            description: Amount of the coin earn transaction.
                          created_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating creation date of the coin
                              earn transaction.
                            readOnly: true
                        required:
                          - id
                          - external_ref
                          - end_user
                          - transaction_id
                          - currency
                          - amount
                          - created_at
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                      - type: object
                        description: >-
                          If the transaction represents a `COIN_BURN` operation,
                          this object will detail the information of the coin
                          burn transaction.
                        x-examples:
                          example-1:
                            id: coin_burn_id_example
                            external_ref: external_ref_example
                            end_user: end_user_external_ref
                            transaction_id: transaction_id_example
                            currency: RTEST
                            amount: '25.00'
                            created_at: '2025-01-22T20:20:26.328972Z'
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: UUID used to identify the coin burn transaction.
                          external_ref:
                            type: string
                            description: >-
                              Arbitrary string used as external_ref when the
                              coin burn transaction was created.
                          end_user:
                            type: string
                            description: Arbitrary string used as end_user identifier.
                          transaction_id:
                            type: string
                            format: uuid
                            description: UUID used to identify the transaction.
                          currency:
                            type: string
                            description: Currency of the coin burn transaction.
                          amount:
                            type: string
                            description: Amount of the coin burn transaction.
                          created_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating creation date of the coin
                              burn transaction.
                            readOnly: true
                        required:
                          - id
                          - external_ref
                          - end_user
                          - transaction_id
                          - currency
                          - amount
                          - created_at
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                      - type: object
                        description: >-
                          If the transaction represents a `FIAT_DEPOSIT`
                          operation, this object will detail the information of
                          the fiat deposit.
                        x-examples:
                          example-1:
                            id: fiat_deposit_id_example
                            amount: '1000.00'
                            created_at: '2025-01-22T20:20:26.328972Z'
                            updated_at: '2025-01-22T20:25:00.414331Z'
                            currency_code: ARS
                            end_user_id: end_user_external_ref
                            status: COMPLETED
                            payment_method_type: BANK_TRANSFER
                            refunded: false
                            refund_fiat_withdrawal_id: refund_fiat_withdrawal_id_example
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: UUID used to identify the fiat deposit.
                          amount:
                            type: string
                            description: Amount of the fiat deposit.
                          created_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating creation date of the fiat
                              deposit.
                            readOnly: true
                          updated_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating last update date of the
                              fiat deposit.
                            readOnly: true
                          currency_code:
                            type: string
                            description: Currency of the fiat deposit.
                          end_user_id:
                            type: string
                            description: Arbitrary string used as end_user identifier.
                          status:
                            type: string
                            description: Indicates the status of the deposit.
                          payment_method_type:
                            type: string
                            description: Indicates the payment method used for the deposit.
                          refunded:
                            type: boolean
                            description: Indicates if the deposit was refunded.
                          refund_fiat_withdrawal_id:
                            type: string
                            format: uuid
                            description: >-
                              UUID used to identify the fiat withdrawal that
                              refunded the deposit.
                        required:
                          - id
                          - amount
                          - created_at
                          - updated_at
                          - currency_code
                          - end_user_id
                          - status
                          - payment_method_type
                          - refunded
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                      - type: object
                        description: >-
                          If the transaction represents a `FIAT_WITHDRAWAL`
                          operation, this object will detail the information of
                          the fiat withdrawal.
                        x-examples:
                          example-1:
                            id: fiat_withdrawal_id_example
                            transaction_id: transaction_id_example
                            created_at: '2025-01-22T20:20:26.328972Z'
                            updated_at: '2025-01-22T20:25:00.414331Z'
                            end_user_id: end_user_external_ref
                            currency_code: ARS
                            amount: '1000.00'
                            status: COMPLETED
                            external_ref: external_ref_example
                            beneficiary_fiat_account_id: beneficiary_fiat_account_id_example
                            is_fiat_deposit_refund: false
                            refunded_fiat_deposit: refunded_fiat_deposit_example
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: UUID used to identify the fiat withdrawal.
                          transaction_id:
                            type: string
                            format: uuid
                            description: UUID used to identify the transaction.
                          created_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating creation date of the fiat
                              withdrawal.
                            readOnly: true
                          updated_at:
                            type: string
                            format: date-time
                            description: >-
                              ISO DateTime indicating last update date of the
                              fiat withdrawal.
                            readOnly: true
                          end_user_id:
                            type: string
                            description: Arbitrary string used as end_user identifier.
                          currency_code:
                            type: string
                            description: Currency of the fiat withdrawal.
                          amount:
                            type: string
                            description: Amount of the fiat withdrawal.
                          status:
                            type: string
                            description: Indicates the status of the withdrawal.
                          external_ref:
                            type: string
                            description: >-
                              Arbitrary string used as external_ref when the
                              fiat withdrawal was created.
                          beneficiary_fiat_account_id:
                            type: string
                            format: uuid
                            description: >-
                              UUID used to identify the beneficiary fiat
                              account.
                          is_fiat_deposit_refund:
                            type: boolean
                            description: >-
                              Indicates if the withdrawal is a refund of a
                              deposit.
                          refunded_fiat_deposit:
                            type: string
                            format: uuid
                            description: >-
                              UUID used to identify the fiat deposit that was
                              refunded.
                        required:
                          - id
                          - transaction_id
                          - created_at
                          - updated_at
                          - end_user_id
                          - currency_code
                          - amount
                          - status
                          - external_ref
                          - beneficiary_fiat_account_id
                          - is_fiat_deposit_refund
                        readOnly: true
                        x-stoplight:
                          id: 0vqlkdmhgi3f7
                  status:
                    type: string
                    description: Indicates the status of the transaction.
                    readOnly: true
                    example: COMPLETED
                required:
                  - id
                  - created_at
                  - end_user
                  - op_type
                x-stoplight:
                  id: 5671qhgh98enx
              examples:
                example-1:
                  value:
                    id: 497f6eca-6276-4993-bfeb-53cbbbba6f08
                    created_at: '2019-08-24T14:15:22Z'
                    end_user: string
                    op_type: BUY
                    operation:
                      id: 636ed595-714b-4785-8d36-3dcac7d2567d
                      external_ref: 71736720-4d62-473b-9916-015e59986e69
                      quote_id: 02642013-9310-47c4-8e85-67cba34d60a5
                      txn_id: 39402e8a-0f0e-49dc-928f-c72cf973383e
                      end_user_id: 73aa41e6-8a97-45f8-8d20-b2bd0cc91193
                      rate: '140.00000000'
                      market_rate: '140.00000000'
                      charged_fee: '0E-8'
                      fee_charged_in_fiat: true
                      deferred_charged_fee: true
                      crypto_charged_fee: '0E-20'
                      base_amount: '11.13622013'
                      quote_amount: '1559.07081820'
                      base_asset: RTEST
                      quote_asset: ARS
                      created_at: '2025-01-22T20:20:26.218009Z'
          description: Successful response
      security:
        - OAuth2:
            - read
            - write
components:
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          scopes:
            read: Default scope to read all resources.
            write: Default scope to performe write operations on certain resources.
          tokenUrl: https://sandbox-b2b.ripio.com/oauth2/token/
      description: >
        B2B’s White Label API uses OAuth2. Currently there is only one supported
        authentication flow:


        * **clientCredentials** allows you to access your own B2B account
        (First-Party Integration) and performs transactions against the public
        API. This oauth2 flow is well suited for this API, as it allows
        machine-to-machine communication.


        Every call to the API has to be authenticated with an OAuth2 Token. In
        order to request this token, you will need to have sandbox or production
        API Keys (client id and client secret) that will be needed to generate a
        credential in order to negotiate an ephemeral access token.


        Every request must be accompianed by an `Authorization` header with a
        value that follows the following schema: `Bearer ACCESS_TOKEN`

````