Get Paid Control Number

Endpoint

Description

This endpoint retrieves a list of pending payment control numbers that have been paid for a specific company.

Authentication

Include the JWT token in the Authorization header:

Authorization: Bearer <your_jwt_token>

Request

Headers

Request Body

The request body should be a JSON object with the following fields:

Field Type Required Description
company_uid string Yes The unique identifier of the company

Example Request

POST /api/v2/payment/listPendingPaymentPaidControlNumber
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

{
    "company_uid": "0001"
}

Response

Success Response (200 OK)

{
    "status": "OK",
    "message" : "list of paid control number",
    "data": [
        {
            "id": "1234",
            "control_number": "PCN123456789",
            "amount": "1500.00",
            "currency": "TZS",
            "status": "PAID",
            "customer_name": "John Doe",
            "payment_date": "2025-09-23T10:30:00Z",
            "reference_number": "REF123456"
        }
    ],
}