Ces fonctions font l’interface avec l’API (libmonetra, anciennement connue sous le nom de libmcve) MCVE (Monetra), et permettent l’accès direct aux fonctions MCVE/Monetra depuis les scripts PHP. MCVE/Monetra est la solution de paiement en ligne de Main Street Softworks pour Linux/Unix/MacOSX/Windows (http://www.mainstreetsoftworks.com/) qui permet de traiter des cartes de crédits, de débit et cartes cadeaux. Il vous permet d’utiliser directement le numéro de carte de crédit, et de l’envoyer à la maison de paiement via votre serveur Unix, avec connexion modem ou internet : il permet de vous passer de services comme Authorize.Net ou Pay Flow Pro). En utilisant le module MCVE/Monetra de PHP, vous pouvez traiter des cartes de crédit directement depuis vos scripts PHP. La référence suivante va vous décrire le processus.

Note : MCVE/Monetra est la solution de remplacement pour le module de RedHat CCVS. Ils ont conclu un accord avec RedHat à la fin de l’année 2001 pour migrer tous leurs clients vers la plateforme MCVE.

Note : Cette extension a été déplacée dans le module PECL et ne sera plus intégrée dans PHP à partir de PHP 5.1.0.

Note : Cette extension n’est pas disponible sur les plates-formes Windows.

Pour activer le support MCVE (Monetra) de PHP commencez par vérifier si la bibliothèque LibMontera (anciennement libmcve) est installée. Si vous compilez le support MCVE/Monetra directement dans PHP, vous devrez configurer PHP avec l’option “–with-mcve”. Si vous utilisez cette option sans spécifiez le chemin d’accès de votre installation de libmonetra, PHP tentera de rechercher dans l’emplacement par défaut de l’installation de LibMonetra (”/usr/local”). Si Monetra (MCVE) est dans un emplacement non standard, exécutez la configuration avec : “–with-mcve=$mcve_path”, où $mcve_path est le chemin menant à votre installation de MCVE/Monetra. Veuillez noter que le support MCVE/Monetra requiert que $mcve_path/lib et $mcve_path/include existent et incluent “mcve.h” ou “monetra.h” dans le répertoire include et “libmcve.so” et/ou “libmcve.a” et/ou “libmonetra.a” dans le répertoire lib.

Si vous voulez installer le support MCVE/Monetra en tant que module, vous pouvez le faire en utilisant les bibliothèques PECL et taper la commande ‘pecl install mcve’ si vous utilisez une version de PEAR au moins de 1.4.0.

Comme MCVE/Monetra vient avec une véritable séparation client/serveur, il n’y a pas de pré-requis supplémentaires pour compiler PHP avec le support MCVE. Pour tester votre extension MCVE/Monetra avec PHP, connectez-vous au site testbox.monetra.com sur le port 8333 pour le mode IP, ou le port 8444 pour le mode SSL en utilisant l’API PHP MCVE/Monetra. Utilisez ‘vitale’ comme nom d’utilisateur et ‘test’ comme mot de passe. Plus de détails sur ce système de test sont disponibles sur http://www.mainstreetsoftworks.com/.

Plus de documentation sur l’API PHP de MCVE/Monetra est disponible à http://www.mainstreetsoftworks.com/documentation.html. La documentation éditée par Main Street est complète et est la source primaire d’informations.

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l’exécution.

“M_PENDING” (entier)

“M_DONE” (entier)

“M_ERROR” (entier)

“M_FAIL” (entier)

“M_SUCCESS” (entier)

Table des matières

m_checkstatus – Vérifie si la transaction a été complétéem_completeauthorizations – Nombre d’autorisations complètes en attente, retourne un tableau de leur identifiantm_connect – Établit une connexion à MCVEm_connectionerror – Obtient une représentation textuelle de la cause de l’échec de connexionm_deletetrans – Supprime une transaction spécifiée de la structure MCVE_CONNm_destroyconn – Détruit la connexion et la structure MCVE_CONNm_destroyengine – Libère la mémoire associée avec la connectivité IP/SSLm_getcell – Récupère une cellule spécifique d’une réponse délimitée par virgule avec le nom de colonnem_getcellbynum – Récupère une cellule spécifique d’une réponse délimitée par virgule avec le numéro de colonnem_getcommadelimited – Récupère les données brutes délimitées par virgule retournées par MCVEm_getheader – Récupère le nom de la colonne dans la réponse délimitée par virgulem_initconn – Crée et initialise une structure MCVE_CONNm_initengine – Apprête le client pour Communication IP/SSLm_iscommadelimited – Vérifie si la réponse est délimitée par virgulem_maxconntimeout – Le temps maximal que l’API tentera une connexion à MCVEm_monitor – Effectue une communication avec MCVE (envoi/réception de données) en mode non-bloquantm_numcolumns – Nombre de colonnes retournées dans une réponse délimitée par virgulem_numrows – Nombre de lignes retournés dans une réponse délimitée par virgulem_parsecommadelimited – Analyse la réponse délimitée par virgule alors m_getcell, etc. fonctionneram_responsekeys – Retourne un tableau de chaînes de caractères qui représente les clés qui peuvent être utilisées en tant que paramètres de réponse sur cette transactionm_responseparam – Récupère un paramètre spécial de réponsem_returnstatus – Vérifie si la transaction fut complétée correctementm_setblocking – Fixe le mode bloquant/non-bloquant pour une connexionm_setdropfile – Fixe la méthode de connexion à Drop-Filem_setip – Fixe la méthode de connexion à IPm_setssl_cafile – Fixe le fichier SSL CA (Certificate Authority) pour vérification du certificat du serveurm_setssl_files – Fixe les fichiers de clé de certificat et certifie si le serveur requiert la vérification du client par certificatm_setssl – Fixe la méthode de connexion à SSLm_settimeout – Fixe le temps maximal d’une transaction (par transaction)m_sslcert_gen_hash – Génère une clé de hachage pour les vérifications de certificat de client SSLm_transactionssent – Vérifie si le tampon de sortie est videm_transinqueue – Nombre de transactions dans la file de clientm_transkeyval – Ajoute une paire clé/valeur d’une transaction. Replace transparam() dépréciéem_transnew – Démarre une nouvelle transactionm_transsend – Finalise et envoie la transactionm_uwait – Attend x micro secondesm_validateidentifier – Valide ou non l’identifiant passé sur n’importe quelle transaction qu’il est passém_verifyconnection – Ping ou non sur la connexion pour la vérifierm_verifysslcert – Vérifie ou non le certificat du serveur SSL