nelsius/nelsius-pay-php

Official PHP SDK for the Nelsius pay Developer API

v1.0.3 2026-03-22 08:34 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *

MIT

• Nelson Siebi

README

Official PHP SDK by Nelson Siebi for the Nelsius Developer API.

Installation

composer require nelsius/nelsius-pay-php

Note: For manual installation, require the files in src/.

Quick Start

use Nelsius\NelsiusClient;

$nelsius = new NelsiusClient('your_secret_key', [
    'base_url' => 'https://api.nelsius.com/api/v1',
    'verify_ssl' => false // Set to false for local development (Laragon, WAMP, etc.)
]);

// 1. Get Payment Methods
$methods = $nelsius->charges->methods();

// 2. Create Hosted Checkout Session
$checkout = $nelsius->checkout->createSession([
    'amount' => 5000,
    'currency' => 'XAF',
    'reference' => 'ORDER_12345',
    'description' => 'Purchase Description',
    'return_url' => 'https://your-site.com/success',
    'cancel_url' => 'https://your-site.com/cancel',
    'customer' => [
        'email' => '[e-mail]',
        'name' => 'Customer Name'
    ]
]);

header('Location: ' . $checkout['data']['checkout_url']);

// 3. Create Direct Charge (Mobile Money)
$charge = $nelsius->charges->create([
    'amount' => 2500,
    'currency' => 'XAF',
    'method' => 'mobile_money',
    'operator' => 'orange',
    'customer_phone' => '690000000',
    'reference' => 'TXN_REF_001'
]);

Features

• Charges: Direct payment processing (Mobile Money, Crypto, etc.)
• Checkout: Hosted payment pages for easier integration.
• Balance: Check your merchant account balance programmatically.
• Payment Methods: Retrieve supported payment methods dynamically.

License

MIT