Payments Service Introduction

Our Payments Service provides a robust and secure way to handle financial transactions within your applications. Whether you need to accept Mobile Money, process card payments, manage subscriptions, or issue payouts, our API is designed for flexibility and ease of integration.

This section covers the initial steps required to configure your account and application specifically for using the Payments service.

Payment Requirements & Setup

To start integrating our Payments service, ensure you have completed the following steps:

  1. Account Creation:

    You need an active main account on our platform. If you haven't already, sign up here.

  2. Company Setup:

    Ensure your primary company profile is configured, or create a specific one if needed for this payment integration.

  3. Payment Methods Configuration:
    • Mobile Money (MOMO) is typically enabled by default.
    • For Card Payments (Visa, Mastercard, etc.), contact our support team to activate this option for your account.
  4. Application Creation & Configuration:
    • Create an 'App' in your dashboard specifically for your payment integration.
    • Enable the 'Payments' service for this App during setup.
    • Configure Payment Webhook URL: Provide a secure endpoint URL where we can send real-time notifications about payment status changes (e.g., successful payments, failures, refunds). This is crucial for keeping your system updated.
  5. API Key Generation:
    • Generate API Access Key and Secret Key specifically for the App you created for payments.
    • Store the Secret Key securely – it won't be shown again.
    • Use these keys to authenticate your API requests to the Payment service endpoints.

Once these requirements are met, you can proceed to the API reference documentation to start making payment requests.