Get Collection Transaction Status

Use this endpoint to check the current status of a USSD push transaction

Endpoint

POST /collection/status

Request

Headers

• Content-Type* — Must be application/json

• x-account-id* — Your unique TemboPlus account identifier

• x-secret-key* — Your TemboPlus API secret key

• x-request-id* — Unique UUID per request for tracing

Body Parameters

• transactionId* (string) — Transaction ID returned from the Initiate MOMO Collection request.

• transactionRef* (string) — Your original transaction reference used in the Initiate MOMO collection request payload.

Example Request Payload

{
  "transactionId": "ZK8pL3vN9qRx",
  "transactionRef": "payment-ref-abc123-2025"
}

Responses

200 OK

Returns the current status of the USSD Push transaction, including the original partner transaction reference and the TemboPlus transaction ID generated at initiation.

Response Format

{
  "statusCode": "PAYMENT_ACCEPTED",
  "transactionId": "ZK8pL3vN9qRx",
  "transactionRef": "payment-ref-abc123-2025"
}

400 BAD REQUEST

Returned when the request payload is missing one or more required fields, or when any field contains invalid data.

Response Format

{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "transactionId": "\"transactionId\" is required"
    },
    "message": "{\"transactionId\":\"\\\"transactionId\\\" is required\"}"
}

Fields inside details and message are optional and vary depending on the specific validation failure.

---

Common Validation Errors to Avoid

• Ensure all required fields are included in the request body in the right format.

• x-request-id must be included in the request headers.

401 UNAUTHORIZED

Returned when authentication headers are missing or invalid.

Response Format:

{
    "statusCode": 401,
    "reason": "INVALID_CREDENTIALS",
    "details": {}
}

404 NOT FOUND

Returned if no matching collection transaction is found for the given transactionId and transactionRef.

Response Format

{
    "statusCode": 404,
    "reason": "NOT_FOUND",
    "details": {}
}

500 INTERNAL SERVER ERROR

Indicates a temporary issue within TemboPlus. Retry later or contact TemboPlus Support with your x-request-id.

Response Format:

{
    "statusCode": 500,
    "reason": "SERVER_ERROR"
}