PHPackages                             maree-sewidan/hyper-pay - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. maree-sewidan/hyper-pay

ActiveLibrary[Payment Processing](/categories/payments)

maree-sewidan/hyper-pay
=======================

package to pay with hyper pay payment gateway

1126PHP

Since May 21Pushed 1y agoCompare

[ Source](https://github.com/MostafaSewidan/HyperPay)[ Packagist](https://packagist.org/packages/maree-sewidan/hyper-pay)[ RSS](/packages/maree-sewidan-hyper-pay/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

HyperPay
========

[](#hyperpay)

Installation
------------

[](#installation)

You can install the package via [Composer](https://getcomposer.org).

```
composer require maree-sewidan/hyper-pay
```

Publish your hyper-pay config file with

```
php artisan vendor:publish --provider="maree\hyperPay\HyperPayServiceProvider" --tag="hyperPay"
```

then change your hyperPay config from config/hyperPay.php file

```

	"mode" => "test" , // test||live
    "token" =>  "",
    "entityIds" => [
        'VISA MASTER' => "",
        'STC_PAY'     => "",
        'MADA'        => "",
        'APPLEPAY'    => "",
        'AMEX'        => ""
    ],
```

Usage
-----

[](#usage)

first step
----------

[](#first-step)

```
use maree\hyperPay\HyperPay;
$customerInfo = ['email' => 'm7mdmaree26@gmail.com' , 'country' => 'EG' , 'givenName' => 'mohamed maree' ,'surname' => 'mohamed maree' , 'street1' => '23 elmagd' ,'city' => 'almehalla' ,'state' => 'gharbia' , 'postcode' => '1234'];
$brand = 'VISA MASTER'; //you can use 'VISA MASTER' or 'STC_PAY' or 'MADA' or 'APPLEPAY' or 'AMEX'
$response = HyperPay::checkout($amount = 1.0 ,$brand, $customerInfo);
```

note
----

[](#note)

- use 'VISA MASTER' as one brand or key not two different brands or keys
- this function return \['checkoutId' => $checkoutId , 'responseData' => $responseData\]
- use checkoutId to save transaction in database
- use checkoutId in view page in next step

second step
-----------

[](#second-step)

- return view page with $checkoutId to show payment proccess

```

        .wpwl-container{
            z-index: 99;
            color : rgb(15, 13, 13);
        }
        .wpwl-control, .wpwl-group-registration{
            color:#333;
        }
        .pay-link{
            position: relative;
            z-index: 99;
        }
        .pay-link ul{
            display: flex;
            align-items: center;
            justify-content: center;
        }
        .pay-link ul li{
            margin: 10px;
        }
        .pay-link ul li img{
            width: 120px;
            height: 50px;
            max-width: 100%;
        }
        .wpwl-group{
            direction:ltr;
        }
        .wpwl-control-cardNumber{
            direction:ltr !important;
            text-align:right;
        }

        var wpwlOptions = {
            locale: "ar",
            paymentTarget:"_top",
        }

    @if (config('hyperPay.mode') == 'live')

    @else{

    @endif
```

note
----

[](#note-1)

- create route for response url 'show-response-route' EX: Route::get('show-response-route', 'PaymentsController@paymentresponse')->name('show-response-route');
- create function for checkout response 'paymentresponse'
- use that function to check if payment failed or success

inside 'paymentresponse' function use:
--------------------------------------

[](#inside-paymentresponse-function-use)

```
use maree\hyperPay\HyperPay;
//$brand = 'VISA MASTER';// || STC_PAY || MADA || APPLEPAY || AMEX
// $transactionid = $request->resourcePath;
$response = HyperPay::checkoutResponseStatus($transactionid,$brand);
```

return response like:

```
['key' => 'success' , 'msg'=> $description ,'checkoutId' => $checkoutId , 'responseData' => $responseData]
```

or

```
['key' => 'fail'    , 'msg'=> $description ,'checkoutId' => $checkoutId , 'responseData' => $responseData];
```

note: you can use response from data to save transactions in database

- Test Card Details
- Card Number: Visa: 4111111111111111
- CVV: 123
- Expiry Date: 05/22
- Card Name: Test Family

APPLEPAY note
-------------

[](#applepay-note)

- in apple pay you recieve text file from hyperpay then put it inside public/.well-known directory in your project without change that file name
- you must use apple device to check it work successfuly
- you must exists in country provide apple pay payments

current hyperpay package payment ways :
---------------------------------------

[](#current-hyperpay-package-payment-ways-)

- visa
- master
- mada
- stc
- apple pay
- AMEX

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance26

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity18

Early-stage or recently created project

 Bus Factor1

Top contributor holds 64.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/bf3e5c893c005b20c81373350044f93f205d95b05320968c2225648d358c9662?d=identicon)[MostafaSewidan](/maintainers/MostafaSewidan)

---

Top Contributors

[![mohamedmaree](https://avatars.githubusercontent.com/u/12659069?v=4)](https://github.com/mohamedmaree "mohamedmaree (9 commits)")[![MostafaSewidan](https://avatars.githubusercontent.com/u/35866891?v=4)](https://github.com/MostafaSewidan "MostafaSewidan (5 commits)")

### Embed Badge

![Health badge](/badges/maree-sewidan-hyper-pay/health.svg)

```
[![Health](https://phpackages.com/badges/maree-sewidan-hyper-pay/health.svg)](https://phpackages.com/packages/maree-sewidan-hyper-pay)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)