Forum und email

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.

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.

M_PENDING (entier)
M_DONE (entier)
M_ERROR (entier)
M_FAIL (entier)
M_SUCCESS (entier)

Table of Contents

  • 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