Laravel Paystack SDK

Laravel Paystack SDK is a Laravel-native package for working with Paystack through Saloon-backed requests and Actions-first services.

The package currently supports:

• transactions
• customers
• plans
• subscriptions
• Paystack webhook endpoints with persisted calls and queued processing

Why this package

• Actions-first usage for application service classes and controllers
• DTO-first inputs and action-specific response DTOs
• Saloon-backed HTTP integration with package-managed retries, timeouts, and API error handling
• Laravel-native service provider, manager, and facade access for outbound Paystack actions
• Endpoint-first webhook handling powered by spatie/laravel-webhook-client

Start here

• New project setup: Getting Started
• Install the package: Installation
• Configure credentials and transport behavior: Configuration
• Follow realistic Laravel workflows: Examples
• See supported features and current gaps: Support Matrix

Example workflows

The new examples area is a cookbook for application integrators. Start there if you want end-to-end flows instead of isolated API snippets.

• One-Time Checkout
• Verify a Transaction
• Webhook Processing

Feature guides

• Transactions: Transactions
• Customers: Customers
• Billing plans: Plans
• Subscriptions: Subscriptions
• Webhooks: Webhooks

Package model

The public API is centered on injectable action classes and typed DTOs:

Input DTO -> Action -> Action-specific response DTO

For convenience-oriented Laravel usage, the package also exposes PaystackManager and the Paystack facade with the same DTO-first style.

Because response DTOs extend spatie/laravel-data, you can also return them directly from Laravel routes and controllers when you want a built-in JSON response.

Response DTO timestamp fields such as transaction paidAt, subscription nextPaymentDate, and webhook occurredAt are exposed as CarbonImmutable in PHP and serialize to ISO-8601 strings in JSON responses.

Webhook intake is intentionally separate from the manager and facade. Incoming Paystack webhooks are received through Route::webhooks(...), stored, queued, and dispatched as package events.