README

Laravel client for the SPPay public API: OAuth, payments, transfers, transactions, institutions, and SMS.

Package: mboateng/sppay-laravel
PHP: 8.1+
Laravel: 10, 11, or 12

Installation

composer require mboateng/sppay-laravel

The service provider and Sppay facade are registered automatically via Laravel package discovery.

Publish the configuration (optional):

php artisan vendor:publish --tag=sppay-config

Configuration

Values are read from .env through config/sppay.php (use config('sppay.*') in code).

Environment variables

Example .env (use your own secrets; do not commit real credentials):

SPPAY_BASE_URL=https://engine.sppay.dev
SPPAY_OAUTH_URL=https://engine.sppay.dev/oauth/token
SPPAY_CLIENT_ID=your-client-id
SPPAY_CLIENT_SECRET=your-client-secret
SPPAY_USERNAME=your@email.com
SPPAY_PASSWORD=your-password

Laravel loads these into config('sppay.base_url'), config('sppay.oauth_url'), config('sppay.client_id'), etc. You do not need a separate services.php entry unless you prefer to duplicate keys there.

Usage

Facade

Option A — password grant using .env (recommended when credentials live in config):

use Mboateng\Sppay\Facades\Sppay;

$response = Sppay::oauthPasswordGrant();
Sppay::setAccessToken($response['access_token']);

$transactions = Sppay::listTransactions(['page_size' => 10]);

Option B — build the payload yourself:

use Mboateng\Sppay\Facades\Sppay;

$token = Sppay::oauthToken([
    'grant_type' => 'password',
    'client_id' => config('sppay.client_id'),
    'client_secret' => config('sppay.client_secret'),
    'username' => config('sppay.username'),
    'password' => config('sppay.password'),
]);

Sppay::setAccessToken($token['access_token']);

$transactions = Sppay::listTransactions(['page_size' => 10]);

Dependency injection

use Mboateng\Sppay\Contracts\SppayClientContract;

public function __construct(
    private SppayClientContract $sppay
) {}

public function example(): void
{
    $this->sppay->setAccessToken($token);
    $this->sppay->getTransaction('REFERENCE');
}

Manual client

use Mboateng\Sppay\SppayClient;

$client = new SppayClient(
    baseUrl: 'https://engine.sppay.dev',
    accessToken: $token,
);

$client->initiatePayment([/* ... */]);

Public endpoints (no Bearer)

oauthToken() and validatePublicKey() do not send an Authorization header. All other methods require a Bearer token (setAccessToken() or SPPAY_ACCESS_TOKEN).

API methods

listTransactions() accepts query parameters such as account_no, reference, amount, date_from, date_to, type_code, status_id, page_size, page, etc.

Errors

Failed HTTP calls throw Mboateng\Sppay\Exceptions\SppayRequestException. Use getResponseBody() for the raw API error body when available.

Testing

composer test

License

MIT