Transactions Menu View

The transactions menu view displays the list of transactions across all assets.

Accessing the Transactions View

  curl --request POST \
    --url https://api.staging.pipevest.com/v1/ussd/process \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <access-token>' \
    --header 'x-client-id: <client-id>' \
    --data '{"sessionId": "<session-id>", "choice": "3"}'

Example Response

{
    "message": "USSD request processed successfully",
    "data": {
        "sessionId": "ussd_2231df057f1f8f5269f0a268249ac104",
        "currentState": "TRANSACTION_HISTORY",
        "menu": {
            "state": "TRANSACTION_HISTORY",
            "text": "Transaction History:\n\nBUY: AAPL\n0.0036 shares - ZK22.00\nDate: 11/6/2025\n\nBUY: AAPL\n0.093 shares - ZK560.00\nDate: 11/5/2025\n\nSELL: TSLA\n0.0141 shares - ZK139.29\nDate: 11/5/2025\n\nBUY: TSLA\n0.0563 shares - ZK560.00\nDate: 11/5/2025\n\n",
            "options": [
                {
                    "key": "0",
                    "label": "Back to Portfolio",
                    "nextState": "MY_PORTFOLIO"
                }
            ],
            "isEndState": false
        },
        "ussdText": "Transaction History:\n\nBUY: AAPL\n0.0036 shares - ZK22.00\nDate: 11/6/2025\n\nBUY: AAPL\n0.093 shares - ZK560.00\nDate: 11/5/2025\n\nSELL: TSLA\n0.0141 shares - ZK139.29\nDate: 11/5/2025\n\nBUY: TSLA\n0.0563 shares - ZK560.00\nDate: 11/5/2025\n\n\n\n0. Back to Portfolio",
        "expiresAt": "2025-11-10T14:56:05.356Z"
    }
}

What the customer sees

Transaction History:

BUY: AAPL
0.0036 shares - ZK22.00
Date: 11/6/2025

BUY: AAPL
0.093 shares - ZK560.00
Date: 11/5/2025

SELL: TSLA
0.0141 shares - ZK139.29
Date: 11/5/2025

BUY: TSLA
0.0563 shares - ZK560.00
Date: 11/5/2025



0. Back to Portfolio

Paging transactions view

  curl --request POST \
    --url https://api.staging.pipevest.com/v1/ussd/process \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <access-token>' \
    --header 'x-client-id: <client-id>' \
    --data '{"sessionId": "<session-id>", "choice": "5"}'

Individual asset transactions view

Selecting an individual asset filters the transactions to that asset. As with every USSD step, you advance the session by sending the asset’s menu key as the choice to POST /v1/ussd/process.

  curl --request POST \
    --url https://api.staging.pipevest.com/v1/ussd/process \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <access-token>' \
    --header 'x-client-id: <client-id>' \
    --data '{"sessionId": "<session-id>", "choice": "1"}'

{
    "message": "USSD request processed successfully",
    "data": {
        "sessionId": "ussd_2231df057f1f8f5269f0a268249ac104",
        "currentState": "STOCK_TRANSACTIONS",
        "menu": {
            "state": "STOCK_TRANSACTIONS",
            "text": "Apple Inc. Transactions:\n\nTotal: 2 transactions\n\nBUY: 0.0036 shares\nZK22.00 | 11/6/2025\n\nBUY: 0.0930 shares\nZK560.00 | 11/5/2025\n\n",
            "options": [
                {
                    "key": "0",
                    "label": "Back to Asset Details",
                    "nextState": "ASSET_DETAIL"
                }
            ],
            "isEndState": false
        },
        "ussdText": "Apple Inc. Transactions:\n\nTotal: 2 transactions\n\nBUY: 0.0036 shares\nZK22.00 | 11/6/2025\n\nBUY: 0.0930 shares\nZK560.00 | 11/5/2025\n\n\n\n0. Back to Asset Details",
        "expiresAt": "2025-11-10T14:56:05.356Z"
    }
}

What the customer sees

Apple Inc. Transactions:

Total: 2 transactions

BUY: 0.0036 shares
ZK22.00 | 11/6/2025

BUY: 0.0930 shares
ZK560.00 | 11/5/2025



0. Back to Asset Details

Transactions View Example

USSD Transactions View

Check out an example of the ussd transactions view