Welcome to Gafiapay API

Secure virtual account generation and management for Nigerian businesses

What is Gafiapay?

Gafiapay is a payment solution that enables Nigerian businesses to generate and manage virtual accounts through our secure infrastructure. Our platform provides secure virtual account creation, real-time account management, and comprehensive business verification.

Virtual Account Generation

Create 10-digit virtual account numbers for seamless payment collection

Virtual Account Infrastructure

Powered by our secure virtual account infrastructure

Business Verification

Comprehensive KYC and business verification system

Account Management

List and manage all virtual accounts with pagination

Key Features

Virtual Account Generation

Generate 10-digit virtual account numbers through our API. Each account is uniquely associated with a customer's email and name.

Account Management

List and manage all virtual accounts with pagination support. Track account creation dates and customer information.

Secure Authentication

HMAC SHA-256 signature-based authentication with API keys and timestamp validation for secure API access.

Business Verification

Comprehensive business verification system with KYC requirements. Only verified businesses can access the API.

Getting Started

1

Create a Business Account

Sign up for a Gafiapay business account and complete the verification process including KYC requirements.

2

Complete Business Verification

Ensure your business verification status is completed to access the API.

3

Get Your API Keys

Generate your API key and secret key from the dashboard to start making requests.

4

Start Generating Accounts

Begin by generating virtual accounts for your customers using the API.

API Overview

Base URL

https://api.gafiapay.com/api/v1/external

Authentication

All API requests require authentication using your API key and HMAC signature. Learn more about authentication in our Authentication guide.

Available Endpoints

POST /account/generate Generate a new virtual account
GET /account/list List all virtual accounts with pagination

Response Format

All responses are returned in JSON format with a consistent structure: 

{
  "status": "success",
  "data": {
    // Response data specific to the endpoint
  }
}

Best Practices

Secure Your API Keys

Never expose your API keys in client-side code or public repositories. Store them securely in environment variables.

Handle Errors Gracefully

Implement proper error handling and retry mechanisms for failed requests. Check the status field in responses.

Use Pagination

When listing accounts, use pagination parameters to handle large datasets efficiently.

Validate Business Status

Ensure your business verification is completed before attempting to use the API.

Ready to Get Started?

Begin your integration journey with our authentication guide

Get Started with Authentication