Getting Started

Set up your Danipa developer account, get API keys, and send your first test transaction in under 5 minutes.

Overview

The Danipa Payment API lets you integrate cross-border remittance, mobile money payouts, and digital wallet functionality into your application. All endpoints follow RESTful conventions with JSON request and response bodies.

Base URLs:

Step 1: Create a Developer Account

Sign up at developer.danipa.com with your email address. You'll receive a verification email — click the link to activate your account.

Step 2: Get Your API Keys

After logging in to the developer dashboard:

1. Navigate to Settings → API Keys
2. Click Generate Sandbox Key
3. Copy your API Key and API Secret

Important: Your API Secret is shown only once. Store it securely — you'll need it to sign requests and verify webhooks.

Step 3: Make Your First API Call

Test connectivity with a simple health check:

curl https://sandbox.api.danipa.com/ms/v1/health \
  -H "Authorization: Bearer YOUR_API_KEY"

Expected response:

{
  "status": "healthy",
  "version": "1.0.0",
  "environment": "sandbox"
}

Step 4: Send a Test Remittance

curl -X POST https://sandbox.api.danipa.com/ms/v1/remittance \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: test-001" \
  -d '{
    "source": {
      "currency": "CAD",
      "amount": 100.00
    },
    "destination": {
      "provider": "MTN_MOMO",
      "msisdn": "+233241234567",
      "currency": "GHS"
    },
    "reference": "test-remittance-001"
  }'

Response:

{
  "id": "txn_sandbox_abc123",
  "status": "PENDING",
  "source": { "currency": "CAD", "amount": 100.00 },
  "destination": { "currency": "GHS", "amount": 792.11 },
  "exchange_rate": 7.9211,
  "fee": { "currency": "CAD", "amount": 1.49 },
  "created_at": "2026-03-11T10:30:00Z"
}

In sandbox mode, transactions automatically settle after 5 seconds.

Step 5: Set Up Webhooks

Configure your webhook endpoint in the developer dashboard under Settings → Webhooks. See the Webhooks guide for details on event types and signature verification.

Next Steps

For merchants accepting payments:

• Merchant Onboarding — Register your business and get API keys
• Payment Links — Accept payments with shareable links
• Invoices — Generate and send invoices

For all integrations:

• API Reference — Full endpoint documentation
• API Explorer — Browse all endpoints interactively
• Webhooks — Event notifications and HMAC verification
• SDKs — Official libraries for Java, Node.js, and PHP
• Error Handling — Error codes and troubleshooting