unicodeveloper/laravel-paystack là dự án mã nguồn mở trên GitHub với 649 sao, viết chủ yếu bằng PHP. :credit_card: :package: :moneybag: Laravel 6, 7, 8, 9, 10 and 11 Package for Paystack
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Though there are multiple ways to pay an order, most payment gateways expect you to follow the following flow in your checkout process:
1. The customer is redirected to the payment provider
After the customer has gone through the checkout process and is ready to pay, the customer must be redirected to the site of the payment provider.
The redirection is accomplished by submitting a form with some hidden fields. The form must send a POST request to the site of the payment provider. The hidden fields minimally specify the amount that must be paid, the order id and a hash.
The hash is calculated using the hidden form fields and a non-public secret. The hash used by the payment provider to verify if the request is valid.
2. The customer pays on the site of the payment provider
The customer arrives on the site of the payment provider and gets to choose a payment method. All steps necessary to pay the order are taken care of by the payment provider.
3. The customer gets redirected back to your site
After having paid the order the customer is redirected back. In the redirection request to the shop-site some values are returned. The values are usually the order id, a payment result and a hash.
The hash is calculated out of some of the fields returned and a secret non-public value. This hash is used to verify if the request is valid and comes from the payment provider. It is paramount that this hash is thoroughly checked.
Usage
Open your .env file and add your public key, secret key, merchant email and payment url like so:
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Requests;
use App\Http\Controllers\Controller;
use Illuminate\Support\Facades\Redirect;
use Paystack;
class PaymentController extends Controller
{
/**
* Redirect the User to Paystack Payment Page
* @return Url
*/
public function redirectToGateway()
{
try{
return Paystack::getAuthorizationUrl()->redirectNow();
}catch(\Exception $e) {
return Redirect::back()->withMessage(['msg'=>'The paystack token has expired. Please refresh the page and try again.', 'type'=>'error']);
}
}
/**
* Obtain Paystack payment information
* @return void
*/
public function handleGatewayCallback()
{
$paymentDetails = Paystack::getPaymentData();
dd($paymentDetails);
// Now you have the payment details,
// you can store the authorization_code in your db to allow for recurrent subscriptions
// you can then redirect or do whatever you want
}
}
/**
* In the case where you need to pass the data from your
* controller instead of a form
* Make sure to send:
* required: email, amount, reference, orderID(probably)
* optionally: currency, description, metadata
* e.g:
*
*/
$data = array(
"amount" => 700 * 100,
"reference" => '4g4g5485g8545jg8gj',
"email" => '[email protected]',
"currency" => "NGN",
"orderID" => 23456,
);
return Paystack::getAuthorizationUrl($data)->redirectNow();
Let me explain the fluent methods this package provides a bit here.
/**
* This fluent method does all the dirty work of sending a POST request with the form data
* to Paystack Api, then it gets the authorization Url and redirects the user to Paystack
* Payment Page. We've abstracted all of it, so you don't have to worry about that.
* Just eat your cookies while coding!
*/
Paystack::getAuthorizationUrl()->redirectNow();
/**
* Alternatively, use the helper.
*/
paystack()->getAuthorizationUrl()->redirectNow();
/**
* This fluent method does all the dirty work of verifying that the just concluded transaction was actually valid,
* It verifies the transaction reference with Paystack Api and then grabs the data returned from Paystack.
* In that data, we have a lot of good stuff, especially the `authorization_code` that you can save in your db
* to allow for easy recurrent subscription.
*/
Paystack::getPaymentData();
/**
* Alternatively, use the helper.
*/
paystack()->getPaymentData();
/**
* This method gets all the customers that have performed transactions on your platform with Paystack
* @returns array
*/
Paystack::getAllCustomers();
/**
* Alternatively, use the helper.
*/
paystack()->getAllCustomers();
/**
* This method gets all the plans that you have registered on Paystack
* @returns array
*/
Paystack::getAllPlans();
/**
* Alternatively, use the helper.
*/
paystack()->getAllPlans();
/**
* This method gets all the transactions that have occurred
* @returns array
*/
Paystack::getAllTransactions();
/**
* Alternatively, use the helper.
*/
paystack()->getAllTransactions();
/**
* This method generates a unique super secure cryptographic hash token to use as transaction reference
* @returns string
*/
Paystack::genTranxRef();
/**
* Alternatively, use the helper.
*/
paystack()->genTranxRef();
/**
* This method creates a subaccount to be used for split payments
* @return array
*/
Paystack::createSubAccount();
/**
* Alternatively, use the helper.
*/
paystack()->createSubAccount();
/**
* This method fetches the details of a subaccount
* @return array
*/
Paystack::fetchSubAccount();
/**
* Alternatively, use the helper.
*/
paystack()->fetchSubAccount();
/**
* This method lists the subaccounts associated with your paystack account
* @return array
*/
Paystack::listSubAccounts();
/**
* Alternatively, use the helper.
*/
paystack()->listSubAccounts();
/**
* This method Updates a subaccount to be used for split payments
* @return array
*/
Paystack::updateSubAccount();
/**
* Alternatively, use the helper.
*/
paystack()->updateSubAccount();
<form method="POST" action="{{ route('pay') }}" accept-charset="UTF-8" class="form-horizontal" role="form">
<div class="row" style="margin-bottom:40px;">
<div class="col-md-8 col-md-offset-2">
<p>
<div>
Lagos Eyo Print Tee Shirt
₦ 2,950
</div>
</p>
<input type="hidden" name="email" value="[email protected]"> {{-- required --}}
<input type="hidden" name="orderID" value="345">
<input type="hidden" name="amount" value="800"> {{-- required in kobo --}}
<input type="hidden" name="quantity" value="3">
<input type="hidden" name="currency" value="NGN">
<input type="hidden" name="metadata" value="{{ json_encode($array = ['key_name' => 'value',]) }}" > {{-- For other necessary things you want to add to your payload. it is optional though --}}
<input type="hidden" name="reference" value="{{ Paystack::genTranxRef() }}"> {{-- required --}}
<input type="hidden" name="split_code" value="SPL_EgunGUnBeCareful"> {{-- to support transaction split. more details https://paystack.com/docs/payments/multi-split-payments/#using-transaction-splits-with-payments --}}
<input type="hidden" name="split" value="{{ json_encode($split) }}"> {{-- to support dynamic transaction split. More details https://paystack.com/docs/payments/multi-split-payments/#dynamic-splits --}}
{{ csrf_field() }} {{-- works only when using laravel 5.1, 5.2 --}}
<input type="hidden" name="_token" value="{{ csrf_token() }}"> {{-- employ this in place of csrf_field only in laravel 5.0 --}}
<p>
<button class="btn btn-success btn-lg btn-block" type="submit" value="Pay Now!">
<i class="fa fa-plus-circle fa-lg"></i> Pay Now!
</button>
</p>
</div>
</div>
</form>
When clicking the submit button the customer gets redirected to the Paystack site.
So now we've redirected the customer to Paystack. The customer did some actions there (hopefully he or she paid the order) and now gets redirected back to our shop site.
Paystack will redirect the customer to the url of the route that is specified in the Callback URL of the Web Hooks section on Paystack dashboard.
We must validate if the redirect to our site is a valid request (we don't want imposters to wrongfully place non-paid order).
In the controller that handles the request coming from the payment provider, we have
Paystack::getPaymentData() - This function calls the verification methods and ensure it is a valid transaction else it throws an exception.
You can test with these details
Card Number: 4123450131001381
Expiry Date: any date in the future
CVV: 883
Todo
Charge Returning Customers
Add Comprehensive Tests
Implement Transaction Dashboard to see all of the transactions in your laravel app
Contributing
Please feel free to fork this package and contribute by submitting a pull request to enhance the functionalities.
How can I thank you?
Why not star the github repo? I'd love the attention! Why not share the link for this repository on Twitter or HackerNews? Spread the word!
Don't forget to follow me on twitter!
Thanks!
Prosper Otemuyiwa.
License
The MIT License (MIT). Please see License File for more information.
Đọc thêm về unicodeveloper/laravel-paystack ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/unicodeveloper/laravel-paystack là nguồn chính thức.
unicodeveloper/laravel-paystack có bao nhiêu sao?
unicodeveloper/laravel-paystack có 649 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/unicodeveloper/laravel-paystack. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
unicodeveloper/laravel-paystack có những chủ đề gì?
GitHub topics của unicodeveloper/laravel-paystack: "laravel-paystack", "library", "money", "payment", "payment-provider", "paystack", "plan", "transfer". TopGit xếp repo vào nhóm mã nguồn mở.
unicodeveloper/laravel-paystack có trang demo không?
Dự án có trang chủ ở https://paystack.co. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
unicodeveloper/laravel-paystack còn đang phát triển không?
Commit gần nhất trên unicodeveloper/laravel-paystack là 2.4 năm trước (theo timestamp GitHub). Repo có 352 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
unicodeveloper/laravel-paystack dùng license gì?
unicodeveloper/laravel-paystack phát hành theo license MIT. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
unicodeveloper/laravel-paystack viết bằng ngôn ngữ gì?
unicodeveloper/laravel-paystack chủ yếu viết bằng PHP. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc đầy đủ README ở tab phía trên.
laravel-paystack có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về laravel-paystack.