Coop Tuku Till

You can get a Cooperative Bank Till (Kenya) 400200 that is Linked direct to your Wallet.

Overview

The Coop Tuku Till is an M-Pesa Paybill number (400200) linked to your wallet. Any payments made to this Paybill account (e.g., Account Number 12345) are credited to your wallet immediately, ensuring seamless and real-time fund reflection. Additionally, if someone uses the wallet number as the account number instead of the default account, the system processes it in the same way.

App users can apply for a unique Coop Tuku Till for their organizations. Once approved, they can use this till for various purposes, such as collecting offerings, payments, or donations. This service is ideal for entities like churches, supermarkets, and other organizations requiring a simple and efficient payment solution.

---

Key Features

• Instant Reflection: Payments reflect immediately in the associated wallet.

• Default Account Number: Standard account numbers can be used (e.g., 12345), but wallet numbers are also valid as account numbers.

• Custom Application: App users can apply for their unique till number.

• Wide Usage: Suitable for churches, businesses, and other organizations to simplify collections.

• Verification: Tuku Pay verifies applications to ensure compliance and security.

---

Application Process

Requirements

Applications use KYC information already available from the app or user registration process.

---

Endpoints for Coop Tuku Till

1. Apply for Coop Tuku Till

Used to submit an application for a unique Coop Tuku Till number.

Method	POST
URL	/api/tuku-till/apply

Request Body:

{
  "appId": "app123",
  "organizationName": "Grace Church"
}

Response:

{
  "status": "success",
  "message": "Application submitted successfully. Awaiting verification.",
  "applicationId": "tillApp001"
}

---

2. Retrieve Coop Tuku Till Applications

Used to fetch details of till applications for an app.

Method	GET
URL	/api/tuku-till/list

Request Body:

{
  "appId": "app123"
}

Response:

{
  "status": "success",
  "applications": [
    {
      "applicationId": "tillApp001",
      "organizationName": "Grace Church",
      "status": "pending_verification"
    },
    {
      "applicationId": "tillApp002",
      "organizationName": "Mercy Supermarket",
      "status": "approved",
      "tillNumber": "400200",
      "accountNumber": "124567"
    }
  ]
}

---

3. Update Coop Tuku Till Application

Used to edit or update details of a till application before approval.

Method	PUT
URL	/api/tuku-till/update

Request Body:

{
  "applicationId": "tillApp001",
  "organizationName": "Grace Church Updated"
}

Response:

{
  "status": "success",
  "message": "Till application updated successfully."
}

---

4. Deactivate Coop Tuku Till

Used by Tuku Pay to deactivate a till for non-compliance or inactivity.

Method	POST
URL	/internal/tuku-till/deactivate

Request Body:

{
  "tillNumber": "400200",
  "reason": "Non-compliance with regulations."
}

Response:

{
  "status": "success",
  "message": "Till deactivated successfully."
}

---

5. Webhooks for Coop Tuku Till

Tuku Pay provides webhook notifications for:

• Payment Received: Triggered whenever a payment is made to a till.

• Application Status Update: Notifies apps when a till application is approved, rejected, or deactivated.

Example Payment Webhook Notification:

{
  "tillNumber": "400200",
  "accountNumber": "12345",
  "transactionId": "txn123",
  "amount": 5000,
  "payerPhone": "[phone]",
  "timestamp": "2024-12-19T10:45:00Z"
}

Example Application Status Update Webhook Notification:

{
  "applicationId": "tillApp001",
  "status": "approved",
  "tillNumber": "400200",
  "accountNumber": "124567"
}

---

Additional Notes

1. Instant Fund Reflection: Payments are credited to the wallet instantly.

2. Wallet Number Compatibility: The wallet number can be used as an account number for payments.

3. Verification Process: Applications are subject to verification, and Tuku Pay may request additional checks.

4. Deactivation Policy: Till numbers can be deactivated by Tuku Pay for compliance reasons or upon the app user's request.