Gérez vous de l'argent pour le compte de tiers ?

Créer des Wallets  

const walletPromise = 
    fPay.wallet.create({
        name: "Magasin Yopougon"
    });
const walletPromise = 
    fPay.wallet.create({
        name: "Magasin Cocody"
    });
const walletPromise = 
    fPay.wallet.create({
        name: "Magasin San-Pedro"
    });

const walletPromise = 
    fPay.wallet.create({
        name: "Compte Entreprise #1"
    });
const walletPromise = 
    fPay.wallet.create({
        name: "Compte Entreprise #2"
    });
const walletPromise = 
    fPay.wallet.create({
        name: "Compte Entreprise #3"
    });

Entrée d'argent sur un Wallet  

Destination  

Lors de toute entrée d'argent sur votre compte, les fonds recupérés seront déposés sur votre  Wallet  principal par défaut. Parce qu'il vous est possible de créer plusieurs  Wallet  additionnels, il vous est également possible choisir la destination des fonds une fois que l'utilisateur aura payé.
Ainsi, vous pouvez posséder un  Wallet  pour votre épargne ou bien un  Wallet  par magasin si vous avez plusieurs magasins et choisir où iront les fonds reçus.

Comment ça marche ?

Pour spécifier la destination des fonds, il vous faut le MARS du  Wallet , accessible via le champ mars.alpha
Par exemple si le MARS du Wallet  est "CI FPay W09POT", alors vous devriez entrer le code suivant :

const depositPromise = 
    fPay.deposit.initiate({
        destination: "CI FPay W09POT",
        source: {
            _type: "Single",
            account: {
                country: "CI",
                identifier: "+2250100000000",
                providerKey: "MoovMoney"
            }
        },
        amount: {
            currency: "XOF",
            value: "10_000"
        }
    });

Transférer de l'argent entre Wallets  

Vous avez la possibilité d'éffectuer des mouvements entre tout Wallet que vous possédez. Ainsi, vous pouvez retirer de l'argent de votre Wallet pour le déposer sur celui de votre utilisateur et inversement. Ces mouvements de comptes peuvent même correspondre à des utilisateurs que vous avez qui se payent entre eux.
Aussi, si dans le cadre de votre activité, vous êtes amené à recevoir des cautions de la part de vos utilisateurs, vous pouvez stocker cette caution sur leurs Wallet respectifs. Plus tard, vous pouvez déduire de cette caution les montants correspondant à des infractions qu'ils ont eu à faire en effectuant un Transfer vers votre Wallet ou bien, si aucune infraction n'a été commise, vous pouvez initier un remboursement vers leurs portefeuille mobile money directement depuis leurs Wallet : Les possibilités sont infinies et votre choix dépendra de votre activité.

Comment ça marche ?

Imaginons que vous possédez un Wallet dont le MARS est "CI FPay MPO099R" et un autre Wallet  dont dont le MARS est  "CI FPay MOY67RT". Pour transférer de l'argent du premier Wallet vers le second, vous devez faire le code suivant:

const transferPromise = 
    fPay.transfer.initiate({
        amount: "10_000 XOF",
        source: "CI FPay MPO099R",
        destination: "CI FPay MOY67RT"
    });

Sortie d'argent depuis un Wallet  

Lors de toute sortie d'argent, les fonds envoyés seront prélevés sur votre  Wallet  principal par défaut. Si la sortie d'argent se fait pour un client spécifique, parce que vous avez la possibilité d'indiquer à FPay le  Wallet  à partir duquel l'argent doit être prelevé pour cette sortie d'argent, vous pouvez spécifier le Wallet du client concerné par cette sortie d'argent, peu importe si cette sortie d'argent est faite via un objet Transfer ou un objet QuasiTransfer.

Comment ça marche ?

Pour spécifier la source des fonds, il vous faut le MARS du  Wallet , accessible via le champ mars.alpha
Par exemple si le MARS du Wallet  est "CI FPay W09POT", alors vous devriez entrer le code suivant :

const transferPromise = 
    fPay.transfer.initiate({
        amount: {
            currency: "XOF",
            value: "10_000"
        },
        source: "CI FPay W09POT",
        destination: {
            _type: "Single",
            account: {
                country: "CI",
                identifier: "+2250100000000",
                providerKey: "MoovMoney"
            }
        }
    });

const quasiTransferPromise = 
    fPay.quasiTransfer.initiate({
        amount: {
            currency: "XOF",
            value: "10_000"
        },
        source: "CI FPay W09POT"
    });

Établir un relevé des Transactions  

Supposons que nous sommes le 27 Octobre (27/10) et que nous souhaiterions établir pour un client un relevé des Transaction survenues sur son Wallet depuis le 1er du mois jusqu'à ce jour.
Le résultat pourrait se presenter comme sur la figure suivante :

Nous allons voir comment construire ce tableau précédent pour chacun de vos clients

Un mot sur l'objet Transaction

Chaque fois qu'un changement intervient sur le solde d'un Wallet, un objet Transaction est créé pour matérialiser ce mouvement d'argent. Que ce changement de solde soit du à un Transfer, à un Deposit ou à tout autre objet, un objet Transaction sera créé.
Ainsi, pour réaliser le tableau précédent, voici les champs de l'objet Transaction qui vont nous être utile:

•   amount
  Ayant une valeur toujours positive, ce champ représente le montant qui a été ajouté ou retiré du Wallet considéré.
•   dc
  Abbréviation pour debit ou credit, ce champ indique si le montant précédent à été ajouté ou retiré du Wallet considéré.
  Les 2 valeurs possibles de ce champ sont "Debit" ou "Credit".
  Si la valeur est "Debit", alors le montant qui est toujours positif a été retiré du Wallet.
  Si la valeur est "Credit", alors le montant qui est toujours positif a été ajouté au Wallet.
•   wallet
  Ce champ est un indicateur de l'état du Wallet cible sur lequel la Transaction à eu lieu. C'est notamment avec ce champ qu'il sera possible d'accéder au solde avant ainsi qu'au solde après la Transaction.
•   status
  Ce champ indique si la transaction à réussie ou échouée. Les 2 valeurs possibles de ce champ sont Successful ou Failure.
  Veuillez noter qu'il ne s'agit pas de string, ce sont des objets. Par exemple l'objet Failure possède un champ isCancelled qui permet de savoir si la transaction a échoué parce qu'elle a été annulée.
•   parent
  Ce champ indique l'objet parent dont l'exécution a entrainé la création de cette Transaction. Ce parent peut donc être un objet Transfer, Deposit, QuasiTransfer etc...
•   details
  Ce champ, si il est disponible, permettra d'accéder à l'id de la transaction généré par l'opérateur si cette transaction concerne une opération entre FPay et l'extérieur (Mtn Money, Orange Money ou Moov Money).
  

Implémentation

Maintenant que le décor est planté, nous allons :

• Lister toutes les Transaction réussies durant le mois en cours pour le Wallet de l'utilisateur concerné. Supposons que le Wallet de l'utilisateur considéré possède comme id la valeur   123456789.
• Extraire pour chaque Transaction les informations requises pour construire le tableau.

Lister toutes les Transaction réussies durant le mois en cours

const transactionsCollectionPromise = 
    fPay.transaction.list({
        filter: "status = 'Successful'"
                + " AND createdTime in CurrentMonth"
                + " AND wallet.id = '123456789'",
        sortBy: "createdTime:ASC"
    });

//  Access items in the returned collection, page per page
let transactionsCollection = await transactionsCollectionPromise;
let allTransactions = transactionsCollection.toArray();
while(transactionsCollection.hasNextPage()){
    transactionsCollection = 
        await fPay.transaction.fetchPage(transactionsCollection.pagination.nextPage);
    const transactions = transactionsCollection.toArray();
    allTransactions = allTransactions.concat(transactions);
}

Extraire pour chaque Transaction les informations requises pour construire le tableau

let debitTransactionsAmount = [];
let creditTransactionsAmount= [];
for (const transaction of allTransactions) {
    const date = new Date(transaction.createdTime.iso8601); 
    const dayOfMonth = date.getDate(); 
    const month = date.getMonth(); 
    const details = transaction.h1.fr; 
    const beforeBalance = transaction.wallet.before.balance.available; 
    const afterBalance = transaction.wallet.after.balance.available; 
    let debitAmount = null;
    if(transaction.dc.isDebit()){
        // amount is always positive so we have to negate the value for debit 
        debitAmount = -transaction.amount.value;
        debitTransactionsAmount.push(debitAmount); 
    }
    let creditAmount = null;
    if(transaction.dc.isCredit()){
        creditAmount = transaction.amount.value; 
        creditTransactionsAmount.push(creditAmount); 
    }
    
    // Here we have extracted the most of required values, you can
    // do the stuff with them inside the loop
}
const firstTransaction: Transaction = allTransactions[0];
const lastTransaction: Transaction  = allTransactions[allTransactions.length-1];

// Finally the values for summary 
const initialBalance = firstTransaction.wallet.before.balance.available
const endBalance = lastTransaction.wallet.after.balance.available
const totalDebits = debitTransactionsAmount.reduce((sum, el) => sum + el, 0);
const totalCredits = creditTransactionsAmount.reduce((sum, el) => sum + el, 0);

// Congratulation 🎉🥳👏
// At this point, you can create a beautiful PDF or HTML Table for your user 🥂👏🍾