LXXXIII. Fonctions de paiement MCVE (Monetra)

Introduction

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.

Installation

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/.

Voir aussi

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.

Constantes pré-définies

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ée
m_completeauthorizations -- Nombre d'autorisations complètes en attente, retourne un tableau de leur identifiant
m_connect -- Établit une connexion à MCVE
m_connectionerror -- Obtient une représentation textuelle de la cause de l'échec de connexion
m_deletetrans -- Supprime une transaction spécifiée de la structure MCVE_CONN
m_destroyconn -- Détruit la connexion et la structure MCVE_CONN
m_destroyengine -- Libère la mémoire associée avec la connectivité IP/SSL
m_getcell -- Récupère une cellule spécifique d'une réponse délimitée par virgule avec le nom de colonne
m_getcellbynum -- Récupère une cellule spécifique d'une réponse délimitée par virgule avec le numéro de colonne
m_getcommadelimited -- Récupère les données brutes délimitées par virgule retournées par MCVE
m_getheader -- Récupère le nom de la colonne dans la réponse délimitée par virgule
m_initconn -- Crée et initialise une structure MCVE_CONN
m_initengine -- Apprête le client pour Communication IP/SSL
m_iscommadelimited -- Vérifie si la réponse est délimitée par virgule
m_maxconntimeout -- Le temps maximal que l'API tentera une connexion à MCVE
m_monitor -- Effectue une communication avec MCVE (envoi/réception de données) en mode non-bloquant
m_numcolumns -- Nombre de colonnes retournées dans une réponse délimitée par virgule
m_numrows -- Nombre de lignes retournés dans une réponse délimitée par virgule
m_parsecommadelimited -- Analyse la réponse délimitée par virgule alors m_getcell, etc. fonctionnera
m_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 transaction
m_responseparam -- Récupère un paramètre spécial de réponse
m_returnstatus -- Vérifie si la transaction fut complétée correctement
m_setblocking -- Fixe le mode bloquant/non-bloquant pour une connexion
m_setdropfile -- Fixe la méthode de connexion à Drop-File
m_setip -- Fixe la méthode de connexion à IP
m_setssl_cafile -- Fixe le fichier SSL CA (Certificate Authority) pour vérification du certificat du serveur
m_setssl_files -- Fixe les fichiers de clé de certificat et certifie si le serveur requiert la vérification du client par certificat
m_setssl -- Fixe la méthode de connexion à SSL
m_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 SSL
m_transactionssent -- Vérifie si le tampon de sortie est vide
m_transinqueue -- Nombre de transactions dans la file de client
m_transkeyval -- Ajoute une paire clé/valeur d'une transaction. Replace transparam() dépréciée
m_transnew -- Démarre une nouvelle transaction
m_transsend -- Finalise et envoie la transaction
m_uwait -- Attend x micro secondes
m_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érifier
m_verifysslcert -- Vérifie ou non le certificat du serveur SSL