Get History

Request Parameters:

  • page: The page number to retrieve history data (e.g., 1).

  • sort: The sorting order for the history data, which can be either "date_desc" for descending order or "date_asc" for ascending order.

  • type: This is optional and allows you to filter the history by transaction type. You can specify "WITHDRAWAL" or "DEPOSIT" or leave it unset if you want to get both withdrawal and deposit transactions.

Request Example:

GET {{base_url}}/api/external/v1/fiat-gateway/mercuryo/get-history?page=1&sort=date_desc&type=DEPOSIT

Response Example:

The response includes an array of transaction items, each containing the following details:

  • uid: A unique identifier for the transaction.

  • uid - search for transactions by uid

  • orderId - search for transactions by orderId

  • type: The type of transaction (e.g., "DEPOSIT").

  • status: The status of the transaction (e.g., "PENDING").

  • currency: The currency used in the transaction (e.g., "EUR").

  • fee: The fee associated with the transaction (e.g., "3.000000000000000000").

  • paymentId: The payment identifier for the transaction.

  • orderId: A unique identifier for the order.

  • createdAt: The timestamp of when the transaction was created.

  • receivedAmount: The received amount (e.g., "-2").

  • amount: The transaction amount (e.g., "1").

    Response

    ```postman_json
    {
        "success": true,
        "status": null,
        "response": {
            "items": [
                {
                    "uid": "03036731-8ef3-424f-a802-1495060ea052",
                    "type": "DEPOSIT",
                    "status": "PENDING",
                    "currency": "EUR",
                    "paymentId": "18703863-3d79cb8a2c7da7dba16fe74771ecef9947defefe992b8540e6a29f8823a7",
                    "orderId": "03036731-8ef3-424f-a802-1495060ea052",
                    "createdAt": 1697815124,
                    "processedAmount": "7",
                    "amount": "10",
                    "feeAmount": "3"
                },           
                {
                    "uid": "49aa96e4-a2ac-4ad3-9e23-344730932e43",
                    "type": "DEPOSIT",
                    "status": "PENDING",
                    "currency": "EUR",
                    "paymentId": "17547050-085ba8a165eb3be05a31213c45a9d829c5788a9bf343c421a701dc30bcdb",
                    "orderId": "5",
                    "createdAt": 1697022124,
                    "processedAmount": "-2",
                    "amount": "1",
                    "feeAmount": "3"
                },
                {
                    "uid": "969f5149-fe10-4c50-8761-abe80ef5d81a",
                    "type": "DEPOSIT",
                    "status": "PENDING",
                    "currency": "EUR",
                    "paymentId": "17545041-0ed1f499c7148ae03da73cbd14c05638b4359c02ebcba431d9065460c7ca",
                    "orderId": "5",
                    "createdAt": 1697020652,
                    "processedAmount": "-2",
                    "amount": "1",
                    "feeAmount": "3"
                },
                {
                    "uid": "52c3e524-ccc1-4b9d-a9ee-4b781c41a2f9",
                    "type": "DEPOSIT",
                    "status": "PENDING",
                    "currency": "EUR",
                    "paymentId": "17463772-1db98c9e904274ab9eb98eacaf1649ec31c2e6c8f72fa663517116ab4288",
                    "orderId": "5",
                    "createdAt": 1696953404,
                    "processedAmount": "-2",
                    "amount": "1",
                    "feeAmount": "3"
                },
                {
                    "uid": "7429b5b4-27b0-4cb0-a24c-ff1c7a8e80ed",
                    "type": "DEPOSIT",
                    "status": "PENDING",
                    "currency": "EUR",
                    "paymentId": "17327710-c79d43f0a58ed845d6f63091cb703d4693674f22e76d4d0f2c9feec2b287",
                    "orderId": "11",
                    "createdAt": 1696852896,
                    "processedAmount": "1",
                    "amount": "1",
                    "feeAmount": "0"
                },
    
            ]
        },
        "errors": null
    }
    ```

The response provides transaction history, including details about the type, status, currency, and amounts for each transaction. You can adjust the request parameters to retrieve specific transaction types or change the sorting order.

Last updated