nascent-africa / orange-money-burkina-sdk

SDK non officiel de l'API de base de Orange Money Burkina afin de faciliter son usage et son intégration par les développeurs dans des projets PHP.

sdk orange-money-burkina

SDK non officiel de l'API de base de Orange Money Burkina afin de faciliter son usage et son intégration par les développeurs dans des projets PHP.

Installation via composer

composer require faso-dev/orange-money-burkina-sdk v1.alpha

Cas d'utilisation

    use Fasodev\Exceptions\PaymentSDKException;
    use Fasodev\Sdk\PaymentSDK;
    use \Fasodev\Sdk\OrangeMoneyAPI;

    require_once __DIR__ . '/../vendor/autoload.php';
    
    try {
        $orangeMoneyAPI = new OrangeMoneyAPI(
            'username',
            'password',
            'merchant_number'
        );
    
        $orangeMoneyAPI->setAmount(1000) // Montant de la transaction
            ->setOTPCode(121212) // Code otp fourni par l'utilisateur
            ->setClientNumber(76819212); // Le numero de client
            
        // Not calling this method will cause the process to default to a test url.
        // And the other hand, calling this method and not pass a parameter will
        // cause the process to default to the production url as provided by Orange Money
        // as of the time of this update.
        // If you need to modify the url to make the api request to a custom endpoint,
        // you can always provide one as a parameter like so:
        // "$orangeMoneyAPI->setUrl('https://custom.orange.bf:9007/payment');"
        $orangeMoneyAPI->setUrl();
    
        $sdk = new PaymentSDK($orangeMoneyAPI);
    
        $result = $sdk->handlePayment(); //Enclenchement du processus de paiement
    
        echo "paiement effectué";
        echo $result->transID;
    
    } catch (PaymentSDKException $exception) {
        echo "Whoops! Unable to process payment. <br /> Error message returned by request: {$exception->getMessage()}. <br /> Error code returned by request: {$exception->getCode()}";
    }

Testing

Exécutez les tests avec:

vendor/bin/phpunit

ou

composer tests

Vous pouvez également exécuter l'exemple de code en procédant comme suit à partir du terminal de commande:

php -S localhost:8000 -t Examples/

N'oubliez pas de faire une copie du fichier .env.exampe et renommez-le en .env, puis définissez les variables à utiliser pour exécuter la requête comme ceci:

APP_ENV=local
ORANGE_MONEY_USERNAME='johndoe'
ORANGE_MONEY_PASSWORD='password'
ORANGE_MONEY_MERCHANT_ID='123456789'

...puis visitez http://localhost:8000/example.php ou http://localhost:8000/example2.php depuis votre navigateur.

Authors

• https://github.com/faso-dev
• https://github.com/yenteck

Merci de contribuer !