Apply Point of Sale

Apply Coop Bank Point of Sale top receive Money to your wallet from Cards.

Overview

Tuku Pay allows app users to apply for a Point of Sale (POS) machine linked directly to their wallet. The POS supports payments via Visa, Mastercard, and other payment methods, making it a versatile tool for any entity, whether a business, church, individual, or organization.

The application process is straightforward and includes providing necessary details about the entity, its purpose, and location for physical verification. Applicants must also submit a signed letter (template available for download) and complete payment if applicable.

---

Key Features

• Versatile Use: Suitable for businesses, churches, individuals, and organizations.

• Direct Wallet Integration: Payments received via the POS are credited directly to the linked wallet.

• Physical Verification: Ensures the authenticity of the applicant's operations through location checks.

• Flexible Payment Options: POS service may be free or require payment based on specific terms.

---

Application Process

1. Download and Complete the Signed Letter: A downloadable template is provided for submission.

2. Provide Entity Details: Applicants must include entity name, description, and location.

3. Submit Payment (If Applicable): Ensure payment is completed if the POS service requires it.

4. Verification: Tuku Pay conducts physical verification before approving the application.

---

Endpoints for POS Application

1. Apply for POS

Used to submit an application for a POS machine.

Method	POST
URL	/api/pos/apply

Request Body:

{
  "appId": "app123",
  "userId":"user123",
  "entityName": "Grace Supermarket",
  "entityDescription": "Retail store selling groceries and household items.",
  "entityLocation": {
    "latitude": -1.2921,
    "longitude": 36.8219
  },
  "signedLetter": "base64-encoded-file-content",
  "paymentStatus": "paid"
}

Response:

{
  "status": "success",
  "message": "POS application submitted successfully. Awaiting verification.",
  "applicationId": "posApp001"
}

---

2. Retrieve POS Applications

Fetches details of submitted POS applications for an app.

Method	GET
URL	/api/pos/list

Request Body:

{
  "appId": "app123",
  "userId": "user"
}

Response:

{
  "status": "success",
  "applications": [
    {
      "applicationId": "posApp001",
      "entityName": "Grace Supermarket",
      "status": "pending_verification"
    },
    {
      "applicationId": "posApp002",
      "entityName": "Mercy Fellowship Church",
      "status": "approved",
      "posId": "pos12345"
    }
  ]
}

---

3. Update POS Application

Used to edit details of a submitted POS application.

Method	PUT
URL	/api/pos/update

Request Body:

{
  "applicationId": "posApp001",
  "entityName": "Grace Supermarket",
  "entityDescription": "Updated description for the supermarket."
}

Response:

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

---

4. Deactivate POS

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

Method	POST
URL	/internal/pos/deactivate

Request Body:

{
  "posId": "pos12345",
  "reason": "Non-compliance with terms of service."
}

Response:

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

---

Additional Notes

1. Customization: The model supports diverse use cases across entities such as churches, businesses, and individuals.

2. Verification Process: Physical verification ensures the credibility of the applicant's operations.

3. Payment Flexibility: Payment for the POS service may be waived based on promotional terms or specific conditions.

4. Integration: The POS integrates seamlessly with Tuku Pay wallets for immediate fund reflection.

5. Notifications: Apps are notified of application status updates via webhooks.