# /transaction/status

Retrieves the current status and processing details of a previously created transaction.

This endpoint provides real-time visibility into the transaction lifecycle, including compliance checks, funding confirmation, routing, payout execution, and final settlement.

The transaction is uniquely identified by its uuid, which is returned by the transaction creation endpoint.

Endpoint: POST /transaction/status
Version: 1.0.0

## Request fields (application/json):

  - `client_id` (string, required)
    Unique identifier assigned to the integrating client. It determines the validation rules, allowed values, compliance policies, and operational limits applied to the request.Error codes (click to expand)RuleCoderequired400001type400002minLength400003maxLength400004

  - `secret_key` (string, required)
    Secret authentication key associated with the client. It is used to authorize the request and must be kept strictly confidential.Error codes (click to expand)RuleCoderequired400005type400006minLength400007maxLength400008

  - `uuid` (string, required)
    Unique identifier of the generated transaction.Error codes (click to expand)RuleCoderequired400500type400501minLength400502maxLength400503

## Response 200 fields (application/json):

  - `status` (string)
    Transaction status 

    Status Description     VOID The transaction has been voided and is no longer valid.   CANCEL The transaction was cancelled before completion.   EXPIRED The transaction was not completed within the allowed time window and has expired.   HOLD The transaction is temporarily on hold due to compliance or operational review.   DONE The transaction has completed its internal processing flow successfully.   SENDTOBANK The transaction has been sent to the bank for processing.   PAID The funds have been paid out to the beneficiary.   TRANSFERRED The funds have been transferred to the payout network or external institution.

  - `transaction_id` (string)
    Unique identifier of the generated transaction.

  - `transaction_uuid` (string)
    Unique identifier of the generated transaction.

  - `status_track_url` (string)
    URL where the user can track the transaction.

  - `folio` (string)
    Money transfer tracking number.

  - `total_receiver` (string)
    Amount in destination currency that the customer is sending plus fees.

  - `total_pay_receiver` (string)
    Amount in destination currency that the beneficiary is receiving.

  - `rate` (string)
    Exchange rate

  - `source_currency_iso` (string)
    ISO currency code of the source (sending) amount. Represents the currency in which the sender funds the transaction.

  - `currency_receiver_iso` (string)
    ISO currency code of the destination (receiving) amount. Represents the currency in which the beneficiary will receive the funds.

  - `holds` (array)
    List of compliance or operational holds applied to the transaction.

 Each hold represents a restriction or review requirement that must be resolved before the transaction can proceed.

  - `holds.type` (string)

  - `holds.description` (string)
    Name or description of the hold that lifted the transaction.

  - `requiredDocumentList` (array)
    List of documents required to resolve compliance or regulatory requirements for the transaction.

  This list is typically populated when the transaction requires additional verification or is placed on hold.

## Response 400 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 400 (click to expand)   Code Description     400000  The body of the request is required  Invalid JSON format of the request body    400001  client_id is required    400005  secret_key is required

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 401 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 401 (click to expand)   Code Description     401000 Invalid credentials

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 404 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 404 (click to expand)   Code Description     404000 Transaction not found

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 500 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 500 (click to expand)   Code Description     500000 Internal Error

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)