### Installation

Source: https://github.com/devscast/maxicash-php/blob/main/README.md

You can use the PHP client by installing the Composer package and adding it to your application’s dependencies.

```bash
composer require devscast/maxicash
```

--------------------------------

### Authentication

Source: https://github.com/devscast/maxicash-php/blob/main/README.md

Initialize the Maxicash client with your merchant credentials and environment.

```php
use Devscast\Maxicash\Client as Maxicash;
use Devscast\Maxicash\Credential;
use Devscast\Maxicash\PaymentEntry;
use Devscast\Maxicash\Environment;

$maxicash = new Maxicash(
    credential: new Credential('marchand_id', 'marchand_password'),
    environment: Environment::SANDBOX // use `Environment::LIVE` for live
);
```

--------------------------------

### Create a Payment Entry

Source: https://github.com/devscast/maxicash-php/blob/main/README.md

Create a new payment entry with amount, reference, and callback URLs.

```php
$entry = new PaymentEntry(
    credential: $maxicash->credential,
    amount: intval(47.50 * 100), // amount in cents
    reference: "this text will be shown on maxicash payment page",
    acceptUrl: "your_website_accept_url",
    declineUrl: "your_website_decline_url",
);
```

--------------------------------

### Donate Button for NGOs

Source: https://github.com/devscast/maxicash-php/blob/main/README.md

Generate a donation URL for NGOs.

```php
$donationUrl = $maxicash->donationUrl()
```

--------------------------------

### Redirect to Maxicash Gateway

Source: https://github.com/devscast/maxicash-php/blob/main/README.md

Generate the URL to redirect the user to the Maxicash payment gateway.

```php
$url = $maxicash->queryStringURLPayment($entry);
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.