Home / Guides / Payment API integration / hospitality and accommodation businesses
DASNET business guide · Kenya

Payment API integration for hospitality and accommodation businesses | DASNET

A payment API integration must secure credentials, validate requests, preserve correlation IDs, handle asynchronous outcomes and reconcile transactions.

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

Explore DASNETDeveloper documentation
Digital checkout workflow for a merchant
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 Payment API integration means for hospitality and accommodation businesses

A payment API integration must secure credentials, validate requests, preserve correlation IDs, handle asynchronous outcomes and reconcile transactions. For hospitality and accommodation businesses, the goal is to coordinate bookings, deposits, final bills and refunds. 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 booking changes and cancellations can create differences between expected and actual payment amounts. 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. Define the payment lifecycle and the source of truth for final status.
  2. Keep credentials on the server and validate incoming data before calling a provider.
  3. Persist internal IDs and provider references before returning from the initiation step.
  4. Validate callbacks, deduplicate events and handle retries safely.
  5. Test timeouts, provider errors, delayed status updates, reversals and reconciliation.

A workflow shaped around this use case

  1. Tie each payment to a booking reference and applicable terms.
  2. Track deposits, balances, cancellations and refunds separately.
  3. Confirm the final transaction before closing the booking account.

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

Should an API 200 response mark an order paid?

Not unless that response is the documented final payment result; initiation and settlement are different states.

How should callbacks be retried?

Make the handler idempotent and safely accept duplicate deliveries without repeating side effects.

Where should secrets be stored?

Use environment secrets or a managed secret store, never public client code or source control.

What must be tested before go-live?

Success, decline, timeout, malformed payload, duplicate callback, delayed callback and reconciliation paths.

How does this apply to hospitality and accommodation businesses?

The main objective is to coordinate bookings, deposits, final bills and refunds. 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 hospitality and accommodation businesses · STK Push integration guide for hospitality and accommodation businesses · Safaricom Daraja API workflows for hospitality and accommodation businesses · Online payment links for hospitality and accommodation businesses · Customer payment requests for hospitality and accommodation businesses · Merchant payment collections for hospitality and accommodation businesses

Get started with DASNET