# PHP Admin SDK

L'installation de la version PHP du SDK Admin requiert l'utilisation de la commande *composer* qui suit :

```
composer require kkiapay/kkiapay-php:dev-master
```

## Initialisation

L'utilisation du SDK Admin serveur requiert de procéder à l'instanciation d'un objet *kkiapay.* Il vous faudra afin de procéder à cette opération non seulement récupérer vos clés d'API, mais également user des lignes de code ci-après que vous soyez en mode [Sandbox](https://docs.kkiapay.me/v1/compte/kkiapay-sandbox-guide-de-test) ou en production.

* En Sandbox

```php
$kkiapay = new \Kkiapay\Kkiapay($public_key,
                                $private_key, 
                                $secret, 
                                $sandbox = true);
```

{% hint style="info" %}
La valeur ***true*** de l'attribut `$sandbox` vous permet de passer en mode test.
{% endhint %}

* En Production

```php
$kkiapay = new \Kkiapay\Kkiapay($public_key,
                                $private_key, 
                                $secret);
```

## Statut d'une transaction

Il vous est offert, avec le SDK Admin Serveur, la possibilité de récupérer l’ensemble des informations liées à une transaction, en utilisant la référence de l’opération ayant été effectuée. Il vous faudra pour cela fournir les informations suivantes :

* Vos clés publique, privée et secrète d'API
* La référence de l’opération (voir l’image ci-dessous)

![](https://3656574980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LX3NlYdn5V7BnDqQm92%2F-LhkBRrLK51AmF-c6Vc2%2F-LhkBg3LnqA8lHNZqn1i%2FGroup%206.png?alt=media\&token=7e8f9cfa-42bc-4594-a435-63b23f6fb757)

### Exemple d'utilisation

Vous pouvez afin de tester cette fonctionnalité, user du code ci-après :

```php
$kkiapay->verifyTransaction($transaction_id)

//response
Array(
    [performed_at] => 2025-04-10T15:01:49.499Z
    [type] => DEBIT
    [status] => SUCCESS
    [source] => MOBILE_MONEY
    [source_common_name] => mtn-benin
    [amount] => 40
    [fees] => 1
    [reason] => payment
    [failureCode] => 
    [failureMessage] => 
    [state] => null
    [partnerId] => 
    [feeSupportedBy] => customer
    [income] => 40
    [transactionId] => 0845058258857440
    [performedAt] => 10/04/2025
    [client] => Array
        (
            [fullname] => John Doe
            [phone] => 22997000000
            [email] => john.doe@gmail.com
        )
)
```

## **Remboursement d'une transaction**

Toute transaction effectuée par mobile money et portant la mention "**Succès**" peur faire l'objet d'une opération de remboursement. En effet, il vous est offert la possibilité de procéder à un remboursement si votre client n’a pas obtenu satisfaction pour le bien ou service pour lequel il a payé ou si vous le jugez nécessaire. Il vous faudra afin de procéder à une telle opération, fournir les informations ci-après :

* Vos clés publique, privée et secrète d'API
* La référence de l’opération (voir l’image ci-dessous)

![](https://3656574980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LX3NlYdn5V7BnDqQm92%2F-LhkBRrLK51AmF-c6Vc2%2F-LhkBg3LnqA8lHNZqn1i%2FGroup%206.png?alt=media\&token=7e8f9cfa-42bc-4594-a435-63b23f6fb757)

{% hint style="info" %}
Le remboursement d'une transaction n'inclut point celui des frais de transaction qui lui sont liés.
{% endhint %}

### Exemple d'utilisation

Vous pouvez afin de tester cette fonctionnalité user du code ci-après :

```php
$kkiapay->refundTransaction($transaction_id);
```