Getting Started

The OGateway API gives you access to robust payment features that allow you to collect payments, manage payouts, and handle financial operations programmatically. This API is designed to be RESTful, using predictable resource-oriented URLs, standard HTTP response codes, and JSON-encoded requests and responses.

Getting Started Here is your roadmap to integrating with OGateway:

  1. Base URLs:

    1. The Base URL for the dashboard is: dash.ogateway.io
    2. The Base URL for the API is: api.ogateway.io
  2. Create an account: Sign up for an OGateway account. By default, you will have access to a Test environment where you can simulate transactions without moving real money.

  3. Get your API Keys: Navigate to the Settings > API Keys tab in your customer dashboard. Here you will find your Test Key for development.

    Generate and manage your API keys from the Settings menu.

  4. Complete your KYC: To take your integration live, you must complete your business profile in the Settings > Business tab. We will review your documents to approve your account for production.

  5. Go Live: Once approved, you can toggle the internal dashboard switch from Test to Live. You can then generate your Live Key to start processing real payments.

❗️

Keep your API Keys secure. Never commit it to version control, or expose it within your applications

📘

API Keys can be re-generated from the Dashboard

Input/Output Format Both request bodies and response data are formatted as JSON. The Content-Type header for responses will always be application/json.

Standard Response Format: Generally, all responses follow this structure:

{
  "status": "success",
  "code": 200,
  "message": "Transaction initiated successfully",
  "data": { 
    "id": "45dcf5e9-e594...",
    "amount": 100,
    "currency": "GHS"
  }
}

Response Fields

FieldData TypeUsage / Definition
statusStringsuccess or error
codeIntegerStandard HTTP response status code
messageStringHuman readable result
dataJson ObjectThe payload of the requested action
idString (UUID)The transaction reference
amountDoubleThe transaction amount / value
currencyStringThe transaction currency