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.

Types de ressources

Cette extension définit une ressource MCVE_CONN retournée par la fonction m_initconn() .

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.

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