---
title: "POST /payments/initiate-ussd-push-request"
method: POST
path: "/payments/initiate-ussd-push-request"
tags: ["Payments", "Initiate"]
---

# POST /payments/initiate-ussd-push-request

`POST /payments/initiate-ussd-push-request`

Sends the USSD-PUSH request to customer's mobile device for payment authorization

## Request body

- object
  - `amount` string, required — Your payment amount
  - `currency` 'TZS', required
  - `orderReference` string, required — Your unique Order reference
  - `phoneNumber` string, required — Mobile phone number to receive USSD-PUSH and make payment, starting with country code and without the plus sign, e.g., 255712345678
  - `checksum` string — If enabled, this is the generated checksum of the payload. Refer to the [documentation](/home/checksum) for more details.

## Response `200`

Initiate USSD Push response

- InitiateUSSDPushResponse
  - `id` string — Unique identifier for the USSD-PUSH transaction
  - `status` 'PROCESSING' | 'SUCCESS' | 'FAILED' | 'SETTLED' — Current status of the transaction
  - `channel` string — Payment channel used for the transaction (e.g., TIGO-PESA, M-PESA, AIRTEL-MONEY)
  - `orderReference` string — Your unique Reference identifier for the order
  - `collectedAmount` string — Amount collected from the transaction
  - `collectedCurrency` string — Currency of the collected amount (e.g., TZS)
  - `createdAt` string, date-time — Timestamp when the transaction was created
  - `clientId` string — Application Client ID associated with the payment

## Other responses

- `400` — Validation Error
- `401` — Invalid or Expired Token
- `404` — Not Found Error
- `409` — Conflict Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/clickpesa/apis/core-api-openapi-specification.md) · [All operations](https://skmtc.dev/clickpesa/apis/core-api-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickpesa/core-api-openapi-specification/revisions/9f70f35c5590/schema)