Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/phpviet/laravel-omnipay
:dizzy: Package hổ trợ tích hợp các cổng thanh toán trong nước.
https://github.com/phpviet/laravel-omnipay
active-merchant laravel-package momo omnipay onepay phpviet vnpay vtcpay
Last synced: 3 days ago
JSON representation
:dizzy: Package hổ trợ tích hợp các cổng thanh toán trong nước.
- Host: GitHub
- URL: https://github.com/phpviet/laravel-omnipay
- Owner: phpviet
- License: mit
- Created: 2019-05-28T15:20:25.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-11-11T03:25:48.000Z (about 1 year ago)
- Last Synced: 2024-12-24T07:14:00.028Z (10 days ago)
- Topics: active-merchant, laravel-package, momo, omnipay, onepay, phpviet, vnpay, vtcpay
- Language: PHP
- Homepage:
- Size: 68.4 KB
- Stars: 91
- Watchers: 7
- Forks: 51
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
Laravel Omnipay
## Thông tin
Hiện nay các cổng thanh toán trong nước có cấu trúc API rất đa dạng và ít có điểm chung,
khiến cho việc chúng ta xây dựng các api-client cũng gặp nhiều khó khăn,
chính vì vậy package này được sinh ra nhằm đồng bộ các phương thức của các cổng thanh toán,
giúp cho việc tích hợp sẽ dễ dàng hơn, nó được thiết kế trên nền tảng [Omnipay](https://omnipay.thephpleague.com/)
giúp bạn tối giản lại các tham trị khi tạo request gửi lên các cổng thanh toán.
Do tất cả các cổng thanh toán đều có phương thức chung nên nó sẽ giúp cho bạn chuyển tiếp từ cổng thanh toán này sang cổng thanh toán khác đơn giản hơn.
Ví dụ:
```php
\MoMoAIO::purchase([
'amount' => 20000,
'returnUrl' => 'https://github.com/phpviet',
'notifyUrl' => 'https://github.com/phpviet',
'orderId' => 'Mã đơn hàng',
'requestId' => 'Mã request id, gợi ý nên xài uuid4',
])->send();
\OnePayDomestic::purchase([
'AgainLink' => 'https://github.com/phpviet',
'vpc_MerchTxnRef' => microtime(false),
'vpc_ReturnURL' => 'https://github.com/phpviet',
'vpc_TicketNo' => '127.0.0.1',
'vpc_Amount' => '200000',
'vpc_OrderInfo' => 456,
])->send();
\VNPay::purchase([
'vnp_TxnRef' => time(),
'vnp_OrderType' => 100000,
'vnp_OrderInfo' => time(),
'vnp_IpAddr' => '127.0.0.1',
'vnp_Amount' => 1000000,
'vnp_ReturnUrl' => 'https://github.com/phpviet',
])->send();
\VTCPay::purchase([
'receiver_account' => '0963465816',
'reference_number' => microtime(false),
'amount' => 50000,
'url_return' => 'https://phpviet.org'
])->send();
```
Các cổng thanh toán đang được hổ trợ tích hợp:
+ **[MoMo](https://momo.vn)**
+ **[OnePay](https://onepay.vn)**
+ **[VNPay](https://vnpay.vn)**
+ **[VTCPay](https://vtcpay.vn)**
## Cài đặt
Cài đặt Laravel Omnipay thông qua [Composer](https://getcomposer.org):
```bash
composer require phpviet/laravel-omnipay
```
Sau khi cài đặt xong bạn cần phải publish config file để thiết lập thông số cho cổng thanh toán bạn cần tích hợp, publish thông qua câu lệnh:
```php
php artisan vendor:publish --provider="PHPViet\Laravel\Omnipay\OmnipayServiceProvider" --tag="config"
```
Nội dung file publish nằm trong thư mục `config/laravel-omnipay.php` của bạn như sau:
```php
return [
// Cấu hình cho các cổng thanh toán tại hệ thống của bạn, các cổng không xài có thể xóa cho gọn hoặc không điền.
// Các thông số trên có được khi bạn đăng ký tích hợp.
'gateways' => [
'MoMoAIO' => [
'driver' => 'MoMo_AllInOne',
'options' => [
'accessKey' => '',
'secretKey' => '',
'partnerCode' => '',
'testMode' => false,
],
],
'MoMoQRCode' => [
'driver' => 'MoMo_QRCode',
'options' => [
'accessKey' => '',
'secretKey' => '',
'partnerCode' => '',
'testMode' => false,
],
],
'MoMoAIA' => [
'driver' => 'MoMo_AppInApp',
'options' => [
'accessKey' => '',
'secretKey' => '',
'partnerCode' => '',
'publicKey' => '',
'testMode' => false,
],
],
'MoMoPOS' => [
'driver' => 'MoMo_POS',
'options' => [
'accessKey' => '',
'secretKey' => '',
'partnerCode' => '',
'publicKey' => '',
'testMode' => false,
],
],
'OnePayDomestic' => [
'driver' => 'OnePay_Domestic',
'options' => [
'vpcMerchant' => '',
'vpcAccessCode' => '',
'vpcUser' => '',
'vpcPassword' => '',
'vpcHashKey' => '',
'testMode' => false,
],
],
'OnePayInternational' => [
'driver' => 'OnePay_International',
'options' => [
'vpcMerchant' => '',
'vpcAccessCode' => '',
'vpcUser' => '',
'vpcPassword' => '',
'vpcHashKey' => '',
'testMode' => false,
],
],
'VTCPay' => [
'driver' => 'VTCPay',
'options' => [
'websiteId' => '',
'securityCode' => '',
'testMode' => false,
],
],
'VNPay' => [
'driver' => 'VNPay',
'options' => [
'vnpTmnCode' => '',
'vnpHashSecret' => '',
'testMode' => false,
],
],
],
];
```
## Cách sử dụng
+ [Cổng thanh toán MoMo](/docs/MoMo.md)
+ [Cổng thanh toán OnePay](/docs/OnePay.md)
+ [Cổng thanh toán VNPay](/docs/VNPay.md)
+ [Cổng thanh toán VTCPay](/docs/VTCPay.md)
## Dành cho nhà phát triển
Nếu như bạn cảm thấy thư viện chúng tôi còn thiếu sót hoặc sai sót và bạn muốn đóng góp để phát triển chung,
chúng tôi rất hoan nghênh! Hãy tạo các `issue` để đóng góp ý tưởng cho phiên bản kế tiếp hoặc tạo `PR`
để đóng góp phần thiếu sót hoặc sai sót. Riêng đối với các lỗi liên quan đến bảo mật thì phiền bạn gửi email đến
[email protected] thay vì tạo issue. Cảm ơn!