Confirm Requests

Confirming a request will create an executable order request for the customer within our system.

Caution

It is highly recommended that you require the customer to input some sort of security key (i.e. pin, OTP, etc…) before making the POST request to confirm an order request.

Creating an order request

Tip

Order requests are confirmed by advancing the session — send the confirm 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"}'

Note

The purchase amount and order type were already captured earlier in the flow (see Stock Purchase). Confirming only sends the customer’s menu choice — there is no amount or orderType in the confirm body.

Example Response

{
  "message": "USSD request processed successfully",
  "data": {
    "sessionId": "ussd_5310deea137a9cd999b02ae68a7bbbec",
    "currentState": "PURCHASE_SUCCESS",
    "menu": {
      "state": "PURCHASE_SUCCESS",
      "text": "Zamtel Message\n Thank you for purchasing 100ZK of Apple stock. You will receive a confirmation shortly.",
      "options": [
        {
          "key": "0",
          "label": "Back to Home",
          "nextState": "HOME"
        }
      ],
      "isEndState": false
    },
    "ussdText": "Zamtel Message\n Thank you for purchasing 100ZK of Apple stock. You will receive a confirmation shortly.\n\n0. Back to Home",
    "expiresAt": "2025-11-06T14:58:33.942Z"
  }
}

What the customer sees

Zamtel Message
Thank you for purchasing 100ZK of Apple stock. You will receive a confirmation shortly.

0. Back to Home

Confirm request view example

USSD Confirm Request View

Check out an example of the ussd confirm request view