API reference.
Complete REST API reference for the Danipa Fintech Platform. Explore 52+ endpoints across 10 categories covering merchant APIs, payment links, invoices, analytics, remittance, wallets, KYC, and MTN MoMo integration.
Base URL
https://api.danipa.com/ms
Authentication
Bearer JWT / Basic Auth
Spec Version
OpenAPI 3.1.0
Authentication
User registration and authentication
2 endpoints
| Method | Path | Summary |
|---|---|---|
| POST | /v1/auth/register | Register a new user |
| POST | /v1/auth/forgot-password | Request password reset |
User Profile
Manage the authenticated user's profile
3 endpoints
| Method | Path | Summary |
|---|---|---|
| GET | /v1/users/me | Get current user profile |
| PATCH | /v1/users/me | Update current user profile |
| POST | /v1/users/me/logout-all | Sign out all devices |
Wallet
Digital wallet — creation, balances, currency accounts, fund-in, cash-out, P2P transfers, refunds
14 endpoints
| Method | Path | Summary |
|---|---|---|
| POST | /v1/wallets | Create wallet |
| GET | /v1/wallets/me | Get wallet |
| GET | /v1/wallets/me/balances | Get all balances |
| GET | /v1/wallets/me/balances/{currency} | Get balance for currency |
| POST | /v1/wallets/me/accounts/{currency} | Add currency account |
| DELETE | /v1/wallets/me/accounts/{currency} | Remove currency account |
| POST | /v1/wallets/me/fund-in | Fund wallet via MoMo or Stripe |
| POST | /v1/wallets/me/fund-in/{fundInId}/confirm | Confirm fund-in payment |
| GET | /v1/wallets/me/fund-ins | List fund-in requests |
| POST | /v1/wallets/me/cash-out | Cash out to MoMo |
| GET | /v1/wallets/me/cash-outs | List cash-out requests |
| POST | /v1/wallets/me/transfer | P2P transfer |
| POST | /v1/wallets/me/refund | Request refund |
| GET | /v1/wallets/me/transactions/{currency} | Get transaction history |
Transfers
Create and track cross-border money transfers
4 endpoints
| Method | Path | Summary |
|---|---|---|
| GET | /v1/transactions/corridors | List corridors |
| POST | /v1/transactions | Create transfer |
| GET | /v1/transactions | List transactions |
| GET | /v1/transactions/{id} | Get transaction detail |
Recipients
Manage saved transfer recipients
4 endpoints
| Method | Path | Summary |
|---|---|---|
| GET | /v1/recipients | List recipients |
| POST | /v1/recipients | Create recipient |
| PATCH | /v1/recipients/{id} | Update recipient |
| DELETE | /v1/recipients/{id} | Delete recipient |
Exchange Rates
FX rates and fee calculations for send money flow
1 endpoint
| Method | Path | Summary |
|---|---|---|
| GET | /v1/exchange-rates | Get exchange rate and fee |
KYC
Know Your Customer — document upload, status, and tier upgrade
4 endpoints
| Method | Path | Summary |
|---|---|---|
| GET | /v1/kyc/status | Get KYC status |
| GET | /v1/kyc/tiers | List KYC tiers |
| POST | /v1/kyc/documents | Upload KYC document |
| POST | /v1/kyc/upgrade | Request tier upgrade |
Merchants
Merchant onboarding, API key management, and KYB verification
8 endpoints
| Method | Path | Summary |
|---|---|---|
| POST | /v1/merchants | Register merchant |
| GET | /v1/merchants/me | Get merchant profile |
| POST | /v1/merchants/me/api-keys | Create API key |
| GET | /v1/merchants/me/api-keys | List API keys |
| DELETE | /v1/merchants/me/api-keys/{keyId} | Revoke API key |
| POST | /v1/merchants/me/api-keys/{keyId}/rotate | Rotate API key |
| POST | /v1/merchants/me/verification | Submit KYB document |
| GET | /v1/merchants/me/verification | List KYB documents |
Payment Links
Create and manage shareable payment links
6 endpoints
| Method | Path | Summary |
|---|---|---|
| POST | /v1/merchants/me/payment-links | Create payment link |
| GET | /v1/merchants/me/payment-links | List payment links |
| PUT | /v1/merchants/me/payment-links/{id} | Update payment link |
| DELETE | /v1/merchants/me/payment-links/{id} | Deactivate payment link |
| GET | /v1/payment-links/{shortCode} | Get payment link details (public) |
| POST | /v1/payment-links/{shortCode}/checkout | Checkout via payment link (public) |
Payment Requests
Request money from other Danipa users
6 endpoints
| Method | Path | Summary |
|---|---|---|
| POST | /v1/payment-requests | Create payment request |
| POST | /v1/payment-requests/{id}/accept | Accept payment request |
| POST | /v1/payment-requests/{id}/reject | Reject payment request |
| POST | /v1/payment-requests/{id}/cancel | Cancel payment request |
| GET | /v1/payment-requests/sent | Get sent payment requests |
| GET | /v1/payment-requests/received | Get received payment requests |
Authentication
The Danipa API supports two authentication schemes depending on the endpoint.
Bearer JWT.
Most API endpoints require a JWT Bearer token. Obtain a token by calling the authentication endpoint with your credentials. Include it in the Authorization header.
Authorization: Bearer eyJhbGciOi...
Basic Auth.
Token-creation endpoints (e.g., MTN MoMo OAuth) use HTTP Basic authentication. Provide your API User ID as the username and your API Key as the password, Base64-encoded.
Authorization: Basic base64(userId:apiKey)
Schemas
126 data models defined in the OpenAPI specification. Download the full spec for complete schema definitions including properties, types, and validation rules.
View all 126 models
Download the spec.
Use the complete OpenAPI 3.1.0 spec with Swagger UI, Postman, or code generators.