Download the PHP package gosuccess/digistore24-api without Composer

Digistore24 API Client for PHP

Modern, type-safe PHP API client for Digistore24 with PHP 8.4 property hooks and clean architecture.

Features

• ✨ PHP 8.4 Property Hooks - Automatic validation on property assignment
• 🎯 Type-Safe - Full type hints, enums, and generics throughout
• 🏗️ Clean Architecture - Resource-based design with separation of concerns
• 🔄 Automatic Retry - Built-in exponential backoff for failed requests
• 🚦 Rate Limiting - Handles API rate limits gracefully
• 📝 Fully Documented - Comprehensive PHPDoc with examples
• 🧪 Exception Handling - Typed exceptions for different error scenarios
• ✅ 122 Endpoints - Complete coverage of Digistore24 API
• 🎉 Optional Request Parameters - Clean API calls without explicit Request objects

Requirements

• PHP 8.4.0 or higher (for property hooks support)
• cURL extension
• mbstring extension

Installation

Quick Start

Architecture

This wrapper uses a resource-based architecture with typed requests and responses:

Directory Structure

Naming Conventions

Directories:

• ✅ Singular form: Exception/, Request/, Response/
• ❌ NOT plural: Exceptions/, Requests/, Responses/

Classes:

• Abstract classes: AbstractRequest, AbstractResponse → in Base/
• Interfaces: RequestInterface, ResponseInterface → in Contract/
• DTOs: BuyerData, PaymentPlanData → in DTO/
• Exceptions: ApiException, NotFoundException → in Exception/
• Enums: HttpMethod, StatusCode → in Enum/
• Helper classes: AccountAccessEntry, EticketDetail → in Response/*/

Namespaces:

Architecture Decisions

1. Singular directories - More consistent with PSR standards
2. Property hooks - Eliminate constructors where possible
3. final classes - Not readonly (allow mutation)
4. Typed constants - Enums instead of magic values
5. String interpolation - "{$var}" instead of concatenation
6. Single class per file - Helper classes in separate files
7. Use imports - Never use fully-qualified class names (FQCN)
8. Dedicated Enum directory - HttpMethod, StatusCode in Enum/

PHP 8.4 Property Hooks

Property hooks provide automatic validation without constructors:

Benefits:

• ✅ No boilerplate constructors
• ✅ Automatic validation on assignment
• ✅ Mutable properties (read AND write)
• ✅ Clean, maintainable code

Usage:

Examples

Simple API Calls (No Request Object Needed)

Many methods with all-optional parameters can now be called without creating a Request object:

Advanced API Calls (With Request Objects for Filters)

When you need filters or custom parameters, use Request objects:

Create Buy URL with Payment Plan

Add Tracking Parameters

Error Handling

Performance

Benchmarks

Performance tests conducted on PHP 8.4.12 with 16GB RAM:

Key Performance Features:

• ✅ Zero-copy property hooks - No constructor overhead
• ✅ Lazy loading - Resources instantiated on demand
• ✅ Memory efficient - ~2MB per request average
• ✅ Fast validation - Inline property hook checks

Rate Limiting & Retry Logic

The client automatically handles Digistore24 API rate limits with exponential backoff:

Retry Strategy:

• 1st retry: Wait 1 second
• 2nd retry: Wait 2 seconds (exponential)
• 3rd retry: Wait 4 seconds (exponential)
• After 3 attempts: Throw RateLimitException

Status codes with automatic retry:

• 429 Too Many Requests - Rate limit hit
• 500 Internal Server Error - Server error
• 502 Bad Gateway - Temporary unavailability
• 503 Service Unavailable - Service down
• 504 Gateway Timeout - Request timeout

Status codes WITHOUT retry:

• 400 Bad Request - Invalid parameters
• 401 Unauthorized - Invalid API key
• 403 Forbidden - Insufficient permissions
• 404 Not Found - Resource not found

Manual Rate Limit Handling

For fine-grained control, you can implement custom retry logic:

Available Resources

API Endpoints Documentation

Affiliate Management

Billing & Invoicing

Buy URL Management

Buyer Management

Country & Currency

Delivery Management

E-Tickets

Forms & Custom Data

Images

IPN/Webhook Management

License Keys

Marketplace

Member Access

Monitoring

Order Forms

Payment Plans

Payouts & Commissions

Product Groups

Product Management

Purchase Management

Rebilling/Subscriptions

Service Proof

Shipping

Statistics

Tracking & Conversion

Transactions

Upgrades

Upsells

User/API Key Management

Vouchers/Coupons

Migration

Upgrading from gosuccess/php-ds24-api-wrapper? See MIGRATION.md for detailed instructions on namespace changes, constructor updates, and breaking changes.

Testing

The project has comprehensive test coverage with over 1035 tests.

Quality Metrics:

• Tests: 1213 tests, 3462 assertions
• PHPStan: Level 9 (maximum strictness)

See TESTING.md for detailed testing guide, coverage setup, mutation testing, and best practices.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Development

This library is maintained primarily for GoSuccess's own use. You're welcome to use it, but it isn't run as a community project. To work on it locally:

See DEVELOPER_SETUP.md for detailed IDE setup instructions.

Support

• Documentation: Check the docs/ directory for endpoint-specific guides
• Testing Guide: See TESTING.md for test setup and coverage
• Issues: Report bugs on GitHub Issues
• Migration Guide: See MIGRATION.md for upgrading from v2.x
• Changelog: See CHANGELOG.md for version history