dfrv

1. Bienvenue

2. PAIEMENTS DE FACTURES
ET WALLET
P.I.E(Paiement Integration Engine)
Version 1.0 Redigé par: Roméo KOUAME.
Validé par: Valery SEKA
2
JANVIER
2024
FORMATION

3. A PROPOS DU DOCUMENT
 Ce document est destiné à l’équipe support AISSA et DEVELOPPEMENT
 Il ne s’agit pas d’un guide utilisateur destiné aux filiales
 Le domaine d’utilisation de cette documentation ne s’applique qu’au sein du groupe BANK OF AFRICA

4. PAIEMENTS DE FACTURES
CANAL DIGITAL
CANAL AGENCE
Version 1.0 Redigé par: Roméo KOUAME.
Validé par: Valery SEKA
4
CONTENU
WALLET

5. PARTIE 1
Paiements de factures
BILLPAY

6. TITRE 1
BILLPAY-CANAL DIGITAL

7. SOMMAIRE
 CH 1 : Les tables de travail
 CH 2 : Les paramétrages FX5Y8
 CH 3 : Le package
 CH 4 : Les scripts de traitement
 CH 5 : Les répertoires de traitement
 CH 6 : Les fichiers LOG

8. CHAPITRE 1
Les tables de travail

9. Les tables de travail

BOA_BILLPAY_RECAP_LOAD

BOA_BILLPAY_RECAP_W

BOA_BILLPAY_FIC_LOG

BOA_BILLPAY_RECAP_OUT

BOA_BILLPAY_RECAP_OUT_LOG

BOA_BILLPAY_SPOOL_OFF

BOA_AUCP

10. Les tables de travail
BOA_BILLPAYFX : Cette table contient l’image des paramétrages effectués dans le serveur de BILLPAY.
BOA_BILLPAY_XML: Elle contient les traces des requêtes HTTP envoyées au serveur BILLPAY, ainsi que les
réponses de ces requêtes.
BOA_BILLPAY_UNPAID : Contient les traces des opérations initiées depuis IGOR, dont le paiement n’a pas
encore oubiti au niveau du moteur BILLPAY
BOA_BILLPAY_PAID : Contient les traces des opérations initiées depuis IGOR, dont le paiement a oubiti au
niveau du moteur BILLPAY
BOA_BILLPAYFX_HIST : Table d’historisation des paramètres, avant chaque mise à jour.
BOA_BILLPAY_RECAP_LOAD : Table dans laquelle est chargée le contenu des fichiers de reconciliation, avant
traitement.
BOA_BILLPAY_RECAP_W : Table dans laquelle est chargée le contenu de la table BOA_BILLPAY_RECAP_LOAD
pour traitement, ligne par ligne.

11. Les tables de travail
BOA_BILLPAY_RECAP_OUT : Cette table contient les lignes devant figurer dans le fichier RETOUR à générer.
BOA_BILLPAY_RECAP_OUT_LOG: Elle historise tous les fichiers RETOURS générés.
BOA_BILLPAY_SPOOL_OFF : Dans cette table est enregistrée le contenu global du fichier RETOUR généré.
BOA_AUCP : Contient les transactions à comptabiliser

12. CHAPITRE2
Paramétrage FX5Y8

13. Paramétrage FX5Y8
Deux(2) TNAMES ont été utilisés à savoir :
1. BILLPAYFX
2. HOSTPAR

14. Paramétrage FX5Y8
1. BILLPAYFX / CIONDFT

X1 = TVA

X2 = COMPTE DE TVA(en cas de compte unique)

X3 = RACINE CLIENT(en cas de compte par agence

X4 = Rubrique comptable(en cas de compte par
agence

X5 = Code BILLER(en MAJUSCULE)

X1 = TIMBRE

X2 = COMPTE DE TIMBRE(en cas de compte unique)

X3 = RACINE CLIENT(en cas de compte par agence

X4 = Rubrique comptable(en cas de compte par agence

X5 = Code BILLER(en MAJUSCULE)

X1 = COMM

X2 = COMPTE DE COMMISSION(en cas de compte unique)

X3 = RACINE CLIENT(en cas de compte par agence

X4 = Rubrique comptable(en cas de compte par agence

X5 = Code BILLER(en MAJUSCULE)
Ce model est utilisé pour les comptes de commission, TVA et Timbres

15. Paramétrage FX5Y8
1. BILLPAYFX / BILLER

X1 = Code BILLER(en MAJUSCULE)

X2 = COMPTE D’ATTENTE DU BILLER (Compte de passage)

X3 = COMPTE A VUE DU BILLER

X4 = COMPTE PRINCIPAL DU BILLER (A utiliser si une consolidation est
faite sur un compte principal à la compta su soir)

X8 = Prend valeur Y si le BILLER veut ses opérations consolidées en un
seul crédit sur son compte PRINCIPAL à la compta su soir. (Dans le cas
contraire, Y, prend valeur NULL ou N)
Ce model est utilisé pour les comptes du Biller

16. Paramétrage FX5Y8
1. BILLPAYFX / BILLER

Y1 = La PART de commission du BILLER

Y2 = La PART de commission de la banque

Y3 = COMPTE de commission du BILLER
Ce model est utilisé pour les comptes du Biller

17. Paramétrage FX5Y8
1. BILLPAYFX / MODEC

Si les commissions sont à la charge du BILLER, X1 = BPB et X8 = FACTURIER

si les commissions sont à la charge du CLIENT, X1 = BPC et X8 = CLIENT
Ce model est utilisé pour la définition des codes d’opération ainsi la
partie(CLIENT ou FACTURIER) à charge des commissions

18. Paramétrage FX5Y8
1. BILLPAYFX / MODECLIB

Si X1 = BPB , X8 = FACTURIER et Y1 = FRAIS CIONS SUR FACTURIER

si X1 = BPC , X8 = CLIENT et Y1 = FRAIS CIONS SUR CLIENT
Ce model est utilisé pour la définition des libellés des codes d’opération des
commissions

19. Paramétrage FX5Y8
1. BILLPAYFX / NOTIFICATIONS

Si X3 = FROM,

X1 = BILLPAY(Code)

X2 = O(Obligatoire)

Y1 = ADRESSE MAIL D’ENVOI

Si X3 = MAIL_TO,

X1 = CODE DU BILLER(En minuscule)

X2 = O(Obligatoire)

Y1 à Y5= ADRESSES MAILS DES DESTINATAIRES

Si X3 = TO_CC,

X1 = BILLPAY(Code)

X2 = O(Obligatoire)

Y1 = ADRESSE 1 A METTRE EN COPIE

Y2 = ADRESSE 2 A METTRE EN COPIE

20. Paramétrage FX5Y8
1. BILLPAYFX / URL

X1 = BILLPAY

X5 = http://

Y1 = billpay.mybank.of.africa:80

Y2 = Code Iso du Pays (Exemple TG pour TOGO et CI pour Côte D’Ivoire)

Y3 = CORE(qui défini le canal, lié à IGOR)
Ce model est utilisé pour les paramètres composant l’URL

21. Paramétrage FX5Y8
1. BILLPAYFX / REJETS

Il s’agit ici de paramétrer l’ensemble des codes de Rejets renvoyés par le
moteur BILLPAY.

X1 pour les Codes de Rejet

X2 pour les niveaux(Warning ou Bloquant)

Y1 pour les libellés des code de rejet

22. Paramétrage FX5Y8
2. HOSTPAR
CODAPPEL : Paramétrage du code d’appel pour la mise en ligne des états
PARAMLST : Paramétrage des lignes d’état

23. CHAPITRE3
Les packages

24. Les packages
Les packages utilisés sont :
 PK_BOA_AUTOCPT. Il permet, par sa procédure P_DEMAUTOTR, de faire la
réservation de fond, par le débit du compte du client, pour un crédit du
compte d’attente du BILLER.
: Ce package est utilisé dans d’autres applications, autre que BILLPAY.
 BOA_BillPay : Package principal de Billpay

25. CHAPITRE 4
Les scripts de traitement

26. Il s’agit des scripts:
- CTL
- SH
- SQL
- SQI

27. Le script CTL
Le script CTL boa_billpay_chrg_fic.ctl est utilisé pour charger le contenu du
fichier de réconciliation dans la table BOA_BILLPAY_RECAP_LOAD pour
traitement

28. Les scripts SH
trtbillpay_fic.sh : Script principal pour le traitement des fichiers retour.
boa_billpay_compta.sh : Script permettant de générer les écritures comptables dans
MVTD, en attendant la compta du soir.
get_billpay_sftp_file.sh : Script utilisé pour la récupération des fichiers de
réconciliations depuis le serveur SFTP
boa_billpay_traitefic.sh : traite les fichiers récupérés
billpay_out_fic.sh : Génère les fichiers RETOUR à transmettre via SFTP
boa_billpay_sendmail.sh : Script permettant de transmettre les fichiers RETOUR
générés par mail
boa_BillPay_Rejoue.sh : Rejoue pour avoir le dernier statut.

29. Les scripts SQL
boa_billpay_controle_fichier.sql : Il effectue les contrôles sur chacun des fichiers chargés
boa_billpay_controle_trx.sql : Il effectue les contrôles sur chacune des lignes de
transactions, contenues dans le fichier chargé.
boa_billpay_gen_fic_retour.sql : Il permet de générer les fichiers RETOUR.
boa_billpay_rejoue_status.sql : Script permettant la récupération du dernier statut de
chaque transaction non comptabilisée
boa_billpay_sendmail.sql : Script d’envoi de mail
ebillpay.sql : Script de génération d’état
list_biller_billpay : Script de récupération de la liste des billers enregistrés
list_nooper_billpay: Script de récupération de la liste des NOOPER à dont on doit
générer les écritures comptables

30. Le scripts SQI
cboa_aucp.sqi : Il est utilisé dans la comptabilisation des transactions de BILLPAY
:Ce SQI est utilisé dans d’autres applications, autre que BILLPAY.

31. PARTIE VI
Les répertoires de traitement

32. Les répertoires de traitement
Les répertoires utilisés pour les traitements sont:
$USR/BILLPAY : Répertoire de travail dans lequel sont déposés les
fichiers de transactions à traiter(à comptabiliser ou pas).
$USR/BILLPAY/TRAITES : Répertoire dans lequel sont déplacés les
fichiers déjà traités.
$USR/BILLPAY/RETOUR : Répertoire dans lequel sont stockés les
fichiers RETOUR générés à transmettre au serveur BILLPAY.

33. Les répertoires de traitement
 $USR/BILLPAY/RETOUR/SEND : Répertoire dans lequel sont stockés les
fichiers RETOUR, déjà transmis au serveur de BILLPAY .
 $USR/BILLPAY/FILE_BILLER : Répertoire des fichiers à transmettre aux billers
 $USR/BILLPAY/FILE_BILLER/ENVOYES : Répertoire des fichiers transmis aux
billers

34. TITRE 2
BILLPAY-CANAL AGENCE

35.  Ecran boa_billpay : Ecran de consultation des paiements ou
factures en attente
 Ecran guichet_billpay : Ecran Guichet, pour les paiements
 Ecran billet_billpay : Ecran de billetage
Pour la partie AGENCE, nous avons mis en place trois(3) écrans qui sont :

36. Ecran boa_billpay

37. Ecran guichet_billpay

38. Ecran billet_billpay

39. PARTIE VII
Les fichiers LOG

40. Les fichiers LOG
L’ensemble des LOGs se trouvent dans le répertoire $USR/BILLPAY/log
Il s’agit principalement du fichier: trtbillpay_fic.log

41. PARTIE 2
WALLET
…. A suivre …

42. Merci !