Get Order Details

Testing Env

https://stage-api.fintegence.io

GET

/v1/order/details/{orderId}

Retrieves the current, detailed information for a specific order using its orderId. Use it to track the transaction lifecycle from initial wallet generation to final settlement and conversion.

Wallet Generation

Immediately after an order is created, its initial status is WAITING_FOR_WALLET_ADDRESS. In this state, the system is asynchronously preparing the payment destination.

walletAddress and expiresAt are null.

Full details appear automatically once status changes to WAITING_FOR_DEPOSIT.

Compliance and Partial Deposits

Whenever a deposit is detected, including partial payments (PARTIALLY_COVERED), the order may enter compliance statuses such as WAITING_FOR_TR_DATA or WAITING_FOR_VERIFICATION.

These states indicate that received funds are undergoing risk or manual review. Checks must be completed successfully for the order to progress toward COMPLETED, even if the customer still needs to send additional funds to cover a partial payment.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400P403: Validation error

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠401Access Denied

🟠404P463: Order not found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stage-api.fintegence.io/v1/order/details/orderId' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "orderId": "a44a0805-dd40-4dc4-80d7-8bc81783ec42",
    "lockId": "8b94a8f6-1c9d-4a6f-92c8-5f6d9e72a123",
    "status": "WAITING_FOR_CONFIRMATION",
    "createdAt": "2025-08-31T21:21:35.840Z",
    "confirmations": 1,
    "requiredConfirmations": 3,
    "receivedAmount": 849.39,
    "totalAmountRequired": 1000,
    "cryptocurrency": "usdc",
    "walletAddress": "0xE353464eBa01d651c16D8879cbCaE1C80568705C",
    "transactionHash": "0x84a1234b3b251ab02f1735c634eacab43a282dcbdebf22c1eb0634f5678695cd",
    "network": "POLYGON"
}

Create and Finalize an Order

Payment link & Checkout Link