Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/codeboxrcodehub/upay

Upay(bangladesh) payment gateway integration package for laravel/php projects
https://github.com/codeboxrcodehub/upay

bd-payment laravel-upay-package laravel-upay-payment payment-gateway upay upay-api upay-api-gateway upay-gateway upay-laravel

Last synced: 2 days ago
JSON representation

Upay(bangladesh) payment gateway integration package for laravel/php projects

Awesome Lists containing this project

README

        



Upay BD Payment Gateway





This is a Laravel/PHP package for [Upay](https://www.upaybd.com/) BD Payment Gateway. This package can be used in laravel or without laravel/php projects. You can use this package for headless/rest implementation as well as blade or regular mode development. We created this package while working for a project and thought to made it release for all so that it helps. This package is available as regular php [composer package](https://packagist.org/packages/codeboxr/upay).

## Features

1. [Create Payment/Take to Payment Page](https://github.com/codeboxrcodehub/upay#1-create-payment)
2. [Create Payment for Headless/RestAPI](https://github.com/codeboxrcodehub/upay#2-create-payment-for-restapi)
3. [Query Payment/Payment Details](https://github.com/codeboxrcodehub/upay#2-query-payment)

## Requirements

- PHP >=7.4
- Laravel >= 6

## Installation

```bash
composer require codeboxr/upay
```

### vendor publish (config)

```bash
php artisan vendor:publish --provider="Codeboxr\Upay\UpayServiceProvider"
```

After publish config file setup your credential. you can see this in your config directory upay.php file

```
"sandbox" => env("UPAY_SANDBOX", false), // for sandbox use true
"server_ip" => env("UPAY_SERVER_IP", ""),
"merchant_id" => env("UPAY_MERCHANT_ID", ""),
"merchant_key" => env("UPAY_MERCHANT_KEY", ""),
"merchant_code" => env("UPAY_MERCHANT_CODE", ""),
"merchant_name" => env("UPAY_MERCHANT_NAME", ""),
"merchant_mobile" => env("UPAY_MERCHANT_MOBILE", ""),
"merchant_city" => env("UPAY_MERCHANT_CITY", ""),
"merchant_category_code" => env("UPAY_CATEGORY_CODE", ""),
"redirect_url" => env("UPAY_CALLBACK_URL", "")
```

### Set .env configuration

```
UPAY_SANDBOX=true // for production use false
UPAY_SERVER_IP="" // uPay only support IPV4 for production server don't needed sandbox
UPAY_MERCHANT_ID=""
UPAY_MERCHANT_KEY=""
UPAY_MERCHANT_CODE=""
UPAY_MERCHANT_NAME=""
UPAY_MERCHANT_MOBILE=""
UPAY_MERCHANT_CITY=""
UPAY_CATEGORY_CODE=""
UPAY_CALLBACK_URL=""
```

## Usage

### 1. Create Payment

```
use Codeboxr\Upay\Facade\Payment;

return Payment::executePayment($amount, $invoiceId, $txnId, $date);

```

### Example

```
return Payment::executePayment(10, 'CBX10101', '10127373', '2022-08-26');
```

### 2. Create Payment for REST API

```
use Codeboxr\Upay\Facade\Payment;

return Payment::createPayment($amount, $invoiceId, $txnId, $date);

```

### Example

```
return Payment::createPayment(10, 'CBX10101', '10127373', '2022-08-26');
```

### 3. Query Payment

```
use Codeboxr\Upay\Facade\Payment;

Payment::queryPayment($invoiceId); // Invoice ID
```

Note: Upay only support IPV4 for production server

## Contributing

Contributions to the Upay package are welcome. Please note the following guidelines before submitting your pull request.

- Follow [PSR-4](http://www.php-fig.org/psr/psr-4/) coding standards.
- Read Upay API documentations first.Please contact with Upay for their api documentation and sandbox access.

## License

Upay package is licensed under the [MIT License](http://opensource.org/licenses/MIT).

Copyright 2022 [Codeboxr](https://codeboxr.com) We are not not affiliated with Upay and don't give any guarantee.