Getting Started

Welcome to the NjiaPay developer documentation! This documentation provides all the information you need to start accepting payments seamlessly on your platform. The Payments API offers a robust set of resources for managing transactions, built around REST principles to ensure flexibility and ease of use.

Why NjiaPay?

NjiaPay is a payment processing platform that enables you to accept payments from customers across multiple payment service providers, payment methods and currencies.. With our hosted checkout solution, you can start accepting payments quickly while maintaining PCI compliance and security.

Key Features

• Hosted Checkout Page: PCI-compliant payment page that is optimized for security, speed and user experience
• Multiple Payment Methods: Support for cards, bank transfers, mobile money, and more
• Global Currency Support: Accept payments in 40+ currencies
• Recurring Payments: Support for subscriptions and auto-payments via Merchant-Initiated Transactions (MIT)
• Payment Splits: Distribute payments to multiple beneficiaries
• Real-time Webhooks: Get instant notifications about payment status changes
• Comprehensive Refunds: Process full and partial refunds through the API
• Smart Routing: Optimize payment success rates with intelligent PSP routing

Quick Links

How It Works

sequenceDiagram
    participant Merchant as Your Server
    participant NjiaPay as NjiaPay API
    participant Customer as Customer
    participant Checkout as Hosted Checkout

    Merchant->>NjiaPay: 1. Create Payment Intent
    NjiaPay-->>Merchant: Return redirect_url
    Merchant->>Customer: 2. Redirect to checkout
    Customer->>Checkout: 3. Complete payment
    Checkout->>NjiaPay: 4. Process payment
    NjiaPay-->>Merchant: 5. Send webhook notification (optional but recommeded)
    NjiaPay-->>Customer: 6. Redirect to return_url

Integration Steps

1. Authenticate - Obtain your API keys from the merchant portal
2. Create Payment Intent - Initialize a payment with amount and currency
3. Redirect Customer - Send customer to hosted checkout page
4. Handle Webhooks - Listen for payment status updates
5. Test Integration - Verify everything works with our MockPSP

Environments

NjiaPay provides two environments for development and production:

Sandbox (Testing)

• Base URL: https://app.staging.infinic.dev/
• Purpose: Test your integration without processing real payments
• API Keys: Provided by NjiaPay support during onboarding

Production (Live)

• Base URL: https://app.infinic.com/
• Purpose: Process real payments
• API Keys: Generate from the merchant portal

Need Help?

• Questions? Contact our support team
• Found a bug? Report it to our technical team
• Feature request? Let us know what you need

Ready to start? Head over to the Quick Start Guide to accept your first payment in minutes!