---
title: "Retrieve Details of Wallet Transaction"
source_url: https://docs.rapyd.net/en/retrieve-details-of-wallet-transaction.html
lang: en
---

# Retrieve Details of Wallet Transaction

Retrieve the details of a wallet transaction.

> **Note:**
>
> The response fields vary depending on the type of the transaction. See [Transaction Types](https://docs.rapyd.net/en/transaction-types.md "Transaction Types").
>
> The examples do not include responses of all transaction types.

> **Note:**
>
> This endpoint replaces the deprecated endpoint - `GET /v1/user/:wallet/transactions/:transaction`
>
> Rapyd no longer supports the deprecated endpoint.

### Parameters

### Request Path Parameters

- - ewallet
  - ID of the wallet. String starting with **ewallet_**.
- - transaction
  - ID of the transaction, from the response to [List Wallet Transactions](https://docs.rapyd.net/en/list-wallet-transactions.md "List Wallet Transactions"). String starting with **wt_**.

### Request Header Parameters

- - access_key
  - Unique access key provided by Rapyd for each authorized user.

    See [Developers](https://docs.rapyd.net/en/developers.md "Developers").
- - Content-Type
  - Indicates that the data appears in JSON format. Set to **application/json**.
- - salt
  - Random string. Recommended length: 8-16 characters.
- - signature
  - Signature calculated for each request individually.

    See [Request Signatures](https://docs.rapyd.net/en/request-signatures.md "Request Signatures").
- - timestamp
  - Timestamp for the request, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds).

### Response Parameters

- - action_data
  - The fields of the object vary depending on the type of the transaction.

    - - address
      - Billing address associated with the payment. For details about the fields of the 'address' object, see [Create Address](https://docs.rapyd.net/en/create-address.md "Create Address").
    - - amount
      - Amount of the transaction, in units defined in `currency_code`.
    - - balance_type
      - Type of the currency account balance of the wallet affected by the transaction. See [Wallet Balance Types](https://docs.rapyd.net/en/wallet-balance-types.md "Wallet Balance Types").
    - - captured
      - Indicates that the payment was successfully captured.
    - - client_type
      - Reserved.
    - - complete_payment_url
      - URL where the customer is redirected when payment is successful, after returning from an external page such as a 3DS page. Does not support localhost URLs.
    - - country_code
      - Country of the sender. Two-letter ISO 3166-1 ALPHA-2 code.
    - - created_at
      - Time of creation of the transaction object, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"),
    - - currency_code
      - The transaction currency. In transactions with foreign exchange, this is the source currency. Three-letter ISO 4217 code for the currency.
    - - customer_token
      - ID of the customer who is making the payment. String starting with **cus_**.
    - - description
      - Description of the transaction.
    - - dest_currency
      - The destination currency in transactions with foreign exchange. Three-letter ISO 4217 code for the currency.
    - - dest_currency_symbol
      - A URL link to the symbol of the destination currency.
    - - destination_city_id
      - Reserved.
    - - destination_ewallet_id
      - ID of the wallet that the money is transferred to. String starting with **ewallet_**.
    - - destination_transaction_id
      - ID of the transaction with regard to the destination. String starting with **wt_**.
    - - dispute
      - Details about the dispute, if the transaction was disputed.
    - - error_payment_url
      - URL where the customer is redirected when payment is not successful, after returning from an external page, such as a 3DS page. Does not support localhost URLs.
    - - escrow
      - Determines whether the payment is held in escrow for later release. Relevant for card payments. Relevant to the request.
    - - ewallet_id
      - ID of the wallet that the money is transferred from. String starting with **ewallet_**.
    - - ewallets
      - An array of one object, which contains the following fields:

        - - amount
          - The amount of the payment to the wallet, in units of the currency defined in `currency`.
        - - ewallet_id
          - ID of the wallet.
        - - percent
          - The percentage that is paid to the wallet out of the total payment.
        - - refunded_amount
          - The total amount refunded against this payment, in units of the currency defined in `currency`.
    - - expiration
      - Determines the time which the transaction must be completed by, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"),.
    - - expired_at
      - Determines the time which the transaction must be completed by, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"),. Relevant to cash payouts.
    - - failure_code
      - Error code explaining reason for failure of the transaction.
    - - failure_message
      - Message to the merchant, explaining the reason for failure of payment capture.
    - - fixed_side
      - Determines whether the FX rate is fixed for the buy side or for the sell side. Relevant for payment with FX.
    - - flow_type
      - Indicates the type of payment flow. One of the following:

        - **redirect_url** - The customer is directed to a URL to complete the transaction.
        - **self_service_pos** - The customer completes the transaction at a point-of-sale location.
        - **bank_transfer** - The customer completes the transaction at the bank branch or bank website.
        - **card** - The transaction is completed immediately or on request of the merchant.
        - **ewallet** - The transaction is completed immediately or when funds are released from escrow.
    - - fx_rate
      - Currency conversion rate for the transaction. Decimal.
    - - group_payment
      - ID of the group payment. Relevant when the payment is part of a group payment. The ID of the group payment, a string starting with **gp_**.
    - - id
      - ID of the transaction. UUID.
    - - instructions
      - Describes how the customer makes the payment. Contains the following fields:

        - - name
          - Description of the payment method.
        - - steps
          - An array containing a list of steps for the customer to take. Each step is named **step*N***, where ***N*** is an integer.
    - - invoice
      - ID of the invoice that this payment is for. String starting with **inv_**.
    - - is_group
      - Indicates that the payment is a group payment.
    - - is_partial
      - Indicates that the payment has been partially paid. When **false**, indicates that the payment is unpaid or fully paid.
    - - merchant_reference_id
      - Identifier defined by the client for reference purposes. Limit: 45 characters.
    - - merchant_requested_amount
      - The amount of the payment in units of the currency paid by the sender, as defined in `merchant_requested_currency`. Relevant to payments with foreign exchange.
    - - merchant_requested_currency
      - The currency that the payment is converted into. Corresponds to `currency` in the request. Three-letter ISO 4217 code. Relevant to payments with foreign exchange.
    - - metadata
      - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata").
    - - order
      - ID of the order that this payment is for. Relevant when the payment is for an order.
    - - original_amount
      - Value depends on the transaction type:

        - **Foreign exchange payments** - The amount paid by the sender, in units of the currency defined in `requested_currency`, including gross transaction fees and gross FX fees.
        - **Payments not involving foreign exchange** - The amount of the payment, in units of the currency defined in `currency_code`, including gross transaction fees.
    - - outcome
      - Contains the following fields:

        - **network_status** - Network status of the payment. One of the following values:

          - approved_by_network
          - declined_by_network
          - not_sent_to_network
          - reversed_after_approval
        - **risk_level** - Assessment of the risk level of the payment. One of the following values:

          - normal
          - elevated
          - highest
          - not_assessed
        - **seller_message** - Message to the merchant.
        - **type** - One of the following values:

          - authorized
          - manual_review
          - issuer_declined
          - blocked
          - invalid
        - **reason** - More detailed indication of the reason indicated by `type`. One of the following values:

          - highest_risk_level - Blocked by default rules.
          - elevated_risk_level - Placed in review by default rules.
          - rule - Placed in review by rules defined by the client.
    - - paid
      - Indicates whether the payment has been fully collected.
    - - paid_at
      - Time of the transaction, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"),.
    - - payment_fees
      - Defines transaction fees and foreign exchange fees.
    - - payment_method
      - 'payment_method' object or ID. If not specified in this field, the payment method is the default payment method specified for the customer.The 'payment_method' object contains a `type` field and a `fields` object.
    - - payment_method_data
      - Information about the payment method.
    - - payment_method_options
      - Object describing additional information for the payment. To determine the fields, run [Get Payment Method Required Fields](https://docs.rapyd.net/en/get-payment-method-required-fields.md "Get Payment Method Required Fields").
    - - payment_method_type
      - The type of transaction method, payment or payout type. Use [List Payout Method Types](https://docs.rapyd.net/en/list-payout-method-types.md "List Payout Method Types") or [List Payment Methods by Country](https://docs.rapyd.net/en/list-payment-methods-by-country.md "List Payment Methods by Country") for a list of supported types for a country.
    - - payment_method_type_category
      - Category of payment method type. One of the following values:

        - **bank_redirect**
        - **bank_transfer**
        - **card**
        - **cash**
        - **ewallet**
        - **rapyd_ewallet**
    - - phone_number
      - The customer's primary phone number in E.164 format. The merchant is responsible for verifying that the number is correct. One method of verifying might be to send an activation code to the phone by SMS, with a limited time for response.
    - - price_before_changes
      - Reserved.
    - - proportional_refund
      - Indicates that the payment is a group payment and refund is made in proportion between group payers.
    - - quote_id
      - ID of the currency exchange quote.
    - - quotes_comparisons
      - Reserved.
    - - reason
      - Reason for issuing the transaction. Free text.
    - - receipt_email
      - Email address that the receipt for this transaction is sent to.
    - - receipt_number
      - Reserved.
    - - redirect_url
      - URL where the customer can complete a payment. Relevant when `payment_flow_type` is **redirect**.
    - - refunded
      - Indicates whether there was a refund against this payment.
    - - refunded_amount
      - The total amount refunded against this payment, in units of the currency defined in `currency`.
    - - refunds
      - An object containing the following fields:

        - **data** - A list of up to three refunds.
        - **has_more** - Indicates whether there are more than three refunds against this payment.
        - **total_count** - Total number of refunds against this payment.
        - **url** - URL for requesting all of the refunds against this payment.
    - - rewards
      - Reserved.
    - - source_ewallet_id
      - ID of the wallet that the money is transferred from. String starting with **ewallet_**.
    - - source_transaction_id
      - ID of the transaction with regard to the source. String starting with **wt_**.
    - - src_currency
      - The source currency in transactions with foreign exchange. Three-letter ISO 4217 code for the currency.
    - - src_currency_symbol
      - A URL link to the symbol for the source currency.
    - - statement_descriptor
      - A text description suitable for a customer's payment statement. Limited to 22 characters.
    - - status
      - Status of the transaction. One of the following:

        - **CANCELED**
        - **CLOSED**
    - - subtype
      - Subtype of the transaction.
    - - textual_codes
      - A set of text codes for the customer to use to complete the steps described in the `instructions` field. Contains one or more of the following fields:

        - **code**
        - **pay_code**
        - **pairing_code**
        - **payment_code**
        - **response_code**
    - - transaction_id
      - ID of the associated transaction. String starting with **wt_**.
    - - type
      - Type of transaction. See [Transaction Types](https://docs.rapyd.net/en/transaction-types.md "Transaction Types").
    - - visual_codes
      - A set of images for the customer to use to complete the steps described in the `instructions` field. For example, a QR code or barcode.
- - amount
  - Amount of the transaction, in units of the currency defined in `currency`. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 4217:2015.
- - balance
  - Amount of the balance affected by the transaction.
- - balance_type
  - Type of the currency account balance of the wallet affected by the transaction. See [Wallet Balance Types](https://docs.rapyd.net/en/wallet-balance-types.md "Wallet Balance Types").
- - created_at
  - Time the transaction was made, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - currency_code
  - Three-letter ISO 4217 code for the currency used in the `amount` field.
- - destination_balance_type
  - Type of the currency account balance of the wallet receiving the money. See [Wallet Balance Types](https://docs.rapyd.net/en/wallet-balance-types.md "Wallet Balance Types").
- - destination_ewallet_id
  - ID of the wallet receiving the money. String starting with **ewallet_**.
- - destination_phone_number
  - Phone number of the owner of the wallet receiving the money, in E.164 format.
- - destination_transaction_id
  - ID of the transaction with regard to the destination. String starting with **wt_**.
- - ewallet_id
  - ID of the affected wallet. String starting with **ewallet_**.
- - id
  - ID of the transaction. UUID.
- - metadata
  - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata").
- - reason
  - Reason for the transaction.
- - response_metadata
  - Metadata created with [Set Transfer Response](https://docs.rapyd.net/en/set-transfer-response.md "Set Transfer Response").
- - source_balance_type
  - Type of the currency account balance of the wallet sending the money. See [Wallet Balance Types](https://docs.rapyd.net/en/wallet-balance-types.md "Wallet Balance Types").
- - source_ewallet_id
  - ID of the wallet sending the money. String starting with **ewallet_**.
- - source_transaction_id
  - ID of the transaction with regard to the source. String starting with **wt_**.
- - status
  - Status of the transaction.

    - **CAN** - Canceled. The transferor canceled the transfer.
    - **CLO** - Closed. The transferee accepted the funds.
    - **DEC** - Declined. The transferee rejected the transfer.
    - **EXP** - Expired. The transferee did not respond before the transfer expired.
    - **HLD** - Hold. Rapyd Protect is putting this transfer on hold and reviewing it.
    - **PEN** - Pending. Waiting for the transferee to accept.
    - **REJ** - Rejected. Rapyd Protect has rejected this transfer.
- - subtype
  - Subtype of the transaction.
- - transfer_response_at
  - Time of the [Set Transfer Response](https://docs.rapyd.net/en/set-transfer-response.md "Set Transfer Response") operation, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - type
  - Transaction type. See [Transaction Types](https://docs.rapyd.net/en/transaction-types.md "Transaction Types").

### Code Samples

- - .NET

    - ```csharp
      using System;

      namespace RapydApiRequestSample
      {
          class Program
          {
              static void Main(string[] args)
              {
                  try
                  {
                      string wallet = "ewallet_4c4cb6d688d87f26bc5e679691c69f04";
                      string transaction = "dfa55d22-3ac8-11ea-8193-0e0450a4edb1";

                      string result = RapydApiRequestSample.Utilities.MakeRequest("GET", $"/v1/user/{wallet}/transactions/{transaction}");

                      Console.WriteLine(result);
                  }
                  catch (Exception e)
                  {
                      Console.WriteLine("Error completing request: " + e.Message);
                  }
              }
          }
      }
      ```
- - JavaScript

    - ```javascript
      const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

      async function main() {
        try {
          const result = await makeRequest(
            'GET',
            '/v1/user/ewallet_4c4cb6d688d87f26bc5e679691c69f04/transactions/dfa55d22-3ac8-11ea-8193-0e0450a4edb1'
          );
          console.log(result);
        } catch (error) {
          console.error('Error completing request', error);
        }
      }
      ```
- - PHP

    - ```php
      <?php
      $path = $_SERVER['DOCUMENT_ROOT'];
      $path .= "/<path-to-your-utility-file>/utilities.php";
      include($path);

      try {
          $object = make_request('get', '/v1/user/ewallet_4c4cb6d688d87f26bc5e679691c69f04/transactions/dfa55d22-3ac8-11ea-8193-0e0450a4edb1');
          var_dump($object);
      } catch(Exception $e) {
          echo "Error: $e";
      }
      ?>
      ```
- - Python

    - ```python
      from pprint import pprint

      from utilities import make_request

      wallet = 'ewallet_4c4cb6d688d87f26bc5e679691c69f04'
      transaction = 'dfa55d22-3ac8-11ea-8193-0e0450a4edb1'
      results = make_request(method='get', path=f'/v1/user/{wallet}/transactions/{transaction}')

      pprint(results)
      ```

- /v1/ewallets/:ewallet/transactions/:transaction

- Retrieve Details of Wallet Transaction - balance transfer
- ```curl
  curl -X get 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_31fb2dbbaf6519461ee4fbe1062220d3/transactions/wt_adae2a5d591dbd405e2d48b76df17519' \
  -H 'access_key: your-access-key-here' \
  -H 'Content-Type: application/json' \
  -H 'salt: your-random-string-here' \
  -H 'signature: your-calculated-signature-here' \
  -H 'timestamp: your-unix-timestamp-here'
  ```
- ```json
  {
      "status": {
          "error_code": "",
          "status": "SUCCESS",
          "message": "",
          "response_code": "",
          "operation_id": "ab131f11-dc87-4154-9726-e80bb37bfd23"
      },
      "data": {
          "id": "wt_adae2a5d591dbd405e2d48b76df17519",
          "currency": "EUR",
          "amount": 28,
          "ewallet_id": "ewallet_31fb2dbbaf6519461ee4fbe1062220d3",
          "type": "put_funds_on_hold",
          "subtype": null,
          "balance_type": "on_hold_balance",
          "balance": 34,
          "source_ewallet_id": "ewallet_31fb2dbbaf6519461ee4fbe1062220d3",
          "source_balance_type": "available_balance",
          "created_at": 1764838142,
          "status": "CLOSED",
          "reason": "",
          "metadata": {}
      }
  }
  ```

- Retrieve Details of Wallet Transaction - balance transfer with subtype
- ```curl
  curl -X get
  https://sandboxapi.rapyd.net/v1/ewallets/ewallet_9fa604317114b2c0d5ae0599f9eabdf6/transaction/wt_80f5118850d40c3f7cf8154546fa9323
  -H 'access_key: your-access-key-here'
  -H 'Content-Type: application/json'
  -H 'salt: your-random-string-here'
  -H 'signature: your-calculated-signature-here'
  -H 'timestamp: your-unix-timestamp-here'
  ```
- ```json
  {
      "status": {
          "error_code": "",
          "status": "SUCCESS",
          "message": "",
          "response_code": "",
          "operation_id": "eb6aa4e3-24ba-4516-9ca4-f2b5036b0123"
      },
      "data": [
          {
              "id": "wt_80f5118850d40c3f7cf8154546fa9323",
              "currency": "USD",
              "amount": -18,
              "ewallet_id": "ewallet_9fa604317114b2c0d5ae0599f9eabdf6",
              "type": "balance_transfer",
              "subtype": "monthly_user_wallets_fee",
              "balance_type": "available_balance",
              "balance": 550050873.93,
              "destination_ewallet_id": "ewallet_56e3911e5fec5db8e0a36e1212bf4576",
              "destination_balance_type": "received_balance",
              "created_at": 1706673447,
              "status": "CLOSED",
              "reason": "",
              "metadata": {}
          }
      ]
  }
  ```
