Matérialisant une demande de fonds, un encaissement, cet objet contient un lien d'encaissement ainsi qu'un QRCode qu'il est possible de scanner juste en utilisant l'appareil photo d'un smartphone. Une fois créé, vous pouvez accéder au lien d'encaissement par le champ securePay.link et vous pourrez accéder à l'url pointant vers l'image du QRCode avec le champ securePay.qrCode.src
Vous pouvez contrôler le message affiché à l'utilisateur en soumettant une valeur pour le champ h1 lors de la création de l'objet FundRequest. Si vous ajoutez 2 langues, l'utilisateur pourra changer de langue et voir le message l'invitant à payer dans sa langue native.
Une fois que vous transmettrez ce lien à votre utilisateur, ou que vous lui présenterez le QRCode, celui ci arrivera sur une page l'invitant à payer comme illustré sur la figure suivante :
cancel Annule puis Retourne un objet FundRequest identifié par un identifiant.
Vous avez la possibilité d'utiliser un ID unique propre à votre système. Pour utiliser votre propre ID au lieu de celui généré par FPay, vous devez préciser le champ foreignId lors de la création de cet objet. Ainsi, vous pourrez récupérer cet objet par le champ foreignId ainsi ajouté qui doit être unique pour tous les objets de type FundRequest. Voici tous les champs dont les valeurs peuvent servir d'identifiant pour cette opération:
idforeignIdFundRequest déja annulé, qui a réussi ou qui a échoué.const fundRequestPromise = fPay.fundRequest.cancel("identifier");create Créer un nouvel objet FundRequest et retourne l'objet nouvellement créé.
Cette opération prend en entrée les paramètres suivants:
CreateFundRequestFormamountAmountFormcurrencystringvaluestringdescriptionstring | undefineddestinationDestinationForm | undefinedDestinationForm.MultipleDestinationFormMultipleDestinationFormDestinationForm.SingleDestinationFormSingleDestinationFormaccountMoneyAccountFormcountrystringidentifierstringid du Wallet, du portefeuille FPayproviderKeystringexpirestring | undefined<after><space><$number><$timeUnit><on><space><$iso8601Datetime>neverFundRequest, La valeur never est la valeur par defaut si aucune valeur n'est précisée.QuasiTransfer, La valeur 24h est la valeur par defaut si aucune valeur n'est précisée."after 15m""after 90s""after 1h""after 2d""after 1w""on 2028-05-19T01:13Z""on 2028-05-19""on 15:30"feesFeesForm | undefinedpayerstringforeignDatastring | undefinedforeignIdstring | undefinedh1H1DescriptorForm | undefinedenstring | undefinedfrstring | undefinedonFailureOnFundRequestCompletedForm | undefinedredirectUserTostring | undefinedonSuccessOnFundRequestCompletedForm | undefinedredirectUserTostring | undefinedVoici un exemple de code pour éffectuer une création d'un objet FundRequest:
const fundRequestPromise =
fPay.fundRequest.create({
amount: {
currency: "XOF",
value: "10_000"
},
description: "My description",
destination: {
_type: "Single",
account: {
country: "CI",
identifier: "123456789",
providerKey: "FPay"
}
},
expire: "after 12h",
fees: {
payer: "CounterPart"
},
foreignData: "{\"myKey\": 19, \"myOtherKey\": \"myOtherValue\"}",
foreignId: "123456789",
h1: {
en: "Payment description",
fr: "Description du paiement"
},
onFailure: {
redirectUserTo: "https://you-server.com/ui/failure"
},
onSuccess: {
redirectUserTo: "https://you-server.com/ui/success"
}
});get Retourne un objet FundRequest identifié par un identifiant.
Vous avez la possibilité d'utiliser un ID unique propre à votre système. Pour utiliser votre propre ID au lieu de celui généré par FPay, vous devez préciser le champ foreignId lors de la création de cet objet. Ainsi, vous pourrez récupérer cet objet par le champ foreignId ainsi ajouté qui doit être unique pour tous les objets de type FundRequest. Voici tous les champs dont les valeurs peuvent servir d'identifiant pour cette opération:
idforeignIdconst fundRequestPromise = fPay.fundRequest.get("identifier");list Retourne une collection d'objets FundRequest éventuellement filtrée et/ou triée. Voici les paramètres supportés par cette opération.
| NOM | TYPE | DESCRIPTION | VALEUR PAR DÉFAUT |
|---|---|---|---|
filter | string | undefined | Condition que doit respecter tout objet qui sera retourné dans cette collection | |
sortBy | string | undefined | Spécification du champ ainsi que de l'ordre (ascendant ou descendant) par lesquels seront triés les objets retournés | |
limit | number | undefined | Nombre total de résultats à retourner dans cette collection | |
Voici quelques exemples de code pour éffectuer un listing afin de retourner une collection d'objets FundRequest:
const fundRequestsCollectionPromise = fPay.fundRequest.listAll();const fundRequestsCollectionPromise =
fPay.fundRequest.list({
sortBy: "id:ASC"
});const fundRequestsCollectionPromise =
fPay.fundRequest.list({
limit: 5
});const fundRequestsCollectionPromise =
fPay.fundRequest.list({
filter: "id in {'31234', '5678', '9990'}"
});const fundRequestsCollectionPromise =
fPay.fundRequest.list({
filter: "createdTime isBefore Yesterday",
sortBy: "foreignId:DESC"
});const fundRequestsCollectionPromise =
fPay.fundRequest.list({
filter: "id startsWith abcd",
sortBy: "createdTime:ASC",
limit: 25
});fetchPage Lorsque vous récupérez une liste de FundRequest, les résultats retournés par le serveur peuvent être paginés c'est dire que ces résultats seront disposés sur plusieurs pages. Cette fonction fetchPage permet de naviguer de page en page afin d'itérer sur tous les éléments. Par conséquent cette fonction retourne une collection de FundRequest.
Imaginons que vous ayez récupéré une collection de FundRequestavec le code suivant:
const fundRequestsCollectionPromise = fPay.fundRequest.listAll();Si jamais le resultat est disposé sur plusieurs pages, pour consulter la page suivante, vous devez faire:
fundRequestsCollectionPromise.then(fundRequestCollection => {
if(fundRequestCollection.hasNextPage()) {
const nextFundRequestPromise = fPay.fundRequest.fetchPage(fundRequestCollection.pagination.nextPage);
}
});send Envoie des fonds à une demande de fonds identifiée par un identifiant et retourne un Attempt symbolisant une tentative d'envoi de fonds vers FPay.
Voici tous les champs dont les valeurs peuvent servir d'identifiant pour cette opération:
idforeignIdSendFundRequestFormidstringsourceSourceFormSourceForm.MultipleSourceFormMultipleSourceFormSourceForm.SingleSourceFormSingleSourceFormaccountMoneyAccountFormcountrystringidentifierstringproviderKeystringVoici un exemple de code pour éffectuer un envoi avec un objet FundRequest:
const attemptPromise =
fPay.fundRequest.send({
id: "123456789",
source: {
_type: "Single",
account: {
country: "CI",
identifier: "+2250500000000",
providerKey: "MtnMoney"
}
}
});update Modifie un objet FundRequest et retourne la version modifiée de celui ci.
Voici tous les champs dont les valeurs peuvent servir d'identifiant pour cette opération:
idforeignIdFundRequest:| NOM | TYPE | DESCRIPTION |
|---|---|---|
description | string | undefined | Peut être mis à Jour Peut être Supprimé |
foreignData | string | undefined | Peut être mis à Jour Peut être Supprimé |
Voici quelques exemples de code pour éffectuer une modification:
fundRequestPromise =
fPay.fundRequest.update({
id: "<id | foreignId>",
change: {
description: "<new value>",
foreignData: "<new value>"
}
});fundRequestPromise =
fPay.fundRequest.update({
id: "<id | foreignId>",
change: {
description: "<new value>"
},
'remove': ['foreignData']
});fundRequestPromise =
fPay.fundRequest.update({
id: "<id | foreignId>",
'remove': ['description', 'foreignData']
});Lorsque vous récupérez une liste, voici les champs par lesquels il est possible de faire des filtres ainsi que des tris.
| NOM | TYPE | DESCRIPTION |
|---|---|---|
amount.currency.code | string | |
amount.value | number | |
completedTime | string | |
completedTime.iso8601 | string | |
completedTime.timestamp.milliseconds | number | |
completedTime.timestamp.seconds | number | |
createdTime | string | |
createdTime.iso8601 | string | |
createdTime.timestamp.milliseconds | number | |
createdTime.timestamp.seconds | number | |
creator | string | |
creator._type | string | |
creator.accountId | string | |
creator.authAccessId | string | |
creator.personId | string | |
description | string | |
destination | string | |
destination._type | string | |
destination.account.balanceType | string | |
destination.account.identifier._type | string | |
destination.account.identifier.value | string | |
destination.account.provider.country.iso3166.alpha2 | string | |
destination.account.provider.country.iso3166.alpha3 | string | |
destination.account.provider.country.name | string | |
destination.account.provider.key | string | |
destination.account.provider.name | string | |
destination.amount.currency.code | string | |
destination.amount.value | number | |
expire.delay | string | |
expire.time | string | |
expire.time.iso8601 | string | |
expire.time.timestamp.milliseconds | number | |
expire.time.timestamp.seconds | number | |
fees.amount.currency.code | string | |
fees.amount.value | number | |
fees.payer | string | |
fees.value.fixe | number | |
fees.value.percent | number | |
foreignId | string | |
h1Descriptor.en | string | |
h1Descriptor.fr | string | |
id | string | |
onFailure.redirectUserTo | string | |
onSuccess.redirectUserTo | string | |
securePay.link | string | |
securePay.purpose.label | string | |
securePay.qrCode.src | string | |
sending | string | |
source | string | |
source._type | string | |
source.account.balanceType | string | |
source.account.identifier._type | string | |
source.account.identifier.value | string | |
source.account.provider.country.iso3166.alpha2 | string | |
source.account.provider.country.iso3166.alpha3 | string | |
source.account.provider.country.name | string | |
source.account.provider.key | string | |
source.account.provider.name | string | |
source.amount.currency.code | string | |
source.amount.value | number | |
status | string | |
status._type | string | |
status.cancelled.afterTimeout | boolean | |
status.reason.en | string | |
status.reason.fr | string |
Des exemples de code sont disponibles sur la page Audit Reporting & Tableau de bord.
FundRequestamountAmount | undefinedcurrencyAmountCurrencycodestringunitstringvaluenumbercompletedTimeUTCDateTime | undefinediso8601stringtimestampTimestampmillisecondsnumbersecondsDoublecreatedTimeUTCDateTimeiso8601stringtimestampTimestampmillisecondsnumbersecondsDoublecreatorCreatorCreator.ApiApi_typestringaccountIdstringauthAccessIdstringCreator.UiUi_typestringaccountIdstringpersonIdstringdescriptionstring | undefineddestinationDestinationDestination.MultipleMultiple_typestringDestination.SingleSingle_typestringaccountMoneyAccountbalanceTypestringidentifierMoneyAccountIdentifier_typestringvaluestringid du Wallet FPay.man du Wallet FPay.providerMoneyAccountProvidercountryCountryiso3166Iso3166Countryalpha2stringalpha3stringnamestringkeystringnamestringamountAmountcurrencyAmountCurrencycodestringunitstringvaluenumberexpireExpire | undefineddelayDurationiso8601stringmillisecondsDoublesecondsDoubletimeUTCDateTimeiso8601stringtimestampTimestampmillisecondsnumbersecondsDoublefeesFeesamountAmountcurrencyAmountCurrencycodestringunitstringvaluenumberpayerstring | undefinedvalueFeesValuefixenumberpercentnumberforeignDatastring | undefinedforeignIdstring | undefinedh1DescriptorH1Descriptor | undefinedenstring | undefinedfrstring | undefinedidstringonFailureOnFundRequestCompleted | undefinedredirectUserTostring | undefinedonSuccessOnFundRequestCompleted | undefinedredirectUserTostring | undefinedsecurePaySecurePaylinkstringpurposeSecurePayPurposeSecurePayPurpose.PurchasePurchase_typestringlabelstringSecurePayPurpose.ReceiveReceive_typestringSecurePayPurpose.SendSend_typestringqrCodeQrCodesrcstringsendingstringsourceSource | undefinedSource.MultipleMultiple_typestringSource.SingleSingle_typestringaccountMoneyAccountbalanceTypestringidentifierMoneyAccountIdentifier_typestringvaluestringid du Wallet FPay.man du Wallet FPay.providerMoneyAccountProvidercountryCountryiso3166Iso3166Countryalpha2stringalpha3stringnamestringkeystringnamestringamountAmountcurrencyAmountCurrencycodestringunitstringvaluenumberstatusFundRequestStatusFundRequestStatus.FailureFailure_typestringcancelledCancelled | undefinedafterTimeoutbooleanreasonLocalizedTextenstringfrstringFundRequestStatus.ProcessingProcessing_typestringreasonLocalizedTextenstringfrstringFundRequestStatus.StartedStarted_typestringFundRequestStatus.StartingStarting_typestringFundRequestStatus.SuccessfulSuccessful_typestringFundRequestStatus.WaitingToStartWaitingToStart_typestringurlstring