Skip to main content
Welcome to the DHMAD API documentation. DHMAD provides a secure, reliable platform for escrow services and payment processing, allowing you to build trust into your marketplace, e-commerce, or service platform.

​
What is DHMAD?

DHMAD is a secure escrow platform that acts as a trusted third party between buyers and sellers. Funds are held securely until both parties are satisfied with the transaction, providing peace of mind for all parties involved.

​
Key Features

Secure Escrow

Funds are held securely until transaction completion

Easy Integration

Simple REST API with comprehensive documentation

Real-time Updates

Webhooks and real-time notifications for transaction status

Developer Friendly

Built for developers with clear APIs and excellent support

Pre-account KYC

Verify sellers before they join DHMAD via the Identity Verifications API

​
Use Cases

DHMAD is perfect for:
  • Marketplaces: Secure transactions between buyers and sellers, plus pre-account seller KYC before users sign up on DHMAD
  • Freelance Platforms: Hold funds until work is completed — for example Tunisie Freelance, Tunisia’s freelance marketplace that uses DHMAD for payments
  • E-commerce: Additional security layer for high-value transactions
  • Service Providers: Escrow for service delivery
  • B2B Platforms: Secure business-to-business transactions

​
Sandbox

DHMAD offers a sandbox environment (sandbox.dhmad.tn) for testing. Use sk_sandbox_ API keys with https://sandbox.dhmad.tn/api — same API, separate data, no impact on production. See the Sandbox guide for details.

​
Getting Started

Ready to get started? Follow these steps:
  1. Create a Developer Account - Apply for API access
  2. Get Your API Keys - Generate API keys in the dashboard
  3. Associate User Account - Link your developer account to a user account
  4. Make Your First Request - Create your first escrow
We recommend testing in the sandbox before going live.

​
API Overview

The DHMAD API is a RESTful API that uses:
  • Base URL (production): https://dhmad.tn/api/v1
  • Base URL (sandbox): https://sandbox.dhmad.tn/api/v1 — for testing; see Sandbox
  • Authentication: API Key via Authorization: Bearer or X-API-Key header
  • Content Type: application/json
  • Rate Limiting: 100 requests per minute per IP address (configurable)

​
Support

Need help? We’re here for you:
All API endpoints require authentication. Make sure to include your API key in the X-API-Key header for all requests.