README

A Laravel package for SkipCash payment gateway integration with sandbox/production support.

Requirements

• PHP 8.1+
• Laravel 9.0+

Quick Install

composer require smsheese/skipcash
php artisan vendor:publish --tag=config
php artisan migrate

Configuration

Add to .env:

SKIPCASH_MODE=sandbox
SKIPCASH_CLIENT_ID=your_client_id
SKIPCASH_KEY_ID=your_key_id
SKIPCASH_KEY_SECRET=your_key_secret
SKIPCASH_WEBHOOK_KEY=your_webhook_key

Basic Usage

use Smsheese\Skipcash\Services\SkipCashGateway;

$gateway = app(SkipCashGateway::class);

// Create payment
$response = $gateway->createPayment([
    'Uid' => $gateway->generateUuid(),
    'KeyId' => config('skipcash.key_id'),
    'Amount' => '100.00',
    'FirstName' => 'John',
    'LastName' => 'Doe',
    'Phone' => '+97412345678',
    'Email' => 'john@example.com',
]);

// Redirect to payment page
return redirect($response['resultObj']['payUrl']);

Features

• Secure HMAC-SHA256 signatures - Only non-empty fields in correct order
• Webhook validation - Signature verification with timing-safe comparison
• Idempotency - Prevents duplicate webhook processing
• Tokenization - Save cards for returning customers
• Recurring payments - Subscription support
• Refunds - Full and partial refunds

Documentation

Detailed documentation available in docs/skipcash/. These files were fetched from the official SkipCash Developer Portal and saved as Markdown for reference.

Quick usage guide available in docs/USAGE.md.

• API Integration
• Authentication
• Webhooks
• Tokenization
• Recurring Payments
• Refunds
• Direct Debit (QPAY)
• WooCommerce

Routes

Status Codes

License

MIT License - See LICENSE file.