Quick Start

Get started with GetMiPay API in 5 minutes and start accepting mobile money payments.

Prerequisites

Before you begin, make sure you have:

A valid business registration document
Government-issued ID for KYC verification
Active mobile money account
Business bank account (optional)

Complete Onboarding Process

Step 1: Create Merchant Account

Used GetMiPay Merchant App

Web Dashboard: getmipay.com/merchant

Open GetMiPay Merchant App or visit web dashboard
Click “Create Merchant Account”
Enter business email and secure password
Verify email through OTP sent to your inbox
Complete basic business profile

Business Information Required

Business name and legal structure
Business address and contact information
Tax identification number
Business category and industry

Step 2: Complete KYC Verification

Required Documents

Individual/Sole Proprietor

Government-issued ID (Passport, National ID, Driver’s License)
Proof of address (Utility bill, Bank statement)
Recent passport photograph

Company/Business

Certificate of incorporation
Company tax identification
Director’s identification documents
Board resolution authorizing account creation

KYC Submission Process

# 1. Log in to your merchant dashboard
# 2. Navigate to "Verification" section
# 3. Upload required documents
# 4. Submit for review
# 5. Wait for approval (24-48 hours)

Step 3: Authenticate With API Keys

Use your public and private API keys once to create a JWT bearer token.

curl -X POST "https://getmipay.com/api/v1/action/auth" \
  -H "Content-Type: application/json" \
  -d '{
    "public_apikey": "gmp_pk_...",
    "private_secretkey": "gmp_sk_..."
  }'

The response contains a Tymon JWT that expires after 24 hours.

{
  "success": true,
  "message": "Authentication successful",
  "data": {
    "token": "JWT_TOKEN_HERE",
    "token_type": "bearer",
    "token_format": "JWT",
    "expires_at": "2026-05-21T23:59:59Z"
  }
}

Step 4: Call Protected APIs

For protected API requests, send only the JWT bearer token in the Authorization header.

curl "https://getmipay.com/api/v1/convert-currency?amount=10000&from=XAF&to=XOF" \
  -H "Authorization: Bearer JWT_TOKEN_HERE"

PayIn requests also require service and operation headers. Add otp only for services that require OTP.

curl -X POST "https://getmipay.com/api/v1/payments/payin" \
  -H "Authorization: Bearer JWT_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -H "service: 1" \
  -H "operation: 2" \
  -d '{
    "amount": 1000,
    "phone": "237600000000",
    "order_id": "ORDER-1001"
  }'

PayOut requests use operation: 4.

​Quick Start

​Prerequisites

​Complete Onboarding Process

​Step 1: Create Merchant Account

​Used GetMiPay Merchant App

​Sign Up Process

​Business Information Required

​Step 2: Complete KYC Verification

​Required Documents