Download the PHP package yosefib/sadad-pgw without Composer

yosefIb/sadad-pgw

Laravel package for integrating with SADAD PGW (Payment Gateway)
This package simplifies the process of validating users, creating invoices, handling OTPs, and confirming payments using SADAD.

🚀 Features

• ✅ Validate customer identity and create invoice
• 🔐 Confirm payment using OTP
• 🔁 Resend OTP
• 📊 Check transaction status
• 🎯 Unified and formatted API responses

📦 Installation (Local Usage in Laravel)

1. Install the package in your Laravel project:

2. Edit your Laravel project’s composer.json and add:

3. Run:

4. Add environment variables in your .env:

5. Add this config file in config/sadad.php:

🧪 Usage Example

✅ Response Format

Success

Failure

🏦 Complete Payment Flow (Full Transaction Steps)

To complete a transaction using SADAD PGW:

1. Validate the Customer and Create Invoice

   • Call the validateCustomer method.
   • This sends an OTP to the customer's phone.
   • Also creates a pending transaction in SADAD.

2. Pay the Invoice with OTP

   • After the customer receives the OTP via SMS, use it to confirm payment.
   • You need the transactionId returned from validateCustomer.

3. Resend OTP (if needed)

   • If the customer did not receive the OTP, you can request to resend it.
4. Check Transaction Status (Optional)
   • To check if the transaction was successfully paid:

📋 Example Flow

• Step 1: validateCustomer ➔ OTP sent to user.
• Step 2: User receives OTP ➔ enters it.
• Step 3: payInvoice using OTP ➔ transaction completed.

✅ Done!

📄 License

MIT © 2025 Yosef Ibrahem Ali

🧾 Response Example for Completed Payment

After calling payInvoice, a successful response may look like:

On failure (e.g. invalid OTP):

🗂️ Service Categories

When creating an invoice via validateCustomer, you must pass a category ID.
Use one of the following:

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.