granada-pride/paytabs

This provide integration with the PayTabs payment gateway

v2.4.1 2025-02-05 21:04 UTC

MIT

• Hussein Gaber

README

PayTabs Payment Gateway Integration for Laravel

Table of Contents

1. Description
2. Installation
3. Configuration
4. Usage
   • Creating a PayPage
   • Querying Transactions
5. Troubleshooting
6. Testing
7. Contribution
8. License

Description

PayTabs Payment Gateway Integration with Laravel Framework

Installation

You can install the package via composer:

composer require granada-pride/paytabs

Note: This package is compatible with Laravel 9 and higher. Ensure your application meets this requirement before installing.

Configuration

After installation, publish the configuration file using the following command:

php artisan vendor:publish --provider="GranadaPride\Paytabs\PaytabsServiceProvider"

The configuration file paytabs.php will be added to your config directory. Here is a sample configuration:

return [
    'profile_id' => env('PAYTABS_PROFILE_ID'),
    'server_key' => env('PAYTABS_SERVER_KEY'),
    'currency' => env('PAYTABS_CURRENCY'),
    'region' => env('PAYTABS_REGION'),
];

Configuration Options

• profile_id: Your PayTabs profile ID, required for API requests.
• server_key: Your PayTabs server key, used for authentication.
• currency: The currency code in which payments will be processed (e.g., USD).
• region: The region for your PayTabs account (e.g., ARE, SAU).

Usage

Create PayPage

Here’s how to create a payment page using this package:

use GranadaPride\Paytabs\Paytabs;
use GranadaPride\Paytabs\DTO\CustomerDetails;

$paytabs = Paytabs::make();

// Set Cart Information
$paytabs->setCart('CART123', 150.00, 'Sample Cart Description');

// Set Customer Information using the CustomerDetails DTO
$customerDetails = new CustomerDetails(
    name: 'John Doe',
    phone: '[phone]',
    email: '[e-mail]',
    street: '123 Main St',
    city: 'Cityville',
    state: 'Stateland',
    country: 'US',
    zipCode: '12345'
);

$paytabs->setCustomer($customerDetails);

// Option 1: Use Customer Information for Shipping if it's the same
$paytabs->useCustomerForShipping();

// Option 2: Set Shipping Information separately if it's different
$shippingDetails = new CustomerDetails(
    name: 'Jane Doe',
    phone: '[phone]',
    email: '[e-mail]',
    street: '456 Market St',
    city: 'Townsville',
    state: 'Regionland',
    country: 'US',
    zipCode: '54321'
);

$paytabs->setShipping($shippingDetails);

// Set URLs and Language
$paytabs->setCallbackUrl('https://yourdomain.com/callback')
        ->setReturnUrl('https://yourdomain.com/return')
        ->setPaypageLang('en');

// Generate Payment Page
$response = $paytabs->paypage();

// Handle the response
dd($response);

Query Transaction

You can also query a transaction using its reference:

use GranadaPride\Paytabs\Paytabs;

$response = Paytabs::make()
    ->queryTransaction('TST2422201903602');

dd($response);

Troubleshooting

Common Issues

• Invalid Credentials: Ensure that your profile_id and server_key in the configuration file are correct.
• Unsupported Region: Double-check that the region in your configuration file is valid and supported by PayTabs.
• Transaction Failure: Verify the transaction data (e.g., cart amount, customer details) to ensure it meets PayTabs' requirements.

If you encounter other issues, refer to the PayTabs API Documentation for more details.

Testing

Soon...

Contribution

Contributions are welcome! If you’d like to contribute to this package, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Write your code and ensure it is well-documented.
4. Submit a pull request with a clear description of your changes.

License

This package is open-sourced software licensed under the MIT license.