Testing Tools - Monei API

Overview

Monei provides testing tools and utilities to help you develop and debug your integration. This guide covers available tools, debugging techniques, and testing strategies. What you’ll learn:

API testing tools
Debugging techniques
Mock data generators
Automated testing
CI/CD integration

API Testing Tools

Postman Collection

Import our Postman collection for quick API testing:

Download Collection

Download the Monei Postman Collection

Import to Postman

Open Postman → Import → Select downloaded file

Configure Environment

Create environment with your API key:

{
  "api_key": "sk_test_your_key_here",
  "base_url": "https://api.dev.monei.cc"
}

Start Testing

Use pre-configured requests to test all endpoints

cURL Examples

Quick API testing from command line:

# Get wallet information
curl https://api.dev.monei.cc/api/v1/wallet/me \
  -H "x-api-key: sk_test_your_key_here"

Mock Data Generators

Generate Test References

// Reference generator
function generateReference(prefix = 'TEST') {
  const timestamp = Date.now();
  const random = Math.random().toString(36).substring(2, 8).toUpperCase();
  return `${prefix}-${timestamp}-${random}`;
}

// Usage
const depositRef = generateReference('DEP');
console.log(depositRef); // DEP-1708000000-A3X9K2

const payoutRef = generateReference('PAY');
console.log(payoutRef); // PAY-1708000000-B7Y4M1

const billRef = generateReference('BILL');
console.log(billRef); // BILL-1708000000-C5Z8N3

Generate Test Data

// Test data generator
const testData = {
  // Test phone numbers
  generatePhone: () => {
    const prefixes = ['0801', '0802', '0803', '0805', '0807', '0808'];
    const prefix = prefixes[Math.floor(Math.random() * prefixes.length)];
    const suffix = Math.floor(Math.random() * 10000000).toString().padStart(7, '0');
    return prefix + suffix;
  },
  
  // Test meter numbers
  generateMeter: () => {
    return Math.floor(Math.random() * 100000000000).toString().padStart(11, '0');
  },
  
  // Test smartcard numbers
  generateSmartcard: () => {
    return Math.floor(Math.random() * 10000000000).toString().padStart(10, '0');
  },
  
  // Test amounts
  generateAmount: (min = 100, max = 50000) => {
    return Math.floor(Math.random() * (max - min + 1)) + min;
  },
  
  // Test card
  testCard: {
    cardNumber: '5531886652142950',
    cvv: '564',
    expiryMonth: '09',
    expiryYear: '32',
    cardHolderName: 'TEST USER'
  }
};

// Usage
console.log('Phone:', testData.generatePhone());
console.log('Meter:', testData.generateMeter());
console.log('Amount:', testData.generateAmount());

Automated Testing

Unit Tests

// __tests__/wallet.test.js
const MoneiSDK = require('monei-sdk');

describe('Wallet Operations', () => {
  let monei;
  
  beforeAll(() => {
    monei = new MoneiSDK({
      apiKey: process.env.MONEI_SANDBOX_API_KEY,
      environment: 'sandbox'
    });
  });
  
  test('should get wallet information', async () => {
    const wallet = await monei.wallet.me();
    
    expect(wallet).toBeDefined();
    expect(wallet.nairaBalance).toBeDefined();
    expect(wallet.subwallets).toBeInstanceOf(Array);
  });
  
  test('should make deposit', async () => {
    const deposit = await monei.wallet.depositWithCard({
      amount: 5000,
      reference: `TEST-${Date.now()}`,
      card: {
        cardNumber: '5531886652142950',
        cvv: '564',
        expiryMonth: '09',
        expiryYear: '32',
        cardHolderName: 'TEST USER'
      }
    });
    
    expect(deposit.reference).toBeDefined();
    expect(deposit.status).toBe('successful');
  });
  
  test('should handle insufficient balance', async () => {
    const wallet = await monei.wallet.me();
    const balance = parseFloat(wallet.nairaBalance);
    
    await expect(
      monei.payout.bankTransfer({
        amount: balance + 10000, // More than balance
        bank: '058',
        accountNumber: '0123456789',
        transactionPin: '1234'
      })
    ).rejects.toThrow('Insufficient balance');
  });
});

Integration Tests

// __tests__/integration/bill-payment.test.js
describe('Bill Payment Flow', () => {
  test('complete airtime purchase flow', async () => {
    // 1. Get billers
    const billers = await monei.bills.getBillers({ category: 'airtime' });
    expect(billers.length).toBeGreaterThan(0);
    
    const mtn = billers.find(b => b.shortName === 'MTN');
    expect(mtn).toBeDefined();
    
    // 2. Validate customer
    const validation = await monei.bills.validate({
      billerId: mtn.billerId,
      customerId: '08012345678',
      type: 'PREPAID'
    });
    
    expect(validation.validated).toBe(true);
    expect(validation.customerName).toBeDefined();
    
    // 3. Make payment
    const payment = await monei.bills.pay({
      billerId: mtn.billerId,
      customerId: '08012345678',
      amount: 100,
      type: 'PREPAID'
    });
    
    expect(payment.status).toBe('successful');
    expect(payment.reference).toBeDefined();
    
    // 4. Verify transaction
    const transaction = await monei.transactions.getByReference(payment.reference);
    expect(transaction.status).toBe('SUCCESS');
  });
});

CI/CD Integration

GitHub Actions

name: Test Monei Integration

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      
      - name: Install dependencies
        run: npm ci
      
      - name: Run tests
        env:
          MONEI_SANDBOX_API_KEY: ${{ secrets.MONEI_SANDBOX_API_KEY }}
        run: npm test
      
      - name: Upload coverage
        uses: codecov/codecov-action@v3

GitLab CI

stages:
  - test

test:
  stage: test
  image: node:18
  
  variables:
    MONEI_SANDBOX_API_KEY: $MONEI_SANDBOX_API_KEY
  
  before_script:
    - npm ci
  
  script:
    - npm test
  
  coverage: '/All files[^|]*\|[^|]*\s+([\d\.]+)/'
  
  artifacts:
    reports:
      coverage_report:
        coverage_format: cobertura
        path: coverage/cobertura-coverage.xml

Debugging Tools

Request/Response Logging

// Debug middleware
const debug = require('debug')('monei:api');

class MoneiDebugger {
  constructor(sdk) {
    this.sdk = sdk;
    this.interceptRequests();
  }
  
  interceptRequests() {
    const originalFetch = global.fetch;
    
    global.fetch = async (...args) => {
      const [url, options] = args;
      
      // Log request
      debug('REQUEST:', {
        url,
        method: options?.method || 'GET',
        headers: options?.headers,
        body: options?.body
      });
      
      const start = Date.now();
      const response = await originalFetch(...args);
      const duration = Date.now() - start;
      
      // Log response
      const responseData = await response.clone().json();
      debug('RESPONSE:', {
        status: response.status,
        duration: `${duration}ms`,
        data: responseData
      });
      
      return response;
    };
  }
}

// Usage
const monei = new MoneiSDK({ apiKey: process.env.MONEI_API_KEY });
new MoneiDebugger(monei);

// Enable debug logs
// DEBUG=monei:* node your-script.js

Error Tracking

const Sentry = require('@sentry/node');

Sentry.init({
  dsn: process.env.SENTRY_DSN,
  environment: process.env.NODE_ENV,
  tracesSampleRate: 1.0,
});

// Wrap Monei calls
async function safeMoneiCall(fn, context) {
  const transaction = Sentry.startTransaction({
    op: 'monei.api',
    name: context
  });
  
  try {
    const result = await fn();
    transaction.setStatus('ok');
    return result;
  } catch (error) {
    transaction.setStatus('error');
    Sentry.captureException(error, {
      contexts: {
        monei: { operation: context }
      }
    });
    throw error;
  } finally {
    transaction.finish();
  }
}

// Usage
const wallet = await safeMoneiCall(
  () => monei.wallet.me(),
  'wallet.me'
);

Performance Testing

Load Testing

import http from 'k6/http';
import { check, sleep } from 'k6';

export const options = {
  stages: [
    { duration: '30s', target: 10 },  // Ramp up
    { duration: '1m', target: 10 },   // Stay at 10
    { duration: '30s', target: 0 },   // Ramp down
  ],
};

export default function () {
  const url = 'https://api.dev.monei.cc/api/v1/wallet/me';
  const params = {
    headers: {
      'x-api-key': __ENV.MONEI_API_KEY,
    },
  };
  
  const response = http.get(url, params);
  
  check(response, {
    'status is 200': (r) => r.status === 200,
    'response time < 500ms': (r) => r.timings.duration < 500,
  });
  
  sleep(1);
}

// Run: k6 run --env MONEI_API_KEY=sk_test_... load-test.js

Best Practices

Test Early

Start testing during development, not after

Automate Tests

Create automated test suites for CI/CD

Use Mock Data

Generate realistic test data

Test Edge Cases

Test failures, timeouts, and errors

Monitor Tests

Track test coverage and results

Keep Tests Fast

Optimize test execution time

Next Steps

Sandbox

Learn about sandbox environment

Security

Security best practices

Error Handling

Handle errors properly

Webhooks

Test webhook integration

Introduction

Core Concepts

Account Management

Naira Wallet

EVM Blockchain

Solana

Offramp (Crypto to Fiat)

Bill Payments

Transactions

Security

Testing

Documentation Index

​Overview

​API Testing Tools

​Postman Collection

​cURL Examples

​Mock Data Generators

​Generate Test References

​Generate Test Data

​Automated Testing

​Unit Tests

​Integration Tests

​CI/CD Integration

​GitHub Actions

​GitLab CI

​Debugging Tools

​Request/Response Logging

​Error Tracking

​Performance Testing

​Load Testing

​Best Practices

Test Early

Automate Tests

Use Mock Data

Test Edge Cases

Monitor Tests

Keep Tests Fast

​Next Steps

Sandbox

Security

Error Handling

Webhooks

Overview

API Testing Tools

Postman Collection

cURL Examples

Mock Data Generators

Generate Test References

Generate Test Data

Automated Testing

Unit Tests

Integration Tests

CI/CD Integration

GitHub Actions

GitLab CI

Debugging Tools

Request/Response Logging

Error Tracking

Performance Testing

Load Testing

Best Practices

Next Steps