API Reference

Complete endpoint documentation with interactive examples

💳

Payment Endpoints

Process payments and transactions

POST

https://mag.umva.us/payment/initiate

Initiate a new payment transaction

Parameters

Name	Type	Required	Description
`public_key`	string	Yes	Your merchant public API key
`identifier`	string	Yes	Unique transaction identifier
`amount`	decimal	Yes	Payment amount
`currency`	string	Yes	Currency code (USD, EUR, etc.)
`customer_email`	string	Yes	Customer email address

Response Example

JSON Response

{
  "success": "ok",
  "message": "Payment Initiated",
  "url": "https://pay.umva.net/checkout?payment_id=xxx"
}

POST

https://mag.umva.us/sandbox/payment/initiate

Test payment endpoint (sandbox)

TEST MODE

GET

https://mag.umva.us/verify/payment

Verify payment status

Parameters

Name	Type	Required	Description
`payment_id`	string	Yes	Payment transaction ID
`public_key`	string	Yes	Your public API key

Response Example

JSON Response

{
  "success": true,
  "data": {
    "payment_id": "PAY-67890",
    "order_id": "ORDER-12345",
    "amount": 100.00,
    "currency": "USD",
    "status": "completed",
    "paid_at": "2025-10-18T10:30:00Z"
  }
}

WEBHOOK

IPN / Webhooks

Receive POST notifications when payment status changes

Signature Verification:

signature = HMAC_SHA256(amount + identifier, secret_key)

💰

Withdrawal Endpoints

Manage withdrawal requests (Mobile Money & Crypto)

GET

https://mag.umva.us/api/merchant/withdraw/api/methods

Get your saved withdrawal methods

Name	Value	Required
`X-API-Key`	Your public API key	Yes

POST

https://mag.umva.us/api/merchant/withdraw/api/fees

Calculate withdrawal fees before processing

Name	Type	Required	Description
`currency`	string	Yes	Currency code (RWF, USDT.TRC20, etc.)
`amount`	decimal	Yes	Withdrawal amount

POST

https://mag.umva.us/api/merchant/withdraw/api/create-direct

Create withdrawal (Mobile Money or Crypto)

Parameters (Mobile Money)

Name	Type	Required	Description
`currency`	string	Yes	Currency code (RWF, GHS, KES, etc.)
`amount`	decimal	Yes	Withdrawal amount
`mobile_number`	string	Yes	Mobile number with country code
`provider`	string	Yes	Mobile money provider (MTN, AIRTEL, etc.)

Parameters (Crypto)

Name	Type	Required	Description
`currency`	string	Yes	USDT.TRC20 or USDT.BEP20
`amount`	decimal	Yes	Withdrawal amount
`wallet_address`	string	Yes	USDT wallet address
`network`	string	Yes	BEP20 or TRC20

Crypto Network Fees:

USDT.BEP20: NO FEE
USDT.TRC20: 1 USDT fixed charge

GET

https://mag.umva.us/api/merchant/withdraw/api/status/{trx}

Check withdrawal status by transaction reference

Name	Type	Required	Description
`trx`	string	Yes	Transaction reference from withdrawal response

📧

Messaging Endpoints

WhatsApp and Email API

POST

https://mag.umva.us/api/messaging/whatsapp/send

Send WhatsApp messages

POST

https://mag.umva.us/api/messaging/email/send

Send email messages

Parameters

Name	Type	Required	Description
`api_key`	string	Yes	Your API key
`email`	string	Yes	Recipient email address
`subject`	string	Yes	Email subject
`message`	string	Yes	Email body (HTML supported)
`reply_to`	string	Optional	Reply-to email address

🚀

Lab & SEO Tools Endpoints

Social media marketing services 50% OFF

POST

https://mag.umva.us/api/lab

Get available services (action=services)

POST

https://mag.umva.us/api/lab

Place order (action=add)

Parameters

Name	Type	Required	Description
`api_key`	string	Yes	Your API key
`action`	string	Yes	Must be "add"
`service`	integer	Yes	Service ID from services list
`link`	string	Yes	Target URL/username
`quantity`	integer	Yes	Order quantity

POST

https://mag.umva.us/api/lab

Check order status (action=status)

🌐

Hosting & Domains Endpoints

Web hosting and domain management 50% OFF Shared Hosting

GET

https://mag.umva.us/api/hosting/plans

Get available hosting plans

POST

https://mag.umva.us/api/hosting/create

Create new hosting account

Parameters

Name	Type	Required	Description
`plan_id`	integer	Yes	Hosting plan ID
`domain`	string	Yes	Domain name
`duration`	integer	Yes	Billing period (1, 3, 6, or 12 months)

GET

https://mag.umva.us/api/domain/search

Search domain availability

POST

https://mag.umva.us/api/domain/register

Name	Type	Required	Description
`domain`	string	Yes	Domain name to register
`period`	integer	Optional	Registration period (1-6 years, default: 1)

HTTP Status Codes

200

Request successful

201

Created

Resource created successfully

400

Bad Request

Invalid parameters

401

Unauthorized

Invalid API credentials

500

Server Error

Internal server error

429

Too Many Requests

Rate limit exceeded

Rate Limits

API Rate Limits:

Payment API: 60 requests per minute
Withdrawal API: 30 requests per minute
Query Endpoints: 120 requests per minute

Exceeding rate limits will result in a 429 Too Many Requests response.

📚

Full Documentation

Complete API guides and examples

🟢

API Status

Real-time system health

🔑

Get API Keys

Access your credentials

API Reference

Payment Endpoints

Parameters

Response Example

Parameters

Response Example

Withdrawal Endpoints

Headers

Parameters

Parameters (Mobile Money)

Parameters (Crypto)

URL Parameters

Messaging Endpoints

Parameters

Parameters

Lab & SEO Tools Endpoints

Parameters

Parameters

Parameters

Hosting & Domains Endpoints

Parameters

Parameters

HTTP Status Codes

Rate Limits

Full Documentation

API Status

Get API Keys

API Reference

Payment Endpoints

Parameters

Response Example

Parameters

Response Example

Withdrawal Endpoints

Headers

Parameters

Parameters (Mobile Money)

Parameters (Crypto)

URL Parameters

Messaging Endpoints

Parameters

Parameters

Lab & SEO Tools Endpoints

Parameters

Parameters

Parameters

Hosting & Domains Endpoints

Parameters

Parameters

HTTP Status Codes

Rate Limits

Full Documentation

API Status

Get API Keys

We Value Your Privacy

Cookie Preferences

Strictly Necessary Cookies

Functional Cookies

Performance Cookies

Marketing Cookies