PAYDUNYA Client PHP

https://paydunya.com/developers/php

Inclure la librairie PHP PAYDUNYA

require 'paydunya/paydunya.php'

Vous pouvez créer un fichier de configuration globale contenant les paramètres suivants et l'inclure par la suite dans chacun de vos fichiers. Penser premièrement à inclure le client PHP de PAYDUNYA au niveau de votre fichier de configuration globale.

Paydunya_Setup::setMasterKey(VOTRE_CLE_PRINCIPALE);
Paydunya_Setup::setPublicKey(VOTRE_CLE_PUBLIQUE);
Paydunya_Setup::setPrivateKey(VOTRE_CLE_PRIVEE);
Paydunya_Setup::setMode(["test"|"live"]);
Paydunya_Setup::setToken(VOTRE_TOKEN);

Paydunya_Checkout_Store::setName("Magasin Chez Sandra"); // Seul le nom est requis
Paydunya_Checkout_Store::setTagline("L'élégance n'a pas de prix");
Paydunya_Checkout_Store::setPhoneNumber("336530583");
Paydunya_Checkout_Store::setPostalAddress("Dakar Plateau - Etablissement kheweul");
Paydunya_Checkout_Store::setWebsiteUrl("http://www.chez-sandra.sn");
Paydunya_Checkout_Store::setLogoUrl("http://www.chez-sandra.sn/logo.png");

Vous pouvez optionnellement définir une URL à laquelle seront redirigés vos clients après une annulation de commande.

// Configuration globale de l'URL de redirection après annulation de paiement.
Paydunya_Checkout_Store::setCancelUrl(URL_DE_REDIRECTION_APRES_ANNULATION);

PAYDUNYA redirigera automatiquement le client à cette adresse URL après un paiement fructueux. Cette configuration est facultative et il fortement recommandé de ne pas s'en servir, à moins que vous voulez personnaliser l'expérience de paiement de vos clients. Si cette URL de redirection n'est pas définie, PAYDUNYA redirigera le client vers une page affichant son reçu électronique.

// Configuration globale de l'URL de redirection après confirmation de paiement.
Paydunya_Checkout_Store::setReturnUrl(URL_DE_REDIRECTION_APRES_SUCCES);

$co = new Paydunya_Checkout_Invoice();

co = new Paydunya_Onsite_Invoice();

Les paramètres attendus sont nom du produit, la quantité, le prix unitaire, le prix total et une description optionelle. addItem(nom_du_produit, quantité, prix_unitaire, prix_total, description_optionelle)

$co->addItem("Clavier DELL", 2, 3000, 6000);
$co->addItem("Ordinateur Lenovo L440", 1, 400000, 400000, "Réduction de 10%");
$co->addItem("Casque Logitech", 1, 8000, 8000);

PAYDUNYA s'attend à ce que vous préciser un montant total de facture. Ce sera ce montant qui sera facturé à votre client. Nous considérons que vous auriez déjà fait tous les calculs au niveau de votre serveur avant de fixer ce montant.

NOTE: PAYDUNYA n'effectuera pas de calculs au niveau de ses serveurs. Le montant total de la facture fixé à partir de votre serveur sera celui que PAYDUNYA utilisera pour facturer votre client.

$co->setTotalAmount(6500);

Vous pouvez de manière optionelle définir une description générale de facture qui sera utilisée dans les cas où la facture n'a pas besoin d'une liste des éléments ou dans les cas où vous avez besoin d'inclure des informations supplémentaires à votre facture

$co->setDescription("Description Optionnelle");

Vous pouvez représenter l'ajout d'informations de taxes au niveau de la page de paiement. Ces informations seront ensuite affichées sur la facture, le reçu électronique, le reçu imprimé et les téléchargements PDF.

$co->addTax('TVA (18%)', 5000);
$co->addTax('Autre taxe', 700);

Si vous avez besoin d'ajouter des données supplémentaires à vos informations de requête de paiement à des fins d'utilisation ultérieure, nous vous offrons la possibilité de sauvegarder des données personnalisées sur nos serveurs et de les récupérer une fois le paiement réussi.

NOTE: Les données personnalisées ne sont affichées nulle part sur la page de paiement, les factures/reçus, les téléchargements et impressions.

$co->addCustomData("Prénom", "Badara");
$co->addCustomData("Nom", "Alioune");
$co->addCustomData("CartId", 97628);
$co->addCustomData("Coupon","NOEL");

Après avoir rajouté des articles à votre facture et configurer le montant total de la facture, vous pouvez rediriger votre client vers la page de paiement en appelant la méthode create depuis votre objet facture ($co). Veuillez s'il vous plaît noter que la méthode "$co->create()" retourne un booléen (true ou false) selon le fait que la facture ait été créée avec succès ou non. Cela vous permet de mettre une instruction if - else et gérer le résultat comme bon vous semble.

// Le code suivant décrit comment créer une facture de paiement au niveau de nos serveurs,
// rediriger ensuite le client vers la page de paiement
// et afficher ensuite son reçu de paiement en cas de succès.
if($co->create()) {
   header("Location: ".$co->getInvoiceUrl());
}else{
  echo $co->response_text;
}

La première étape consiste à récupérer l'adresse email ou le numéro de téléphone du client PAYDUNYA. Passer le ensuite en paramètre la méthode create d'une instance de la classe Paydunya_Onsite_Invoice. PAYDUNYA vous renverra un token PSR. Le client PAYDUNYA recevra également un code de confirmation par e-mail et SMS (uniquement pour les transactions réelles).

    if($co->create("EMAIL_OU_NUMERO_DU_CLIENT_PAYDUNYA")) {
       $opr_token = $co->token;
    }else{
      echo $co->response_text;
    }

La seconde étape nécessite que vous récupérer le code de confirmation envoyé au client, y ajouter votre token PSR pour ensuite facturer réellement le client. En cas de succès de paiement, vous devriez être en mesure d'accéder à l'URL du reçu électronique et d'autres informations listées au niveau de la documentation officielle.

if($co->charge("TOKEN_PSR", "CODE_DE_CONFIRMATION_DU_CLIENT")){
    $receipt = $co->receipt_url;
    $customer_name = $co->customer["name"];
}else{
    echo $co->response_text;
}

Cette option s'avère très intéressante si vous souhaitez créer votre propre solution de paiement par dessus celle de PAYDUNYA ou si vous devez reverser un certain pourcentage à chaque vente. L'argent est reçu sur les comptes destinataires et le service n'est pas facturé.

Vous pouvez transférer des fonds vers d'autres comptes clients PAYDUNYA à partir de votre compte via l'API de Transfert Automatique (TFA). Pour des raisons de sécurité, vous devez explicitement activer l'option de Transfert Automatique (TFA) dans la configuration de votre intégration. Vous pouvez toujours activer ou désactiver le Transfert Automatique (TFA) en mettant à jour la configuration de votre intégration.

$direct_pay = new Paydunya_DirectPay();
if ($direct_pay->creditAccount("EMAIL_OU_NUMERO_MOBILE_DU_CLIENT_PAYDUNYA", MONTANT_A_TRANSFERER)) {
  echo $direct_pay->description."\n";
  echo $direct_pay->response_text."\n";
  echo $direct_pay->transaction_id."\n";
}else{
  echo $direct_pay->response_text."\n";
}

https://github.com/paydunya/paydunya-php-demo-store

1. Faire un Fork de ce dépôt
2. Créer une nouvelle branche (git checkout -b new-feature)
3. Faire un commit de vos modifications (git commit -am "Ajout d'une nouvelle fonctionnalité")
4. Faire un Push au niveau de la branche (git push origin new-feature)
5. Créer un Pull Request