Home / Guides / Safaricom Daraja API workflows / clinics and wellness businesses
DASNET business guide · Kenya

Safaricom Daraja API workflows for clinics and wellness businesses | DASNET

Daraja-based workflows need secure credential handling, permissioned production access, request validation, asynchronous status handling and auditable reconciliation.

This guide explains the workflow, how to prepare, which checks matter and how to handle common exceptions for clinics and wellness businesses.

Explore DASNETDeveloper documentation
Merchant mobile-money payment workflow
In this guide

Understand the workflow, apply the checklist, and confirm which payment channels and features are enabled for your account before using them in production.

What Safaricom Daraja API workflows means for clinics and wellness businesses

Daraja-based workflows need secure credential handling, permissioned production access, request validation, asynchronous status handling and auditable reconciliation. For clinics and wellness businesses, the goal is to keep service billing and operational records orderly. A reliable workflow makes the request, responsible person, reference and final outcome visible rather than leaving the process in disconnected messages.

The operational challenge

A common challenge is that sensitive personal information should not be exposed in payment notes or support requests. When the source request, payment status and business record do not line up, staff can repeat work or act on an assumption. A consistent process separates initiation from completion and records the evidence used to make a decision.

A practical end-to-end workflow

  1. Confirm which Daraja products and production permissions have been approved for the business.
  2. Keep access tokens and consumer secrets on a trusted server, rotate credentials and restrict access.
  3. Use a unique business reference for each request and store provider identifiers for traceability.
  4. Validate callback and status responses; never rely on the browser redirect alone.
  5. Monitor failure rates, latency, duplicate notifications and unresolved pending transactions.

A workflow shaped around this use case

  1. Keep payment descriptions limited to necessary billing context.
  2. Restrict access to sensitive customer and service records.
  3. Reconcile payments using references without placing confidential details in public channels.

How DASNET fits

DASNET is a business workspace for supported payment workflows and everyday business operations. Depending on account configuration, teams may use it to manage payment requests and collections, review transaction records, handle supported wallet and payout activity, organise invoices or bills, and keep customer and operational information together. The precise menu, channel and automation available to a business should be confirmed in its account. DASNET is not a promise that every payment rail, bank destination or provider feature is automatically enabled.

Controls and measures to review

  1. Track the number of unresolved items and how long they remain open.
  2. Separate pending, successful, failed, reversed and disputed outcomes in reports.
  3. Keep a clear owner for exceptions and a reference for every consequential action.
  4. Review access permissions and avoid storing credentials or sensitive authentication data in notes.
  5. Compare material payment totals with trusted provider or bank records.

Frequently asked questions

Can sandbox credentials be used in production?

No. Use the correct production app, approved shortcode and production credentials.

Why can an API request be accepted but later fail?

Acceptance may only mean the request passed initial validation. The final result can arrive asynchronously.

Should credentials be committed to GitHub?

No. Use repository secrets or a managed secret store and never commit credentials to source control.

What is the safest way to reconcile?

Match internal order IDs, provider request IDs, references, amounts and final provider status.

How does this apply to clinics and wellness businesses?

The main objective is to keep service billing and operational records orderly. Start with the workflow and controls on this page, then verify the exact features enabled for your DASNET account.

What should we do if a payment or record looks wrong?

Pause any consequential action, keep the non-sensitive reference and timestamp, check the trusted source record, and follow your documented support or reconciliation process. Never share PINs, OTPs, passwords or API secrets.

Does DASNET guarantee that every feature is enabled?

No. Product availability depends on account setup, permissions, provider approvals and enabled services. Confirm the live configuration before making operational commitments.

Related DASNET guides

Continue with these related workflows:

M-Pesa STK Push for clinics and wellness businesses · STK Push integration guide for clinics and wellness businesses · Online payment links for clinics and wellness businesses · Customer payment requests for clinics and wellness businesses · Merchant payment collections for clinics and wellness businesses · Bulk payouts and bulk payments for clinics and wellness businesses

Get started with DASNET