SDK PHP

Le SDK PHP de Digitalpaye est un SDK Laravel qui permet aux développeurs d'interagir avec l'API Digitalpaye de manière transparente depuis des applications PHP. Ce SDK simplifie le processus d'intégration et fournit des méthodes pour effectuer diverses opérations telles que la vérification des soldes, la création de demandes de collecte et l'initiation de transferts.

Installation

Vous pouvez installer le SDK PHP via Composer en exécutant la commande suivante :

composer require digitalpaye/digitalpaye-sdk-php:dev-version_1_0_1

Alternativement, vous pouvez télécharger le SDK directement depuis GitHub : Digitalpaye SDK PHP.

Démarrage

  • Get balance

<?php
require_once __DIR__ . '/../vendor/autoload.php';
use DigitalpayeSdkPhp\Services\Digitalpaye;

$apikey = "live_digitalpaye129923061";
$apisecret = "d511e1f4-d932-32fcd-a804-371539700d60c";
$config = new Digitalpaye($apikey, $apisecret);
//Get balance
$balance = $config->getBalance();
echo($balance["data"]["balance"]);
?>
  • Créer une transaction Orange Money

<?php
require_once __DIR__ . '/../vendor/autoload.php';
use DigitalpayeSdkPhp\Services\Digitalpaye;

$apikey = "live_digitalpaye129923061";
$apisecret = "d511e1f4-d932-32fcd-a804-371539700d60c";

$config = new Digitalpaye($apikey, $apisecret);
//Create Collecte Orange Money
$dataCreateCollecteOrangeMoney = array(
    "code_country" => "CI",
    "operator"=> "ORANGE_MONEY_CI",
    "currency"=> "XOF",
    "customer_id"=> "0777101308",
    "code_otp" => "5923",
    "amount"=> 310,
    "name_user"=> "GUEI HELIE",
    "transaction_id"=> "10180120"
);
$collecteOrangeMoney = $config->createPayment($dataCreateCollecteOrangeMoney);
if($collecteOrangeMoney["status"]=="PENDING"){
    echo("La transaction est en cours de confirmation");
}else if($collecteOrangeMoney["status"]=="SUCCESSFULL"){
 echo("La transaction a été traitée avec succès.");
}else{
    echo($collecteOrangeMoney["message"]);
}
?>
  • Créer une transaction Wave

<?php
require_once __DIR__ . '/../vendor/autoload.php';
use DigitalpayeSdkPhp\Services\Digitalpaye;

$apikey = "live_digitalpaye129923061";
$apisecret = "d511e1f4-d932-32fcd-a804-371539700d60c";

$config = new Digitalpaye($apikey, $apisecret);
//Create Collecte Wave
$dataCreateCollecteWave = array(
    "code_country" => "CI",
    "operator"=> "WAVE_CI",
    "currency"=> "XOF",
    "url_success" => "https://digitalpaye.com",
    "url_error" => "https://digitalpaye.com",
    "customer_id"=> "0777101308",
    "amount"=> 310,
    "name_user"=> "GUEI HELIE",
    "transaction_id"=> "10180120"
);
$collecteWave = $config->createPayment($dataCreateCollecteWave);
if($collecteWave["status"]=="PENDING"){
     header("Location: " . $collecteWave["data"]["wave_launch_url"]);
}else{
    echo($collecteWave["message"]);
}
?>
  • Créer une transaction MTN Money

<?php

require_once __DIR__ . '/../vendor/autoload.php';
use DigitalpayeSdkPhp\Services\Digitalpaye;

$apikey = "live_digitalpaye129923061";
$apisecret = "d511e1f4-d932-32fcd-a804-371539700d60c";

$config = new Digitalpaye($apikey, $apisecret);

//Create Collecte MTN Mobile Money
$dataCreateCollecteMTN= array(
    "code_country" => "CI",
    "operator"=> "MTN_MONEY_CI",
    "currency"=> "XOF",
    "customer_id"=> "0546573332",
    "amount"=> 310,
    "name_user"=> "GUEI HELIE",
    "transaction_id"=> "10180120"
);
$collecteMTN = $config->createPayment($dataCreateCollecteMTN);
if($collecteMTN["status"]=="PENDING"){
    echo("La transaction est en cours de confirmation");
}else if($collecteMTN["status"]=="FAILED"){
    echo("La transaction a échouée");
}else{
    echo($collecteMTN["message"]);
}
?>
  • Créer une transaction Par carte (Visa card, MasterCard)

<?php

require_once __DIR__ . '/../vendor/autoload.php';
use DigitalpayeSdkPhp\Services\Digitalpaye;

$apikey = "live_digitalpaye129923061";
$apisecret = "d511e1f4-d932-32fcd-a804-371539700d60c";

$config = new Digitalpaye($apikey, $apisecret);

//Create Collecte Card
$dataCreateCollecteCard= array(
    "code_country" => "CI",
    "currency"=> "XOF",
    "customer_id"=> "0546573332",
    "amount"=> 310,
    "email_user" => "elieguei225@gmial.com",
    "name_user"=> "GUEI HELIE",
    "transaction_id"=> "10180120",
    "redirect_url" => "https://digitalpaye.com"
);
$collecteCard = $config->createCollecteCard($dataCreateCollecteCard);
if($collecteCard["status"]=="PENDING"){
    header("Location: " . $collecteCard["data"]["urlPayment"]);
}else if($collecteCard["status"]=="FAILED"){
    echo("La transaction a échouée");
}else{
    echo($collecteCard["message"]);
}
?>
  • Obtenir le status d'une transaction

<?php

require_once __DIR__ . '/../vendor/autoload.php';
use DigitalpayeSdkPhp\Services\Digitalpaye;

$apikey = "live_digitalpaye129923061";
$apisecret = "d511e1f4-d932-32fcd-a804-371539700d60c";

$transactionId = "f511e4f4-d932-4fcd-a804-51539700d60c";
$config = new Digitalpaye($apikey, $apisecret);
//Get Status transaction
$getStatusTransaction = $config->getStatus($transactionId);
if($getStatusTransaction["code_status"]==202){
    echo("La transaction est en cours de validation");
}else if($getStatusTransaction["code_status"]==200){
    echo("La transaction a été validé");
}else{
    echo($getStatusTransaction["message"]);
}
?>
  • Obtenir toutes les transactions

<?php

require_once __DIR__ . '/../vendor/autoload.php';
use DigitalpayeSdkPhp\Services\Digitalpaye;

$apikey = "live_digitalpaye129923061";
$apisecret = "d511e1f4-d932-32fcd-a804-371539700d60c";

$config = new Digitalpaye($apikey, $apisecret);
//Get all transactions
$transactions = $config->getAllTransactions();
//Convertir en Json
$jsonTransactions = json_encode($transactions);
echo($jsonTransactions);
?>
  • Faire un transfert d'argent

<?php

require_once __DIR__ . '/../vendor/autoload.php';
use DigitalpayeSdkPhp\Services\Digitalpaye;

$apikey = "live_digitalpaye129923061";
$apisecret = "d511e1f4-d932-32fcd-a804-371539700d60c";

$config = new Digitalpaye($apikey, $apisecret);

///Create Transfert

$dataCreateTransfer = array(
    "code_country" => "CI",
    "currency"=> "XOF",
    "customer_id"=> "0777101308",
    "amount"=> 310,
    "name"=> "GUEI HELIE",
    "operator"=> "WAVE_CI",
    "transaction_id"=> "10180120"
);
$transfer = $config->createTransfert($dataCreateTransfer);
if($transfer["code_status"]=="SUCESSFUL"){
    echo("Le transfert a été validé");
}else if($transfer["code_status"]=="PENDING"){
    echo("Le transfert est en cours");
}else{
    echo("Le transfert a echoué");
}

?>

Gestions des erreurs

Code statusMessageDescription

400

FIELD_MISSING

Indique qu'un champ requis est manquant dans la requête.

401

TOKEN_EXPIRED

Signifie que le jeton d'authentification a expiré et doit être renouvelé.

403

ERROR

Erreur générale indiquant un problème d'accès ou d'autorisation.

406

DEVELOPER_NO_FOUND

Indique que le développeur spécifié n'a pas été trouvé.

407

COMPANY_NO_FOUND

Signale qu'aucune entreprise correspondante n'a été trouvée.

409

TRANSACTION_DUPLICATED

Indique qu'une transaction en double a été détectée.

410

OPERATOR_NO_SUPPORTED

Signifie que l'opérateur spécifié n'est pas pris en charge.

412

AMOUNT_INSUFFISANT

Indique que le montant de la transaction est insuffisant.

504

PAYMENT_FAILED_TRY_AGAINST

Indique que le paiement a échoué et qu'il faut réessayer.

506

COMPANY_NO_VERIFY

Signifie que l'entreprise n'a pas été vérifiée.

507

ACCOUNT_COMPANY_DISABLED

Indique que le compte de l'entreprise est désactivé.

200

SUCESSFUL

Succès de la requête.

201

CREATED

La ressource a été créée avec succès.

202

PAYMENT_IS_PENDING

Indique que le paiement est en attente.

500

ERROR_INTERNE_TRY_AGAIN

Erreur interne du serveur. Réessayez ultérieurement.

Dernière mise à jour