smsheese/skipcash

SkipCash payment gateway integration for Laravel with enhanced security and features.

dev-main 2026-02-26 12:55 UTC

Requires

• php: ^8.1
• laravel/framework: ^9.0|^10.0|^11.0

Requires (Dev)

• phpunit/phpunit: ^10.0

Suggests

• laravel/framework: Required for Laravel integration

MIT

• Sheese Sheikh
• Shahzad Thathal

• payment
• laravel
• credit-card
• payment-gateway
• Qatar
• skipcash

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' => '[phone]',
    'Email' => '[e-mail]',
]);

// 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

Method	Endpoint	Description
POST	/payment/generate-payment-link	Create payment
POST	/payment/create-with-token	Pay with saved token
GET	/payment/card-details/{tokenIds}	Get card details
ANY	/payment/gateway/response/skipcash	Return URL
ANY	/payment/gateway/response/skipcash/webhook	Webhook

Status Codes

ID	Text	Description
0	new	Created
1	pending	Awaiting
2	paid	Success
3	canceled	Cancelled
4	failed	Failed
5	rejected	Rejected
6	refunded	Refunded
7	pending refund	Refund pending
8	refund failed	Refund failed

License

MIT License - See LICENSE file.