Download the PHP package fadhila36/sumopod-pay-laravel without Composer

SumoPod Pay for Laravel

Unofficial Laravel SDK for the SumoPod Payment Gateway. This package provides a seamless integration with SumoPod, allowing you to create payments and handle secure webhooks directly within your Laravel application.

[!WARNING] Disclaimer: This package is an unofficial SDK created by a third party. It is not affiliated with, maintained, authorized, endorsed, or sponsored by SumoPod. All trademarks, service marks, and trade names of SumoPod used herein are the property of SumoPod.

Features

• 🚀 Laravel Native — Uses Laravel's HTTP Client, Facades, and config system.
• 🔌 Easy Installation — Built-in Artisan command to publish config and update your .env.
• 🔒 Secure Webhooks — Out-of-the-box middleware for Svix-style HMAC signature & token verification.
• ♻️ Automatic Retry — Exponential backoff for network issues and 5xx errors.
• 🎯 Strongly Typed — Written with strict types, DTOs, and full static analysis (Larastan Level 6).

Installation

You can install the package via composer:

After installing, run the interactive install command:

This command will:

1. Publish the config/sumopod-pay.php file to your app.
2. Automatically append the required SumoPod variables to your .env and .env.example files if they don't exist yet.

(Note: We provide an .env.example inside this package if you prefer to see the variables manually, but the install command handles adding them to your project automatically!)

Environment Variables

Make sure to fill in your API key in your .env file:

Usage

Creating a Payment

You can use the provided SumoPod Facade to interact with the API cleanly:

Webhooks

This package automatically registers a highly secure webhook endpoint at /sumopod/webhook (you can change this path in the config file).

The endpoint uses a dedicated middleware (VerifyWebhookSignature) to ensure the request genuinely came from SumoPod by computing the Svix-style HMAC signature or checking the Static Token.

Listening to Webhook Events

When a valid webhook is received, the package dispatches a standard Laravel event: Fadhila36\SumoPodPay\Events\SumoPodWebhookReceived.

To handle webhooks, simply create a listener for this event in your Laravel app:

Register your listener in your EventServiceProvider:

Checking API Connection

We provide a handy artisan command to verify your API key and connection to the SumoPod servers:

Testing

Security

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

License

The MIT License (MIT). Please see License File for more information.