Home / Guides / Refunds, reversals and payment disputes / developers and product teams
DASNET business guide · Kenya

Refunds, reversals and payment disputes for developers and product teams | DASNET

Refund and reversal handling needs a clear distinction between a customer request, an initiated reversal and a provider-confirmed final outcome.

This guide explains the workflow, how to prepare, which checks matter and how to handle common exceptions for developers and product teams.

Explore DASNETDeveloper documentation
Operations team reviewing a payment issue
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 Refunds, reversals and payment disputes means for developers and product teams

Refund and reversal handling needs a clear distinction between a customer request, an initiated reversal and a provider-confirmed final outcome. For developers and product teams, the goal is to integrate payment workflows without exposing secrets or creating duplicate effects. 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 asynchronous callbacks, retries and timeouts complicate the user experience. 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. Identify the original transaction using its provider reference, amount, date and internal order ID.
  2. Check the payment route's documented eligibility, deadlines and approval requirements before initiating a reversal or refund.
  3. Record the reason, approver, customer communication and provider response without exposing sensitive data.
  4. Track the refund or reversal as its own lifecycle and reconcile the final result against the original payment.
  5. Prevent duplicate refund actions by checking existing requests and provider status before retrying.

A workflow shaped around this use case

  1. Keep provider credentials server-side and persist correlation IDs.
  2. Implement idempotent callback handling and explicit transaction states.
  3. Test delayed, duplicate, failed and malformed events before production.

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

Does requesting a reversal mean funds have returned?

No. A request can be pending, rejected or completed. Verify the provider-confirmed final result.

Can every payment be reversed?

No. Eligibility and time limits depend on the payment rail, provider rules and transaction state.

What should support ask for?

Use non-sensitive transaction references, timestamps and amounts. Never request a PIN, OTP or password.

How do I avoid duplicate refunds?

Use a unique case reference, check the original transaction and existing refund status, and process updates idempotently.

How does this apply to developers and product teams?

The main objective is to integrate payment workflows without exposing secrets or creating duplicate effects. 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 developers and product teams · STK Push integration guide for developers and product teams · Safaricom Daraja API workflows for developers and product teams · Online payment links for developers and product teams · Customer payment requests for developers and product teams · Merchant payment collections for developers and product teams

Get started with DASNET