phpviet / laravel-omnipay
Laravel Omnipay hổ trợ tích hợp các cổng thanh toán trong nước.
Installs: 7 357
Dependents: 1
Suggesters: 0
Security: 0
Stars: 91
Watchers: 7
Forks: 51
Open Issues: 5
Requires
- php: ^7.1
- ignited/laravel-omnipay: ^3.3
- illuminate/support: ^5.7 || ^6.0 || ^7.0 || ^8.0
- phpviet/omnipay-momo: ^1.0
- phpviet/omnipay-onepay: ^1.0
- phpviet/omnipay-vnpay: ^1.0
- phpviet/omnipay-vtcpay: ^1.0
Requires (Dev)
- orchestra/testbench: ^3.7 || ^4.0 || ^5.0 || ^6.0
This package is auto-updated.
Last update: 2024-10-09 15:10:13 UTC
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 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ụ:
\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:
Cài đặt
Cài đặt Laravel Omnipay thông qua Composer:
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 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:
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
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
vuongxuongminh@gmail.com thay vì tạo issue. Cảm ơn!